fix: google-cloud-audit-log wheel installs unintended top-level docs package

[namefreezers]

Thank you for opening a Pull Request! Before submitting your PR, there are a few things you can do to make sure it goes smoothly:

• Make sure to open an issue as a bug/issue before writing your code! That way we can discuss the change, evaluate designs, and agree on the general idea
• Ensure the tests and linter pass
• Code coverage does not decrease (if any source code was changed)
• Appropriate docs were updated (if necessary)

Fixes#17270 🦕

This PR fixes google-cloud-audit-log packaging so the wheel no longer installs an unintended top-level docs/conf.py file into site-packages.

The issue was caused by broad namespace package discovery in setup.py, which allowed the repository’s top-level docs/ directory to be discovered as an installable package. This changes package discovery to include only the intended google* namespace while continuing to exclude test/doc-related paths. I also added a regression test that runs the real setup.py, captures the discovered packages, and asserts that google.cloud.audit is included while docs is not.

I verified the built wheel locally and confirmed it contains only google/cloud/audit/... runtime files plus dist-info metadata, with no docs/conf.py. This prevents confusing stray files in virtual environments and avoids potential collisions with other top-level docs packages.

Check which I ran:

(venv) PS C:\Users\Name\PycharmProjects\google-adk-3\google-cloud-python\packages\google-cloud-audit-log> uv run --with build --with setuptools python -m build --wheel && uv run python -m zipfile --list ".\dist\google_cloud_audit_log-0.5.0-py3-none-any.whl"&& rm -r .\build\ && rm -r .\dist\ && rm -r .\google_cloud_audit_log.egg-info\
* Creating isolated environment: venv+pip...
* Installing packages in isolated environment:
- setuptools >= 40.8.0
* Getting build dependencies for wheel...
C:\Users\Name\AppData\Local\Temp\build-env-qxhimdp9\Lib\site-packages\setuptools\dist.py:765: SetuptoolsDeprecationWarning: License classifiers are deprecated.
!!********************************************************************************
Please consider removing the following classifiers in favor of a SPDX license expression:
License :: OSI Approved :: Apache Software License
See https://packaging.python.org/en/latest/guides/writing-pyproject-toml/#license for details.********************************************************************************!!self._finalize_license_expression()
running egg_info
writing google_cloud_audit_log.egg-info\PKG-INFO
writing dependency_links to google_cloud_audit_log.egg-info\dependency_links.txt
writing requirements to google_cloud_audit_log.egg-info\requires.txt
writing top-level names to google_cloud_audit_log.egg-info\top_level.txt
reading manifest file 'google_cloud_audit_log.egg-info\SOURCES.txt'
reading manifest template 'MANIFEST.in'
warning: no files found matching '*.json' under directory 'google'
warning: no files found matching 'py.typed' under directory 'google'
warning: no previously-included files matching '__pycache__' found anywhere in distribution
no previously-included directories found matching 'scripts\readme-gen'
adding license file 'LICENSE'
writing manifest file 'google_cloud_audit_log.egg-info\SOURCES.txt'* Building wheel...
C:\Users\Name\AppData\Local\Temp\build-env-qxhimdp9\Lib\site-packages\setuptools\dist.py:765: SetuptoolsDeprecationWarning: License classifiers are deprecated.
!!********************************************************************************
Please consider removing the following classifiers in favor of a SPDX license expression:
License :: OSI Approved :: Apache Software License
See https://packaging.python.org/en/latest/guides/writing-pyproject-toml/#license for details.********************************************************************************!!self._finalize_license_expression()
running bdist_wheel
running build
running build_py
copying google\cloud\audit\audit_log_pb2.py -> build\lib\google\cloud\audit
copying google\cloud\audit\bigquery_audit_metadata_pb2.py -> build\lib\google\cloud\audit
copying google\cloud\audit\__init__.py -> build\lib\google\cloud\audit
running egg_info
writing google_cloud_audit_log.egg-info\PKG-INFO
writing dependency_links to google_cloud_audit_log.egg-info\dependency_links.txt
writing requirements to google_cloud_audit_log.egg-info\requires.txt
writing top-level names to google_cloud_audit_log.egg-info\top_level.txt
reading manifest file 'google_cloud_audit_log.egg-info\SOURCES.txt'
reading manifest template 'MANIFEST.in'
warning: no files found matching '*.json' under directory 'google'
warning: no files found matching 'py.typed' under directory 'google'
warning: no previously-included files matching '__pycache__' found anywhere in distribution
no previously-included directories found matching 'scripts\readme-gen'
adding license file 'LICENSE'
writing manifest file 'google_cloud_audit_log.egg-info\SOURCES.txt'
copying google\cloud\audit\audit_log.proto -> build\lib\google\cloud\audit
copying google\cloud\audit\audit_log_pb2.pyi -> build\lib\google\cloud\audit
copying google\cloud\audit\bigquery_audit_metadata.proto -> build\lib\google\cloud\audit
copying google\cloud\audit\bigquery_audit_metadata_pb2.pyi -> build\lib\google\cloud\audit
installing to build\bdist.win-amd64\wheel
running install
running install_lib
creating build\bdist.win-amd64\wheel
creating build\bdist.win-amd64\wheel\google
creating build\bdist.win-amd64\wheel\google\cloud
creating build\bdist.win-amd64\wheel\google\cloud\audit
copying build\lib\google\cloud\audit\audit_log.proto -> build\bdist.win-amd64\wheel\.\google\cloud\audit
copying build\lib\google\cloud\audit\audit_log_pb2.py -> build\bdist.win-amd64\wheel\.\google\cloud\audit
copying build\lib\google\cloud\audit\audit_log_pb2.pyi -> build\bdist.win-amd64\wheel\.\google\cloud\audit
copying build\lib\google\cloud\audit\bigquery_audit_metadata.proto -> build\bdist.win-amd64\wheel\.\google\cloud\audit
copying build\lib\google\cloud\audit\bigquery_audit_metadata_pb2.py -> build\bdist.win-amd64\wheel\.\google\cloud\audit
copying build\lib\google\cloud\audit\bigquery_audit_metadata_pb2.pyi -> build\bdist.win-amd64\wheel\.\google\cloud\audit
copying build\lib\google\cloud\audit\__init__.py -> build\bdist.win-amd64\wheel\.\google\cloud\audit
running install_egg_info
Copying google_cloud_audit_log.egg-info to build\bdist.win-amd64\wheel\.\google_cloud_audit_log-0.5.0-py3.14.egg-info
running install_scripts
creating build\bdist.win-amd64\wheel\google_cloud_audit_log-0.5.0.dist-info\WHEEL
creating 'C:\\Users\\Name\\PycharmProjects\\google-adk-3\\google-cloud-python\\packages\\google-cloud-audit-log\\dist\\.tmp-s9jvzbct\\google_cloud_audit_log-0.5.0-py3-none-any.whl' and adding 'build\\bdist.win-amd64\\wheel' to it
adding 'google/cloud/audit/__init__.py'
adding 'google/cloud/audit/audit_log.proto'
adding 'google/cloud/audit/audit_log_pb2.py'
adding 'google/cloud/audit/audit_log_pb2.pyi'
adding 'google/cloud/audit/bigquery_audit_metadata.proto'
adding 'google/cloud/audit/bigquery_audit_metadata_pb2.py'
adding 'google/cloud/audit/bigquery_audit_metadata_pb2.pyi'
adding 'google_cloud_audit_log-0.5.0.dist-info/licenses/LICENSE'
adding 'google_cloud_audit_log-0.5.0.dist-info/METADATA'
adding 'google_cloud_audit_log-0.5.0.dist-info/WHEEL'
adding 'google_cloud_audit_log-0.5.0.dist-info/top_level.txt'
adding 'google_cloud_audit_log-0.5.0.dist-info/RECORD'
removing build\bdist.win-amd64\wheel
Successfully built google_cloud_audit_log-0.5.0-py3-none-any.whl
File Name Modified Size
google/cloud/audit/__init__.py 2026-05-27 12:15:08 0
google/cloud/audit/audit_log.proto 2026-05-27 12:15:08 15317
google/cloud/audit/audit_log_pb2.py 2026-05-27 12:15:08 10641
google/cloud/audit/audit_log_pb2.pyi 2026-05-27 12:15:08 13351
google/cloud/audit/bigquery_audit_metadata.proto 2026-05-27 12:15:08 34497
google/cloud/audit/bigquery_audit_metadata_pb2.py 2026-05-27 12:15:08 37184
google/cloud/audit/bigquery_audit_metadata_pb2.pyi 2026-05-27 12:15:08 70216
google_cloud_audit_log-0.5.0.dist-info/licenses/LICENSE 2026-05-27 13:44:56 11358
google_cloud_audit_log-0.5.0.dist-info/METADATA 2026-05-27 13:44:56 9346
google_cloud_audit_log-0.5.0.dist-info/WHEEL 2026-05-27 13:44:56 91
google_cloud_audit_log-0.5.0.dist-info/top_level.txt 2026-05-27 13:44:56 7
google_cloud_audit_log-0.5.0.dist-info/RECORD 2026-05-27 13:44:56 1154

