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