fork/rules_rust
git clone https://git.julia.blue/fork/rules_rust
43e5279e
cleanup
1load ( "@bazel_skylib//:bzl_library.bzl" , "bzl_library" ) 2load ( "@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], 12deps = [ 13"@bazel_skylib//lib:paths" , 14"@bazel_skylib//lib:selects" , 15"@bazel_skylib//lib:structs" , 16"@bazel_skylib//rules:common_settings" , 17], 18) 19 20bzl_library ( 21name = "all_docs" , 22deps = [ 23":docs_deps" , 24"@rules_rust//cargo:bzl_lib" , 25"@rules_rust//crate_universe:bzl_lib" , 26"@rules_rust//crate_universe/private/module_extensions:bzl_lib" , 27"@rules_rust//rust:bzl_lib" , 28"@rules_rust_bindgen//:bzl_lib" , 29"@rules_rust_prost//:bzl_lib" , 30"@rules_rust_protobuf//:bzl_lib" , 31"@rules_rust_wasm_bindgen//:bzl_lib" , 32], 33) 34 35PAGES = dict ([ 36page ( 37name = "cargo" , 38symbols = [ 39"cargo_bootstrap_repository" , 40"cargo_build_script" , 41"cargo_dep_env" , 42"cargo_env" , 43], 44), 45page ( 46name = "rust" , 47symbols = [ 48"rust_binary" , 49"rust_library" , 50"rust_library_group" , 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_clippy" , 80header_template = ":rust_clippy.vm" , 81symbols = [ 82"rust_clippy" , 83"rust_clippy_aspect" , 84], 85), 86page ( 87name = "rust_doc" , 88symbols = [ 89"rust_doc" , 90"rust_doc_test" , 91], 92), 93page ( 94name = "rust_fmt" , 95header_template = ":rust_fmt.vm" , 96symbols = [ 97"rustfmt_aspect" , 98"rustfmt_test" , 99"rustfmt_toolchain" , 100], 101), 102page ( 103name = "rust_repositories" , 104symbols = [ 105"rules_rust_dependencies" , 106"rust_analyzer_toolchain_repository" , 107"rust_register_toolchains" , 108"rust_repositories" , 109"rust_repository_set" , 110"rust_stdlib_filegroup" , 111"rust_toolchain_repository_proxy" , 112"rust_toolchain_repository" , 113"rust_toolchain_tools_repository" , 114"rust_toolchain" , 115], 116), 117page ( 118name = "settings" , 119symbols = [ 120"incompatible_flag" , 121"fail_when_enabled" , 122], 123), 124]) 125 126# Generate headers for each page 127[ gen_header ( page = p ) for p in PAGES . values ()] 128 129[ 130stardoc ( 131name = "%s_md" % k , 132out = "%s.md" % k , 133header_template = ":%s_gen_header_vm" % k , 134input = ":symbols.bzl" , 135symbol_names = PAGES [ k ]. symbols , 136deps = [ ":all_docs" ], 137) 138for k in PAGES . keys () 139] 140 141genrule ( 142name = "flatten_header_vm" , 143outs = [ "flatten_header.vm" ], 144cmd = ">$@ echo '# Rust rules\n \n % s \n '" % "\n ". join ( 145sorted ([ "* [{rule}](#{rule})" . format ( rule = v ) for k in PAGES . keys () for v in PAGES [ k ]. symbols ]), 146), 147output_to_bindir = True , 148) 149 150stardoc ( 151name = "flatten_md" , 152out = "flatten.md" , 153header_template = ":flatten_header_vm" , 154input = ":symbols.bzl" , 155symbol_names = sorted ([ symbol for k in PAGES . keys () for symbol in PAGES [ k ]. symbols ]), 156deps = [ ":all_docs" ], 157) 158 159stardoc ( 160name = "crate_universe_workspace" , 161out = "crate_universe.md" , 162input = "@rules_rust//crate_universe:docs_workspace.bzl" , 163deps = [ ":all_docs" ], 164) 165 166stardoc ( 167name = "crate_universe_bzlmod" , 168out = "crate_universe_bzlmod.md" , 169input = "@rules_rust//crate_universe:docs_bzlmod.bzl" , 170deps = [ ":all_docs" ], 171) 172 173# This target exists to avoid this issue: 174# https://github.com/bazelbuild/rules_cc/issues/279 175bzl_library ( 176name = "bindgen_lib" , 177srcs = [ 178"@com_google_protobuf//:bzl_srcs" , 179"@rules_cc//cc:bzl_srcs" , 180], 181deps = [ 182"@com_google_protobuf//bazel:cc_proto_library_bzl" , 183"@rules_cc//cc/common" , 184"@rules_cc//cc/toolchains:toolchain_rules" , 185"@rules_rust_bindgen//:bzl_lib" , 186], 187) 188 189stardoc ( 190name = "rust_bindgen" , 191out = "rust_bindgen.md" , 192input = "@rules_rust_bindgen//:defs.bzl" , 193deps = [ ":bindgen_lib" ], 194) 195 196stardoc ( 197name = "rust_protobuf" , 198out = "rust_protobuf.md" , 199input = "@rules_rust_protobuf//:defs.bzl" , 200deps = [ "@rules_rust_protobuf//:bzl_lib" ], 201) 202 203stardoc ( 204name = "rust_prost" , 205out = "rust_prost.md" , 206input = "@rules_rust_prost//:defs.bzl" , 207deps = [ "@rules_rust_prost//:bzl_lib" ], 208) 209 210stardoc ( 211name = "rust_wasm_bindgen" , 212out = "rust_wasm_bindgen.md" , 213input = "@rules_rust_wasm_bindgen//:defs.bzl" , 214deps = [ "@rules_rust_wasm_bindgen//:bzl_lib" ], 215) 216 217stardoc ( 218name = "rust_wasm_bindgen_rules_js" , 219out = "rust_wasm_bindgen_rules_js.md" , 220input = "@rules_rust_wasm_bindgen//rules_js:defs.bzl" , 221deps = [ "@rules_rust_wasm_bindgen//rules_js:bzl_lib" ], 222) 223 224stardoc ( 225name = "rust_wasm_bindgen_rules_nodejs" , 226out = "rust_wasm_bindgen_rules_nodejs.md" , 227input = "@rules_rust_wasm_bindgen//rules_nodejs:defs.bzl" , 228deps = [ "@rules_rust_wasm_bindgen//rules_nodejs:bzl_lib" ], 229) 230 231sh_binary ( 232name = "update_docs" , 233srcs = [ "update_docs.sh" ], 234) 235 236sh_binary ( 237name = "test_docs" , 238srcs = [ "test_docs.sh" ], 239)