feat: Make Sphinx integration experimental publicly visible (#1813)
With this commit the visibility settings are adjusted to use the Sphinx
Integration from rules_python also in other (dependent) projects.
Since the Sphinx integration is not yet stable, we denote in the
documentation that this is done under the experimental API support.
Meaning, breaking changes can occure at any point in time.
See the discussion in #1796
diff --git a/sphinxdocs/private/BUILD.bazel b/sphinxdocs/private/BUILD.bazel
index 01758b3..ec6a945 100644
--- a/sphinxdocs/private/BUILD.bazel
+++ b/sphinxdocs/private/BUILD.bazel
@@ -34,7 +34,7 @@
"sphinx_build.py",
"sphinx_server.py",
],
- visibility = ["//:__subpackages__"],
+ visibility = ["//visibility:public"],
)
bzl_library(
@@ -70,14 +70,14 @@
name = "inventory_builder",
srcs = ["inventory_builder.py"],
# Only public because it's an implicit attribute
- visibility = ["//:__subpackages__"],
+ visibility = ["//visibility:public"],
)
py_binary(
name = "proto_to_markdown",
srcs = ["proto_to_markdown.py"],
# Only public because it's an implicit attribute
- visibility = ["//:__subpackages__"],
+ visibility = ["//visibility:public"],
deps = [":proto_to_markdown_lib"],
)
@@ -85,7 +85,7 @@
name = "proto_to_markdown_lib",
srcs = ["proto_to_markdown.py"],
# Only public because it's an implicit attribute
- visibility = ["//:__subpackages__"],
+ visibility = ["//visibility:public"],
deps = [
":stardoc_output_proto_py_pb2",
],
diff --git a/sphinxdocs/sphinx.bzl b/sphinxdocs/sphinx.bzl
index a0b1a05..d9385bd 100644
--- a/sphinxdocs/sphinx.bzl
+++ b/sphinxdocs/sphinx.bzl
@@ -23,6 +23,8 @@
Defining your own `sphinx-build` binary is necessary because Sphinx uses
a plugin model to support extensibility.
+
+The Sphinx integration is still experimental.
"""
load(
