fork/rules_rust

git clone https://git.julia.blue/fork/rules_rust

UebelAndreDeleted deprecated `rust_analyzer` rule. (#1405)3aa88ab0

0.7.0
4.8 KiB201 linesraw
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(
8    name = "docs_deps",
9    srcs = [
10        "@bazel_tools//tools:bzl_srcs",
11        "@com_google_protobuf//:bzl_srcs",
12        "@rules_nodejs//nodejs:bzl",
13    ],
14    deps = [
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(
24    name = "all_docs",
25    deps = [
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([
38    page(
39        name = "cargo",
40        symbols = [
41            "cargo_bootstrap_repository",
42            "cargo_build_script",
43            "cargo_env",
44        ],
45    ),
46    page(
47        name = "defs",
48        symbols = [
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    ),
61    page(
62        name = "providers",
63        symbols = [
64            "CrateInfo",
65            "DepInfo",
66            "StdLibInfo",
67        ],
68    ),
69    page(
70        name = "rust_analyzer",
71        header_template = ":rust_analyzer.vm",
72        symbols = [
73            "rust_analyzer_aspect",
74        ],
75    ),
76    page(
77        name = "rust_bindgen",
78        header_template = ":rust_bindgen.vm",
79        symbols = [
80            "rust_bindgen_library",
81            "rust_bindgen_dependencies",
82            "rust_bindgen_register_toolchains",
83            "rust_bindgen_toolchain",
84            "rust_bindgen",
85        ],
86    ),
87    page(
88        name = "rust_clippy",
89        header_template = ":rust_clippy.vm",
90        symbols = [
91            "rust_clippy",
92            "rust_clippy_aspect",
93        ],
94    ),
95    page(
96        name = "rust_doc",
97        symbols = [
98            "rust_doc",
99            "rust_doc_test",
100        ],
101    ),
102    page(
103        name = "rust_fmt",
104        header_template = ":rust_fmt.vm",
105        symbols = [
106            "rustfmt_aspect",
107            "rustfmt_test",
108        ],
109    ),
110    page(
111        name = "rust_proto",
112        header_template = ":rust_proto.vm",
113        symbols = [
114            "rust_grpc_library",
115            "rust_proto_library",
116            "rust_proto_repositories",
117            "rust_proto_transitive_repositories",
118            "rust_proto_toolchain",
119        ],
120    ),
121    page(
122        name = "rust_repositories",
123        symbols = [
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    ),
134    page(
135        name = "rust_wasm_bindgen",
136        header_template = ":rust_wasm_bindgen.vm",
137        symbols = [
138            "rust_wasm_bindgen_dependencies",
139            "rust_wasm_bindgen_register_toolchains",
140            "rust_wasm_bindgen_toolchain",
141            "rust_wasm_bindgen",
142        ],
143    ),
144    page(
145        name = "settings",
146        symbols = [
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[
157    stardoc(
158        name = "%s_md" % k,
159        out = "%s.md" % k,
160        header_template = ":%s_gen_header_vm" % k,
161        input = ":symbols.bzl",
162        symbol_names = PAGES[k].symbols,
163        deps = [":all_docs"],
164    )
165    for k in PAGES.keys()
166]
167
168genrule(
169    name = "flatten_header_vm",
170    outs = ["flatten_header.vm"],
171    cmd = ">$@ echo '# Rust rules\n\n%s\n'" % "\n".join(
172        sorted(["* [{rule}](#{rule})".format(rule = v) for k in PAGES.keys() for v in PAGES[k].symbols]),
173    ),
174    output_to_bindir = True,
175)
176
177stardoc(
178    name = "flatten_md",
179    out = "flatten.md",
180    header_template = ":flatten_header_vm",
181    input = ":symbols.bzl",
182    symbol_names = sorted([symbol for k in PAGES.keys() for symbol in PAGES[k].symbols]),
183    deps = [":all_docs"],
184)
185
186stardoc(
187    name = "crate_universe",
188    out = "crate_universe.md",
189    input = "@rules_rust//crate_universe:docs.bzl",
190    deps = [":all_docs"],
191)
192
193sh_binary(
194    name = "update_docs",
195    srcs = ["update_docs.sh"],
196)
197
198sh_binary(
199    name = "test_docs",
200    srcs = ["test_docs.sh"],
201)