fork/rules_rust
git clone https://git.julia.blue/fork/rules_rust
0e86b9dd
0.11.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_flag" , 58"extra_rustc_flags" , 59"capture_clippy_output" , 60], 61), 62page ( 63name = "providers" , 64symbols = [ 65"CrateInfo" , 66"DepInfo" , 67"StdLibInfo" , 68], 69), 70page ( 71name = "rust_analyzer" , 72header_template = ":rust_analyzer.vm" , 73symbols = [ 74"rust_analyzer_aspect" , 75"rust_analyzer_toolchain" , 76], 77), 78page ( 79name = "rust_bindgen" , 80header_template = ":rust_bindgen.vm" , 81symbols = [ 82"rust_bindgen_library" , 83"rust_bindgen_dependencies" , 84"rust_bindgen_register_toolchains" , 85"rust_bindgen_toolchain" , 86"rust_bindgen" , 87], 88), 89page ( 90name = "rust_clippy" , 91header_template = ":rust_clippy.vm" , 92symbols = [ 93"rust_clippy" , 94"rust_clippy_aspect" , 95], 96), 97page ( 98name = "rust_doc" , 99symbols = [ 100"rust_doc" , 101"rust_doc_test" , 102], 103), 104page ( 105name = "rust_fmt" , 106header_template = ":rust_fmt.vm" , 107symbols = [ 108"rustfmt_aspect" , 109"rustfmt_test" , 110], 111), 112page ( 113name = "rust_proto" , 114header_template = ":rust_proto.vm" , 115symbols = [ 116"rust_grpc_library" , 117"rust_proto_library" , 118"rust_proto_repositories" , 119"rust_proto_transitive_repositories" , 120"rust_proto_toolchain" , 121], 122), 123page ( 124name = "rust_repositories" , 125symbols = [ 126"rules_rust_dependencies" , 127"rust_register_toolchains" , 128"rust_repositories" , 129"rust_repository_set" , 130"rust_stdlib_filegroup" , 131"rust_toolchain_repository_proxy" , 132"rust_toolchain_repository" , 133"rust_toolchain_tools_repository" , 134"rust_toolchain" , 135], 136), 137page ( 138name = "rust_wasm_bindgen" , 139header_template = ":rust_wasm_bindgen.vm" , 140symbols = [ 141"rust_wasm_bindgen_dependencies" , 142"rust_wasm_bindgen_register_toolchains" , 143"rust_wasm_bindgen_toolchain" , 144"rust_wasm_bindgen" , 145], 146), 147page ( 148name = "settings" , 149symbols = [ 150"incompatible_flag" , 151"fail_when_enabled" , 152], 153), 154]) 155 156# Generate headers for each page 157[ gen_header ( page = p ) for p in PAGES . values ()] 158 159[ 160stardoc ( 161name = "%s_md" % k , 162out = "%s.md" % k , 163header_template = ":%s_gen_header_vm" % k , 164input = ":symbols.bzl" , 165symbol_names = PAGES [ k ]. symbols , 166deps = [ ":all_docs" ], 167) 168for k in PAGES . keys () 169] 170 171genrule ( 172name = "flatten_header_vm" , 173outs = [ "flatten_header.vm" ], 174cmd = ">$@ echo '# Rust rules\n \n % s \n '" % "\n ". join ( 175sorted ([ "* [{rule}](#{rule})" . format ( rule = v ) for k in PAGES . keys () for v in PAGES [ k ]. symbols ]), 176), 177output_to_bindir = True , 178) 179 180stardoc ( 181name = "flatten_md" , 182out = "flatten.md" , 183header_template = ":flatten_header_vm" , 184input = ":symbols.bzl" , 185symbol_names = sorted ([ symbol for k in PAGES . keys () for symbol in PAGES [ k ]. symbols ]), 186deps = [ ":all_docs" ], 187) 188 189stardoc ( 190name = "crate_universe" , 191out = "crate_universe.md" , 192input = "@rules_rust//crate_universe:docs.bzl" , 193deps = [ ":all_docs" ], 194) 195 196sh_binary ( 197name = "update_docs" , 198srcs = [ "update_docs.sh" ], 199) 200 201sh_binary ( 202name = "test_docs" , 203srcs = [ "test_docs.sh" ], 204)