Moved examples and docs repository definitions into their WORKSPACE files (#896)

Author: UebelAndre

docs/WORKSPACE.bazel

@@ -1,13 +1,41 @@
 workspace(name = "rules_rust_docs")
 
-load(":docs_repositories.bzl", "repositories")
+local_repository(
+    name = "rules_rust",
+    path = "..",
+)
 
-repositories()
+load("@rules_rust//rust:repositories.bzl", "rust_repositories")
 
-load(":docs_deps.bzl", "deps")
+rust_repositories(include_rustc_srcs = True)
 
-deps()
+load("@rules_rust//proto:repositories.bzl", "rust_proto_repositories")
 
-load(":docs_transitive_deps.bzl", "transitive_deps")
+rust_proto_repositories()
 
-transitive_deps()
+load("@rules_rust//proto:transitive_repositories.bzl", "rust_proto_transitive_repositories")
+
+rust_proto_transitive_repositories()
+
+load("@rules_rust//wasm_bindgen:repositories.bzl", "rust_wasm_bindgen_repositories")
+
+rust_wasm_bindgen_repositories()
+
+load("@build_bazel_rules_nodejs//:index.bzl", "node_repositories")
+
+node_repositories()
+
+load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")
+
+http_archive(
+    name = "io_bazel_stardoc",
+    sha256 = "ff10a8b1503f5606fab5aa5bc9ae267272c023af7789f03caef95b5ab3fe0df2",
+    strip_prefix = "stardoc-d93ee5347e2d9c225ad315094507e018364d5a67",
+    urls = [
+        "https://github.com/bazelbuild/stardoc/archive/d93ee5347e2d9c225ad315094507e018364d5a67.zip",
+    ],
+)
+
+load("@io_bazel_stardoc//:setup.bzl", "stardoc_repositories")
+
+stardoc_repositories()

docs/docs_deps.bzl

@@ -1,19 +1,110 @@
 workspace(name = "examples")
 
-load(":examples_repositories.bzl", "repositories")
+# Users of `rules_rust` will commonly be unable to load it
+# using a `local_repository`. Instead, to setup the rules,
+# please see https://bazelbuild.github.io/rules_rust/#setup
+local_repository(
+    name = "rules_rust",
+    path = "..",
+)
+
+load("@rules_rust//rust:repositories.bzl", "rust_repositories")
+
+rust_repositories(include_rustc_srcs = True)
+
+load("@rules_rust//bindgen:repositories.bzl", "rust_bindgen_repositories")
 
-repositories()
+rust_bindgen_repositories()
 
-load(":examples_deps.bzl", "deps")
+load("@rules_rust//proto:repositories.bzl", "rust_proto_repositories")
 
-deps()
+rust_proto_repositories()
 
-load(":examples_transitive_deps.bzl", "transitive_deps")
+load("@rules_rust//proto:transitive_repositories.bzl", "rust_proto_transitive_repositories")
 
-transitive_deps()
+rust_proto_transitive_repositories()
+
+load("@rules_rust//wasm_bindgen:repositories.bzl", "rust_wasm_bindgen_repositories")
+
+rust_wasm_bindgen_repositories()
 
 load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")
 
+###############################################################################
+# Workspace examples
+###############################################################################
+
+# buildifier: disable=same-origin-load
+load("@rules_rust//rust:repositories.bzl", "rust_repository_set")
+
+# `rust_repository_set` is the core repository rule for downloading and defining
+# a rust_toolchain. Should there be a need for a customized toolchain, this macro can
+# be used to define and register one.
+rust_repository_set(
+    name = "fake_toolchain_for_test_of_sha256",
+    edition = "2018",
+    exec_triple = "x86_64-unknown-linux-gnu",
+    extra_target_triples = [],
+    rustfmt_version = "1.4.12",
+    sha256s = {
+        "rust-1.46.0-x86_64-unknown-linux-gnu": "e3b98bc3440fe92817881933f9564389eccb396f5f431f33d48b979fa2fbdcf5",
+        "rust-std-1.46.0-x86_64-unknown-linux-gnu": "ac04aef80423f612c0079829b504902de27a6997214eb58ab0765d02f7ec1dbc",
+        "rustfmt-1.4.12-x86_64-unknown-linux-gnu": "1894e76913303d66bf40885a601462844eec15fca9e76a6d13c390d7000d64b0",
+    },
+    version = "1.46.0",
+)
+
+###############################################################################
+# Examples dependencies
+###############################################################################
+
+load("@build_bazel_rules_nodejs//:index.bzl", "node_repositories")
+
+node_repositories()
+
+http_archive(
+    name = "rules_foreign_cc",
+    sha256 = "3c6445404e9e5d17fa0ecdef61be00dd93b20222c11f45e146a98c0a3f67defa",
+    strip_prefix = "rules_foreign_cc-d54c78ab86b40770ee19f0949db9d74a831ab9f0",
+    url = "https://github.com/bazelbuild/rules_foreign_cc/archive/d54c78ab86b40770ee19f0949db9d74a831ab9f0.zip",
+)
+
+load("@rules_foreign_cc//:workspace_definitions.bzl", "rules_foreign_cc_dependencies")
+
+rules_foreign_cc_dependencies()
+
+load("//sys:sys_deps.bzl", "sys_deps")
+
+sys_deps()
+
+local_repository(
+    name = "rules_rust_example_cargo_manifest_dir",
+    path = "cargo_manifest_dir/external_crate",
+)
+
+_LIBC_BUILD_FILE_CONTENT = """\
+load("@rules_rust//rust:rust.bzl", "rust_library")
+
+rust_library(
+    name = "libc",
+    srcs = glob(["src/**/*.rs"]),
+    visibility = ["//visibility:public"],
+)
+"""
+
+http_archive(
+    name = "libc",
+    build_file_content = _LIBC_BUILD_FILE_CONTENT,
+    sha256 = "1ac4c2ac6ed5a8fb9020c166bc63316205f1dc78d4b964ad31f4f21eb73f0c6d",
+    strip_prefix = "libc-0.2.20",
+    urls = [
+        "https://mirror.bazel.build/github.com/rust-lang/libc/archive/0.2.20.zip",
+        "https://github.com/rust-lang/libc/archive/0.2.20.zip",
+    ],
+)
+
+###############################################################################
+
 http_archive(
     name = "bazel_toolchains",
     sha256 = "179ec02f809e86abf56356d8898c8bd74069f1bd7c56044050c2cd3d79d0e024",

docs/docs_repositories.bzl

@@ -20,6 +20,8 @@ rust_binary(
     name = "hello_sys",
     srcs = ["src/main.rs"],
     edition = "2018",
+    # Note the `cargo-raze` dependencies here need to have been loaded
+    # in the WORKSPACE file. See `//sys:sys_deps.bzl` for rmore details.
     deps = ["//sys/basic/raze:bzip2"],
 )
 

docs/docs_transitive_deps.bzl

@@ -20,5 +20,7 @@ rust_binary(
     name = "complex_sys",
     srcs = ["src/main.rs"],
     edition = "2018",
+    # Note the `cargo-raze` dependencies here need to have been loaded
+    # in the WORKSPACE file. See `//sys:sys_deps.bzl` for rmore details.
     deps = ["//sys/complex/raze:git2"],
 )

examples/WORKSPACE.bazel

@@ -0,0 +1,14 @@
+# buildifier: disable=module-docstring
+load("//sys/basic/raze:crates.bzl", "rules_rust_examples_basic_sys_fetch_remote_crates")
+load("//sys/complex:repositories.bzl", "rules_rust_examples_complex_sys_repositories")
+
+def sys_deps():
+    """This macro loads dependencies for the `sys` crate examples
+
+    Commonly `*-sys` crates are built on top of some existing library and
+    will have a number of dependencies. The examples here use
+    [cargo-raze](https://github.com/google/cargo-raze) to gather these
+    dependencies and make them avaialble in the workspace.
+    """
+    rules_rust_examples_basic_sys_fetch_remote_crates()
+    rules_rust_examples_complex_sys_repositories()