packaging.python.org icon indicating copy to clipboard operation
packaging.python.org copied to clipboard

Python Packaging User Guide

Results 177 packaging.python.org issues
Sort by recently updated
recently updated
newest added

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...

type: bug
component: guides

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/

diataxis: explanation

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.,...

state: blocked
type: task
component: specifications
component: guides

* 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...

component: tutorials

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...

type: task
component: specifications
diataxis: reference