feat: add public filegroups containing bzl files to allow downstream rulesets to generate docs (#443)

Author: mattem

BUILD

@@ -33,3 +33,20 @@ filegroup(
     ],
     visibility = ["//distro:__pkg__"],
 )
+
+# Reexport of all bzl files used to allow downstream rules to generate docs
+# without shipping with a dependency on Skylib
+filegroup(
+    name = "bzl",
+    srcs = [
+        "//python/pip_install:bzl",
+        "//python:bzl",
+        # Requires Bazel 0.29 onward for public visibility of these .bzl files.
+        "@bazel_tools//tools/python:private/defs.bzl",
+        "@bazel_tools//tools/python:python_version.bzl",
+        "@bazel_tools//tools/python:srcs_version.bzl",
+        "@bazel_tools//tools/python:toolchain.bzl",
+        "@bazel_tools//tools/python:utils.bzl",
+    ],
+    visibility = ["//visibility:public"],
+)

python/BUILD

@@ -38,6 +38,20 @@ filegroup(
     visibility = ["//:__pkg__"],
 )
 
+# Filegroup of bzl files that can be used by downstream rules for documentation generation
+# Using a filegroup rather than bzl_library to not give a transitive dependency on Skylib
+filegroup(
+    name = "bzl",
+    srcs = [
+        "defs.bzl",
+        "packaging.bzl",
+        "pip.bzl",
+        "whl.bzl",
+        "private/reexports.bzl",
+    ],
+    visibility = ["//:__pkg__"],
+)
+
 # ========= Core rules =========
 
 exports_files([

python/pip_install/BUILD

@@ -8,6 +8,15 @@ filegroup(
     visibility = ["//:__pkg__"],
 )
 
+filegroup(
+    name = "bzl",
+    srcs = [
+        "pip_repository.bzl",
+        "repositories.bzl",
+    ],
+    visibility = ["//:__pkg__"],
+)
+
 exports_files(
     ["pip_repository.bzl", "repositories.bzl"],
     visibility = ["//docs:__pkg__"],