@public and @private

This library provides two very simple decorators that document the public visibility of the names in your module. They keep your module’s __all__ in sync so you don’t have to.

Also included is a function that you can put at the bottom of your module to simply infer all the public names, and populate the __all__ for you.

Installation

$ pip install atpublic

The install extra additionally installs @public and @private into builtins, so they’re always available without having to import them first:

$ pip install atpublic[install]

Note that while the top-level module is named public, the PyPI package is called atpublic due to a name conflict. Do not install public; that is a different package!

Author

Licensed under the terms of the Apache License Version 2.0. See the LICENSE file for details.

Project details

Project home: https://gitlab.com/flufl/public

Report bugs at: https://gitlab.com/flufl/public/-/work_items

Code hosting: https://gitlab.com/flufl/public.git

Documentation: https://public.readthedocs.io

PyPI: https://pypi.org/project/atpublic/

Release files for atpublic 8.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for atpublic 8.0.0
File	Size	Uploaded
atpublic-8.0.0.tar.gz	8.0 kB	Sep 18, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for atpublic 8.0.0
File	Interpreter	ABI	Platform	Reset
atpublic-8.0.0-py3-none-any.whl 11.1 kB Sep 18, 2026	Python 3	none	any	Details

Total release size: 19.1 kB

Release files / atpublic-8.0.0.tar.gz

Download URL	atpublic-8.0.0.tar.gz
Size	8.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`3aed41fabe1d0110be4ff6c227361a7b8dd790efbbcdbaeea5be3495edd8e7b9`
BLAKE2b-256 checksum How to use checksums	`fa76f3157c604474fd642b40ed64826a0a0433bba7207294996e8c2d4d84a0fe`
Upload date	Sep 18, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.12.3`

Release files / atpublic-8.0.0-py3-none-any.whl

Download URL	atpublic-8.0.0-py3-none-any.whl
Size	11.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`01eb44a6befc79752f1ca0a87b13a22f556b635a9f39bd93ea5bb9e45eec099e`
BLAKE2b-256 checksum How to use checksums	`00356f69186fb0cb25e703003d04f10b65ed3c73e3989a4781b5e9294df7a019`
Upload date	Sep 18, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.12.3`