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

Translation

Source change

English

Macedonian

Needs editing

Skip

	English	Macedonian	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
	This page discusses the file formats that are used to distribute Python packages and the differences between them.
	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?	Бинарна Дистрибуција
	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 added in the repository

English

Macedonian 20 characters edited Current translation Needs editing

2 months ago

None

Source string changed

English 15 characters edited

2 months 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	Macedonian
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

2 months ago

Last updated

2 months ago

Source string age

2 months ago

Translation file

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