?HAMA

Navigation

Breadcrumbs

Create

Edit File Size: 1.60 KB

//opt/alt/python311/share/doc/alt-python311-setuptools/docs/userguide/index.rst

Text Base64

==================================================
Building and Distributing Packages with Setuptools
==================================================

The first step towards sharing a Python library or program is to build a
distribution package [#package-overload]_. This includes adding a set of
additional files containing metadata and configuration to not only instruct
``setuptools`` on how the distribution should be built but also
to help installer (such as :pypi:`pip`) during the installation process.

This document contains information to help Python developers through this
process. Please check the :doc:`/userguide/quickstart` for an overview of
the workflow.

Also note that ``setuptools`` is what is known in the community as :pep:`build
backend <517#terminology-and-goals>`, user facing interfaces are provided by tools
such as :pypi:`pip` and :pypi:`build`. To use ``setuptools``, one must
explicitly create a ``pyproject.toml`` file as described :doc:`/build_meta`.

Contents
========

.. toctree::
    :maxdepth: 1

quickstart
    package_discovery
    dependency_management
    development_mode
    entry_point
    datafiles
    ext_modules
    distribution
    miscellaneous
    extension
    declarative_config
    pyproject_config

---

.. rubric:: Notes

.. [#package-overload]
   A :term:`Distribution Package` is also referred in the Python community simply as "package"
   Unfortunately, this jargon might be a bit confusing for new users because the term package
   can also to refer any :term:`directory <package>` (or sub directory) used to organize
   :term:`modules <module>` and auxiliary files.

Exit & Reset Text mode: syntax highlighting auto-detects file type.

Name	Size	Perms	Modified	Actions
datafiles.rst	17.99 KB	lrw-r--r--	2022-11-24 06:08:53	Edit Download recursive recursive
declarative_config.rst	12.43 KB	lrw-r--r--	2022-11-24 06:08:53	Edit Download recursive recursive
dependency_management.rst	11.36 KB	lrw-r--r--	2022-11-24 06:08:53	Edit Download recursive recursive
development_mode.rst	11.84 KB	lrw-r--r--	2022-11-24 06:08:53	Edit Download recursive recursive
distribution.rst	10.07 KB	lrw-r--r--	2022-11-24 06:08:53	Edit Download recursive recursive
entry_point.rst	17.94 KB	lrw-r--r--	2022-11-24 06:08:53	Edit Download recursive recursive
extension.rst	12.99 KB	lrw-r--r--	2022-11-24 06:08:53	Edit Download recursive recursive
ext_modules.rst	7.05 KB	lrw-r--r--	2022-11-24 06:08:53	Edit Download recursive recursive
index.rst	1.60 KB	lrw-r--r--	2022-11-24 06:08:53	Edit Download recursive recursive
miscellaneous.rst	4.24 KB	lrw-r--r--	2022-11-24 06:08:53	Edit Download recursive recursive
package_discovery.rst	18.35 KB	lrw-r--r--	2022-11-24 06:08:53	Edit Download recursive recursive
pyproject_config.rst	11.44 KB	lrw-r--r--	2022-11-24 06:08:53	Edit Download recursive recursive
quickstart.rst	15.79 KB	lrw-r--r--	2022-11-24 06:08:53	Edit Download recursive recursive

Directory Contents