(venv) PS C:\Users\Name\PycharmProjects\google-adk-3\google-cloud-python\packages\google-cloud-audit-log> uv run --with pytest --with setuptools pytest tests/unit/test_packaging.py -q .. [100%]
2 passed in 0.23s

(venv) PS C:\Users\Name\PycharmProjects\google-adk-3\google-cloud-python\packages\google-cloud-audit-log> uv run --with nox nox -s lint lint_setup_py nox > Running session lint
nox > Creating virtual environment (virtualenv) using python3.14 in .nox\lint
nox > python -m pip install flake8 ruff==0.14.14
nox > ruff format --check --target-version=py39 --line-length=88 docs google tests noxfile.py setup.py
10 files already formatted
nox > flake8 google tests
nox > Session lint was successful in 5 seconds.
nox > Running session lint_setup_py
nox > Creating virtual environment (virtualenv) using python3.14 in .nox\lint_setup_py
nox > python -m pip install docutils pygments setuptools
nox > python setup.py check --restructuredtext --strict
C:\Users\Name\PycharmProjects\google-adk-3\google-cloud-python\packages\google-cloud-audit-log\.nox\lint_setup_py\Lib\site-packages\setuptools\dist.py:765: SetuptoolsDeprecationWarning: License classifiers are deprecated.
!!********************************************************************************
Please consider removing the following classifiers in favor of a SPDX license expression:
License :: OSI Approved :: Apache Software License
See https://packaging.python.org/en/latest/guides/writing-pyproject-toml/#license for details.********************************************************************************!!self._finalize_license_expression()
running check
nox > Session lint_setup_py was successful in 9 seconds.
nox > Ran 2 sessions in 14 seconds:
nox >* lint: success, took 5 seconds
nox >* lint_setup_py: success, took 9 seconds

[gemini-code-assist]

Code Review

This pull request updates the setup.py configuration for the google-cloud-audit-log package to restrict package discovery. Specifically, it configures find_namespace_packages to only include packages matching google* and explicitly exclude docs* alongside the existing exclusions for tests. Additionally, a unit test has been added to verify that the docs package is not discovered during setup. I have no feedback to provide as there are no review comments.

[namefreezers]

@parthea Sorry, I accidentally unassigned myself from the PR. This wasn't intentional. Please assign me back if it is needed.
And I’ve fixed the unit tests and the checks are passing now. The PR is ready for review.