pypa/packaging.python.org — Spanish @ Hosted Weblate: What is a source distribution?

Zen

	English	Spanish	Actions
	Whereas ``install_requires`` metadata is automatically analyzed by pip during an install, requirements files are not, and only are used when a user specifically installs them using ``python -m pip install -r``.
	For more on "Abstract" vs "Concrete" requirements, see https://caremad.io/posts/2013/07/setup-vs-requirement/.
	Package Formats	Índice de paquetes
	This page discusses the file formats that are used to distribute Python packages and the differences between them.	Esta página discute los formatos de archivo que son usado para distribuir paquetes de Python y las diferencias entre ellos.
	You will find files in two formats on package indices such as PyPI_: source distributions, or sdists for short, and binary distributions, commonly called wheels. For example, the `PyPI page for pip 23.3.1 <pip-pypi_>`_ lets you download two files, ``pip-23.3.1.tar.gz`` and ``pip-23.3.1-py3-none-any.whl``. The former is an sdist, the latter is a wheel. As explained below, these serve different purposes. When publishing a package on PyPI (or elsewhere), you should always upload both an sdist and one or more wheel.
	What is a source distribution?	Paquete de Distribución
	Conceptually, a source distribution is an archive of the source code in raw form. Concretely, an sdist is a ``.tar.gz`` archive containing the source code plus an additional special file called ``PKG-INFO``, which holds the project metadata. The presence of this file helps packaging tools to be more efficient by not needing to compute the metadata themselves. The ``PKG-INFO`` file follows the format specified in :ref:`core-metadata` and is not intended to be written by hand [#core-metadata-format]_.
	You can thus inspect the contents of an sdist by unpacking it using standard tools to work with tar archives, such as ``tar -xvf`` on UNIX platforms (like Linux and macOS), or :ref:`the command line interface of Python's tarfile module <python:tarfile-commandline>` on any platform.
	Sdists serve several purposes in the packaging ecosystem. When :ref:`pip`, the standard Python package installer, cannot find a wheel to install, it will fall back on downloading a source distribution, compiling a wheel from it, and installing the wheel. Furthermore, sdists are often used as the package source by downstream packagers (such as Linux distributions, Conda, Homebrew and MacPorts on macOS, ...), who, for various reasons, may prefer them over, e.g., pulling from a Git repository.
	A source distribution is recognized by its file name, which has the form :samp:`{package_name}-{version}.tar.gz`, e.g., ``pip-23.3.1.tar.gz``.
	If you want technical details on the sdist format, read the :ref:`sdist specification <source-distribution-format>`.

Loading…

None

String updated in the repository

English

Spanish 0 characters edited Current translation Needs editing

a month ago

None

String added in the repository

English

Spanish 23 characters edited Current translation Needs editing

a month ago

None

Source string changed

English 26 characters edited

a month ago

Browse all string changes

Things to check

Mismatched question mark

Source and translation do not both end with a question mark

Reset

Glossary

English	Spanish
source distribution		pypa
Source Distribution		pypa

String information

Flags

placeholders:BigQuery:easy_install:HTML:HTTP:Linux:pip:PSF:PyPI:Python:setuptools:venv:virtualenv:Windows:":pep:`440`":``pip``:``setuptools``:"::":|PyPUG|, rst-text

Source string location

../source/discussions/package-formats.rst:21

String age

a month ago

Last updated

a month ago

Source string age

a month ago

Translation file

locales/es/LC_MESSAGES/messages.po, string 147