packaging.python.org
packaging.python.org copied to clipboard
Python Packaging User Guide
I had filed a issue over on the packaging-problems project, and as part of resolving that @sinoroc request that I file a documentation issue over here. Looking specifically at the...
Use pyproject.toml metadata instead of referring to setuptools' install_requires setup() keyword. ---- :books: Documentation preview :books:: https://python-packaging-user-guide--1427.org.readthedocs.build/en/1427/
There is currently confusion in the ecosystem around what sdists should contain, and specifically - whether they should contain tests and documentation - whether they should contain auxiliary files (e.g.,...
* More fleshed-out introduction to the API * Add specification for latest standard of both HTML and JSON formats * For each API endpoint, its features are described generally, then...
... and such? People often use images videos and such in their project descriptions. For screenshots, for guides, and various other things. How should these be included?
(For more information about this issue, please see #194). We need a short section to follow the package sources section (see #200) (i.e., as its own file). It should satisfy...
The single-sourcing-package-version page is pretty out of date. I've (started to) update it to reflect the current standard of practice: I know this doc deliberately doesn't make a recommendation, but...
Use internal references when the PEPs have been imported into the PUG. ---- :books: Documentation preview :books:: https://python-packaging-user-guide--1405.org.readthedocs.build/en/1405/ - https://python-packaging-user-guide--1405.org.readthedocs.build/en/1405/discussions/deploying-python-applications/ - https://python-packaging-user-guide--1405.org.readthedocs.build/en/1405/glossary/#term-Project - https://python-packaging-user-guide--1405.org.readthedocs.build/en/1405/guides/packaging-namespace-packages/ - https://python-packaging-user-guide--1405.org.readthedocs.build/en/1405/guides/writing-pyproject-toml/#pyproject-guide-build-system-table - https://python-packaging-user-guide--1405.org.readthedocs.build/en/1405/key_projects/ - https://python-packaging-user-guide--1405.org.readthedocs.build/en/1405/specifications/entry-points/...
I believe `pypiserver` is a simple and efficient way to get an own index server running, and should deserve a recommendation and usage example. The guide is rather thin, in...
This is a matter of someone going through https://peps.python.org/topic/packaging/, identifying all accepted and final PEPs, and converting their content into [reference material](https://diataxis.fr/reference/) on this documentation. This would be content that...