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