fork/rules_rust

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

UebelAndreUpdated rust_bindgen dependencies API (#1354)120f911d

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