fork/rules_rust
git clone https://git.julia.blue/fork/rules_rust
120f911d
0.5.0
1load ( "@bazel_skylib//:bzl_library.bzl" , "bzl_library" ) 2load ( "@io_bazel_stardoc//stardoc:stardoc.bzl" , "stardoc" ) 3load ( "//:page.bzl" , "gen_header" , "page" ) 4 5package ( default_visibility = [ "//visibility:private" ]) 6 7bzl_library ( 8name = "docs_deps" , 9srcs = [ 10"@bazel_tools//tools:bzl_srcs" , 11"@com_google_protobuf//:bzl_srcs" , 12"@rules_nodejs//nodejs:bzl" , 13], 14deps = [ 15"@bazel_skylib//lib:paths" , 16"@bazel_skylib//lib:selects" , 17"@bazel_skylib//rules:common_settings" , 18"@rules_proto//proto:defs" , 19"@rules_proto//proto:repositories" , 20], 21) 22 23bzl_library ( 24name = "all_docs" , 25deps = [ 26":docs_deps" , 27"@rules_rust//:bzl_lib" , 28"@rules_rust//bindgen:bzl_lib" , 29"@rules_rust//cargo:bzl_lib" , 30"@rules_rust//crate_universe:bzl_lib" , 31"@rules_rust//proto:bzl_lib" , 32"@rules_rust//rust:bzl_lib" , 33"@rules_rust//wasm_bindgen:bzl_lib" , 34], 35) 36 37PAGES = dict ([ 38page ( 39name = "cargo" , 40symbols = [ 41"cargo_bootstrap_repository" , 42"cargo_build_script" , 43"cargo_env" , 44], 45), 46page ( 47name = "defs" , 48symbols = [ 49"rust_binary" , 50"rust_library" , 51"rust_static_library" , 52"rust_shared_library" , 53"rust_proc_macro" , 54"rust_test" , 55"rust_test_suite" , 56"error_format" , 57"extra_rustc_flags" , 58"capture_clippy_output" , 59], 60), 61page ( 62name = "providers" , 63symbols = [ 64"CrateInfo" , 65"DepInfo" , 66"StdLibInfo" , 67], 68), 69page ( 70name = "rust_analyzer" , 71header_template = ":rust_analyzer.vm" , 72symbols = [ 73"rust_analyzer" , 74"rust_analyzer_aspect" , 75], 76), 77page ( 78name = "rust_bindgen" , 79header_template = ":rust_bindgen.vm" , 80symbols = [ 81"rust_bindgen_library" , 82"rust_bindgen_dependencies" , 83"rust_bindgen_register_toolchains" , 84"rust_bindgen_toolchain" , 85"rust_bindgen" , 86], 87), 88page ( 89name = "rust_clippy" , 90header_template = ":rust_clippy.vm" , 91symbols = [ 92"rust_clippy" , 93"rust_clippy_aspect" , 94], 95), 96page ( 97name = "rust_doc" , 98symbols = [ 99"rust_doc" , 100"rust_doc_test" , 101], 102), 103page ( 104name = "rust_fmt" , 105header_template = ":rust_fmt.vm" , 106symbols = [ 107"rustfmt_aspect" , 108"rustfmt_test" , 109], 110), 111page ( 112name = "rust_proto" , 113header_template = ":rust_proto.vm" , 114symbols = [ 115"rust_grpc_library" , 116"rust_proto_library" , 117"rust_proto_repositories" , 118"rust_proto_transitive_repositories" , 119"rust_proto_toolchain" , 120], 121), 122page ( 123name = "rust_repositories" , 124symbols = [ 125"rules_rust_dependencies" , 126"rust_register_toolchains" , 127"rust_repositories" , 128"rust_repository_set" , 129"rust_stdlib_filegroup" , 130"rust_toolchain_repository_proxy" , 131"rust_toolchain_repository" , 132"rust_toolchain" , 133], 134), 135page ( 136name = "rust_wasm_bindgen" , 137header_template = ":rust_wasm_bindgen.vm" , 138symbols = [ 139"rust_wasm_bindgen_dependencies" , 140"rust_wasm_bindgen_register_toolchains" , 141"rust_wasm_bindgen_toolchain" , 142"rust_wasm_bindgen" , 143], 144), 145page ( 146name = "settings" , 147symbols = [ 148"incompatible_flag" , 149"fail_when_enabled" , 150], 151), 152]) 153 154# Generate headers for each page 155[ gen_header ( page = p ) for p in PAGES . values ()] 156 157[ 158stardoc ( 159name = "%s_md" % k , 160out = "%s.md" % k , 161header_template = ":%s_gen_header_vm" % k , 162input = ":symbols.bzl" , 163symbol_names = PAGES [ k ]. symbols , 164deps = [ ":all_docs" ], 165) 166for k in PAGES . keys () 167] 168 169genrule ( 170name = "flatten_header_vm" , 171outs = [ "flatten_header.vm" ], 172cmd = ">$@ echo '# Rust rules\n \n % s \n '" % "\n ". join ( 173sorted ([ "* [{rule}](#{rule})" . format ( rule = v ) for k in PAGES . keys () for v in PAGES [ k ]. symbols ]), 174), 175output_to_bindir = True , 176) 177 178stardoc ( 179name = "flatten_md" , 180out = "flatten.md" , 181header_template = ":flatten_header_vm" , 182input = ":symbols.bzl" , 183symbol_names = sorted ([ symbol for k in PAGES . keys () for symbol in PAGES [ k ]. symbols ]), 184deps = [ ":all_docs" ], 185) 186 187stardoc ( 188name = "crate_universe" , 189out = "crate_universe.md" , 190input = "@rules_rust//crate_universe:docs.bzl" , 191deps = [ ":all_docs" ], 192) 193 194sh_binary ( 195name = "update_docs" , 196srcs = [ "update_docs.sh" ], 197) 198 199sh_binary ( 200name = "test_docs" , 201srcs = [ "test_docs.sh" ], 202)