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