1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
|
==========================================================
@public and @private -- Document your module's interface
==========================================================
.. currentmodule:: public
This library provies two very simple decorators that document the *publicness*
of the names in your module. They keep your module's ``__all__`` in sync so
you don't have to.
Please note that while the package is called :doc:`public <apiref>` and it
provides a top-level module named ``public``, the PyPI package is called
``atpublic`` due to name conflicts.
Requirements
============
``public`` requires Python 3.8 or newer.
Documentation
=============
A `simple guide`_ to using the library is available, along with a detailed
`API reference`_.
Project details
===============
* Project home: https://gitlab.com/warsaw/public
* Report bugs at: https://gitlab.com/warsaw/public/issues
* Code hosting: https://gitlab.com/warsaw/public.git
* Documentation: https://public.readthedocs.io
* PyPI: https://pypi.python.org/pypi/atpublic
You can install it with `pip`::
% pip install atpublic
**Do not install "public"; that is a different package!**
You can grab the latest development copy of the code using git. The main
repository is hosted on GitLab. If you have git installed, you can grab
your own branch of the code like this::
$ git clone https://gitlab.com/warsaw/public.git
You can contact the author via barry@python.org.
Copyright
=========
Copyright (C) 2016-2024 Barry A. Warsaw
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
Table of Contents and Index
===========================
* :ref:`genindex`
.. toctree::
:glob:
using
apiref
NEWS
.. _`simple guide`: using.html
.. _`API reference`: apiref.html
|
