From 4e9072067911ae050c322495fae036bfc109cf1c Mon Sep 17 00:00:00 2001 From: Rafael Fontenelle Date: Mon, 20 May 2024 09:01:55 +0000 Subject: [PATCH 1/4] Translated using Weblate (Slovak) Currently translated at 3.5% (122 of 3462 strings) Translated using Weblate (French) Currently translated at 6.4% (223 of 3462 strings) Translated using Weblate (Portuguese (Brazil)) Currently translated at 77.2% (2674 of 3462 strings) Co-authored-by: Rafael Fontenelle Translate-URL: https://hosted.weblate.org/projects/pypa/packaging-python-org/fr/ Translate-URL: https://hosted.weblate.org/projects/pypa/packaging-python-org/pt_BR/ Translate-URL: https://hosted.weblate.org/projects/pypa/packaging-python-org/sk/ Translation: pypa/packaging.python.org --- locales/fr/LC_MESSAGES/messages.po | 14 +- locales/pt_BR/LC_MESSAGES/messages.po | 733 ++++++++++++++------------ locales/sk/LC_MESSAGES/messages.po | 19 +- 3 files changed, 424 insertions(+), 342 deletions(-) diff --git a/locales/fr/LC_MESSAGES/messages.po b/locales/fr/LC_MESSAGES/messages.po index 7beaf191b..010e6bd5b 100644 --- a/locales/fr/LC_MESSAGES/messages.po +++ b/locales/fr/LC_MESSAGES/messages.po @@ -10,16 +10,16 @@ msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2024-04-18 14:36+0000\n" -"PO-Revision-Date: 2024-01-27 05:01+0000\n" +"PO-Revision-Date: 2024-04-25 06:07+0000\n" "Last-Translator: Rafael Fontenelle \n" -"Language-Team: French \n" +"Language-Team: French \n" "Language: fr\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Plural-Forms: nplurals=2; plural=n > 1;\n" -"X-Generator: Weblate 5.4-dev\n" +"X-Generator: Weblate 5.5.1-dev\n" #: ../source/contribute.rst:5 msgid "Contribute to this guide" @@ -2721,9 +2721,9 @@ msgid "" "Python community. It is open to all Python developers to consume and " "distribute their distributions." msgstr "" -"`PyPI `_ est l':term:`Index de Paquets` par défaut pour la " -"communauté Python. Il est ouvert à tous les développeurs Python pour qu'ils " -"utilisent et distribuent leurs paquets." +"`PyPI `_ est l':term:`Index de Paquets ` " +"par défaut pour la communauté Python. Il est ouvert à tous les développeurs " +"Python pour qu'ils utilisent et distribuent leurs paquets." #: ../source/glossary.rst:175 msgid "pypi.org" diff --git a/locales/pt_BR/LC_MESSAGES/messages.po b/locales/pt_BR/LC_MESSAGES/messages.po index 4470bf024..33c3454f4 100644 --- a/locales/pt_BR/LC_MESSAGES/messages.po +++ b/locales/pt_BR/LC_MESSAGES/messages.po @@ -11,7 +11,7 @@ msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2024-04-18 14:36+0000\n" -"PO-Revision-Date: 2024-03-01 20:00+0000\n" +"PO-Revision-Date: 2024-04-25 06:07+0000\n" "Last-Translator: Rafael Fontenelle \n" "Language-Team: Portuguese (Brazil) \n" @@ -20,7 +20,7 @@ msgstr "" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Plural-Forms: nplurals=2; plural=n > 1;\n" -"X-Generator: Weblate 5.5-dev\n" +"X-Generator: Weblate 5.5.1-dev\n" #: ../source/contribute.rst:5 msgid "Contribute to this guide" @@ -1154,16 +1154,16 @@ msgstr "" "requirement/." #: ../source/discussions/package-formats.rst:5 -#, fuzzy -#| msgid "Package Index" msgid "Package Formats" -msgstr "Índice de Pacotes" +msgstr "Formatos de Pacotes" #: ../source/discussions/package-formats.rst:7 msgid "" "This page discusses the file formats that are used to distribute Python " "packages and the differences between them." msgstr "" +"Esta página discute os formatos de arquivo usados para distribuir pacotes " +"Python e as diferenças entre eles." #: ../source/discussions/package-formats.rst:10 msgid "" @@ -1176,12 +1176,18 @@ msgid "" "publishing a package on PyPI (or elsewhere), you should always upload both " "an sdist and one or more wheel." msgstr "" +"Você encontrará arquivos em dois formatos em índices de pacotes como PyPI_: " +"**distribuições fonte**, ou a abreviação **sdists**, e **distribuições " +"binárias**, comumente chamadas de **wheels**. Por exemplo, a `página PyPI " +"para pip 23.3.1 `_ permite baixar dois arquivos, ``pip-23.3.1.tar." +"gz`` e ``pip-23.3.1-py3-none-any.whl``. O primeiro é um sdist, o último é " +"uma wheel. Conforme explicado abaixo, eles têm finalidades diferentes. Ao " +"publicar um pacote no PyPI (ou em outro lugar), você deve sempre enviar um " +"sdist e um ou mais wheel." #: ../source/discussions/package-formats.rst:21 -#, fuzzy -#| msgid "Python source distributions" msgid "What is a source distribution?" -msgstr "Distribuições fonte Python" +msgstr "O que é uma distribuição fonte?" #: ../source/discussions/package-formats.rst:23 msgid "" @@ -1193,6 +1199,14 @@ msgid "" "INFO`` file follows the format specified in :ref:`core-metadata` and is not " "intended to be written by hand [#core-metadata-format]_." msgstr "" +"Conceitualmente, uma distribuição fonte é um arquivo do código-fonte em " +"formato bruto. Concretamente, um sdist é um arquivo ``.tar.gz`` contendo o " +"código-fonte mais um arquivo especial adicional chamado ``PKG-INFO``, que " +"contém os metadados do projeto. A presença desse arquivo ajuda as " +"ferramentas de empacotamento a serem mais eficientes, pois não precisam " +"calcular os próprios metadados. O arquivo ``PKG-INFO`` segue o formato " +"especificado em :ref:`core-metadata` e não se destina a ser escrito à mão " +"[#core-metadata-format]_." #: ../source/discussions/package-formats.rst:31 msgid "" @@ -1201,6 +1215,11 @@ msgid "" "(like Linux and macOS), or :ref:`the command line interface of Python's " "tarfile module ` on any platform." msgstr "" +"Você pode, portanto, operar o conteúdo de um sdist descompactando-o usando " +"ferramentas padrão para trabalhar com arquivos tar, como ``tar -xvf`` em " +"plataformas UNIX (como Linux e macOS), ou :ref:`a interface de linha de " +"comando do módulo tarfile do Python ` em " +"qualquer plataforma." #: ../source/discussions/package-formats.rst:36 msgid "" @@ -1212,28 +1231,43 @@ msgid "" "Homebrew and MacPorts on macOS, ...), who, for various reasons, may prefer " "them over, e.g., pulling from a Git repository." msgstr "" +"Os sdists servem a vários propósitos no ecossistema de embalagens. Quando " +":ref:`pip`, o instalador padrão do pacote Python, não consegue encontrar um " +"wheel para instalar, ele recorrerá ao download de uma distribuição fonte, " +"compilando um wheel a partir dela e instalando o wheel. Além disso, os " +"sdists são frequentemente usados como fonte de pacote por empacotadores " +"downstream (como distribuições Linux, Conda, Homebrew e MacPorts no macOS, " +"...), que, por vários motivos, podem preferi-los, por exemplo, extraindo de " +"um repositório Git." #: ../source/discussions/package-formats.rst:44 msgid "" "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``." msgstr "" +"Uma distribuição fonte é reconhecida pelo seu nome de arquivo, que tem o " +"formato :samp:`{nome_do_pacote}-{versão}.tar.gz`, por exemplo, ``pip-23.3.1." +"tar.gz``." #: ../source/discussions/package-formats.rst:50 msgid "" "If you want technical details on the sdist format, read the :ref:`sdist " "specification `." msgstr "" +"Se você quiser detalhes técnicos sobre o formato sdist, leia a :ref:`" +"especificação de sdist `." #: ../source/discussions/package-formats.rst:55 msgid "What is a wheel?" -msgstr "" +msgstr "O que é um wheel?" #: ../source/discussions/package-formats.rst:57 msgid "" "Conceptually, a wheel contains exactly the files that need to be copied when " "installing the package." msgstr "" +"Conceitualmente, um wheel contém exatamente os arquivos que precisam ser " +"copiados durante a instalação do pacote." #: ../source/discussions/package-formats.rst:60 msgid "" @@ -1244,6 +1278,12 @@ msgid "" "files) but compiled, executable code (like ``.so`` files on Linux or DLLs on " "Windows)." msgstr "" +"Há uma grande diferença entre sdists e wheels para pacotes com :term:`" +"módulos de extensão `, escritos em linguagens compiladas " +"como C, C++ e Rust, que precisam ser compilados em código de máquina " +"dependente de plataforma. Com esses pacotes, as rodas não contêm código " +"fonte (como arquivos fonte C), mas código executável compilado (como " +"arquivos ``.so`` no Linux ou DLLs no Windows)." #: ../source/discussions/package-formats.rst:66 msgid "" @@ -1254,6 +1294,12 @@ msgid "" "Python interpreter (unless the :ref:`Python stable ABI ` " "is used)." msgstr "" +"Além disso, embora exista apenas um sdist por versão de um projeto, pode " +"haver muitos wheels. Novamente, isto é mais relevante no contexto dos " +"módulos de extensão. O código compilado de um módulo de extensão está " +"vinculado a um sistema operacional e arquitetura de processador, e muitas " +"vezes também à versão do interpretador Python (a menos que a :ref:`ABI " +"estável do Python ` seja usada)." #: ../source/discussions/package-formats.rst:72 msgid "" @@ -1262,6 +1308,11 @@ msgid "" "versions. Python is an interpreted language, which does not need ahead-of-" "time compilation, so wheels contain ``.py`` files just like sdists." msgstr "" +"Para pacotes Python puro, a diferença entre sdists e wheels é menos " +"acentuada. Normalmente existe um único wheel, para todas as plataformas e " +"versões do Python. Python é uma linguagem interpretada, que não precisa de " +"compilação antecipada, então wheels contêm arquivos ``.py`` assim como " +"sdists." #: ../source/discussions/package-formats.rst:77 msgid "" @@ -1271,6 +1322,11 @@ msgid "" "Python version instead of one single wheel. Instead, installers like :ref:" "`pip` generate them while installing the package." msgstr "" +"Se você está se perguntando sobre os arquivos de bytecode ``.pyc``: eles não " +"estão incluídos nos wheels, pois são pouco custoso para gerar, e incluí-los " +"forçaria desnecessariamente um grande número de pacotes a distribuir um " +"wheel por versão do Python em vez de um único wheel. Em vez disso, " +"instaladores como :ref:`pip` os geram durante a instalação do pacote." #: ../source/discussions/package-formats.rst:83 msgid "" @@ -1283,6 +1339,13 @@ msgid "" "along with a hash of their content, as a safety check of the download's " "integrity." msgstr "" +"Dito isto, ainda existem diferenças importantes entre sdists e wheels, mesmo " +"para projetos Python puros. Os wheels devem conter exatamente o que será " +"instalado e nada mais. Em particular, os wheels nunca devem incluir testes e " +"documentação, ao contrário dos sdists. Além disso, o formato do wheel é mais " +"complexo que o sdist. Por exemplo, inclui um arquivo especial -- chamado " +"``RECORD`` -- que lista todos os arquivos no wheel junto com um hash de seu " +"conteúdo, como uma verificação de segurança da integridade do download." #: ../source/discussions/package-formats.rst:91 msgid "" @@ -1297,6 +1360,18 @@ msgid "" "for your users, since a wheel is directly installable. By only including " "files that must be installed, wheels also make for smaller downloads." msgstr "" +"À primeira vista, você pode se perguntar se wheels são realmente necessários " +"para projetos \"simples e básicos\" de Python puro. Tenha em mente que " +"devido à flexibilidade dos sdists, instaladores como o pip não podem " +"instalar diretamente a partir dos sdists -- eles precisam primeiro construir " +"um wheel, invocando o :term:`backend de construção` que o sdist especifica (" +"o backend de construção pode fazer todo tipo de transformações durante a " +"construção do wheel, como compilar extensões C). Por esse motivo, mesmo para " +"um projeto Python puro, você deve sempre enviar *ambos* sdist e wheel para o " +"PyPI ou outros índices de pacotes. Isso torna a instalação muito mais rápida " +"para seus usuários, já que um wheel pode ser instalado diretamente. Ao " +"incluir apenas os arquivos que devem ser instalados, os wheels também " +"permitem downloads menores." #: ../source/discussions/package-formats.rst:102 msgid "" @@ -1307,6 +1382,13 @@ msgid "" "interface of Python's zipfile module `. This can " "be very useful to check that the wheel includes all the files you need it to." msgstr "" +"No nível técnico, um wheel é um arquivo ZIP (ao contrário dos sdists que são " +"arquivos TAR). Você pode inspecionar seu conteúdo descompactando-o como um " +"arquivo ZIP normal, por exemplo, usando ``unzip`` em plataformas UNIX como " +"Linux e macOS, ``Expand-Archive`` no PowerShell no Windows, ou :ref:`a linha " +"de comando interface do módulo zipfile do Python `. Isso pode ser muito útil para verificar se o wheel inclui " +"todos os arquivos necessários." #: ../source/discussions/package-formats.rst:109 msgid "" @@ -1316,6 +1398,11 @@ msgid "" "equivalent of ``PKG-INFO`` in sdists, as well as ``RECORD``. This can be " "useful to ensure no files are missing from your wheels." msgstr "" +"Dentro de um wheel, você encontrará os arquivos do pacote, além de um " +"diretório adicional chamado :samp:`{nome_do_pacote}-{versão}.dist-info`. " +"Este diretório contém vários arquivos, incluindo um arquivo ``METADATA`` que " +"é equivalente a ``PKG-INFO`` em sdists, bem como ``RECORD``. Isso pode ser " +"útil para garantir que nenhum arquivo esteja faltando em suas rodas." #: ../source/discussions/package-formats.rst:115 msgid "" @@ -1325,6 +1412,12 @@ msgid "" "the wheel is compatible with. For example, the name ``pip-23.3.1-py3-none-" "any.whl`` means that:" msgstr "" +"O nome do arquivo de um wheel (ignorando alguns recursos raramente usados) é " +"assim: " +":samp:`{nome_do_pacote}-{versão}-{tag_python}-{tag_abi}-{tag_plataforma}.whl`" +". Esta convenção de nomenclatura identifica com quais plataformas e versões " +"do Python a roda é compatível. Por exemplo, o nome ``pip-23.3.1-py3-none-any." +"whl`` significa que:" #: ../source/discussions/package-formats.rst:121 msgid "" @@ -1332,32 +1425,37 @@ msgid "" "whether CPython, the most widely used Python implementation, or an " "alternative implementation like PyPy_;" msgstr "" +"(``py3``) Este wheel pode ser instalado em qualquer implementação do Python " +"3, seja CPython, a implementação Python mais usada, ou uma implementação " +"alternativa como PyPy_;" #: ../source/discussions/package-formats.rst:124 msgid "(``none``) It does not depend on the Python version;" -msgstr "" +msgstr "(``none``) Não depende da versão do Python;" #: ../source/discussions/package-formats.rst:125 msgid "(``any``) It does not depend on the platform." -msgstr "" +msgstr "(``qualquer``) Não depende da plataforma." #: ../source/discussions/package-formats.rst:127 msgid "" "The pattern ``py3-none-any`` is common for pure Python projects. Packages " "with extension modules typically ship multiple wheels with more complex tags." msgstr "" +"O padrão ``py3-none-any`` é comum para projetos Python puros. Pacotes com " +"módulos de extensão normalmente enviam vários wheels com tags mais complexas." #: ../source/discussions/package-formats.rst:130 msgid "" "All technical details on the wheel format can be found in the :ref:`wheel " "specification `." msgstr "" +"Todos os detalhes técnicos sobre o formato do wheel podem ser encontrados na " +":ref:`especificação de wheels `." #: ../source/discussions/package-formats.rst:138 -#, fuzzy -#| msgid "What about..." msgid "What about eggs?" -msgstr "E quanto a..." +msgstr "E quanto a eggs?" #: ../source/discussions/package-formats.rst:140 msgid "" @@ -1365,67 +1463,43 @@ msgid "" "format. It should not be used anymore. Since August 2023, PyPI `rejects egg " "uploads `_." msgstr "" +"\"Egg\" é um formato de pacote antigo que foi substituído pelo formato de " +"wheels. Não deve mais ser usado. Desde agosto de 2023, o PyPI `rejeita " +"envios de eggs `_." #: ../source/discussions/package-formats.rst:144 -#, fuzzy -#| msgid "" -#| "Here's a breakdown of the important differences between :term:`Wheel` " -#| "and :term:`Egg`." msgid "Here's a breakdown of the important differences between wheel and egg." -msgstr "" -"Aqui está uma análise das diferenças importantes entre :term:`Wheel` e :term:" -"`Egg`." +msgstr "Aqui está uma análise das diferenças importantes entre wheel e egg." #: ../source/discussions/package-formats.rst:146 -#, fuzzy -#| msgid "" -#| "The :term:`Egg` format was introduced by :ref:`setuptools` in 2004, " -#| "whereas the :term:`Wheel` format was introduced by :pep:`427` in 2012." msgid "" "The egg format was introduced by :ref:`setuptools` in 2004, whereas the " "wheel format was introduced by :pep:`427` in 2012." msgstr "" -"O formato :term:`Egg` foi introduzido por :ref:`setuptools` em 2004, " -"enquanto o formato :term:`Wheel` foi introduzido pela :pep:`427` em 2012." +"O formato egg foi introduzido pelo :ref:`setuptools` em 2004, enquanto o " +"formato wheel foi introduzido pela :pep:`427` em 2012." #: ../source/discussions/package-formats.rst:149 -#, fuzzy -#| msgid "" -#| ":term:`Wheel` has an :doc:`official standard specification `. :term:`Egg` did not." msgid "" "Wheel has an :doc:`official standard specification `. Egg did not." msgstr "" -":term:`Wheel` tem uma :doc:`especificação de padrão oficial `. :term:`Egg` não tinha." +"Wheel tem uma :doc:`especificação de padrão oficial `. Egg não tinha." #: ../source/discussions/package-formats.rst:152 -#, fuzzy -#| msgid "" -#| ":term:`Wheel` is a :term:`distribution ` format, i." -#| "e a packaging format. [1]_ :term:`Egg` was both a distribution format and " -#| "a runtime installation format (if left zipped), and was designed to be " -#| "importable." msgid "" "Wheel is a :term:`distribution ` format, i.e a " "packaging format. [#wheel-importable]_ Egg was both a distribution format " "and a runtime installation format (if left zipped), and was designed to be " "importable." msgstr "" -":term:`Wheel` é um formato de :term:`distribuição `, " -"ou seja, um formato de empacotamento. [1]_ :term:`Egg` era um formato de " +"Wheel é um formato de :term:`distribuição `, ou seja, " +"um formato de empacotamento. [#wheel-importable]_ Egg era um formato de " "distribuição e um formato de instalação em tempo de execução (se deixado " "compactado), e foi projetado para ser importável." #: ../source/discussions/package-formats.rst:156 -#, fuzzy -#| msgid "" -#| ":term:`Wheel` archives do not include .pyc files. Therefore, when the " -#| "distribution only contains Python files (i.e. no compiled extensions), " -#| "and is compatible with Python 2 and 3, it's possible for a wheel to be " -#| "\"universal\", similar to an :term:`sdist `." msgid "" "Wheel archives do not include ``.pyc`` files. Therefore, when the " "distribution only contains Python files (i.e. no compiled extensions), and " @@ -1433,66 +1507,48 @@ msgid "" "\"universal\", similar to an :term:`sdist `." msgstr "" -"Os arquivos :term:`Wheel` não incluem arquivos .pyc. Portanto, quando a " +"Os arquivos wheel não incluem arquivos ``.pyc``. Portanto, quando a " "distribuição contém apenas arquivos Python (ou seja, sem extensões " "compiladas) e é compatível com Python 2 e 3, é possível que um wheel seja " -"\"universal\", semelhante a um :term:`sdist `." +"\"universal\", semelhante a um :term:`sdist `." #: ../source/discussions/package-formats.rst:161 -#, fuzzy -#| msgid "" -#| ":term:`Wheel` uses :pep:`PEP376-compliant <376>` ``.dist-info`` " -#| "directories. Egg used ``.egg-info``." msgid "" "Wheel uses standard :ref:`.dist-info directories `. Egg used ``.egg-info``." msgstr "" -":term:`Wheel` usa diretórios ``.dist-info`` :pep:`compatíveis com a PEP376 " -"<376>`. Egg usava ``.egg-info``." +"Wheel usa :ref:`diretórios .dist-info ` " +"padrões. Egg usava ``.egg-info``." #: ../source/discussions/package-formats.rst:164 -#, fuzzy -#| msgid "" -#| ":term:`Wheel` has a :pep:`richer file naming convention <425>`. A single " -#| "wheel archive can indicate its compatibility with a number of Python " -#| "language versions and implementations, ABIs, and system architectures." msgid "" "Wheel has a :ref:`richer file naming convention `. A " "single wheel archive can indicate its compatibility with a number of Python " "language versions and implementations, ABIs, and system architectures." msgstr "" -":term:`Wheel` tem uma :pep:`convenção de nomenclatura de arquivo mais rica " -"<425>`. Um único arquivo de wheel pode indicar sua compatibilidade com " -"várias versões e implementações da linguagem Python, ABIs e arquiteturas de " -"sistema." +"Wheel tem uma :ref:`convenção de nomenclatura de arquivo mais rica `. Um único arquivo de wheel pode indicar sua compatibilidade " +"com várias versões e implementações da linguagem Python, ABIs e arquiteturas " +"de sistema." #: ../source/discussions/package-formats.rst:168 -#, fuzzy -#| msgid "" -#| ":term:`Wheel` is versioned. Every wheel file contains the version of the " -#| "wheel specification and the implementation that packaged it." msgid "" "Wheel is versioned. Every wheel file contains the version of the wheel " "specification and the implementation that packaged it." msgstr "" -":term:`Wheel` é versionado. Cada arquivo wheel contém a versão da " -"especificação wheel e a implementação que a empacotou." +"Wheel é versionado. Cada arquivo wheel contém a versão da especificação " +"wheel e a implementação que a empacotou." #: ../source/discussions/package-formats.rst:171 -#, fuzzy -#| msgid "" -#| ":term:`Wheel` is internally organized by `sysconfig path type `_, therefore " -#| "making it easier to convert to other formats." msgid "" "Wheel is internally organized by `sysconfig path type `_, therefore making it " "easier to convert to other formats." msgstr "" -":term:`Wheel` é internamente organizado pelo `tipo de caminho sysconfig " -"`_, " -"portanto tornando mais fácil converter para outros formatos." +"Wheel é internamente organizado pelo `tipo de caminho sysconfig `_, portanto " +"tornando mais fácil converter para outros formatos." #: ../source/discussions/package-formats.rst:177 msgid "" @@ -1503,6 +1559,13 @@ msgid "" "backend, typically ``[project]`` in ``pyproject.toml``, and translated by " "the build backend into ``PKG-INFO``." msgstr "" +"Este formato é baseado em e-mail. Embora seja improvável que isso seja " +"escolhido hoje, considerações de compatibilidade com versões anteriores " +"levam a que ele seja mantido como formato canônico. Do ponto de vista do " +"usuário, isso é praticamente invisível, já que os metadados são " +"especificados pelo usuário de uma forma compreendida pelo backend de " +"construção, normalmente ``[project]`` em ``pyproject.toml``, e traduzidos " +"pelo backend de construção em ``PKG-INFO``." #: ../source/discussions/package-formats.rst:184 msgid "" @@ -2245,34 +2308,19 @@ msgstr "" #: ../source/discussions/versioning.rst:6 #: ../source/specifications/simple-repository-api.rst:310 -#, fuzzy -#| msgid "Version" msgid "Versioning" -msgstr "Versão" +msgstr "Versionamento" #: ../source/discussions/versioning.rst:8 -#, fuzzy -#| msgid "" -#| "This section describes the steps to follow before installing other Python " -#| "packages." msgid "This discussion covers all aspects of versioning Python packages." msgstr "" -"Esta seção descreve as etapas a serem seguidas antes de instalar outros " -"pacotes Python." +"Esta discussão cobre todos os aspectos do versionamento de pacotes Python." #: ../source/discussions/versioning.rst:12 -#, fuzzy msgid "Valid version numbers" -msgstr "Versionamento baseado em data" +msgstr "Números de versão validos" #: ../source/discussions/versioning.rst:14 -#, fuzzy -#| msgid "" -#| "Different Python projects may use different versioning schemes based on " -#| "the needs of that particular project, but all of them are required to " -#| "comply with the flexible :pep:`public version scheme <440#public-version-" -#| "identifiers>` specified in :pep:`440` in order to be supported in tools " -#| "and libraries like ``pip`` and ``setuptools``." msgid "" "Different Python projects may use different versioning schemes based on the " "needs of that particular project, but in order to be compatible with tools " @@ -2281,57 +2329,57 @@ msgid "" "`specification of version specifiers `. Here are some " "examples of version numbers [#version-examples]_:" msgstr "" -"Diferentes projetos Python podem usar diferentes esquemas de controle de " -"versão com base nas necessidades daquele projeto específico, mas todos eles " -"são obrigados a cumprir com o :pep:`esquema públicode versão <440#public-" -"version-identifiers>` flexível especificado na :pep:`440` para serem " -"suportados em ferramentas e bibliotecas como ``pip`` e ``setuptools``." +"Diferentes projetos Python podem usar diferentes esquemas de versionamento " +"com base nas necessidades daquele projeto específico, mas para serem " +"compatíveis com ferramentas como :ref:`pip`, todos eles são obrigados a " +"cumprir um formato flexível para identificadores de versão, para o qual a " +"referência oficial é a :ref:`especificação dos especificadores de versão " +"`. Aqui estão alguns exemplos de números de versão " +"[#version-examples]_:" #: ../source/discussions/versioning.rst:21 msgid "A simple version (final release): ``1.2.0``" -msgstr "" +msgstr "Uma versão simples (versão final): ``1.2.0``" #: ../source/discussions/versioning.rst:22 -#, fuzzy -#| msgid "Development release segment: ``.devN``" msgid "A development release: ``1.2.0.dev1``" -msgstr "Segmento de versão de desenvolvimento: ``.devN``" +msgstr "Uma versão de desenvolvimento: ``1.2.0.dev1``" #: ../source/discussions/versioning.rst:23 msgid "An alpha release: ``1.2.0a1``" -msgstr "" +msgstr "Uma versão alfa: ``1.2.0a1``" #: ../source/discussions/versioning.rst:24 msgid "A beta release: ``1.2.0b1``" -msgstr "" +msgstr "Uma versão beta: ``1.2.0b1``" #: ../source/discussions/versioning.rst:25 msgid "A release candidate: ``1.2.0rc1``" -msgstr "" +msgstr "Um candidato a lançamento: ``1.2.0rc1``" #: ../source/discussions/versioning.rst:26 -#, fuzzy -#| msgid "Post-release segment: ``.postN``" msgid "A post-release: ``1.2.0.post1``" -msgstr "Segmento de pós lançamento: ``.postN``" +msgstr "Um pós-lançamento: ``1.2.0.post1``" #: ../source/discussions/versioning.rst:27 msgid "" "A post-release of an alpha release (possible, but discouraged): ``1.2.0a1." "post1``" msgstr "" +"Um pós-lançamento de uma versão alfa (possível, mas desencorajado): ``1.2.0a1" +".post1``" #: ../source/discussions/versioning.rst:28 msgid "A simple version with only two components: ``23.12``" -msgstr "" +msgstr "Uma versão simples com apenas dois componentes: ``23.12``" #: ../source/discussions/versioning.rst:29 msgid "A simple version with just one component: ``42``" -msgstr "" +msgstr "Uma versão simples com apenas um componente: ``42``" #: ../source/discussions/versioning.rst:30 msgid "A version with an epoch: ``1!1.0``" -msgstr "" +msgstr "Uma versão com uma época: ``1!1.0``" #: ../source/discussions/versioning.rst:32 msgid "" @@ -2342,6 +2390,13 @@ msgid "" "versions of dependencies to install, unless explicitly requested (e.g., with " "``pip install pkg==1.1a3`` or ``pip install --pre pkg``)." msgstr "" +"Os projetos podem usar um ciclo de pré-lançamentos para dar suporte aos " +"testes de seus usuários antes do lançamento final. Em ordem, as etapas são: " +"versões alfa, versões beta, candidatos a lançamento, versão final. Pip e " +"outros instaladores modernos de pacotes Python ignoram pré-lançamentos por " +"padrão ao decidir quais versões de dependências instalar, a menos que " +"solicitado explicitamente (por exemplo, com ```pip install pkg==1.1a3`` ou ``" +"pip install --pre pkg``)." #: ../source/discussions/versioning.rst:39 msgid "" @@ -2349,6 +2404,10 @@ msgid "" "a development cycle, for example, a nightly build, or a build from the " "latest source in a Linux distribution." msgstr "" +"O objetivo dos lançamentos de desenvolvimento é oferecer suporte aos " +"lançamentos feitos no início de um ciclo de desenvolvimento, por exemplo, " +"uma construção noturna ou uma construção a partir do código-fonte mais " +"recente em uma distribuição Linux." #: ../source/discussions/versioning.rst:43 msgid "" @@ -2358,6 +2417,11 @@ msgid "" "with a new final release (e.g., incrementing the third component when using " "semantic versioning)." msgstr "" +"Os pós-lançamentos são usados para corrigir pequenos erros em uma versão " +"final que não afetam o software distribuído, como corrigir um erro nas notas " +"de versão. Eles não devem ser usados para correção de bugs; isso deve ser " +"feito com uma nova versão final (por exemplo, incrementando o terceiro " +"componente ao usar o versionamento semântico)." #: ../source/discussions/versioning.rst:49 msgid "" @@ -2369,12 +2433,17 @@ msgid "" "epoch, as in \"1!1.0\", in order to be treated as more recent than the old " "version numbers." msgstr "" +"Por fim, as épocas, um recurso raramente usado, servem para corrigir a ordem " +"de classificação ao alterar o esquema de versionamento. Por exemplo, se um " +"projeto estiver usando versionamento de calendário, com versões como 23.12, " +"e mudar para versionamento semântico, com versões como 1.0, a comparação " +"entre 1.0 e 23.12 irá para o lado errado. Para corrigir isso, os novos " +"números de versão devem ter uma época explícita, como em \"1!1.0\", para " +"serem tratados como mais recentes que os números de versão antigos." #: ../source/discussions/versioning.rst:59 -#, fuzzy -#| msgid "Semantic versioning (preferred)" msgid "Semantic versioning vs. calendar versioning" -msgstr "Versionamento semântico (preferencial)" +msgstr "Versionamento semântico vs. versionamento de calendário" #: ../source/discussions/versioning.rst:61 msgid "" @@ -2383,6 +2452,11 @@ msgid "" "new release of a package. Two versioning schemes are commonly used for " "Python packages, semantic versioning and calendar versioning." msgstr "" +"Um esquema de versionamento é uma forma formalizada de interpretar os " +"segmentos de um número de versão e de decidir qual deve ser o próximo número " +"de versão para um novo lançamento de um pacote. Dois esquemas de " +"versionamento são comumente usados para pacotes Python, versionamento " +"semântico e versionamento de calendário." #: ../source/discussions/versioning.rst:68 msgid "" @@ -2391,6 +2465,10 @@ msgid "" "That view may differ from the end-users' perception of what said formalized " "versioning scheme promises them." msgstr "" +"A decisão de qual número de versão escolher cabe ao mantenedor do projeto. " +"Isso efetivamente significa que os incrementos de versão refletem a visão do " +"mantenedor. Essa visão pode diferir da percepção dos usuários finais sobre o " +"que o referido esquema de versionamento formalizado lhes promete." #: ../source/discussions/versioning.rst:74 msgid "" @@ -2400,49 +2478,42 @@ msgid "" "when security vulnerability needs to be addressed. Security releases often " "come in patch versions but contain breaking changes inevitably." msgstr "" +"Existem exceções conhecidas para selecionar o próximo número de versão. Os " +"mantenedores podem escolher conscientemente quebrar a suposição de que o " +"segmento da última versão contém apenas alterações compatíveis com versões " +"anteriores. Um desses casos é quando a vulnerabilidade de segurança precisa " +"ser abordada. As versões de segurança geralmente vêm em versões de patch, " +"mas inevitavelmente contêm alterações importantes." #: ../source/discussions/versioning.rst:84 #: ../source/specifications/version-specifiers.rst:721 -#, fuzzy msgid "Semantic versioning" -msgstr "Versionamento serial" +msgstr "Versionamento semântico" #: ../source/discussions/versioning.rst:86 -#, fuzzy -#| msgid "" -#| "The essence of semantic versioning is a 3-part MAJOR.MINOR.MAINTENANCE " -#| "numbering scheme, where the project author increments:" msgid "" "The idea of *semantic versioning* (or SemVer) is to use 3-part version " "numbers, *major.minor.patch*, where the project author increments:" msgstr "" -"A essência do versionamento semântico é um esquema de numeração MAIOR.MENOR." -"MANUTENÇÃO de 3 partes, onde o autor do projeto incrementa:" +"A ideia do *versionamento semântico* (ou SemVer) é usar números de versão de " +"3 partes, *principal.menor.correção*, onde o autor do projeto incrementa:" #: ../source/discussions/versioning.rst:89 -#, fuzzy -#| msgid "MAJOR version when they make incompatible API changes," msgid "*major* when they make incompatible API changes," -msgstr "Versão PRINCIPAL quando eles fazem alterações de API incompatíveis," +msgstr "*principal* quando são feitas alterações incompatíveis à API," #: ../source/discussions/versioning.rst:90 -#, fuzzy -#| msgid "" -#| "MINOR version when they add functionality in a backwards-compatible " -#| "manner, and" msgid "" "*minor* when they add functionality in a backwards-compatible manner, and" msgstr "" -"Versão MENOR quando adicionam funcionalidade de maneira compatível com " -"versões anteriores, e" +"*menor* quando é adicionada funcionalidade de maneira compatível com versões " +"anteriores, e" #: ../source/discussions/versioning.rst:91 -#, fuzzy -#| msgid "MAINTENANCE version when they make backwards-compatible bug fixes." msgid "*patch*, when they make backwards-compatible bug fixes." msgstr "" -"Versão MANUTENÇÃO quando eles fazem correções de bugs compatíveis com " -"versões anteriores." +"*correção*, quando são feitas correções de bugs compatíveis com versões " +"anteriores." #: ../source/discussions/versioning.rst:93 msgid "" @@ -2455,6 +2526,16 @@ msgid "" "strictness]_. Conversely, a bump of the major version number is sometimes " "used to signal significant but backwards-compatible new features." msgstr "" +"A maioria dos projetos Python usa um esquema que se assemelha ao " +"versionamento semântico. No entanto, a maioria dos projetos, especialmente " +"os maiores, não aderem estritamente ao versionamento semântico, uma vez que " +"muitas alterações são tecnicamente prejudiciais, mas afetam apenas uma " +"pequena fração dos usuários. Tais projetos tendem a aumentar o número maior " +"quando a incompatibilidade é alta, ou para sinalizar uma mudança no projeto, " +"ao invés de qualquer pequena incompatibilidade [#semver-strictness]_. Por " +"outro lado, um aumento no número da versão principal às vezes é usado para " +"sinalizar novos recursos significativos, mas compatíveis com versões " +"anteriores." #: ../source/discussions/versioning.rst:103 msgid "" @@ -2467,18 +2548,23 @@ msgid "" "equivalent to ``name >= X.Y.Z, == X.Y.*``, i.e., it requires at least X.Y.Z " "and allows a later release with same X and Y but higher Z." msgstr "" +"Para aqueles projetos que usam controle de versão semântico estrito, esta " +"abordagem permite que os usuários façam uso de :ref:`especificadores de " +"versão de lançamento compatíveis `, " +"com o operador ``~=``. Por exemplo, ``name ~= X.Y`` é aproximadamente " +"equivalente a ``name >= X.Y, == X.*``, ou seja, requer pelo menos a versão " +"X.Y, e permite qualquer versão posterior com Y maior, desde que X é o mesmo. " +"Da mesma forma, ``name ~= X.Y.Z`` é aproximadamente equivalente a ``name >= " +"X.Y.Z, == X.Y.*``, ou seja, requer pelo menos X.Y.Z e permite uma versão " +"posterior com o mesmo X e Y, mas Z superior." #: ../source/discussions/versioning.rst:112 -#, fuzzy -#| msgid "" -#| "Python projects adopting semantic versioning should abide by clauses 1-8 " -#| "of the `Semantic Versioning 2.0.0 specification `_." msgid "" "Python projects adopting semantic versioning should abide by clauses 1-8 of " "the `Semantic Versioning 2.0.0 specification `_." msgstr "" -"Projetos Python que adotam versões semânticas devem obedecer às cláusulas " -"1-8 da `especificação de Versionamento Semântico 2.0.0 `_." +"Projetos Python que adotam versões semânticas devem obedecer às cláusulas 1-" +"8 da `especificação de Versionamento Semântico 2.0.0 `_." #: ../source/discussions/versioning.rst:115 msgid "" @@ -2490,12 +2576,18 @@ msgid "" "contain backwards-incompatible API changes (:doc:`NumPy versioning policy " "`)." msgstr "" +"O popular gerador de documentação :doc:`Sphinx ` é um exemplo " +"de projeto que usa controle de versionamento semântico estrito (:doc:`" +"Política de versionamento do Sphinx `). O " +"famoso pacote de computação científica :doc:`NumPy ` usa " +"explicitamente versionamento semântico \"folgado\", onde lançamentos " +"incrementando a versão menor podem conter alterações de API incompatíveis " +"com versões anteriores (:doc:`Política de versionamento do NumPy `)." #: ../source/discussions/versioning.rst:124 -#, fuzzy -#| msgid "Serial versioning" msgid "Calendar versioning" -msgstr "Versionamento serial" +msgstr "Versionamento de calendário" #: ../source/discussions/versioning.rst:126 msgid "" @@ -2505,48 +2597,41 @@ msgid "" msgstr "" "O versionamento semântico não é uma escolha adequada para todos os projetos, " "como aqueles com uma cadência de lançamento baseada em tempo regular e um " -"processo de descontinuidade que fornece avisos para vários lançamentos antes " +"processo de descontinuação que fornece avisos para vários lançamentos antes " "da remoção de um recurso." #: ../source/discussions/versioning.rst:130 -#, fuzzy -#| msgid "" -#| "A key advantage of date based versioning is that it is straightforward to " -#| "tell how old the base feature set of a particular release is given just " -#| "the version number." msgid "" "A key advantage of date-based versioning, or `calendar versioning " "`_ (CalVer), is that it is straightforward to tell how old the base " "feature set of a particular release is given just the version number." msgstr "" -"Uma vantagem principal do versionamento baseado em data é que é simples " -"dizer quantos anos o conjunto de recursos básicos de uma determinada versão " -"recebe apenas o número da versão." +"Uma vantagem principal do versionamento baseado em data, ou `versionamento " +"de calendário `_ (CalVer), é que é simples dizer quantos anos o " +"conjunto de recursos básicos de uma determinada versão recebe apenas o " +"número da versão." #: ../source/discussions/versioning.rst:134 msgid "" "Calendar version numbers typically take the form *year.month* (for example, " "23.12 for December 2023)." msgstr "" +"Os números de versão do calendário normalmente assumem o formato *ano.mês* (" +"por exemplo, 23.12 para dezembro de 2023)." #: ../source/discussions/versioning.rst:137 msgid "" ":doc:`Pip `, the standard Python package installer, uses calendar " "versioning." msgstr "" +":doc:`Pip `, o instalador padrão do pacote Python, usa " +"versionamento de calendário." #: ../source/discussions/versioning.rst:142 -#, fuzzy -#| msgid "Other Sources" msgid "Other schemes" -msgstr "Outras fontes" +msgstr "Outros esquemas" #: ../source/discussions/versioning.rst:144 -#, fuzzy -#| msgid "" -#| "While serial versioning is very easy to manage as a developer, it is the " -#| "hardest to track as an end user, as serial version numbers convey little " -#| "or no information regarding API backwards compatibility." msgid "" "Serial versioning refers to the simplest possible versioning scheme, which " "consists of a single number incremented every release. While serial " @@ -2554,19 +2639,14 @@ msgid "" "as an end user, as serial version numbers convey little or no information " "regarding API backwards compatibility." msgstr "" -"Embora o versionamento serial seja muito fácil de gerenciar como " -"desenvolvedor, é o mais difícil de rastrear como usuário final, pois os " -"números de versão serial transmitem pouca ou nenhuma informação sobre " -"compatibilidade com versões anteriores da API." +"O versionamento serial refere-se ao esquema de versionamento mais simples " +"possível, que consiste em um único número incrementado a cada versão. Embora " +"o versionamento serial seja muito fácil de gerenciar como desenvolvedor, é o " +"mais difícil de rastrear como usuário final, pois os números de versão " +"serial transmitem pouca ou nenhuma informação sobre compatibilidade com " +"versões anteriores da API." #: ../source/discussions/versioning.rst:150 -#, fuzzy -#| msgid "" -#| "Combinations of the above schemes are possible. For example, a project " -#| "may combine date based versioning with serial versioning to create a YEAR." -#| "SERIAL numbering scheme that readily conveys the approximate age of a " -#| "release, but doesn't otherwise commit to a particular release cadence " -#| "within the year." msgid "" "Combinations of the above schemes are possible. For example, a project may " "combine date based versioning with serial versioning to create a *year." @@ -2576,7 +2656,7 @@ msgid "" msgstr "" "Combinações dos esquemas acima são possíveis. Por exemplo, um projeto pode " "combinar o versionamento baseado em data com o versionamento serial para " -"criar um esquema de numeração ANO.SÉRIE que transmite prontamente a idade " +"criar um esquema de numeração *ano.série* que transmite prontamente a idade " "aproximada de um lançamento, mas não se compromete com uma cadência de " "lançamento particular dentro do ano." @@ -2586,14 +2666,6 @@ msgid "Local version identifiers" msgstr "Identificadores de versão local" #: ../source/discussions/versioning.rst:160 -#, fuzzy -#| msgid "" -#| "Public version identifiers are designed to support distribution via :term:" -#| "`PyPI `. Python's software distribution " -#| "tools also support the notion of a :pep:`local version identifier " -#| "<440#local-version-identifiers>`, which can be used to identify local " -#| "development builds not intended for publication, or modified variants of " -#| "a release maintained by a redistributor." msgid "" "Public version identifiers are designed to support distribution via :term:" "`PyPI `. Python packaging tools also support " @@ -2603,11 +2675,11 @@ msgid "" msgstr "" "Identificadores de versão pública são projetados para suportar distribuição " "via :term:`PyPI `. As ferramentas de " -"distribuição de software do Python também suportam a noção de um :pep:" -"`identificador de versão local <440#local-version-identifiers>`, que pode " -"ser usado para identificar compilações de desenvolvimento local não " -"destinadas à publicação, ou variantes modificadas de uma versão mantida por " -"um redistribuidor." +"empacotamento do Python também oferecem suporte à noção de um :ref:`" +"identificador de versão local `, que pode ser " +"usado para identificar compilações de desenvolvimento local não destinadas à " +"publicação, ou variantes modificadas de uma versão mantida por um " +"redistribuidor." #: ../source/discussions/versioning.rst:166 msgid "" @@ -2620,12 +2692,22 @@ msgid "" "dev1+gd00980f\", or if the repository has untracked changes, like \"0.5." "dev1+gd00980f.d20231217\"." msgstr "" +"Um identificador de versão local assume a forma de um identificador de " +"versão pública, seguido por \"+\" e um rótulo de versão local. Por exemplo, " +"um pacote com patches específicos do Fedora aplicados poderia ter a versão " +"\"1.2.1+fedora.4\". Outro exemplo são as versões calculadas pelo setuptools-" +"scm_, um plugin do setuptools que lê a versão dos dados do Git. Em um " +"repositório Git com alguns commits desde a versão mais recente, setuptools-" +"scm gera uma versão como \"0.5.dev1+gd00980f\", ou se o repositório tiver " +"alterações não rastreadas, como \"0.5.dev1+gd00980f.d20231217\"." #: ../source/discussions/versioning.rst:178 msgid "" "Some more examples of unusual version numbers are given in a `blog post " "`_ by Seth Larson." msgstr "" +"Mais alguns exemplos de números de versão incomuns são fornecidos em uma `" +"postagem no blog `_ de Seth Larson." #: ../source/discussions/versioning.rst:181 msgid "" @@ -2634,6 +2716,11 @@ msgid "" "stufft_>`_, `by Bernát Gábor `_, `by Brett Cannon " "`_. For a humoristic take, read about ZeroVer_." msgstr "" +"Para alguns pontos de vista pessoais sobre este assunto, consulte estas " +"postagens do blog: `de Hynek Schlawak `_, `de " +"Donald Stufft `_, `de Bernát Gábor `_, `de Brett Cannon `_. Para uma visão " +"humorística, leia sobre ZeroVer_." #: ../source/flow.rst:3 msgid "The Packaging Flow" @@ -3041,16 +3128,6 @@ msgid "Built Distribution" msgstr "Distribuição Construída" #: ../source/glossary.rst:47 -#, fuzzy -#| msgid "" -#| "A :term:`Distribution ` format containing files and " -#| "metadata that only need to be moved to the correct location on the target " -#| "system, to be installed. :term:`Wheel` is such a format, whereas " -#| "distutil's :term:`Source Distribution ` is not, in that it requires a build step before it can be " -#| "installed. This format does not imply that Python files have to be " -#| "precompiled (:term:`Wheel` intentionally does not include compiled Python " -#| "files)." msgid "" "A :term:`Distribution ` format containing files and " "metadata that only need to be moved to the correct location on the target " @@ -3063,12 +3140,12 @@ msgid "" msgstr "" "Um formato de :term:`Distribuição ` contendo arquivos " "e metadados que só precisam ser movidos para o local correto no sistema de " -"destino, para serem instalados. :term:`Wheel` é esse formato, enquanto o :" -"term:`Distribuição Fonte ` do distutil " -"não é, pois requer uma etapa de construção antes de poder ser instalado. " -"Este formato não implica que os arquivos Python tenham que ser pré-" -"compilados (:term:`Wheel` intencionalmente não inclui arquivos Python " -"compilados)." +"destino, para serem instalados. :term:`Wheel` é esse formato, enquanto o " +":term:`Distribuição Fonte ` não é, pois " +"requer uma etapa de construção antes de poder ser instalado. Este formato " +"não implica que os arquivos Python tenham que ser pré-compilados " +"(:term:`Wheel` intencionalmente não inclui arquivos Python compilados). Veja " +":ref:`package-formats` para mais informações." #: ../source/glossary.rst:56 msgid "Distribution Package" @@ -3111,18 +3188,13 @@ msgid "Egg" msgstr "Egg" #: ../source/glossary.rst:75 -#, fuzzy -#| msgid "" -#| "A :term:`Built Distribution` format introduced by :pep:`427`, which is " -#| "intended to replace the :term:`Egg` format. Wheel is currently supported " -#| "by :ref:`pip`." msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -"Um formato de :term:`Distribuição Construída` introduzido por :pep:`427`, " -"que se destina a substituir o formato :term:`Egg`. O Wheel é atualmente " -"suportado pelo :ref:`pip`." +"Um formato de :term:`Distribuição Construída` introduzido pelo " +":ref:`setuptools`, que foi substituído pelo :term:`Wheel`. Para detalhes, " +"veja :ref:`egg-format`." #: ../source/glossary.rst:78 msgid "Extension Module" @@ -3461,12 +3533,6 @@ msgid "Source Distribution (or \"sdist\")" msgstr "Distribuição Fonte (ou \"sdist\")" #: ../source/glossary.rst:239 -#, fuzzy -#| msgid "" -#| "A :term:`distribution ` format (usually generated " -#| "using ``python -m build --sdist``) that provides metadata and the " -#| "essential source files needed for installing by a tool like :ref:`pip`, " -#| "or for generating a :term:`Built Distribution`." msgid "" "A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " @@ -3477,7 +3543,8 @@ msgstr "" "Um formato de :term:`distribuição ` (geralmente gerado " "usando ``python -m build sdist``) que fornece metadados e os arquivos-fonte " "essenciais necessários para a instalação por uma ferramenta como :ref:`pip`, " -"ou para gerar uma :term:`Distribuição Construída `." +"ou para gerar uma :term:`Distribuição Construída `. Veja " +":ref:`package-formats` para mais informações." #: ../source/glossary.rst:245 msgid "System Package" @@ -3535,6 +3602,8 @@ msgid "" "The standard :term:`Built Distribution` format. See :ref:`package-formats` " "for more information." msgstr "" +"O formato padrão de :term:`Distribuição Construída`. Veja :ref:`package-" +"formats` para mais informações." #: ../source/glossary.rst:271 msgid "Working Set" @@ -4888,6 +4957,8 @@ msgid "" "See :ref:`versioning` for information on common version schemes and how to " "choose between them." msgstr "" +"Veja :ref:`versioning` para informações sobre esquemas de versões comuns e " +"como escolher entre eles." #: ../source/guides/distributing-packages-using-setuptools.rst:298 msgid "Working in \"development mode\"" @@ -5679,20 +5750,16 @@ msgstr "" #: ../source/guides/hosting-your-own-index.rst:57 #: ../source/guides/index-mirrors-and-caches.rst:47 -#, fuzzy -#| msgid "A simple project" msgid "Existing projects" -msgstr "Um projeto simples" +msgstr "Projetos existentes" #: ../source/guides/hosting-your-own-index.rst:63 -#, fuzzy -#| msgid "Package Index" msgid "Package upload" -msgstr "Índice de Pacotes" +msgstr "Envio de pacotes" #: ../source/guides/hosting-your-own-index.rst:64 msgid "PyPI fall-through [2]_" -msgstr "" +msgstr "Padrão do PyPI [2]_" #: ../source/guides/hosting-your-own-index.rst:65 #: ../source/guides/index-mirrors-and-caches.rst:56 @@ -5702,10 +5769,8 @@ msgstr "Notas adicionais" #: ../source/guides/hosting-your-own-index.rst:67 #: ../source/guides/index-mirrors-and-caches.rst:58 -#, fuzzy -#| msgid ":ref:`pip`" msgid ":ref:`devpi`" -msgstr ":ref:`pip`" +msgstr ":ref:`devpi`" #: ../source/guides/hosting-your-own-index.rst:68 #: ../source/guides/hosting-your-own-index.rst:69 @@ -5731,101 +5796,83 @@ msgstr ":ref:`pip`" #: ../source/guides/index-mirrors-and-caches.rst:108 #: ../source/guides/index-mirrors-and-caches.rst:110 msgid "✔" -msgstr "" +msgstr "✔" #: ../source/guides/hosting-your-own-index.rst:70 msgid "" "multiple indexes with inheritance, with syncing, replication, fail-over; " "mirroring" msgstr "" +"múltiplos índices com herança, com sincronização, replicação, tolerância a " +"falhas; espelhamento" #: ../source/guides/hosting-your-own-index.rst:73 #: ../source/guides/index-mirrors-and-caches.rst:71 -#, fuzzy -#| msgid ":ref:`pip`" msgid ":ref:`simpleindex`" -msgstr ":ref:`pip`" +msgstr ":ref:`simpleindex`" #: ../source/guides/hosting-your-own-index.rst:78 -#, fuzzy -#| msgid "pypiserver" msgid ":ref:`pypiserver`" -msgstr "pypiserver" +msgstr ":ref:`pypiserver`" #: ../source/guides/hosting-your-own-index.rst:83 -#, fuzzy -#| msgid ":ref:`pip`" msgid ":ref:`pypiprivate`" -msgstr ":ref:`pip`" +msgstr ":ref:`pypiprivate`" #: ../source/guides/hosting-your-own-index.rst:88 #: ../source/guides/index-mirrors-and-caches.rst:77 -#, fuzzy -#| msgid ":ref:`pip`" msgid ":ref:`pypicloud`" -msgstr ":ref:`pip`" +msgstr ":ref:`pypicloud`" #: ../source/guides/hosting-your-own-index.rst:91 msgid "unmaintained; also cached proxying; authentication, authorisation" -msgstr "" +msgstr "sem manutenção; também faz proxy de cache; autenticação, autorização" #: ../source/guides/hosting-your-own-index.rst:93 -#, fuzzy -#| msgid ":ref:`pip`" msgid ":ref:`pywharf`" -msgstr ":ref:`pip`" +msgstr ":ref:`pywharf`" #: ../source/guides/hosting-your-own-index.rst:96 msgid "unmaintained; serve files in GitHub" -msgstr "" +msgstr "sem manutenção; serve arquivos no GitHub" #: ../source/guides/hosting-your-own-index.rst:98 #: ../source/guides/index-mirrors-and-caches.rst:83 -#, fuzzy -#| msgid ":ref:`pip`" msgid ":ref:`pulppython`" -msgstr ":ref:`pip`" +msgstr ":ref:`pulppython`" #: ../source/guides/hosting-your-own-index.rst:101 msgid "also mirroring, proxying; plugin for Pulp" -msgstr "" +msgstr "também espelhamento, proxy; plugin para Pulp" #: ../source/guides/hosting-your-own-index.rst:103 -#, fuzzy -#| msgid ":ref:`pip`" msgid ":ref:`pip2pi`" -msgstr ":ref:`pip`" +msgstr ":ref:`pip2pi`" #: ../source/guides/hosting-your-own-index.rst:106 msgid "also mirroring; manual synchronisation" -msgstr "" +msgstr "também espelhamento; sincronização manual" #: ../source/guides/hosting-your-own-index.rst:108 -#, fuzzy -#| msgid ":ref:`pip`" msgid ":ref:`dumb-pypi`" -msgstr ":ref:`pip`" +msgstr ":ref:`dumb-pypi`" #: ../source/guides/hosting-your-own-index.rst:111 msgid "not a server, but a static file site generator" -msgstr "" +msgstr "não é um servidor, mas um gerador de site de arquivo estático" #: ../source/guides/hosting-your-own-index.rst:113 msgid ":ref:`httpserver`" -msgstr "" +msgstr ":ref:`httpserver`" #: ../source/guides/hosting-your-own-index.rst:116 -#, fuzzy -#| msgid "Standard Library Projects" msgid "standard-library" -msgstr "Projetos de biblioteca padrão" +msgstr "biblioteca padrão" #: ../source/guides/hosting-your-own-index.rst:118 #: ../source/guides/index-mirrors-and-caches.rst:107 -#, fuzzy -#| msgid "`AppImage `_" msgid "`Apache `_" -msgstr "`AppImage `_" +msgstr "`Apache `_" #: ../source/guides/hosting-your-own-index.rst:121 #: ../source/guides/index-mirrors-and-caches.rst:111 @@ -5835,6 +5882,10 @@ msgid "" "mod_cache_disk.html>`_, you can cache requests to package indexes through an " "Apache server" msgstr "" +"usando `mod_rewrite `_ e " +"`mod_cache_disk `_, você pode armazenar em cache as solicitações para " +"índices de pacotes por meio de um servidor Apache" #: ../source/guides/hosting-your-own-index.rst:131 msgid "" @@ -5849,6 +5900,8 @@ msgid "" "Can be configured to fall back to PyPI (or another package index) if a " "requested package is missing." msgstr "" +"Pode ser configurado para recorrer ao PyPI (ou outro índice de pacote) se um " +"pacote solicitado estiver ausente." #: ../source/guides/index.rst:4 msgid "" @@ -5866,47 +5919,45 @@ msgid "Package index mirrors and caches" msgstr "Espelhos e caches de índice de pacotes" #: ../source/guides/index-mirrors-and-caches.rst:8 -#, fuzzy -#| msgid "2023-12-14" msgid "2023-11-08" -msgstr "2023-12-14" +msgstr "2023-11-08" #: ../source/guides/index-mirrors-and-caches.rst:10 -#, fuzzy -#| msgid "" -#| "Mirroring or caching of PyPI can be used to speed up local package " -#| "installation, allow offline work, handle corporate firewalls or just " -#| "plain Internet flakiness." msgid "" "Mirroring or caching of PyPI (and other :term:`package indexes `) can be used to speed up local package installation, allow offline " "work, handle corporate firewalls or just plain Internet flakiness." msgstr "" -"O espelhamento ou cache do PyPI pode ser usado para acelerar a instalação do " -"pacote local, permitir o trabalho offline, lidar com firewalls corporativos " -"ou simplesmente falhas na Internet." +"O espelhamento ou cache do PyPI (e outros :term:`índices de pacotes <Índice " +"de Pacotes>`) pode ser usado para acelerar a instalação do pacote local, " +"permitir o trabalho offline, lidar com firewalls corporativos ou " +"simplesmente falhas na Internet." #: ../source/guides/index-mirrors-and-caches.rst:15 msgid "There are multiple classes of options in this area:" -msgstr "" +msgstr "Existem várias classes de opções nesta área:" #: ../source/guides/index-mirrors-and-caches.rst:17 -#, fuzzy -#| msgid "Using other package indexes" msgid "local/hosted caching of package indexes." -msgstr "Usando outros índices de pacotes" +msgstr "fazer cache local/hospedado de índices de pacotes." #: ../source/guides/index-mirrors-and-caches.rst:19 msgid "" "local/hosted mirroring of a package index. A mirror is a (whole or partial) " "copy of a package index, which can be used in place of the original index." msgstr "" +"fazer espelhamento local/hospedado de um índice de pacotes. Um espelho é uma " +"cópia (total ou parcial) de um índice de pacotes, que pode ser usado no " +"lugar do índice original." #: ../source/guides/index-mirrors-and-caches.rst:23 msgid "" "private package index with fall-through to public package indexes (for " "example, to mitigate dependency confusion attacks), also known as a proxy." msgstr "" +"índice de pacotes privados com alternativa para os índices de pacotes " +"públicos (por exemplo, para mitigar ataques de confusão de dependência), " +"também conhecido como proxy." #: ../source/guides/index-mirrors-and-caches.rst:29 msgid "Caching with pip" @@ -5940,68 +5991,62 @@ msgstr "" #: ../source/guides/index-mirrors-and-caches.rst:53 msgid "Cache" -msgstr "" +msgstr "Cache" #: ../source/guides/index-mirrors-and-caches.rst:54 msgid "Mirror" -msgstr "" +msgstr "Espelho" #: ../source/guides/index-mirrors-and-caches.rst:55 msgid "Proxy" -msgstr "" +msgstr "Proxy" #: ../source/guides/index-mirrors-and-caches.rst:62 msgid "" "multiple indexes with inheritance; syncing, replication, fail-over; package " "upload" msgstr "" +"múltiplos índices com herança; sincronização, replicação, tolerância a " +"falhas; envio de pacote" #: ../source/guides/index-mirrors-and-caches.rst:65 -#, fuzzy -#| msgid "pip, :ref:`bandersnatch`" msgid ":ref:`bandersnatch`" -msgstr "pip, :ref:`bandersnatch`" +msgstr ":ref:`bandersnatch`" #: ../source/guides/index-mirrors-and-caches.rst:75 msgid "custom plugin enables caching; re-routing to other package indexes" msgstr "" +"plugin personalizado permite fazer cache; redirecionamento para outros " +"índices de pacotes" #: ../source/guides/index-mirrors-and-caches.rst:81 msgid "unmaintained; authentication, authorisation" -msgstr "" +msgstr "sem manutenção; autenticação, autorização" #: ../source/guides/index-mirrors-and-caches.rst:87 msgid "plugin for Pulp; multiple proxied indexes; package upload" -msgstr "" +msgstr "plugin para Pulp; vários índices proxy; envio de pacote" #: ../source/guides/index-mirrors-and-caches.rst:89 -#, fuzzy -#| msgid ":ref:`pip`" msgid ":ref:`proxpi`" -msgstr ":ref:`pip`" +msgstr ":ref:`proxpi`" #: ../source/guides/index-mirrors-and-caches.rst:93 #: ../source/guides/index-mirrors-and-caches.rst:99 -#, fuzzy -#| msgid "per project index" msgid "multiple proxied indexes" -msgstr "índice por projeto" +msgstr "múltiplos índices sob proxy" #: ../source/guides/index-mirrors-and-caches.rst:95 msgid ":ref:`nginx_pypi_cache`" -msgstr "" +msgstr ":ref:`nginx_pypi_cache`" #: ../source/guides/index-mirrors-and-caches.rst:101 -#, fuzzy -#| msgid ":ref:`pip`" msgid ":ref:`flaskpypiproxy`" -msgstr ":ref:`pip`" +msgstr ":ref:`flaskpypiproxy`" #: ../source/guides/index-mirrors-and-caches.rst:105 -#, fuzzy -#| msgid "Maintainer" msgid "unmaintained" -msgstr "Mantenedor" +msgstr "sem manutenção" #: ../source/guides/installing-scientific-packages.rst:5 msgid "Installing scientific packages" @@ -7709,10 +7754,8 @@ msgid "``python -m build --no-isolation``" msgstr "``python -m build --no-isolation``" #: ../source/guides/modernize-setup-py-project.rst:127 -#, fuzzy -#| msgid "``python -m install --no-build-isolation``" msgid "``python -m pip install --no-build-isolation``" -msgstr "``python -m install --no-build-isolation``" +msgstr "``python -m pip install --no-build-isolation``" #: ../source/guides/modernize-setup-py-project.rst:135 msgid "How to handle packaging metadata?" @@ -9344,6 +9387,14 @@ msgid "" "instructions. Specifically, the token needs the ``contents: write`` " "permission." msgstr "" +"Pode ser necessário gerenciar suas permissões do ``GITHUB_TOKEN`` para " +"permitir a criação da versão do GitHub. Consulte a `documentação do GitHub " +"`_ para " +"obter instruções. Especificamente, o token precisa da permissão ``contents: " +"write``." #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:182 msgid "Finally, the signed distributions are uploaded to the GitHub Release." @@ -9468,16 +9519,12 @@ msgstr "" "do seu projeto:" #: ../source/guides/single-sourcing-package-version.rst:12 -#, fuzzy -#| msgid "" -#| "Read the file in :file:`setup.py` and get the version. Example (from `pip " -#| "setup.py `_)::" msgid "" "Read the file in :file:`setup.py` and get the version. Example (from `pip " "setup.py `_)::" msgstr "" -"Leia o arquivo em :file:`setup.py` e obtenha a versão. Exemplo (de `pip " -"setup.py `_)::" +"Leia o arquivo em :file:`setup.py` e obtenha a versão. Exemplo (do `setup.py " +"do pip `_)::" #: ../source/guides/single-sourcing-package-version.rst:39 msgid "" @@ -10398,12 +10445,21 @@ msgid "" "makes some recommendations of tools that you should *not* use because they " "are deprecated or insecure." msgstr "" +"O cenário de empacotamento do Python consiste em muitas ferramentas " +"diferentes. Para muitas tarefas, o :term:`Python Packaging Authority ` (PyPA, o grupo de trabalho que engloba muitas " +"ferramentas de empacotamento e mantém este guia) propositalmente não faz uma " +"recomendação geral; por exemplo, a razão pela qual existem muitos backends " +"de construção é que o cenário foi aberto para permitir o desenvolvimento de " +"novos backends que atendam melhor às necessidades de determinados usuários " +"do que o backend anteriormente exclusivo, setuptools. Este guia aponta " +"algumas ferramentas que são amplamente reconhecidas e também faz algumas " +"recomendações de ferramentas que você *não* deve usar porque estão " +"descontinuadas ou são inseguras." #: ../source/guides/tool-recommendations.rst:20 -#, fuzzy -#| msgid "Virtual Environment" msgid "Virtual environments" -msgstr "Ambiente Virtual" +msgstr "Ambientes virtuais" #: ../source/guides/tool-recommendations.rst:22 msgid "" @@ -10411,6 +10467,9 @@ msgid "" "`virtualenv` (PyPA project) and :doc:`venv ` (part of " "the Python standard library, though missing some features of virtualenv)." msgstr "" +"As ferramentas padrão para criar e usar ambientes virtuais manualmente são " +":ref:`virtualenv` (projeto PyPA) e :doc:`venv ` (parte " +"da biblioteca padrão Python, embora falte alguns recursos do virtualenv) ." #: ../source/guides/tool-recommendations.rst:28 msgid "Installing packages" @@ -10424,6 +10483,11 @@ msgid "" "in most Python installations through the standard library package :doc:" "`ensurepip `." msgstr "" +":ref:`Pip` é a ferramenta padrão para instalar pacotes do :term:`PyPI " +"`. Você pode querer ler as recomendações do pip " +"para obter :doc:`instalações seguras `. Pip está " +"disponível por padrão na maioria das instalações do Python através do pacote " +"de biblioteca padrão :doc:`ensurepip `." #: ../source/guides/tool-recommendations.rst:36 msgid "" @@ -10435,15 +10499,25 @@ msgid "" "wide applications making use of the same Python interpreter (especially on " "Linux)." msgstr "" +"Alternativamente, considere :ref:`pipx` para o caso de uso específico de " +"instalação de aplicativos Python que são distribuídos por meio de PyPI e " +"executados a partir da linha de comando. Pipx é um wrapper em torno de pip e " +"venv que instala cada aplicativo em um ambiente virtual dedicado. Isso evita " +"conflitos entre as dependências de diferentes aplicações, e também com " +"aplicações de todo o sistema que utilizam o mesmo interpretador Python (" +"especialmente no Linux)." #: ../source/guides/tool-recommendations.rst:43 msgid "" "For scientific software specifically, consider :ref:`Conda` or :ref:`Spack`." msgstr "" +"Especificamente para software científico, considere :ref:`Conda` ou " +":ref:`Spack`." #: ../source/guides/tool-recommendations.rst:45 msgid "Write a \"pip vs. Conda\" comparison, here or in a new discussion." msgstr "" +"Escreva uma comparação \"pip vs. Conda\", aqui ou em uma nova discussão." #: ../source/guides/tool-recommendations.rst:47 msgid "" @@ -10453,10 +10527,16 @@ msgid "" "develop``, which are also deprecated (see :ref:`setup-py-deprecated` for " "background and :ref:`modernize-setup-py-project` for migration advice)." msgstr "" +"**Não** use ``easy_install`` (parte de :ref:`setuptools`), que foi " +"descontinuado em favor do pip (veja :ref:`pip vs easy_install` para detalhes)" +". Da mesma forma, **não** use ``python setup.py install`` ou ``python " +"setup.py development``, que também foram descontinuados (veja :ref:`setup-py-" +"deprecated` para aprofundamento e :ref :`modernize-setup-py-project` para " +"aconselhamento sobre migração)." #: ../source/guides/tool-recommendations.rst:55 msgid "Lock files" -msgstr "" +msgstr "Arquivos de bloqueio" #: ../source/guides/tool-recommendations.rst:57 msgid "" @@ -10464,12 +10544,13 @@ msgid "" "files, which contain the exact versions of all packages installed into an " "environment, for reproducibility purposes." msgstr "" +":ref:`pip-tools` e :ref:`Pipenv` são duas ferramentas reconhecidas para " +"criar arquivos de bloqueio, que contêm as versões exatas de todos os pacotes " +"instalados em um ambiente, para fins de reprodutibilidade." #: ../source/guides/tool-recommendations.rst:63 -#, fuzzy -#| msgid "Build Backend" msgid "Build backends" -msgstr "Backend de construção" +msgstr "Backends de construção" #: ../source/guides/tool-recommendations.rst:67 msgid "" @@ -10477,6 +10558,9 @@ msgid "" "particular tool, only to enumerate common tools. Different use cases often " "need specialized workflows." msgstr "" +"Por favor, lembre-se: este documento não procura orientar o leitor para uma " +"ferramenta específica, apenas enumerar ferramentas comuns. Diferentes casos " +"de uso geralmente precisam de fluxos de trabalho especializados." #: ../source/guides/tool-recommendations.rst:71 msgid "" @@ -19564,10 +19648,8 @@ msgid "This means that the following names are all equivalent:" msgstr "Isso significa que os seguintes nomes são todos equivalentes:" #: ../source/specifications/name-normalization.rst:41 -#, fuzzy -#| msgid "``friendly-bard`` (normalized form)" msgid "``friendly-bard`` (normalized form)" -msgstr "``friendly-bard`` (forma normalizada)" +msgstr "``friendly-bard`` (forma normalizada)" #: ../source/specifications/name-normalization.rst:42 msgid "``Friendly-Bard``" @@ -20430,9 +20512,8 @@ msgstr "" "senhas com segurança usando um `chaveiro`_ (que é instalado pelo Twine):" #: ../source/specifications/pyproject-toml.rst:6 -#, fuzzy msgid "``pyproject.toml`` specification" -msgstr "``pyproject.toml`` é obrigatório?" +msgstr "Especificação do ``pyproject.toml``" #: ../source/specifications/pyproject-toml.rst:10 msgid "" diff --git a/locales/sk/LC_MESSAGES/messages.po b/locales/sk/LC_MESSAGES/messages.po index ab5a89d2a..2b3f56ca9 100644 --- a/locales/sk/LC_MESSAGES/messages.po +++ b/locales/sk/LC_MESSAGES/messages.po @@ -2,21 +2,22 @@ # Copyright (C) 2013–2020, PyPA # This file is distributed under the same license as the Python Packaging User Guide package. # Milan Šalka , 2023. +# Rafael Fontenelle , 2024. msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2024-04-18 14:36+0000\n" -"PO-Revision-Date: 2023-09-21 05:16+0000\n" -"Last-Translator: Milan Šalka \n" -"Language-Team: Slovak \n" +"PO-Revision-Date: 2024-04-25 06:07+0000\n" +"Last-Translator: Rafael Fontenelle \n" +"Language-Team: Slovak \n" "Language: sk\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -"Plural-Forms: nplurals=3; plural=(n==1) ? 0 : (n>=2 && n<=4) ? 1 : 2;\n" -"X-Generator: Weblate 5.1-dev\n" +"Plural-Forms: nplurals=3; plural=((n==1) ? 0 : (n>=2 && n<=4) ? 1 : 2);\n" +"X-Generator: Weblate 5.5.1-dev\n" #: ../source/contribute.rst:5 msgid "Contribute to this guide" @@ -122,7 +123,7 @@ msgstr "" "predpokladať, že niektoré úrovne vopred otázky. To sú podobné tutoriály, ale " "majú úzke a jasné zameranie a môže poskytnúť veľa jaskýň a ďalšie " "informácie, ako je to potrebné. Môžu tiež diskutovať o viacerých prístupov k " -"dosiahnutiu úlohy. :doc:'example sprievodca-style dokument `." #: ../source/contribute.rst:60 ../source/discussions/index.rst:2 @@ -136,7 +137,7 @@ msgid "" "style document `." msgstr "" "Diskusie sú zamerané na pochopenie a informácie. Tieto skúmajú konkrétnu " -"tému bez konkrétneho cieľa. :doc:'example diskusný dokument `." #: ../source/contribute.rst:67 @@ -196,7 +197,7 @@ msgid "" "the language you want to translate." msgstr "" "Ak váš jazyk nie je uvedený na `packaging. python.org`_, kliknite na " -"tlačidlo :gui štít:`Start nový preklad` v dolnej časti zoznamu jazykov a " +"tlačidlo :guilabel:`Start nový preklad` v dolnej časti zoznamu jazykov a " "pridajte jazyk, ktorý chcete preložiť." #: ../source/contribute.rst:100 From afc6afef03fbcd03b27720cede0063c5ffd2a444 Mon Sep 17 00:00:00 2001 From: moto kawasaki Date: Mon, 20 May 2024 09:01:57 +0000 Subject: [PATCH 2/4] Translated using Weblate (Japanese) Currently translated at 82.9% (2891 of 3487 strings) Translated using Weblate (Japanese) Currently translated at 82.6% (2881 of 3487 strings) Translated using Weblate (Japanese) Currently translated at 82.5% (2879 of 3487 strings) Translated using Weblate (Japanese) Currently translated at 82.4% (2878 of 3490 strings) Translated using Weblate (Japanese) Currently translated at 82.4% (2876 of 3490 strings) Translated using Weblate (Japanese) Currently translated at 82.2% (2869 of 3490 strings) Translated using Weblate (Japanese) Currently translated at 82.1% (2867 of 3490 strings) Translated using Weblate (Japanese) Currently translated at 82.1% (2866 of 3490 strings) Translated using Weblate (Japanese) Currently translated at 81.9% (2858 of 3487 strings) Translated using Weblate (Japanese) Currently translated at 81.7% (2852 of 3487 strings) Translated using Weblate (Japanese) Currently translated at 81.7% (2850 of 3487 strings) Translated using Weblate (Japanese) Currently translated at 82.2% (2850 of 3463 strings) Translated using Weblate (Japanese) Currently translated at 82.1% (2844 of 3463 strings) Translated using Weblate (Japanese) Currently translated at 82.0% (2841 of 3463 strings) Translated using Weblate (Japanese) Currently translated at 81.6% (2829 of 3463 strings) Translated using Weblate (Japanese) Currently translated at 81.5% (2824 of 3463 strings) Translated using Weblate (Japanese) Currently translated at 81.4% (2819 of 3463 strings) Co-authored-by: moto kawasaki Translate-URL: https://hosted.weblate.org/projects/pypa/packaging-python-org/ja/ Translation: pypa/packaging.python.org --- locales/ja/LC_MESSAGES/messages.po | 668 +++++++++++++++++++++++------ 1 file changed, 537 insertions(+), 131 deletions(-) diff --git a/locales/ja/LC_MESSAGES/messages.po b/locales/ja/LC_MESSAGES/messages.po index 12471c3f1..20cfe037b 100644 --- a/locales/ja/LC_MESSAGES/messages.po +++ b/locales/ja/LC_MESSAGES/messages.po @@ -10,16 +10,16 @@ msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2024-04-13 15:33+0000\n" -"PO-Revision-Date: 2024-04-18 14:36+0000\n" +"PO-Revision-Date: 2024-05-20 09:01+0000\n" "Last-Translator: moto kawasaki \n" -"Language-Team: Japanese \n" +"Language-Team: Japanese \n" "Language: ja\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Plural-Forms: nplurals=1; plural=0;\n" -"X-Generator: Weblate 5.5-dev\n" +"X-Generator: Weblate 5.6-dev\n" #: ../source/contribute.rst:5 msgid "Contribute to this guide" @@ -1406,6 +1406,11 @@ msgid "" "the wheel is compatible with. For example, the name ``pip-23.3.1-py3-none-" "any.whl`` means that:" msgstr "" +"wheel のファイル名は (ほとんど使われることのない幾つかの機能を除けば) このよ" +"うに見えます: :samp:`{package_name}-{version}-{python_tag}-{abi_tag}-" +"{platform_tag}.whl` 。この命名規則によって、その wheel がどのプラットフォーム" +"でどの Python バージョンと互換性を持つのかを識別することができます。例えば、 " +"``pip-23.3.1-py3-none-any.whl`` という名前は次のことを意味します:" #: ../source/discussions/package-formats.rst:121 msgid "" @@ -1413,31 +1418,38 @@ msgid "" "whether CPython, the most widely used Python implementation, or an " "alternative implementation like PyPy_;" msgstr "" +"(``py3``) CPython、最も広く使われている Python 実装、あるいは PyPy_ のような" +"代替実装でも、 Python 3 の実装があればどこでも、この wheel をインストールする" +"ことができます;" #: ../source/discussions/package-formats.rst:124 msgid "(``none``) It does not depend on the Python version;" -msgstr "" +msgstr "(``none``) Python のバージョンには依存しません;" #: ../source/discussions/package-formats.rst:125 msgid "(``any``) It does not depend on the platform." -msgstr "" +msgstr "(``any``) プラットフォームには依存しません。" #: ../source/discussions/package-formats.rst:127 msgid "" "The pattern ``py3-none-any`` is common for pure Python projects. Packages " "with extension modules typically ship multiple wheels with more complex tags." msgstr "" +"``py3-none-any`` というパターンは、純 Python のプロジェクトに広く見られます。" +"拡張モジュールを伴うパッケージは、典型的に、もっと複雑なタグ群を持つ複数の " +"wheel を出荷します。" #: ../source/discussions/package-formats.rst:130 msgid "" "All technical details on the wheel format can be found in the :ref:`wheel " "specification `." msgstr "" +"wheel のフォーマットに関するすべての技術的な詳細は、 :ref:`wheel 仕様 " +"` で見つかるでしょう。" #: ../source/discussions/package-formats.rst:138 -#, fuzzy msgid "What about eggs?" -msgstr "これは何..." +msgstr "egg って何？" #: ../source/discussions/package-formats.rst:140 msgid "" @@ -1445,45 +1457,43 @@ msgid "" "format. It should not be used anymore. Since August 2023, PyPI `rejects egg " "uploads `_." msgstr "" +"\"Egg\" は、 wheel によって置き換えられた古いパッケージフォーマットです。もは" +"や使用されるべきではありません。 2023 年 8 月以降、 PyPI は `egg のアップロー" +"ドを拒絶 `_ しています。" #: ../source/discussions/package-formats.rst:144 -#, fuzzy msgid "Here's a breakdown of the important differences between wheel and egg." -msgstr ":term:`Wheel`と :term:`Egg`の重要な差異について以下にまとめます。" +msgstr "wheelと egg の重要な差異について以下にまとめます。" #: ../source/discussions/package-formats.rst:146 -#, fuzzy msgid "" "The egg format was introduced by :ref:`setuptools` in 2004, whereas the " "wheel format was introduced by :pep:`427` in 2012." msgstr "" -":term:`Egg`のフォーマットは、2004年に:ref:`setuptools`によって、また、:term:" -"`Wheel`のフォーマットは2012年に:pep:`427`によって導入されました。" +"egg のフォーマットは、2004年に:ref:`setuptools`によって、また、wheel のフォー" +"マットは2012年に :pep:`427` によって導入されました。" #: ../source/discussions/package-formats.rst:149 -#, fuzzy msgid "" "Wheel has an :doc:`official standard specification `. Egg did not." msgstr "" -":term:`Wheel`には :doc:`公式の標準仕様 ` が存在します。 :term:`Egg`には対応するPEPがありません。" +"Wheel には :doc:`公式の標準仕様 ` が存在します。 Egg にはありません。" #: ../source/discussions/package-formats.rst:152 -#, fuzzy msgid "" "Wheel is a :term:`distribution ` format, i.e a " "packaging format. [#wheel-importable]_ Egg was both a distribution format " "and a runtime installation format (if left zipped), and was designed to be " "importable." msgstr "" -":term:`Wheel`は :term:`配布物 `のフォーマット、つまり、" -"パッケージのフォーマットです。[1]_ :term:`Egg`は配布物のフォーマットでもあ" -"り、かつ、(もし圧縮されたままであれば)実行時のインストールフォーマットであっ" -"てimportができるように設計されています。" +"Wheel は :term:`配布物 `のフォーマット、つまり、パッ" +"ケージングのフォーマットです [#wheel-importable]_ 。 Egg は配布物のフォーマッ" +"トでもあり、かつ、(もし圧縮されたままであれば)実行時のインストールフォーマッ" +"トであって、 importができるように設計されています。" #: ../source/discussions/package-formats.rst:156 -#, fuzzy msgid "" "Wheel archives do not include ``.pyc`` files. Therefore, when the " "distribution only contains Python files (i.e. no compiled extensions), and " @@ -1491,50 +1501,47 @@ msgid "" "\"universal\", similar to an :term:`sdist `." msgstr "" -":term:`Wheel`形式のファイルには.pycファイルが含まれていません。従って、配布物" -"には(コンパイル済のファイル抜きの)Pythonファイルのみ(含み、Pythonのバージョン" -"2と3で使用可能ですので、 :term:`sdist `と" -"同様にwheelは「汎用」であると言うことができます。" +"Wheel 形式のファイルには ``.pyc`` ファイルが含まれていません。従って、Python" +"ファイルだけが配布物に含まれている (即ちコンパイル済みの拡張がない) 場合、か" +"つ、 Python 2 および 3 と互換性を持つ時、その wheel ファイルは、 :term:" +"`sdist ` と同様に \"汎用 \" で" +"ある可能性があります。" #: ../source/discussions/package-formats.rst:161 -#, fuzzy msgid "" "Wheel uses standard :ref:`.dist-info directories `. Egg used ``.egg-info``." msgstr "" -":term:`Wheel`は :pep:`PEP376-compliant <376>`に従って ``.dist-info`` ディレク" -"トリを用います。Eggは ``.egg-info`` を用います。" +"Wheel は、:ref:`.dist-info ディレクトリ ` を使" +"います。 Egg は ``.egg-info`` を使います。" #: ../source/discussions/package-formats.rst:164 -#, fuzzy msgid "" "Wheel has a :ref:`richer file naming convention `. A " "single wheel archive can indicate its compatibility with a number of Python " "language versions and implementations, ABIs, and system architectures." msgstr "" -":term:`Wheel`には:pep:`richer file naming convention <425>`が存在します。単独" -"のwheelアーカイブはPython言語のバージョンや実装、ABI、そしてシステムのアーキ" -"テクチャとの互換性を表示することができます。" +"Wheel には :ref:`多彩なファイル命名慣行 `が存在します。" +"単独のwheelアーカイブはPython言語のバージョンや実装、ABI、そしてシステムの" +"アーキテクチャとの互換性を表示することができます。" #: ../source/discussions/package-formats.rst:168 -#, fuzzy msgid "" "Wheel is versioned. Every wheel file contains the version of the wheel " "specification and the implementation that packaged it." msgstr "" -":term:`Wheel`はバージョン付けされています。それぞれのwheelファイルは、それを" -"パッケージしたwheelの仕様や実装のバージョンを保持しています。" +"Wheel はバージョン付けされています。それぞれのwheelファイルは、wheelの仕様の" +"バージョンやパッケージングに使われた実装のバージョンを保持しています。" #: ../source/discussions/package-formats.rst:171 -#, fuzzy msgid "" "Wheel is internally organized by `sysconfig path type `_, therefore making it " "easier to convert to other formats." msgstr "" -":term:`Wheel`は内部では`sysconfigパスの型 `_で整理されているので、他のフォーマットに" -"変換するのがより簡単になっています。" +"wheel は、内部では、 `sysconfigパスの型 `_ に従って整理されているので、他のフォー" +"マットに変換するのがより簡単になっています。" #: ../source/discussions/package-formats.rst:177 msgid "" @@ -1545,6 +1552,12 @@ msgid "" "backend, typically ``[project]`` in ``pyproject.toml``, and translated by " "the build backend into ``PKG-INFO``." msgstr "" +"このフォーマットは、電子メールのものをベースにしています。今となってはこれが" +"選択されるとは思えませんが、後方互換性を鑑みて正規のフォーマットとして維持さ" +"れています。ユーザの観点からは、これはほとんど目に映りません。というのは、ビ" +"ルドバックエンドに理解できる形、典型的には ``pyproject.toml`` の中の " +"``[project]`` でメタデータがユーザによって指定され、ビルドバックエンドが " +"``PKG-INFO`` 内へと翻訳するからです。" #: ../source/discussions/package-formats.rst:184 msgid "" @@ -3094,7 +3107,6 @@ msgid "Built Distribution" msgstr "ビルド済配布物" #: ../source/glossary.rst:47 -#, fuzzy msgid "" "A :term:`Distribution ` format containing files and " "metadata that only need to be moved to the correct location on the target " @@ -3105,20 +3117,21 @@ msgid "" "does not include compiled Python files). See :ref:`package-formats` for more " "information." msgstr "" -":term:`配布物 `とは、ターゲットとなるシステムの適切な位" -"置に移動することでインストールされるファイルやメタデータを内包したフォーマッ" -"トです。:term:`Wheel`はそのようなフォーマットですが、他方で、distutilの :" -"term:`ソースコード配布物 ` フォーマットは、インストールするために" +"ターゲットとなるシステムの適切な位置に移動させることに必要となるファイルやメ" +"タデータだけを含んでいます。 :term:`Wheel` はそのようなフォーマットですが、イ" +"ンストールできるようになる前にビルド段階が必須となると言う点で :term:`ソース" +"コード配布物 ` はそうではありません。" +"このフォーマットであることは、 Python のファイル群があらかじめコンパイルされ" +"た状態でなければならないということを意味しません (:term:`Wheel` では意図的に" +"コンパイル済みの Python ファイル群を含まないようになっています)。より詳しく" +"は :ref:`package-formats` を見てください。" + +#: ../source/glossary.rst:56 ../source/glossary.rst:89 msgid "Distribution Package" msgstr "配布パッケージ" -#: ../source/glossary.rst:59 +#: ../source/glossary.rst:59 ../source/glossary.rst:92 msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " @@ -3130,7 +3143,7 @@ msgstr "" "イルを内部に含むバージョン付きアーカイブファイル。アーカイブファイルはエンド" "ユーザがインターネットからダウンロードしてインストールするものです。" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:64 ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -3148,24 +3161,24 @@ msgstr "" "の混同を避けるために明確に述べる必要がある場合には、長い方の用語を用いること" "があります。" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:72 ../source/glossary.rst:105 msgid "Egg" msgstr "卵" -#: ../source/glossary.rst:75 -#, fuzzy +#: ../source/glossary.rst:75 ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -":term:`Egg` フォーマットを代替することを意図して :pep:`427` で導入された :" -"term:`ビルド済配布物`。現在、:ref:`pip`はWheelをサポートしている。" +":term:`Wheel` によって既に置き換えられていますが、 :term:`ビルド済配布物 " +"` フォーマットは、 :ref:`setuptools` によって導入されまし" +"た。詳細については、 :ref:`egg フォーマット ` を見てください。" -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:78 ../source/glossary.rst:111 msgid "Extension Module" msgstr "拡張モジュール" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:81 ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -3179,11 +3192,11 @@ msgstr "" "ジェクトファイル(.so)、Windows上ではDLL(拡張子.pydを与えられる)のPython拡張、" "Jython拡張ではJavaのクラスファイルの形を取る。" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:88 ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "既知の良好なセット" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:91 ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -3196,11 +3209,11 @@ msgstr "" "が既知の良好なセット(KGS)であると宣言されます。この用語は、個々の配布物を複数" "組み合わせて構成されるフレームワークやツールキットで共通して用いられます。" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:97 ../source/glossary.rst:130 msgid "Import Package" msgstr "インポートパッケージ" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:100 ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." @@ -3208,7 +3221,7 @@ msgstr "" "直接に、あるいは何段階になっても良いが、他のパッケージを組み込んで使うような" "Pythonモジュール。" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:103 ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -3221,11 +3234,11 @@ msgstr "" "term:`配布物パッケージ `との混同を避けるために必要な場" "合には、長い方の用語を用いることにします。" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:108 ../source/glossary.rst:149 msgid "Module" msgstr "モジュール" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:111 ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." @@ -3233,11 +3246,11 @@ msgstr "" "Pythonにおけるソースコード再利用の基本的な単位で、 :term:`Pure Module`か :" "term:`Extension Module`の二つのタイプのうちのいずれか。" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:114 ../source/glossary.rst:155 msgid "Package Index" msgstr "パッケージインデックス" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:117 ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." @@ -3246,11 +3259,11 @@ msgstr "" "索・ダウンロードが適切か)を自動化するwebインターフェイスを伴った配布物のリポ" "ジトリ。" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:120 ../source/glossary.rst:161 msgid "Per Project Index" msgstr "プロジェクト単位の索引" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:123 ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " @@ -3261,11 +3274,11 @@ msgstr "" "`パッケージ索引 `。" #: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 -#: ../source/guides/index-mirrors-and-caches.rst:52 +#: ../source/guides/index-mirrors-and-caches.rst:52 ../source/glossary.rst:168 msgid "Project" msgstr "プロジェクト" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:130 ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " @@ -3275,7 +3288,7 @@ msgstr "" "一連のデータもしくはその他のリソース、または、これらの組み合わせで :term:`配" "布物 `として意図的にパッケージされたもの。" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:134 ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -3289,7 +3302,7 @@ msgstr "" "トのソースコードの一番上のディレクトリに :term:`pyproject.toml`や :term:" "`setup.py`または :term:`setup.cfg`のファイルを含む何ものかというものです。" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:140 ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -3302,7 +3315,7 @@ msgstr "" "ひとつまたはより多くの :term:`配布物 `を内包していま" "す。" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:145 ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -3316,11 +3329,11 @@ msgstr "" "(訳註、「なんとか」とは無関係の別の名前の例)という名前でのみインポート可能な" "パッケージを提供することは可能です。" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:151 ../source/glossary.rst:220 msgid "Pure Module" msgstr "純粋なモジュール" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:154 ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." @@ -3328,11 +3341,11 @@ msgstr "" "Pythonで書かれていて単一の``.py``ファイル(とおそらくは対応する``.pyc``ファイ" "ルや``.pyo``ファイル)に収められた :term:`モジュール `。" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:157 ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "Pythonパッケージングオーソリティ(PyPA)" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:160 ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -3349,11 +3362,11 @@ msgstr "" "`Python談話フォーラム `__ で議論を進" "めています。" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:169 ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "Pythonパッケージインデックス (PyPI)" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:172 ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " @@ -3363,11 +3376,11 @@ msgstr "" "`Package Index`です。ここから配布物を取り出し、また、配布するためにすべての" "Python開発者に開かれています。" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:175 ../source/glossary.rst:268 msgid "pypi.org" msgstr "pypi.org" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:178 ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." @@ -3377,22 +3390,22 @@ msgstr "" "(PyPI)` のためのドメイン名です。2017年にそれまでのドメイン名である ``pypi." "python.org`` を置き換えました。 :ref:`warehouse`を使っています。" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:182 ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "pyproject.toml" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:185 ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" "ツール不可知論者の :term:`プロジェクト ` 仕様を示すファイル。 :pep:" "`518` で定義。" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:187 ../source/glossary.rst:280 msgid "Release" msgstr "リリース" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:190 ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." @@ -3400,7 +3413,7 @@ msgstr "" "ある特定の時点における :term:`プロジェクト `のスナップショットで、" "バージョン識別子付きのもの。" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:193 ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -3412,11 +3425,11 @@ msgstr "" "らば、ソースコード配布物とWindowsインストーラ付配布物の両方が利用可能となって" "いるという具合です。" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:198 ../source/glossary.rst:291 msgid "Requirement" msgstr "要求事項" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:201 ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -3429,11 +3442,11 @@ msgstr "" "`pip` では、「要求事項」とも解釈できる仕様を様々な様式で書くことを許容してい" "ます。詳細については、 :ref:`pip:pip install` の項を参照してください。" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:207 ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "要求事項識別子" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:210 ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -3446,11 +3459,11 @@ msgstr "" "\"foo>=1.3\" は要求事項識別子であり、 \"foo\" の部分がプロジェクトの名称で、 " "\">=1.3\" の部分は :term:`バージョン指定子 ` です" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:215 ../source/glossary.rst:308 msgid "Requirements File" msgstr "Requirementsファイル" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:218 ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " @@ -3462,15 +3475,17 @@ msgstr "" #: ../source/glossary.rst:222 #: ../source/guides/distributing-packages-using-setuptools.rst:59 +#: ../source/glossary.rst:315 msgid "setup.py" msgstr "setup.py" #: ../source/glossary.rst:223 #: ../source/guides/distributing-packages-using-setuptools.rst:80 +#: ../source/glossary.rst:316 msgid "setup.cfg" msgstr "setup.cfg" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:226 ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." @@ -3478,11 +3493,11 @@ msgstr "" ":ref:`distutils`や :ref:`setuptools` で使われるプロジェクトの仕様を記したファ" "イル。 :term:`pyproject.toml`も見てください。" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:229 ../source/glossary.rst:322 msgid "Source Archive" msgstr "ソースコードアーカイブ" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:232 ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` という用語を作る前には、:term:`リリース " "`向けに生のソースコードを収めたアーカイブのことをこう呼んでいた。" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:236 ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" "`ソースコード配布物 (またはsdist) `" #: ../source/glossary.rst:239 -#, fuzzy msgid "" "A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " @@ -3506,16 +3520,17 @@ msgid "" "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -":ref:`pip`のようなツールでインストールする時や :term:`ビルド配布物 ` を生成する時に必要なメタデータと必須ソースコードを提供する、" -"(通常は ``python -m build --sdist`` を使って生成される) :term:`配布物 " -"` フォーマット 。" +":ref:`pip` のようなツールによるインストールや :term:`ビルド済配布物 ` の生成のために必要となるメタデータや基本的なソースコードファイ" +"ル群を提供する :term:`配布物 ` フォーマット (通常は " +"``python -m build --sdist`` を使って生成されます) 。もっと情報が欲しけれ" +"ば、 :ref:`パッケージフォーマット ` を見てください。" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:245 ../source/glossary.rst:338 msgid "System Package" msgstr "システムパッケージ" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:248 ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." @@ -3523,11 +3538,11 @@ msgstr "" "rpmやdpkgのように、オペレーティングシステムに固有のフォーマットで提供される" "パッケージ。" -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:251 ../source/glossary.rst:344 msgid "Version Specifier" msgstr "バージョン指定子" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:254 ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -3542,11 +3557,11 @@ msgstr "" "の仕様のサポートは、 :ref:`setuptools` v8.0 と :ref:`pip` v6.0 で実装されまし" "た。" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:259 ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "仮想環境" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:262 ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -3558,7 +3573,7 @@ msgstr "" "環境の生成と使用 ` フォーマット。更なる情報" +"が知りたければ :ref:`パッケージフォーマット ` を見てくださ" +"い。" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:271 ../source/glossary.rst:376 msgid "Working Set" msgstr "動作可能セット" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:274 ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -15762,6 +15780,7 @@ msgstr "" #: ../source/specifications/version-specifiers.rst:1264 #: ../source/specifications/virtual-environments.rst:54 #: ../source/specifications/pyproject-toml.rst:443 +#: ../source/specifications/inline-script-metadata.rst:213 msgid "History" msgstr "歴史" @@ -17071,6 +17090,7 @@ msgstr "" #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 #: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "仕様" @@ -17877,16 +17897,17 @@ msgstr "" "ものでなければなりません。" #: ../source/specifications/direct-url-data-structure.rst:61 -#, fuzzy msgid "" "A ``requested_revision`` key (type ``string``) MAY be present naming a " "branch/tag/ref/commit/revision/etc (in a format compatible with the VCS). " "This field MUST match the revision requested by the user and MUST NOT exist " "when the user did not select a specific revision." msgstr "" -"``requested_revision`` キー (``string`` 型) は、どのブランチ・タグ・リファレ" -"ンス・コミット・リビジョンその他をインストールするのかを指定するために存在し" -"ていても構いません。" +"``requested_revision`` キー (``string`` 型) は、 (VCS と互換性のあるフォー" +"マットであれば) どのブランチ・タグ・リファレンス・コミット・リビジョンその他" +"を指定するために存在していても構いません。このフィールドは、ユーザが要求する" +"リビジョンに合致しなければなりませんし、ユーザが特定のリビジョンを選択してい" +"ない場合には存在してはなりません。" #: ../source/specifications/direct-url-data-structure.rst:65 msgid "" @@ -18753,11 +18774,16 @@ msgid "" "on Conda-created environments, most of the concerns in this document do not " "apply to ``conda`` when acting as a Python-specific package manager.)" msgstr "" +"(Conda_ は少々特別なケースです、というのは、 `conda` コマンドを使えば単に " +"Python パッケージだけではなくずっと多くのものをインストールすることができるか" +"らで、いくつかの意味ではディストロ 付属のパッケージマネージャにもっ" +"と似ていると言えるでしょう。 ``conda`` コマンドは一般的には Conda が作成した" +"環境の上でのみ動作するので、Python 特有のパッケージマネージャとして動作する場" +"合には、この説明文書における関心のほとんどは ``conda`` には適用されません。)" #: ../source/specifications/externally-managed-environments.rst:118 -#, fuzzy msgid "distro package manager" -msgstr "macOS インストーラとパッケージマネージャ" +msgstr "ディストロ パッケージマネージャ" #: ../source/specifications/externally-managed-environments.rst:105 msgid "" @@ -18771,6 +18797,17 @@ msgid "" "upgrading it in a way that would satisfy a Python-specific package manager " "will generally leave a distro package manager in an inconsistent state." msgstr "" +"当該ディストロのインストール済みインスタンス内でディストロ提供のパッケージを" +"インストール・更新・削除するためのツールで、 Python パッケージか非 Python " +"パッケージかに依らずインストールする能力を持つものであり、従って、一般的にそ" +"のツールに特有のインストール済みソフトウェアのデータベースで :ref:`インストー" +"ル済み配布物のデータベース ` とは無関係のものを" +"持つもの。例には ``apt`` ・ ``dpkg`` ・ ``def`` ・ ``rpm`` ・ ``pacman`` ・ " +"``brew`` を含みます。顕著な特徴としては、あるパッケージがディストロのパッケー" +"ジマネージャによってインストールされていた場合に、 Python 特有のパッケージマ" +"ネージャを満足させる方法でそのパッケージを削除したり更新したりすることが、一" +"般にディストロのパッケージマネージャの状態を不整合なまま放置するであろうとい" +"うことです。" #: ../source/specifications/externally-managed-environments.rst:117 msgid "" @@ -18778,10 +18815,14 @@ msgid "" "\"system's package manager\" to refer to a distro package manager in certain " "contexts." msgstr "" +"この説明文書は、また、ある種の文脈ではディストロのパッケージマネージャのこと" +"を指し示すのに \"外部パッケージマネージャ \" や " +"\"システムのパッケージマネージャ \" のような言い回" +"しを用います。" #: ../source/specifications/externally-managed-environments.rst:127 msgid "shadow" -msgstr "" +msgstr "シャドー " #: ../source/specifications/externally-managed-environments.rst:121 msgid "" @@ -18792,11 +18833,17 @@ msgid "" "``a.py`` in a later ``sys.path`` entry, then ``import a`` returns the module " "from the former, and we say that A 2.0 shadows A 1.0." msgstr "" +"インストール済みの Python パッケージをシャドー するというのは、シャ" +"ドーされたパッケージに由来するファイルをひとつも削除することなしに、インポー" +"ト時に別のパッケージを選好させることです。これは ``sys.path`` に複数のエント" +"リーを要求します: パッケージ A 2.0 がある ``sys.path`` エントリに ``a.py`` モ" +"ジュールをインストールし、かつ、パッケージ A 1.0 が ``a.py`` モジュールを後続" +"の ``sys.path`` エントリにインストールしている時に、 ``import a`` が前者のモ" +"ジュールを返し、これを A 2.0 が A 1.0 をシャドーしたと言います。" #: ../source/specifications/externally-managed-environments.rst:132 -#, fuzzy msgid "This specification is twofold." -msgstr "PyPA 仕様" +msgstr "この仕様には二つの部分があります。" #: ../source/specifications/externally-managed-environments.rst:134 msgid "" @@ -18808,6 +18855,14 @@ msgid "" "provides a means for the distributor to indicate how to use a virtual " "environment as an alternative." msgstr "" +"第一に、 ** Python インタープリタの配布を行う者が、そのインタープリタを\n" +"Python の外側にある手段によって管理されるパッケージを持ち、従って、 pip のよ" +"うな Python 特有のツール類が、特別にオーバーライドされない限りは、当該イン" +"タープリタのグローバルな ``sys.path`` に存在するインストール済みパッケージ" +"を、いかなる意味でも変更するべきではないもの、つまり追加、更新・ダウングレー" +"ド、あるいは削除を行うべきではないものとしてマークを付ける方法 ** を記述しま" +"す。また、代替手段としての仮想環境をどのように使うのかを配布者 " +"が指示する手段を提供します。" #: ../source/specifications/externally-managed-environments.rst:142 msgid "" @@ -18816,6 +18871,10 @@ msgid "" "with a self-compiled interpreter, or with a distro that has not explicitly " "marked its interpreter, will work as it always has worked." msgstr "" +"これは、オプトインのメカニズムです: デフォルトでは、アップストリームのソース" +"からコンパイルされた Python インタープリタは、そのようにマークを付けられるこ" +"とはなく、また、セルフコンパイルされたインタープリタやディストロのものを使っ" +"て ``pip install`` を実行すると、それまでと同様に動作するはずです。" #: ../source/specifications/externally-managed-environments.rst:148 msgid "" @@ -18829,10 +18888,23 @@ msgid "" "packages will not delete (or overwrite) files owned by the external package " "manager." msgstr "" +"第二に、パッケージをインタープリタのグローバルコンテキスト (マークされていな" +"いインタープリタの場合やマークをオーバーライドした場合) にインストールする際" +"に、 ** Python 特有のパッケージマネージャが修正・削除しても構わないのは、今ま" +"さにファイル群を作成しようとしている sysconfig スキームのディレクトリ内にある" +"ものだけである ** というルールを設定します。これによって、 Python インタープ" +"リタの配布者 がふたつのディレクトリをセットアップすることを許" +"し、つまり、一つは自分で管理しているパッケージ群 (のためのディレクトリ) でも" +"う一つはエンドユーザがインストールした管理対象外のパッケージ群 (のためのディ" +"レクトリ) で、管理対象外のパッケージをインストールしたとしても外部パッケージ" +"マネージャ が管理しているファイル群が削除 (または" +"上書き) されることがないことを保証します。" #: ../source/specifications/externally-managed-environments.rst:160 msgid "Marking an interpreter as using an external package manager" msgstr "" +"外部パッケージマネージャ を用いるものとしてイン" +"タープリタにマークを付ける" #: ../source/specifications/externally-managed-environments.rst:162 msgid "" @@ -18840,18 +18912,25 @@ msgid "" "not an external tool such as apt) installs a package into a certain Python " "context, it should make the following checks by default:" msgstr "" +"Python 特有のパッケージインストーラ (つまり pip のようなツール - apt のような" +"外部ツールではない) がある Python コンテキストにパッケージをインストールする" +"前に、デフォルトで以下の項目を確認するべきです:" #: ../source/specifications/externally-managed-environments.rst:167 msgid "" "Is it running outside of a virtual environment? It can determine this by " "whether ``sys.prefix == sys.base_prefix``." msgstr "" +"仮想環境の外側で動作しているのか？ ``sys.prefix == sys.base_prefix`` が成立す" +"るか否かで判断することができます。" #: ../source/specifications/externally-managed-environments.rst:170 msgid "" "Is there an ``EXTERNALLY-MANAGED`` file in the directory identified by " "``sysconfig.get_path(\"stdlib\", sysconfig.get_default_scheme())``?" msgstr "" +"``sysconfig.get_path(\"stdlib\", sysconfig.get_default_scheme())`` で同定され" +"るディレクトリの中に ``EXTERNALLY-MANAGED`` ファイルが存在するか否か？" #: ../source/specifications/externally-managed-environments.rst:173 msgid "" @@ -18859,6 +18938,9 @@ msgid "" "error message indicating that package installation into this Python " "interpreter's directory are disabled outside of a virtual environment." msgstr "" +"両方の条件が真であれば、仮想環境の外側ではこの Python インタープリタのディレ" +"クトリへパッケージをインストールすることが無効にされていることを示すエラー" +"メッセージとともに、インストーラは終了するべきです。" #: ../source/specifications/externally-managed-environments.rst:177 msgid "" @@ -18867,6 +18949,10 @@ msgid "" "be enabled by default and should carry some connotation that its use is " "risky." msgstr "" +"インストーラは、コマンドライン上の ``--break-system-packages`` フラグのよう" +"に、ユーザがこれらのルールをオーバーライドする方法を持っているべきです。この" +"オプションはデフォルトでは無効であるべきで、有効にするとリスクを伴うことを含" +"意する何らかのメッセージを伴うべきです。" #: ../source/specifications/externally-managed-environments.rst:182 msgid "" @@ -18884,6 +18970,19 @@ msgid "" "underscore or hyphen. If it cannot find either of those, or if the language " "code is ``None``, it should look for a key simply named ``Error``." msgstr "" +"``EXTERNALLY-MANAGED`` ファイルは INI スタイルのメタデータファイルで、標準ラ" +"イブラリの configparser_ モジュールでパースできることを意図しています。この" +"ファイルが UTF-8 エンコーディングを用いて ``configparser." +"ConfigParser(interpolation=None)`` によってパースできて、かつ、ファイル内に " +"``[externally-managed]`` セクションがあれば、インストーラはこのファイル内で指" +"定されたエラーメッセージを探して、エラーの一部として出力するべきです。 " +"``locale.getlocale(locale.LC_MESSAGES)`` によって返されるタプルの最初の要素" +"が ``None`` ではない場合には、 ``Error-`` の後に言語コードが続く名前を持つ" +"キーの値として提供されるエラーメッセージを探すべきです。そのようなキーが存在" +"しない場合でも、言語コードがアンダースコアかハイフンを含むのであれば、 " +"``Error-`` の後に言語コードのアンダースコアかハイフンの前までの部分が続くキー" +"を探すべきです。これらのいずれも発見できない場合や、言語コードが ``None`` の" +"場合には、単に ``Error`` というキーを探すべきです。" #: ../source/specifications/externally-managed-environments.rst:200 msgid "" @@ -18893,6 +18992,11 @@ msgid "" "should suggest that the user create a virtual environment to install " "packages." msgstr "" +"インストーラがファイル内のエラーメッセージを見つけられない (ファイルをパース" +"できないか、適切なエラーキーが存在しないのいずれか) 時は、インストーラは自身" +"の内部に予め定義されたエラーメッセージ、それは当該パッケージをインストールす" +"るためにユーザが仮想環境を作成することを示唆するものであるべきですが、それを" +"使うべきです。" #: ../source/specifications/externally-managed-environments.rst:206 msgid "" @@ -18901,13 +19005,16 @@ msgid "" "general, ship a ``EXTERNALLY-MANAGED`` file in their standard library " "directory. For instance, Debian may ship a file in ``/usr/lib/python3.9/" "EXTERNALLY-MANAGED`` consisting of something like" -msgstr "" +msgstr "Python 特有のものではないパッケージマネージャを持つソフトウェア配布者" #: ../source/specifications/externally-managed-environments.rst:230 msgid "" "which provides useful and distro-relevant information to a user trying to " "install a package. Optionally, translations can be provided in the same file:" msgstr "" +"パッケージのインストールを試みるユーザ向けに役に立つとともにディストロに適合" +"した情報を適合すること。オプションとして、同一ファイル内に提供されるトランザ" +"クション:" #: ../source/specifications/externally-managed-environments.rst:240 msgid "" @@ -18916,10 +19023,15 @@ msgid "" "MANAGED`` file, so that users can install whatever they like (as they can " "today) without having to manually override this rule." msgstr "" +"作成後には更新できない単一アプリケーションのコンテナイメージのようなある種の" +"コンテキストでは、配布者 は、このルールを手動でオーバーライドせ" +"ざるを得ないということがなくてもユーザが何であれ彼らの望むものを (その時に) " +"インストールできるように、 ``EXTERNALLY-MANAGED`` ファイルを同梱しない選択を" +"行っても構いません。" #: ../source/specifications/externally-managed-environments.rst:247 msgid "Writing to only the target ``sysconfig`` scheme" -msgstr "" +msgstr "ターゲットとなる ``sysconfig`` スキームだけを書く" #: ../source/specifications/externally-managed-environments.rst:249 msgid "" @@ -18928,6 +19040,11 @@ msgid "" "the scheme returned by ``sysconfig.get_default_scheme()``, but based on " "configuration (e.g. ``pip install --user``), it may use a different scheme." msgstr "" +"通常は、 Python パッケージインストーラは、標準ライブラリパッケージの " +"``sysconfig`` によって返されるスキームにあるディレクトリへインストールを行い" +"ます。普通は、これは、 ``sysconfig.get_default_scheme()`` が返すスキームのこ" +"とですが、設定 (例えば ``pip install --user``) に基づいて異なるスキームを用い" +"ることもあります。" #: ../source/specifications/externally-managed-environments.rst:255 msgid "" @@ -18938,43 +19055,58 @@ msgid "" "in a directory from another scheme), it should leave the existing files " "alone." msgstr "" +"インストーラが ``sysconfig`` スキームへインストールする時はいつでも、そのス" +"キームの外側のファイルをインストーラが決して変更したり削除したりするべきでは" +"ないことをこの仕様が宣言しています。例えば、パッケージのアップグレードを行う" +"時にそのパッケージがスキームの外側のディレクトリ (おそらく別のスキームのも" +"の) にすでにインストールされているなら、既存のファイル群をそのままにしておく" +"べきです。" #: ../source/specifications/externally-managed-environments.rst:262 msgid "" "If the installer does end up shadowing an existing installation during an " "upgrade, we recommend that it produces a warning at the end of its run." msgstr "" +"もし、アップグレードの最中にインストーラが既存のインストール (済のファイル" +"群) をシャドーしてしまうのであれば、警告を生成して実行を中止することを推奨し" +"ます。" #: ../source/specifications/externally-managed-environments.rst:266 msgid "" "If the installer is installing to a location outside of a ``sysconfig`` " "scheme (e.g., ``pip install --target``), then this subsection does not apply." msgstr "" +"インストーラが ``sysconfig`` スキームの外側の場所 (即ち ``pip install --" +"target``) へインストールしようとしているなら、このサブセクションは適用されま" +"せん。" #: ../source/specifications/externally-managed-environments.rst:271 msgid "Recommendations for distros" -msgstr "" +msgstr "ディストロへの推奨" #: ../source/specifications/externally-managed-environments.rst:273 msgid "" "This section is non-normative. It provides best practices we believe distros " "should follow unless they have a specific reason otherwise." msgstr "" +"この節は規範的なものではありません。特に他の理由がなければディストロが従うべ" +"きであると信じられるベストプラクティスを提供するものです。" #: ../source/specifications/externally-managed-environments.rst:277 msgid "Mark the installation as externally managed" -msgstr "" +msgstr "インストールされたものを外部管理のものとしてマークする" #: ../source/specifications/externally-managed-environments.rst:279 msgid "" "Distros should create an ``EXTERNALLY-MANAGED`` file in their ``stdlib`` " "directory." msgstr "" +"ディストロは、その ``stdlib`` ディレクトリ内に ``EXTERNALLY-MANAGED`` ファイ" +"ルを作成するべきです。" #: ../source/specifications/externally-managed-environments.rst:283 -#, fuzzy msgid "Guide users towards virtual environments" -msgstr "仮想環境のランタイムを識別する" +msgstr "仮想環境へ向かうユーザへのガイド文書" #: ../source/specifications/externally-managed-environments.rst:285 msgid "" @@ -18986,6 +19118,13 @@ msgid "" "venv`` does not work, the message should indicate clearly how to make " "``python3 -m venv`` work properly." msgstr "" +"このファイルは、ディストロのパッケージマネージャを使ってシステムワイドのパッ" +"ケージをインストールする方法と仮想鑑賞を構築する方法の両方を示す、役に立ち、" +"かつ、ディストロに適合したエラーメッセージを含んでいるべきです。もし、その" +"ディストロが ``python3`` コマンドは利用できる (かつ、とりわけ ``pip`` か " +"``get-pip`` が利用できる) が、 ``python3 -m venv`` は動作しない状態で使われる" +"ことが多いのであれば、当該メッセージは、 ``python3 -m venv`` を正しく動作させ" +"るにはどうすれば良いかをはっきりと示すべきです。" #: ../source/specifications/externally-managed-environments.rst:293 msgid "" @@ -19000,10 +19139,22 @@ msgid "" "for Python for end users (e.g., ``python3`` on Fedora or ``python3-full`` on " "Debian) depends on pipx." msgstr "" +"Python 言語で書かれたアプリケーションをインストールするツールである " +"packaging pipx_ を採用して、エラーの中で示唆することを検討してください。 " +"pipx はそのアプリケーションだけのための仮想環境を自動的に構築しますし、何らか" +"の Python 言語で書かれたソフトウェア (であって、ディストロ側では利用可能では" +"ないもの) をインストールしたいけれども自身は Python ユーザではないエンドユー" +"ザにとってはずっと良いデフォルト動作です。 Packaging pipx がディストロ側で準" +"備されていれば、システム側のパッケージ群を破壊することを *避ける* ために " +"``pip install --user --break-system-packages pipx`` を使うようにユーザに指示" +"すると言う皮肉を避けることができます。このように整えることで、ディストロ側" +"パッケージとエンドユーザ用 Python 環境 (例えば、 Fedora での ``python3`` や " +"Debian での ``python3-full`` ) がともに pipx に依存するようにすることができま" +"す。" #: ../source/specifications/externally-managed-environments.rst:308 msgid "Keep the marker file in container images" -msgstr "" +msgstr "コンテナイメージ内のマーカーファイルを維持する" #: ../source/specifications/externally-managed-environments.rst:310 msgid "" @@ -19237,11 +19388,13 @@ msgstr "" "ます。" #: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 #, fuzzy msgid "Inline script metadata" msgstr "プロジェクトのメタデータを宣言する" #: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " @@ -19249,12 +19402,14 @@ msgid "" msgstr "" #: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" #: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -19266,6 +19421,7 @@ msgid "" msgstr "" #: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -19276,6 +19432,7 @@ msgid "" msgstr "" #: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " @@ -19283,6 +19440,7 @@ msgid "" msgstr "" #: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " @@ -19290,12 +19448,14 @@ msgid "" msgstr "" #: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" #: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " @@ -19303,40 +19463,47 @@ msgid "" msgstr "" #: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" #: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" #: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" #: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" #: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" #: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" #: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " @@ -19344,10 +19511,12 @@ msgid "" msgstr "" #: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" #: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " @@ -19355,6 +19524,7 @@ msgid "" msgstr "" #: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" @@ -19362,6 +19532,7 @@ msgid "" msgstr "" #: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " @@ -19369,25 +19540,30 @@ msgid "" msgstr "" #: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 msgid "Example" msgstr "例" #: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" #: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 #, fuzzy msgid "Reference Implementation" msgstr "文書の類型" #: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" #: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " @@ -19395,6 +19571,7 @@ msgid "" msgstr "" #: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " @@ -19402,6 +19579,7 @@ msgid "" msgstr "" #: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." @@ -19409,11 +19587,13 @@ msgstr "" #: ../source/specifications/inline-script-metadata.rst:203 #: ../source/specifications/simple-repository-api.rst:815 +#: ../source/specifications/inline-script-metadata.rst:205 #, fuzzy msgid "Recommendations" msgstr "オススメのツール" #: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " @@ -19421,12 +19601,14 @@ msgid "" msgstr "" #: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" #: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " @@ -19537,8 +19719,8 @@ msgid "" "which distributions are compatible with the system they are running on." msgstr "" "プラットフォーム相互互換性タグは、特定のプラットフォームと互換であるとビルド" -"ツールが配布物に印を付けることができるようにし、インストーラが自身が動作して" -"いるシステムと互換であるのはどの配布物であるかを理解できるようにします。" +"ツールが配布物にマークを付けることができるようにし、インストーラが自身が動作" +"しているシステムと互換であるのはどの配布物であるかを理解できるようにします。" #: ../source/specifications/platform-compatibility-tags.rst:16 msgid "The tag format is ``{python tag}-{abi tag}-{platform tag}``." @@ -27009,6 +27191,230 @@ msgid "" "includes multiple lines." msgstr "" +#: ../source/glossary.rst:56 +msgid "Built Metadata" +msgstr "ビルドされたメタデータ" + +#: ../source/glossary.rst:59 +msgid "" +"The concrete form :term:`Core Metadata` takes when included inside an " +"installed :term:`Project` (``METADATA`` file) or a :term:`Distribution " +"Archive` (``PKG-INFO`` in a :term:`Sdist ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" +"インストールされた :term:`プロジェクト ` (``METADATA`` ファイル) " +"や :term:`配布物アーカイブ ` (:term:`Sdist ` の中の ``PKG-INFO`` や :term:`Wheel` 内の " +"``METADATA``) の内部に含まれる場合に :term:`コアとなるメタデータ ` が具体的な形式を取ることになります。" + +#: ../source/glossary.rst:66 +msgid "Core Metadata" +msgstr "コアとなるメタデータ" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" +":ref:`仕様 ` および :term:`コアとなるメタデータのフィールド " +"` あるいは :term:`インストール済みのプロジェクト ` の鍵となる静的なアトリビュートを記述するものを定義しています。" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "コアとなるメタデータのフィールド" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" +":term:`コアとなるメタデータ ` の仕様の中で定義され、 :term:`ビ" +"ルド済みのメタデータ ` の中に保存される、単一のキー・バリュー" +"ペア (または、複数の使用方法のあるフィールドについては、一連の同名のキー・バ" +"リューペア)。特筆すべきことに、 :term:`Pyproject メタデータキー ` とは区別される。" + +#: ../source/glossary.rst:83 +msgid "Distribution Archive" +msgstr "配布物アーカイブ" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" +":term:`配布パッケージ ` のための物理的な配布物のアー" +"ティファクト (即ち、ディスク上のファイル)。" + +#: ../source/glossary.rst:142 +msgid "Installed Project" +msgstr "インストール済みのプロジェクト" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" +":ref:`インストール済みパッケージを記録する ` の" +"仕様の中に記述されているところの、Python インタープリタまたは :term:`仮想環" +"境 ` とともに用いられるべくインストールされた :term:`プ" +"ロジェクト `。" + +#: ../source/glossary.rst:192 +msgid "Project Root Directory" +msgstr "プロジェクトのルートディレクトリ" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" +":term:`プロジェクト ` の :term:`ソースコードツリー ` が位置するファイルシステム上のディレクトリ。" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "プロジェクトソースコードツリー" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" +":term:`ソースコード配布物 ` や :term:`ビ" +"ルド済配布物 ` にパッケージされる前の生のソースコードを含" +"んだ、開発に使われる :term:`プロジェクト ` のディスク上でのフォー" +"マット。" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "プロジェクトソースのメタデータ" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" +":term:`プロジェクト ` の :term:`ソースコードツリー ` 内でパッケージ作者が定義したメタデータで、プロジェクトの :term:`" +"ビルドバックエンド ` が :term:`ビルド済メタデータ ` 内の :term:`コアとなるメタデータのフィールド ` " +"の形か、ツール特有のフォーマット (``pyproject.toml`` 内の ``[tool]`` " +"テーブル、または、ツール独自の設定ファイル) で書くことができます。" + +#: ../source/glossary.rst:226 +msgid "Pyproject Metadata" +msgstr "Pyproject のメタデータ" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" +"ref:`プロジェクトのメタデータを宣言する ` " +"の仕様で定義されており、 :pep:`621` で初めて登場した :term:`" +"プロジェクトソースのメタデータ ` のフォーマットで、 " +":term:`pyproject.toml` ファイルの ``[project]`` テーブルの下の :term:`" +"プロジェクトソースのメタデータ ` " +"として格納されるもの。 ``pyproject.toml`` 内の ``[tool]`` " +"テーブルの下にあるツール特有のソースメタデータでは *ない* ということに注意。" + +#: ../source/glossary.rst:237 +msgid "Pyproject Metadata Key" +msgstr "Pyproject のメタデータキー" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" +"``pyproject.toml`` 内の ``[project]`` テーブルの中にあるトップレベルの TOML " +"キー; :term:`Pyproject のメタデータ ` の一部。 :term:`" +"コアとなるメタデータのフィールド ` " +"のテーブルの値の下にある第２層の TOML キー。" + +#: ../source/glossary.rst:332 +msgid "" +"A :term:`distribution ` format (usually generated " +"using ``python -m build --sdist``) that provides metadata and the essential " +"source files needed for installing by a tool like :ref:`pip`, or for " +"generating a :term:`Built Distribution`. See :ref:`package-formats` for more " +"information." +msgstr "" +":ref:`pip` のようなツールによるインストールや :term:`ビルド済配布物 ` " +"の生成のために必要となるメタデータや必須のソースファイルを提供する :term:`" +"配布物 アーカイブ ` フォーマット (通常は ``python -m " +"build --sdist`` を使って生成されます) 。もっと情報が欲しければ、 :ref:`" +"パッケージフォーマット ` を見てください。" + +#: ../source/glossary.rst:360 +msgid "Wheel Format" +msgstr "Wheel フォーマット" + +#: ../source/glossary.rst:364 +msgid "" +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." +msgstr "" +"標準的な :term:`ビルド済配布物 ` フォーマットで、当初は " +":pep:`427` で導入され、 :ref:`バイナリ配布物のフォーマット ` 仕様で定義されたもの。詳しくは :ref:`" +"パッケージフォーマット ` を見てください。参照実装である " +":term:`Wheel プロジェクト ` と混同しないように。" + +#: ../source/glossary.rst:371 +msgid "Wheel Project" +msgstr "Wheel プロジェクト" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr ":term:`Wheel フォーマット ` の PyPA による参照実装; " +":ref:`wheel` 参照。" + +#: ../source/glossary.rst:17 +msgid "" +"A library that takes a source tree and builds a :term:`source distribution " +"` or :term:`built distribution ` from it. The build is delegated to the backend by a :term:" +"`frontend `. All backends offer a standardized interface." +msgstr "" +"ソースコードツリーを受け取って、そこから :term:`ソースコード配布物 ` や :term:`ビルド済配布物 ` " +"をビルドするライブラリ。ビルドの作業は、 :term:`フロントエンド ` によってバックエンドに委任されます。" + #~ msgid "Wheel vs Egg" #~ msgstr "Wheel対Egg" From f047cc8eb3dd976e08af455595fbeea6ea47a445 Mon Sep 17 00:00:00 2001 From: gfbdrgng Date: Mon, 20 May 2024 09:01:59 +0000 Subject: [PATCH 3/4] Translated using Weblate (Russian) Currently translated at 87.0% (3012 of 3462 strings) Co-authored-by: gfbdrgng Translate-URL: https://hosted.weblate.org/projects/pypa/packaging-python-org/ru/ Translation: pypa/packaging.python.org --- locales/ru/LC_MESSAGES/messages.po | 64 +++++++++--------------------- 1 file changed, 19 insertions(+), 45 deletions(-) diff --git a/locales/ru/LC_MESSAGES/messages.po b/locales/ru/LC_MESSAGES/messages.po index 714a111aa..8db3b5072 100644 --- a/locales/ru/LC_MESSAGES/messages.po +++ b/locales/ru/LC_MESSAGES/messages.po @@ -14,17 +14,17 @@ msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2024-04-18 14:36+0000\n" -"PO-Revision-Date: 2024-03-31 15:01+0000\n" -"Last-Translator: Nikita \n" -"Language-Team: Russian \n" +"PO-Revision-Date: 2024-04-28 16:07+0000\n" +"Last-Translator: gfbdrgng \n" +"Language-Team: Russian \n" "Language: ru\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && " "n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);\n" -"X-Generator: Weblate 5.5-dev\n" +"X-Generator: Weblate 5.5.1\n" #: ../source/contribute.rst:5 msgid "Contribute to this guide" @@ -1351,10 +1351,8 @@ msgid "" msgstr "" #: ../source/discussions/package-formats.rst:138 -#, fuzzy -#| msgid "What about..." msgid "What about eggs?" -msgstr "Как насчёт..." +msgstr "А как насчет яиц?" #: ../source/discussions/package-formats.rst:140 msgid "" @@ -2259,13 +2257,6 @@ msgid "Valid version numbers" msgstr "Метки версий на базе DVCS" #: ../source/discussions/versioning.rst:14 -#, fuzzy -#| msgid "" -#| "Different Python projects may use different versioning schemes based on " -#| "the needs of that particular project, but all of them are required to " -#| "comply with the flexible :pep:`public version scheme <440#public-version-" -#| "identifiers>` specified in :pep:`440` in order to be supported in tools " -#| "and libraries like ``pip`` and ``setuptools``." msgid "" "Different Python projects may use different versioning schemes based on the " "needs of that particular project, but in order to be compatible with tools " @@ -2274,11 +2265,12 @@ msgid "" "`specification of version specifiers `. Here are some " "examples of version numbers [#version-examples]_:" msgstr "" -"Разные проекты Python могут использовать различные схемы версионирования в " -"зависимости от потребностей конкретного проекта, но все они должны " -"соответствовать гибкой схеме :pep:`public version scheme <440#public-version-" -"identifiers>`, указанной в :pep:`440`, чтобы поддерживаться в таких " -"инструментах и библиотеках, как ``pip`` и ``setuptools``." +"Различные Python-проекты могут использовать различные схемы версионирования " +"в зависимости от потребностей конкретного проекта, но для совместимости с " +"такими инструментами, как :ref:`pip`, все они должны соответствовать гибкому " +"формату идентификаторов версий, для которого авторитетной ссылкой является " +":ref:`specification of version specifiers `. Вот " +"несколько примеров номеров версий [#version-examples]_:" #: ../source/discussions/versioning.rst:21 msgid "A simple version (final release): ``1.2.0``" @@ -3095,20 +3087,12 @@ msgid "Egg" msgstr "Яйцо" #: ../source/glossary.rst:75 -#, fuzzy -#| msgid "" -#| "A :term:`Built Distribution` format introduced by :ref:`setuptools`, " -#| "which is being replaced by :term:`Wheel`. For details, see :doc:`The " -#| "Internal Structure of Python Eggs ` " -#| "and `Python Eggs `_" msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -"Формат :term:`Built Distribution`, введенный :ref:`setuptools`, который " -"заменяется :term:`Wheel`. Подробности см. в :doc:`Внутренняя структура " -"Python Eggs ` и `Python Eggs `_" +"Формат :term:`Built Distribution`, введенный :ref:`setuptools`, который был " +"заменен :term:`Wheel`. Подробности см. в :ref:`egg-format`." #: ../source/glossary.rst:78 msgid "Extension Module" @@ -5852,10 +5836,8 @@ msgid "There are multiple classes of options in this area:" msgstr "" #: ../source/guides/index-mirrors-and-caches.rst:17 -#, fuzzy -#| msgid "Using other package indexes" msgid "local/hosted caching of package indexes." -msgstr "Использование других индексов пакетов" +msgstr "локальное/хостинговое кэширование индексов пакетов." #: ../source/guides/index-mirrors-and-caches.rst:19 msgid "" @@ -10640,7 +10622,7 @@ msgstr "" #, fuzzy #| msgid ":doc:`Docs `" msgid ":doc:`tox `." -msgstr ":doc:`Документы `" +msgstr ":doc:`tox `." #: ../source/guides/using-manifest-in.rst:5 msgid "Including files in source distributions with ``MANIFEST.in``" @@ -22658,10 +22640,8 @@ msgstr "" #: ../source/specifications/simple-repository-api.rst:393 #: ../source/specifications/simple-repository-api.rst:499 -#, fuzzy -#| msgid "A full example" msgid "As an example:" -msgstr "Полный пример" +msgstr "В качестве примера:" #: ../source/specifications/simple-repository-api.rst:410 msgid "" @@ -23527,18 +23507,12 @@ msgid "" msgstr "" #: ../source/specifications/simple-repository-api.rst:987 -#, fuzzy -#| msgid "" -#| "The JSON format is defined in :pep:`691`, with additional fields added " -#| "in :pep:`700`, and revisions around providing package metadata " -#| "independently from a package in :pep:`714`." msgid "" "June 2023: renaming the field which provides package metadata independently " "from a package, in :pep:`714`" msgstr "" -"Формат JSON определен в :pep:`691`, дополнительные поля добавлены в :pep:" -"`700`, а изменения, связанные с предоставлением метаданных пакета независимо " -"от пакета, - в :pep:`714`." +"Июнь 2023: переименование поля, предоставляющего метаданные пакета " +"независимо от пакета, в :pep:`714`" #: ../source/specifications/source-distribution-format.rst:6 msgid "Source distribution format" From 17afa4ad3f756d3d72953efddd66c5618d12d5a3 Mon Sep 17 00:00:00 2001 From: Hosted Weblate Date: Mon, 20 May 2024 09:02:03 +0000 Subject: [PATCH 4/4] Update translation files Updated by "Update PO files to match POT (msgmerge)" hook in Weblate. Update translation files Updated by "Update PO files to match POT (msgmerge)" hook in Weblate. Update translation files Updated by "Update PO files to match POT (msgmerge)" hook in Weblate. Co-authored-by: Hosted Weblate Translate-URL: https://hosted.weblate.org/projects/pypa/packaging-python-org/ Translation: pypa/packaging.python.org --- locales/ar/LC_MESSAGES/messages.po | 336 ++++++++++----- locales/ars/LC_MESSAGES/messages.po | 336 ++++++++++----- locales/de/LC_MESSAGES/messages.po | 348 +++++++++++----- locales/eo/LC_MESSAGES/messages.po | 355 +++++++++++----- locales/es/LC_MESSAGES/messages.po | 357 +++++++++++----- locales/fa/LC_MESSAGES/messages.po | 338 ++++++++++----- locales/fil/LC_MESSAGES/messages.po | 336 ++++++++++----- locales/fr/LC_MESSAGES/messages.po | 357 +++++++++++----- locales/frc/LC_MESSAGES/messages.po | 336 ++++++++++----- locales/gl/LC_MESSAGES/messages.po | 336 ++++++++++----- locales/hi/LC_MESSAGES/messages.po | 349 +++++++++++----- locales/id/LC_MESSAGES/messages.po | 338 ++++++++++----- locales/ko/LC_MESSAGES/messages.po | 346 ++++++++++----- locales/lzh/LC_MESSAGES/messages.po | 336 ++++++++++----- locales/mk/LC_MESSAGES/messages.po | 338 ++++++++++----- locales/pl/LC_MESSAGES/messages.po | 336 ++++++++++----- locales/pt_BR/LC_MESSAGES/messages.po | 532 ++++++++++++++++-------- locales/ro/LC_MESSAGES/messages.po | 338 ++++++++++----- locales/ru/LC_MESSAGES/messages.po | 383 ++++++++++++----- locales/sai/LC_MESSAGES/messages.po | 336 ++++++++++----- locales/si/LC_MESSAGES/messages.po | 336 ++++++++++----- locales/sk/LC_MESSAGES/messages.po | 355 +++++++++++----- locales/uk/LC_MESSAGES/messages.po | 355 +++++++++++----- locales/zh_Hans/LC_MESSAGES/messages.po | 355 +++++++++++----- locales/zh_Hant/LC_MESSAGES/messages.po | 348 +++++++++++----- 25 files changed, 6233 insertions(+), 2583 deletions(-) diff --git a/locales/ar/LC_MESSAGES/messages.po b/locales/ar/LC_MESSAGES/messages.po index c71213e52..7d3356bfb 100644 --- a/locales/ar/LC_MESSAGES/messages.po +++ b/locales/ar/LC_MESSAGES/messages.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-15 16:02+0000\n" "PO-Revision-Date: 2024-01-18 07:31+0000\n" "Last-Translator: Youcef Guenaoua \n" "Language-Team: Arabic ` and builds a source distribution or :term:" -"`wheel ` from it. The build is delegated to the backend by a :term:" +"A library that takes a source tree and builds a :term:`source distribution " +"` or :term:`built distribution ` from it. The build is delegated to the backend by a :term:" "`frontend `. All backends offer a standardized interface." msgstr "" @@ -2357,18 +2357,63 @@ msgid "" msgstr "" #: ../source/glossary.rst:56 -msgid "Distribution Package" +msgid "Built Metadata" msgstr "" #: ../source/glossary.rst:59 msgid "" +"The concrete form :term:`Core Metadata` takes when included inside an " +"installed :term:`Project` (``METADATA`` file) or a :term:`Distribution " +"Archive` (``PKG-INFO`` in a :term:`Sdist ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +msgid "Core Metadata" +msgstr "" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +msgid "Distribution Archive" +msgstr "" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 +msgid "Distribution Package" +msgstr "" + +#: ../source/glossary.rst:92 +msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " "to distribute a :term:`Release`. The archive file is what an end-user will " "download from the internet and install." msgstr "" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2380,21 +2425,21 @@ msgid "" "breakdown of the differences." msgstr "" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2403,11 +2448,11 @@ msgid "" "Python extensions on Windows, or a Java class file for Jython extensions." msgstr "" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2416,17 +2461,17 @@ msgid "" "distributions." msgstr "" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2435,50 +2480,61 @@ msgid "" "package` for a breakdown of the differences." msgstr "" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +msgid "Installed Project" +msgstr "" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." msgstr "" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." msgstr "" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " "dependencies of that project." msgstr "" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " "into a :term:`Distribution `." msgstr "" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2487,7 +2543,7 @@ msgid "" "`setup.cfg` file at the root of the project source directory." msgstr "" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2495,7 +2551,7 @@ msgid "" "`distributions `." msgstr "" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2503,21 +2559,89 @@ msgid "" "and have it provide a package importable only as 'bar'." msgstr "" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +msgid "Project Root Directory" +msgstr "" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." msgstr "" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +msgid "Pyproject Metadata" +msgstr "" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +msgid "Pyproject Metadata Key" +msgstr "" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2527,48 +2651,48 @@ msgid "" "`the Python Discourse forum `__." msgstr "" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " "distribute their distributions." msgstr "" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." "python.org``, in 2017. It is powered by :ref:`warehouse`." msgstr "" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." msgstr "" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2576,11 +2700,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2589,11 +2713,11 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2601,72 +2725,72 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " "on :ref:`pip:Requirements Files`." msgstr "" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." msgstr "" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." msgstr "" -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -2675,11 +2799,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -2687,21 +2811,37 @@ msgid "" "Environments`." msgstr "" -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +msgid "Wheel Format" +msgstr "" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +msgid "Wheel Project" +msgstr "" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -11802,7 +11942,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -12808,7 +12948,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "" @@ -14557,24 +14697,24 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 msgid "Inline script metadata" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -14585,7 +14725,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -14595,156 +14735,156 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 msgid "Example" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 msgid "Reference Implementation" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 msgid "Recommendations" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " diff --git a/locales/ars/LC_MESSAGES/messages.po b/locales/ars/LC_MESSAGES/messages.po index 71ad8243b..de7d607df 100644 --- a/locales/ars/LC_MESSAGES/messages.po +++ b/locales/ars/LC_MESSAGES/messages.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-15 16:02+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -2305,9 +2305,9 @@ msgstr "" #: ../source/glossary.rst:17 msgid "" -"A library that takes a source tree or :term:`source distribution ` and builds a source distribution or :term:" -"`wheel ` from it. The build is delegated to the backend by a :term:" +"A library that takes a source tree and builds a :term:`source distribution " +"` or :term:`built distribution ` from it. The build is delegated to the backend by a :term:" "`frontend `. All backends offer a standardized interface." msgstr "" @@ -2352,18 +2352,63 @@ msgid "" msgstr "" #: ../source/glossary.rst:56 -msgid "Distribution Package" +msgid "Built Metadata" msgstr "" #: ../source/glossary.rst:59 msgid "" +"The concrete form :term:`Core Metadata` takes when included inside an " +"installed :term:`Project` (``METADATA`` file) or a :term:`Distribution " +"Archive` (``PKG-INFO`` in a :term:`Sdist ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +msgid "Core Metadata" +msgstr "" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +msgid "Distribution Archive" +msgstr "" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 +msgid "Distribution Package" +msgstr "" + +#: ../source/glossary.rst:92 +msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " "to distribute a :term:`Release`. The archive file is what an end-user will " "download from the internet and install." msgstr "" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2375,21 +2420,21 @@ msgid "" "breakdown of the differences." msgstr "" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2398,11 +2443,11 @@ msgid "" "Python extensions on Windows, or a Java class file for Jython extensions." msgstr "" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2411,17 +2456,17 @@ msgid "" "distributions." msgstr "" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2430,50 +2475,61 @@ msgid "" "package` for a breakdown of the differences." msgstr "" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +msgid "Installed Project" +msgstr "" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." msgstr "" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." msgstr "" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " "dependencies of that project." msgstr "" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " "into a :term:`Distribution `." msgstr "" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2482,7 +2538,7 @@ msgid "" "`setup.cfg` file at the root of the project source directory." msgstr "" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2490,7 +2546,7 @@ msgid "" "`distributions `." msgstr "" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2498,21 +2554,89 @@ msgid "" "and have it provide a package importable only as 'bar'." msgstr "" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +msgid "Project Root Directory" +msgstr "" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." msgstr "" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +msgid "Pyproject Metadata" +msgstr "" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +msgid "Pyproject Metadata Key" +msgstr "" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2522,48 +2646,48 @@ msgid "" "`the Python Discourse forum `__." msgstr "" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " "distribute their distributions." msgstr "" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." "python.org``, in 2017. It is powered by :ref:`warehouse`." msgstr "" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." msgstr "" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2571,11 +2695,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2584,11 +2708,11 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2596,72 +2720,72 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " "on :ref:`pip:Requirements Files`." msgstr "" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." msgstr "" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." msgstr "" -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -2670,11 +2794,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -2682,21 +2806,37 @@ msgid "" "Environments`." msgstr "" -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +msgid "Wheel Format" +msgstr "" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +msgid "Wheel Project" +msgstr "" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -11797,7 +11937,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -12803,7 +12943,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "" @@ -14552,24 +14692,24 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 msgid "Inline script metadata" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -14580,7 +14720,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -14590,156 +14730,156 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 msgid "Example" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 msgid "Reference Implementation" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 msgid "Recommendations" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " diff --git a/locales/de/LC_MESSAGES/messages.po b/locales/de/LC_MESSAGES/messages.po index 6f5d6a300..aa9ff625f 100644 --- a/locales/de/LC_MESSAGES/messages.po +++ b/locales/de/LC_MESSAGES/messages.po @@ -11,11 +11,11 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-15 16:02+0000\n" "PO-Revision-Date: 2024-04-22 14:28+0000\n" "Last-Translator: Pixel-Master \n" -"Language-Team: German \n" +"Language-Team: German \n" "Language: de\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -129,8 +129,8 @@ msgstr "" "können ein gewisses Vorwissen annehmen. Sie sind ähnlich wie Tutorials, " "haben aber einen engen und klaren Fokus. Leitfäden können zusätzliche " "weiterführende Informationen bereitstellen, sofern diese benötigt werden. " -"Sie können auch mehrere Ansätze erläutern, um das gleiche Problem zu lösen. " -":doc:`example guide-style document `." +"Sie können auch mehrere Ansätze erläutern, um das gleiche Problem zu lösen. :" +"doc:`example guide-style document `." #: ../source/contribute.rst:60 ../source/discussions/index.rst:2 msgid "Discussions" @@ -2349,9 +2349,9 @@ msgstr "" #: ../source/glossary.rst:17 msgid "" -"A library that takes a source tree or :term:`source distribution ` and builds a source distribution or :term:" -"`wheel ` from it. The build is delegated to the backend by a :term:" +"A library that takes a source tree and builds a :term:`source distribution " +"` or :term:`built distribution ` from it. The build is delegated to the backend by a :term:" "`frontend `. All backends offer a standardized interface." msgstr "" @@ -2396,11 +2396,57 @@ msgid "" msgstr "" #: ../source/glossary.rst:56 +msgid "Built Metadata" +msgstr "" + +#: ../source/glossary.rst:59 +msgid "" +"The concrete form :term:`Core Metadata` takes when included inside an " +"installed :term:`Project` (``METADATA`` file) or a :term:`Distribution " +"Archive` (``PKG-INFO`` in a :term:`Sdist ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +msgid "Core Metadata" +msgstr "" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +#, fuzzy +msgid "Distribution Archive" +msgstr "Distributionspaket" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 #, fuzzy msgid "Distribution Package" msgstr "Distributionspaket" -#: ../source/glossary.rst:59 +#: ../source/glossary.rst:92 msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " @@ -2408,7 +2454,7 @@ msgid "" "download from the internet and install." msgstr "" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2420,21 +2466,21 @@ msgid "" "breakdown of the differences." msgstr "" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "Ei" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "Erweiterungsmodul" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2443,11 +2489,11 @@ msgid "" "Python extensions on Windows, or a Java class file for Jython extensions." msgstr "" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2456,17 +2502,17 @@ msgid "" "distributions." msgstr "" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "Paket importieren" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2475,50 +2521,62 @@ msgid "" "package` for a breakdown of the differences." msgstr "" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +#, fuzzy +msgid "Installed Project" +msgstr "Betreuer" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "Modul" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." msgstr "" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "Paketindex" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." msgstr "" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "Pro Projekt Index" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " "dependencies of that project." msgstr "" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " "into a :term:`Distribution `." msgstr "" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2527,7 +2585,7 @@ msgid "" "`setup.cfg` file at the root of the project source directory." msgstr "" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2535,7 +2593,7 @@ msgid "" "`distributions `." msgstr "" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2543,21 +2601,89 @@ msgid "" "and have it provide a package importable only as 'bar'." msgstr "" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +msgid "Project Root Directory" +msgstr "" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "Pures Modul" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." msgstr "" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +msgid "Pyproject Metadata" +msgstr "" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +msgid "Pyproject Metadata Key" +msgstr "" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2567,48 +2693,48 @@ msgid "" "`the Python Discourse forum `__." msgstr "" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " "distribute their distributions." msgstr "" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." "python.org``, in 2017. It is powered by :ref:`warehouse`." msgstr "" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." msgstr "" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2616,11 +2742,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2629,11 +2755,11 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2641,72 +2767,72 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " "on :ref:`pip:Requirements Files`." msgstr "" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." msgstr "" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "Quellenarchiv" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." msgstr "" -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -2715,11 +2841,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -2727,22 +2853,40 @@ msgid "" "Environments`." msgstr "" -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +msgid "Wheel Format" +msgstr "" + +#: ../source/glossary.rst:361 #, fuzzy msgid "Wheel" msgstr "Wheel" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +#, fuzzy +#| msgid "Per Project Index" +msgid "Wheel Project" +msgstr "Pro Projekt Index" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -11853,7 +11997,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -12859,7 +13003,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "" @@ -14612,24 +14756,24 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 msgid "Inline script metadata" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -14640,7 +14784,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -14650,158 +14794,158 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 msgid "Example" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 #, fuzzy #| msgid "Documentation types" msgid "Reference Implementation" msgstr "Dokumentationstypen" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 msgid "Recommendations" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " diff --git a/locales/eo/LC_MESSAGES/messages.po b/locales/eo/LC_MESSAGES/messages.po index 16396e41f..5e9a95224 100644 --- a/locales/eo/LC_MESSAGES/messages.po +++ b/locales/eo/LC_MESSAGES/messages.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-15 16:02+0000\n" "PO-Revision-Date: 2021-08-06 05:45+0000\n" "Last-Translator: meowmeowmeowcat \n" "Language-Team: Esperanto ` and builds a source distribution or :term:" -"`wheel ` from it. The build is delegated to the backend by a :term:" +"A library that takes a source tree and builds a :term:`source distribution " +"` or :term:`built distribution ` from it. The build is delegated to the backend by a :term:" "`frontend `. All backends offer a standardized interface." msgstr "" @@ -2426,18 +2426,67 @@ msgid "" msgstr "" #: ../source/glossary.rst:56 -msgid "Distribution Package" +msgid "Built Metadata" msgstr "" #: ../source/glossary.rst:59 msgid "" +"The concrete form :term:`Core Metadata` takes when included inside an " +"installed :term:`Project` (``METADATA`` file) or a :term:`Distribution " +"Archive` (``PKG-INFO`` in a :term:`Sdist ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +#, fuzzy +#| msgid "Configuring metadata" +msgid "Core Metadata" +msgstr "Agordi metadatenojn" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +#, fuzzy +#| msgid "Source Distributions vs Wheels" +msgid "Distribution Archive" +msgstr "Fonto-Distribuoj kontraste kun Wheel-oj" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 +msgid "Distribution Package" +msgstr "" + +#: ../source/glossary.rst:92 +msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " "to distribute a :term:`Release`. The archive file is what an end-user will " "download from the internet and install." msgstr "" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2449,21 +2498,21 @@ msgid "" "breakdown of the differences." msgstr "" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "Egg" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2472,11 +2521,11 @@ msgid "" "Python extensions on Windows, or a Java class file for Jython extensions." msgstr "" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2485,17 +2534,17 @@ msgid "" "distributions." msgstr "" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2504,50 +2553,63 @@ msgid "" "package` for a breakdown of the differences." msgstr "" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +#, fuzzy +#| msgid "Installer" +msgid "Installed Project" +msgstr "Instalilo" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "Modulo" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." msgstr "" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." msgstr "" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " "dependencies of that project." msgstr "" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "Projekto" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " "into a :term:`Distribution `." msgstr "" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2556,7 +2618,7 @@ msgid "" "`setup.cfg` file at the root of the project source directory." msgstr "" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2564,7 +2626,7 @@ msgid "" "`distributions `." msgstr "" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2572,21 +2634,95 @@ msgid "" "and have it provide a package importable only as 'bar'." msgstr "" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +#, fuzzy +#| msgid "Project name" +msgid "Project Root Directory" +msgstr "Nomo de projekto" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "Pura Modulo" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." msgstr "" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +#, fuzzy +#| msgid "Project name" +msgid "Pyproject Metadata" +msgstr "Nomo de projekto" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +#, fuzzy +#| msgid "pyproject.toml" +msgid "Pyproject Metadata Key" +msgstr "pyproject.toml" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2596,48 +2732,48 @@ msgid "" "`the Python Discourse forum `__." msgstr "" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " "distribute their distributions." msgstr "" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "pypi.org" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." "python.org``, in 2017. It is powered by :ref:`warehouse`." msgstr "" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "pyproject.toml" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." msgstr "" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2645,11 +2781,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2658,11 +2794,11 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2670,72 +2806,72 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " "on :ref:`pip:Requirements Files`." msgstr "" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "setup.py" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "setup.cfg" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." msgstr "" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." msgstr "" -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "Versio-Specifilo" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -2744,11 +2880,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -2756,21 +2892,39 @@ msgid "" "Environments`." msgstr "" -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +msgid "Wheel Format" +msgstr "" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "Wheel" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +#, fuzzy +#| msgid "Project" +msgid "Wheel Project" +msgstr "Projekto" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -12141,7 +12295,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -13152,7 +13306,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "Specifado" @@ -14928,26 +15082,26 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 #, fuzzy #| msgid "Configuring metadata" msgid "Inline script metadata" msgstr "Agordi metadatenojn" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -14958,7 +15112,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -14968,161 +15122,161 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 #, fuzzy msgid "Example" msgstr "Ekzemploj" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 #, fuzzy #| msgid "Documentation types" msgid "Reference Implementation" msgstr "Tipoj de dokumentaro" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 #, fuzzy #| msgid "Creating pyproject.toml" msgid "Recommendations" msgstr "Krei la dosieron pyproject.toml" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " @@ -21514,11 +21668,6 @@ msgstr "" #~ msgid "Wheel vs Egg" #~ msgstr "Wheel kontraste kun Egg" -#, fuzzy -#~| msgid "pyproject.toml" -#~ msgid "pyproject type" -#~ msgstr "pyproject.toml" - #, fuzzy #~ msgid "``url``" #~ msgstr "``urls``" diff --git a/locales/es/LC_MESSAGES/messages.po b/locales/es/LC_MESSAGES/messages.po index 9c20ae02f..b902788a9 100644 --- a/locales/es/LC_MESSAGES/messages.po +++ b/locales/es/LC_MESSAGES/messages.po @@ -15,11 +15,11 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-15 16:02+0000\n" "PO-Revision-Date: 2024-04-21 15:31+0000\n" "Last-Translator: Diego Ramirez \n" -"Language-Team: Spanish \n" +"Language-Team: Spanish \n" "Language: es\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -2524,9 +2524,9 @@ msgstr "" #: ../source/glossary.rst:17 msgid "" -"A library that takes a source tree or :term:`source distribution ` and builds a source distribution or :term:" -"`wheel ` from it. The build is delegated to the backend by a :term:" +"A library that takes a source tree and builds a :term:`source distribution " +"` or :term:`built distribution ` from it. The build is delegated to the backend by a :term:" "`frontend `. All backends offer a standardized interface." msgstr "" @@ -2571,10 +2571,59 @@ msgid "" msgstr "" #: ../source/glossary.rst:56 +msgid "Built Metadata" +msgstr "" + +#: ../source/glossary.rst:59 +msgid "" +"The concrete form :term:`Core Metadata` takes when included inside an " +"installed :term:`Project` (``METADATA`` file) or a :term:`Distribution " +"Archive` (``PKG-INFO`` in a :term:`Sdist ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +#, fuzzy +#| msgid "Configuring metadata" +msgid "Core Metadata" +msgstr "Configuración de los metadatos" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +#, fuzzy +#| msgid "Distribution Package" +msgid "Distribution Archive" +msgstr "Paquete de Distribución" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 msgid "Distribution Package" msgstr "Paquete de Distribución" -#: ../source/glossary.rst:59 +#: ../source/glossary.rst:92 msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " @@ -2582,7 +2631,7 @@ msgid "" "download from the internet and install." msgstr "" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2594,21 +2643,21 @@ msgid "" "breakdown of the differences." msgstr "" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2617,11 +2666,11 @@ msgid "" "Python extensions on Windows, or a Java class file for Jython extensions." msgstr "" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2630,17 +2679,17 @@ msgid "" "distributions." msgstr "" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2649,50 +2698,63 @@ msgid "" "package` for a breakdown of the differences." msgstr "" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +#, fuzzy +#| msgid "Installer" +msgid "Installed Project" +msgstr "Instalador" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "Módulo" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." msgstr "" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "Índice de paquetes" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." msgstr "" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "Índice por proyecto" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " "dependencies of that project." msgstr "" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "Proyecto" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " "into a :term:`Distribution `." msgstr "" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2701,7 +2763,7 @@ msgid "" "`setup.cfg` file at the root of the project source directory." msgstr "" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2709,7 +2771,7 @@ msgid "" "`distributions `." msgstr "" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2717,21 +2779,92 @@ msgid "" "and have it provide a package importable only as 'bar'." msgstr "" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +#, fuzzy +msgid "Project Root Directory" +msgstr "Nombre de proyecto" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." msgstr "" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +#, fuzzy +msgid "Pyproject Metadata" +msgstr "Nombre de proyecto" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +#, fuzzy +msgid "Pyproject Metadata Key" +msgstr "Nombre de proyecto" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2741,48 +2874,48 @@ msgid "" "`the Python Discourse forum `__." msgstr "" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " "distribute their distributions." msgstr "" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." "python.org``, in 2017. It is powered by :ref:`warehouse`." msgstr "" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." msgstr "" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2790,11 +2923,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2803,11 +2936,11 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2815,62 +2948,62 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "Archivo de requisitos" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " "on :ref:`pip:Requirements Files`." msgstr "" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." msgstr "" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "Archivo Fuente" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "Paquete de sistema" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." @@ -2878,11 +3011,11 @@ msgstr "" "Un paquete provisto en un formato nativo del sistema operativo, por ejemplo, " "un archivo de RPM o de APT." -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -2891,11 +3024,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "Entorno virtual" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -2903,21 +3036,41 @@ msgid "" "Environments`." msgstr "" -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +#, fuzzy +#| msgid "File format" +msgid "Wheel Format" +msgstr "Formato de archivo" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +#, fuzzy +#| msgid "Project" +msgid "Wheel Project" +msgstr "Proyecto" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -12087,7 +12240,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -13094,7 +13247,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "Especificación" @@ -14858,25 +15011,25 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 #, fuzzy msgid "Inline script metadata" msgstr "Configuración de los metadatos" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -14887,7 +15040,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -14897,159 +15050,159 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 #, fuzzy msgid "Example" msgstr "Ejemplos" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 #, fuzzy msgid "Reference Implementation" msgstr "Tipos de documentación" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 #, fuzzy msgid "Recommendations" msgstr "Recomendaciones de herramientas" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " @@ -21432,10 +21585,6 @@ msgid "" "the file is empty)." msgstr "" -#, fuzzy -#~ msgid "pyproject type" -#~ msgstr "Nombre de proyecto" - #~ msgid "Give a short and long description for your project." #~ msgstr "Brinde una descripción breve y una larga del proyecto." diff --git a/locales/fa/LC_MESSAGES/messages.po b/locales/fa/LC_MESSAGES/messages.po index 77aec48f8..792e513c6 100644 --- a/locales/fa/LC_MESSAGES/messages.po +++ b/locales/fa/LC_MESSAGES/messages.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-15 16:02+0000\n" "PO-Revision-Date: 2023-02-15 07:52+0000\n" "Last-Translator: Arsalan Dehghani \n" "Language-Team: Persian ` and builds a source distribution or :term:" -"`wheel ` from it. The build is delegated to the backend by a :term:" +"A library that takes a source tree and builds a :term:`source distribution " +"` or :term:`built distribution ` from it. The build is delegated to the backend by a :term:" "`frontend `. All backends offer a standardized interface." msgstr "" @@ -2359,18 +2359,63 @@ msgid "" msgstr "" #: ../source/glossary.rst:56 -msgid "Distribution Package" +msgid "Built Metadata" msgstr "" #: ../source/glossary.rst:59 msgid "" +"The concrete form :term:`Core Metadata` takes when included inside an " +"installed :term:`Project` (``METADATA`` file) or a :term:`Distribution " +"Archive` (``PKG-INFO`` in a :term:`Sdist ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +msgid "Core Metadata" +msgstr "" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +msgid "Distribution Archive" +msgstr "" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 +msgid "Distribution Package" +msgstr "" + +#: ../source/glossary.rst:92 +msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " "to distribute a :term:`Release`. The archive file is what an end-user will " "download from the internet and install." msgstr "" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2382,21 +2427,21 @@ msgid "" "breakdown of the differences." msgstr "" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2405,11 +2450,11 @@ msgid "" "Python extensions on Windows, or a Java class file for Jython extensions." msgstr "" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2418,17 +2463,17 @@ msgid "" "distributions." msgstr "" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2437,50 +2482,63 @@ msgid "" "package` for a breakdown of the differences." msgstr "" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +#, fuzzy +#| msgid "Translations" +msgid "Installed Project" +msgstr "ترجمه‌ها" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." msgstr "" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." msgstr "" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " "dependencies of that project." msgstr "" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " "into a :term:`Distribution `." msgstr "" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2489,7 +2547,7 @@ msgid "" "`setup.cfg` file at the root of the project source directory." msgstr "" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2497,7 +2555,7 @@ msgid "" "`distributions `." msgstr "" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2505,21 +2563,89 @@ msgid "" "and have it provide a package importable only as 'bar'." msgstr "" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +msgid "Project Root Directory" +msgstr "" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "ماژول خالص" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." msgstr "" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +msgid "Pyproject Metadata" +msgstr "" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +msgid "Pyproject Metadata Key" +msgstr "" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2529,48 +2655,48 @@ msgid "" "`the Python Discourse forum `__." msgstr "" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " "distribute their distributions." msgstr "" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." "python.org``, in 2017. It is powered by :ref:`warehouse`." msgstr "" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." msgstr "" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2578,11 +2704,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2591,11 +2717,11 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2603,72 +2729,72 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " "on :ref:`pip:Requirements Files`." msgstr "" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." msgstr "" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." msgstr "" -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -2677,11 +2803,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -2689,21 +2815,37 @@ msgid "" "Environments`." msgstr "" -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +msgid "Wheel Format" +msgstr "" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +msgid "Wheel Project" +msgstr "" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -11812,7 +11954,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -12818,7 +12960,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "" @@ -14568,24 +14710,24 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 msgid "Inline script metadata" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -14596,7 +14738,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -14606,156 +14748,156 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 msgid "Example" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 msgid "Reference Implementation" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 msgid "Recommendations" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " diff --git a/locales/fil/LC_MESSAGES/messages.po b/locales/fil/LC_MESSAGES/messages.po index dfd6beb8a..d9b655db6 100644 --- a/locales/fil/LC_MESSAGES/messages.po +++ b/locales/fil/LC_MESSAGES/messages.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-15 16:02+0000\n" "PO-Revision-Date: 2022-11-19 08:28+0000\n" "Last-Translator: RedFurrFox \n" "Language-Team: Filipino ` and builds a source distribution or :term:" -"`wheel ` from it. The build is delegated to the backend by a :term:" +"A library that takes a source tree and builds a :term:`source distribution " +"` or :term:`built distribution ` from it. The build is delegated to the backend by a :term:" "`frontend `. All backends offer a standardized interface." msgstr "" @@ -2358,18 +2358,63 @@ msgid "" msgstr "" #: ../source/glossary.rst:56 -msgid "Distribution Package" +msgid "Built Metadata" msgstr "" #: ../source/glossary.rst:59 msgid "" +"The concrete form :term:`Core Metadata` takes when included inside an " +"installed :term:`Project` (``METADATA`` file) or a :term:`Distribution " +"Archive` (``PKG-INFO`` in a :term:`Sdist ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +msgid "Core Metadata" +msgstr "" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +msgid "Distribution Archive" +msgstr "" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 +msgid "Distribution Package" +msgstr "" + +#: ../source/glossary.rst:92 +msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " "to distribute a :term:`Release`. The archive file is what an end-user will " "download from the internet and install." msgstr "" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2381,21 +2426,21 @@ msgid "" "breakdown of the differences." msgstr "" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2404,11 +2449,11 @@ msgid "" "Python extensions on Windows, or a Java class file for Jython extensions." msgstr "" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2417,17 +2462,17 @@ msgid "" "distributions." msgstr "" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2436,50 +2481,61 @@ msgid "" "package` for a breakdown of the differences." msgstr "" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +msgid "Installed Project" +msgstr "" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." msgstr "" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." msgstr "" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " "dependencies of that project." msgstr "" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " "into a :term:`Distribution `." msgstr "" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2488,7 +2544,7 @@ msgid "" "`setup.cfg` file at the root of the project source directory." msgstr "" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2496,7 +2552,7 @@ msgid "" "`distributions `." msgstr "" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2504,21 +2560,89 @@ msgid "" "and have it provide a package importable only as 'bar'." msgstr "" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +msgid "Project Root Directory" +msgstr "" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." msgstr "" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +msgid "Pyproject Metadata" +msgstr "" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +msgid "Pyproject Metadata Key" +msgstr "" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2528,48 +2652,48 @@ msgid "" "`the Python Discourse forum `__." msgstr "" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " "distribute their distributions." msgstr "" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." "python.org``, in 2017. It is powered by :ref:`warehouse`." msgstr "" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." msgstr "" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2577,11 +2701,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2590,11 +2714,11 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2602,72 +2726,72 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " "on :ref:`pip:Requirements Files`." msgstr "" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." msgstr "" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." msgstr "" -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -2676,11 +2800,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -2688,21 +2812,37 @@ msgid "" "Environments`." msgstr "" -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +msgid "Wheel Format" +msgstr "" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +msgid "Wheel Project" +msgstr "" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -11803,7 +11943,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -12809,7 +12949,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "" @@ -14558,24 +14698,24 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 msgid "Inline script metadata" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -14586,7 +14726,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -14596,156 +14736,156 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 msgid "Example" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 msgid "Reference Implementation" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 msgid "Recommendations" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " diff --git a/locales/fr/LC_MESSAGES/messages.po b/locales/fr/LC_MESSAGES/messages.po index 010e6bd5b..ef719086b 100644 --- a/locales/fr/LC_MESSAGES/messages.po +++ b/locales/fr/LC_MESSAGES/messages.po @@ -9,11 +9,11 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-15 16:02+0000\n" "PO-Revision-Date: 2024-04-25 06:07+0000\n" "Last-Translator: Rafael Fontenelle \n" -"Language-Team: French \n" +"Language-Team: French \n" "Language: fr\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -2494,9 +2494,9 @@ msgstr "" #: ../source/glossary.rst:17 msgid "" -"A library that takes a source tree or :term:`source distribution ` and builds a source distribution or :term:" -"`wheel ` from it. The build is delegated to the backend by a :term:" +"A library that takes a source tree and builds a :term:`source distribution " +"` or :term:`built distribution ` from it. The build is delegated to the backend by a :term:" "`frontend `. All backends offer a standardized interface." msgstr "" @@ -2541,18 +2541,65 @@ msgid "" msgstr "" #: ../source/glossary.rst:56 -msgid "Distribution Package" +msgid "Built Metadata" msgstr "" #: ../source/glossary.rst:59 msgid "" +"The concrete form :term:`Core Metadata` takes when included inside an " +"installed :term:`Project` (``METADATA`` file) or a :term:`Distribution " +"Archive` (``PKG-INFO`` in a :term:`Sdist ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +msgid "Core Metadata" +msgstr "" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +#, fuzzy +#| msgid "Built Distribution" +msgid "Distribution Archive" +msgstr "Distribution compilée" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 +msgid "Distribution Package" +msgstr "" + +#: ../source/glossary.rst:92 +msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " "to distribute a :term:`Release`. The archive file is what an end-user will " "download from the internet and install." msgstr "" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2564,21 +2611,21 @@ msgid "" "breakdown of the differences." msgstr "" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "Egg" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "Module d'extension" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2587,11 +2634,11 @@ msgid "" "Python extensions on Windows, or a Java class file for Jython extensions." msgstr "" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2600,17 +2647,17 @@ msgid "" "distributions." msgstr "" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2619,50 +2666,63 @@ msgid "" "package` for a breakdown of the differences." msgstr "" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +#, fuzzy +#| msgid "Installer" +msgid "Installed Project" +msgstr "Installateur" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "Module" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." msgstr "" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." msgstr "" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " "dependencies of that project." msgstr "" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "Projet" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " "into a :term:`Distribution `." msgstr "" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2671,7 +2731,7 @@ msgid "" "`setup.cfg` file at the root of the project source directory." msgstr "" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2679,7 +2739,7 @@ msgid "" "`distributions `." msgstr "" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2687,21 +2747,95 @@ msgid "" "and have it provide a package importable only as 'bar'." msgstr "" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +#, fuzzy +#| msgid "Project name" +msgid "Project Root Directory" +msgstr "Nom du projet" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "Module pur" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." msgstr "" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +#, fuzzy +#| msgid "Project name" +msgid "Pyproject Metadata" +msgstr "Nom du projet" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +#, fuzzy +#| msgid "pyproject.toml" +msgid "Pyproject Metadata Key" +msgstr "pyproject.toml" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2711,11 +2845,11 @@ msgid "" "`the Python Discourse forum `__." msgstr "" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "Index des Paquets Python (PyPI)" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " @@ -2725,31 +2859,31 @@ msgstr "" "par défaut pour la communauté Python. Il est ouvert à tous les développeurs " "Python pour qu'ils utilisent et distribuent leurs paquets." -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "pypi.org" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." "python.org``, in 2017. It is powered by :ref:`warehouse`." msgstr "" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "pyproject.toml" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "Version" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." @@ -2757,7 +2891,7 @@ msgstr "" "Une image d'un :term:`Projet` à un certain moment dans le temps, défini par " "un numéro de version." -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2765,11 +2899,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2778,11 +2912,11 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2790,62 +2924,62 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " "on :ref:`pip:Requirements Files`." msgstr "" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "setup.py" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "setup.cfg" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." msgstr "" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "Paquet système" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." @@ -2853,11 +2987,11 @@ msgstr "" "Un paquet fourni dans un format natif au système d'exploitation, par ex. un " "fichier rpm ou dpkg." -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -2866,11 +3000,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "Environnement virtuel" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -2878,21 +3012,39 @@ msgid "" "Environments`." msgstr "" -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +msgid "Wheel Format" +msgstr "" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "Wheel" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +#, fuzzy +#| msgid "Project" +msgid "Wheel Project" +msgstr "Projet" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -12074,7 +12226,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -13080,7 +13232,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "Spécification" @@ -14845,24 +14997,24 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 msgid "Inline script metadata" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -14873,7 +15025,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -14883,159 +15035,159 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 #, fuzzy msgid "Example" msgstr "Exemples" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 #, fuzzy #| msgid "Documentation types" msgid "Reference Implementation" msgstr "Types de documentation" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 msgid "Recommendations" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " @@ -21415,11 +21567,6 @@ msgstr "" #~ msgid "Wheel vs Egg" #~ msgstr "Wheel vs Egg" -#, fuzzy -#~| msgid "pyproject.toml" -#~ msgid "pyproject type" -#~ msgstr "pyproject.toml" - #~ msgid "Give a short and long description for your project." #~ msgstr "Renseignez une description courte et longue pour votre projet." diff --git a/locales/frc/LC_MESSAGES/messages.po b/locales/frc/LC_MESSAGES/messages.po index 61d7558dc..daeb3134a 100644 --- a/locales/frc/LC_MESSAGES/messages.po +++ b/locales/frc/LC_MESSAGES/messages.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-15 16:02+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -2305,9 +2305,9 @@ msgstr "" #: ../source/glossary.rst:17 msgid "" -"A library that takes a source tree or :term:`source distribution ` and builds a source distribution or :term:" -"`wheel ` from it. The build is delegated to the backend by a :term:" +"A library that takes a source tree and builds a :term:`source distribution " +"` or :term:`built distribution ` from it. The build is delegated to the backend by a :term:" "`frontend `. All backends offer a standardized interface." msgstr "" @@ -2352,18 +2352,63 @@ msgid "" msgstr "" #: ../source/glossary.rst:56 -msgid "Distribution Package" +msgid "Built Metadata" msgstr "" #: ../source/glossary.rst:59 msgid "" +"The concrete form :term:`Core Metadata` takes when included inside an " +"installed :term:`Project` (``METADATA`` file) or a :term:`Distribution " +"Archive` (``PKG-INFO`` in a :term:`Sdist ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +msgid "Core Metadata" +msgstr "" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +msgid "Distribution Archive" +msgstr "" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 +msgid "Distribution Package" +msgstr "" + +#: ../source/glossary.rst:92 +msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " "to distribute a :term:`Release`. The archive file is what an end-user will " "download from the internet and install." msgstr "" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2375,21 +2420,21 @@ msgid "" "breakdown of the differences." msgstr "" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2398,11 +2443,11 @@ msgid "" "Python extensions on Windows, or a Java class file for Jython extensions." msgstr "" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2411,17 +2456,17 @@ msgid "" "distributions." msgstr "" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2430,50 +2475,61 @@ msgid "" "package` for a breakdown of the differences." msgstr "" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +msgid "Installed Project" +msgstr "" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." msgstr "" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." msgstr "" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " "dependencies of that project." msgstr "" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " "into a :term:`Distribution `." msgstr "" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2482,7 +2538,7 @@ msgid "" "`setup.cfg` file at the root of the project source directory." msgstr "" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2490,7 +2546,7 @@ msgid "" "`distributions `." msgstr "" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2498,21 +2554,89 @@ msgid "" "and have it provide a package importable only as 'bar'." msgstr "" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +msgid "Project Root Directory" +msgstr "" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." msgstr "" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +msgid "Pyproject Metadata" +msgstr "" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +msgid "Pyproject Metadata Key" +msgstr "" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2522,48 +2646,48 @@ msgid "" "`the Python Discourse forum `__." msgstr "" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " "distribute their distributions." msgstr "" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." "python.org``, in 2017. It is powered by :ref:`warehouse`." msgstr "" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." msgstr "" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2571,11 +2695,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2584,11 +2708,11 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2596,72 +2720,72 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " "on :ref:`pip:Requirements Files`." msgstr "" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." msgstr "" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." msgstr "" -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -2670,11 +2794,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -2682,21 +2806,37 @@ msgid "" "Environments`." msgstr "" -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +msgid "Wheel Format" +msgstr "" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +msgid "Wheel Project" +msgstr "" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -11797,7 +11937,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -12803,7 +12943,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "" @@ -14552,24 +14692,24 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 msgid "Inline script metadata" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -14580,7 +14720,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -14590,156 +14730,156 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 msgid "Example" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 msgid "Reference Implementation" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 msgid "Recommendations" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " diff --git a/locales/gl/LC_MESSAGES/messages.po b/locales/gl/LC_MESSAGES/messages.po index a86169162..972707100 100644 --- a/locales/gl/LC_MESSAGES/messages.po +++ b/locales/gl/LC_MESSAGES/messages.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-15 16:02+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -2305,9 +2305,9 @@ msgstr "" #: ../source/glossary.rst:17 msgid "" -"A library that takes a source tree or :term:`source distribution ` and builds a source distribution or :term:" -"`wheel ` from it. The build is delegated to the backend by a :term:" +"A library that takes a source tree and builds a :term:`source distribution " +"` or :term:`built distribution ` from it. The build is delegated to the backend by a :term:" "`frontend `. All backends offer a standardized interface." msgstr "" @@ -2352,18 +2352,63 @@ msgid "" msgstr "" #: ../source/glossary.rst:56 -msgid "Distribution Package" +msgid "Built Metadata" msgstr "" #: ../source/glossary.rst:59 msgid "" +"The concrete form :term:`Core Metadata` takes when included inside an " +"installed :term:`Project` (``METADATA`` file) or a :term:`Distribution " +"Archive` (``PKG-INFO`` in a :term:`Sdist ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +msgid "Core Metadata" +msgstr "" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +msgid "Distribution Archive" +msgstr "" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 +msgid "Distribution Package" +msgstr "" + +#: ../source/glossary.rst:92 +msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " "to distribute a :term:`Release`. The archive file is what an end-user will " "download from the internet and install." msgstr "" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2375,21 +2420,21 @@ msgid "" "breakdown of the differences." msgstr "" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2398,11 +2443,11 @@ msgid "" "Python extensions on Windows, or a Java class file for Jython extensions." msgstr "" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2411,17 +2456,17 @@ msgid "" "distributions." msgstr "" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2430,50 +2475,61 @@ msgid "" "package` for a breakdown of the differences." msgstr "" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +msgid "Installed Project" +msgstr "" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." msgstr "" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." msgstr "" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " "dependencies of that project." msgstr "" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " "into a :term:`Distribution `." msgstr "" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2482,7 +2538,7 @@ msgid "" "`setup.cfg` file at the root of the project source directory." msgstr "" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2490,7 +2546,7 @@ msgid "" "`distributions `." msgstr "" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2498,21 +2554,89 @@ msgid "" "and have it provide a package importable only as 'bar'." msgstr "" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +msgid "Project Root Directory" +msgstr "" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." msgstr "" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +msgid "Pyproject Metadata" +msgstr "" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +msgid "Pyproject Metadata Key" +msgstr "" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2522,48 +2646,48 @@ msgid "" "`the Python Discourse forum `__." msgstr "" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " "distribute their distributions." msgstr "" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." "python.org``, in 2017. It is powered by :ref:`warehouse`." msgstr "" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." msgstr "" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2571,11 +2695,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2584,11 +2708,11 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2596,72 +2720,72 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " "on :ref:`pip:Requirements Files`." msgstr "" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." msgstr "" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." msgstr "" -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -2670,11 +2794,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -2682,21 +2806,37 @@ msgid "" "Environments`." msgstr "" -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +msgid "Wheel Format" +msgstr "" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +msgid "Wheel Project" +msgstr "" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -11797,7 +11937,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -12803,7 +12943,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "" @@ -14552,24 +14692,24 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 msgid "Inline script metadata" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -14580,7 +14720,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -14590,156 +14730,156 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 msgid "Example" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 msgid "Reference Implementation" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 msgid "Recommendations" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " diff --git a/locales/hi/LC_MESSAGES/messages.po b/locales/hi/LC_MESSAGES/messages.po index 912e2ab7a..0cdf9f759 100644 --- a/locales/hi/LC_MESSAGES/messages.po +++ b/locales/hi/LC_MESSAGES/messages.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-15 16:02+0000\n" "PO-Revision-Date: 2022-09-29 05:18+0000\n" "Last-Translator: Aryan 'Ba3a' Kumar \n" "Language-Team: Hindi ` and builds a source distribution or :term:" -"`wheel ` from it. The build is delegated to the backend by a :term:" +"A library that takes a source tree and builds a :term:`source distribution " +"` or :term:`built distribution ` from it. The build is delegated to the backend by a :term:" "`frontend `. All backends offer a standardized interface." msgstr "" @@ -2362,18 +2362,63 @@ msgid "" msgstr "" #: ../source/glossary.rst:56 -msgid "Distribution Package" +msgid "Built Metadata" msgstr "" #: ../source/glossary.rst:59 msgid "" +"The concrete form :term:`Core Metadata` takes when included inside an " +"installed :term:`Project` (``METADATA`` file) or a :term:`Distribution " +"Archive` (``PKG-INFO`` in a :term:`Sdist ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +msgid "Core Metadata" +msgstr "" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +msgid "Distribution Archive" +msgstr "" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 +msgid "Distribution Package" +msgstr "" + +#: ../source/glossary.rst:92 +msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " "to distribute a :term:`Release`. The archive file is what an end-user will " "download from the internet and install." msgstr "" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2385,21 +2430,21 @@ msgid "" "breakdown of the differences." msgstr "" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2408,11 +2453,11 @@ msgid "" "Python extensions on Windows, or a Java class file for Jython extensions." msgstr "" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2421,17 +2466,17 @@ msgid "" "distributions." msgstr "" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2440,50 +2485,63 @@ msgid "" "package` for a breakdown of the differences." msgstr "" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +#, fuzzy +#| msgid "Installing packages" +msgid "Installed Project" +msgstr "पैकेज प्रतिष्ठापन" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." msgstr "" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." msgstr "" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " "dependencies of that project." msgstr "" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " "into a :term:`Distribution `." msgstr "" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2492,7 +2550,7 @@ msgid "" "`setup.cfg` file at the root of the project source directory." msgstr "" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2500,7 +2558,7 @@ msgid "" "`distributions `." msgstr "" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2508,21 +2566,95 @@ msgid "" "and have it provide a package importable only as 'bar'." msgstr "" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +#, fuzzy +#| msgid "Project name" +msgid "Project Root Directory" +msgstr "परियोजना" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." msgstr "" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +#, fuzzy +#| msgid "Project name" +msgid "Pyproject Metadata" +msgstr "परियोजना" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +#, fuzzy +#| msgid "Project name" +msgid "Pyproject Metadata Key" +msgstr "परियोजना" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2532,48 +2664,48 @@ msgid "" "`the Python Discourse forum `__." msgstr "" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " "distribute their distributions." msgstr "" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." "python.org``, in 2017. It is powered by :ref:`warehouse`." msgstr "" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." msgstr "" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2581,11 +2713,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2594,11 +2726,11 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2606,72 +2738,72 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " "on :ref:`pip:Requirements Files`." msgstr "" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." msgstr "" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." msgstr "" -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -2680,11 +2812,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -2692,21 +2824,37 @@ msgid "" "Environments`." msgstr "" -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +msgid "Wheel Format" +msgstr "" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +msgid "Wheel Project" +msgstr "" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -11827,7 +11975,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -12833,7 +12981,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "" @@ -14587,24 +14735,24 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 msgid "Inline script metadata" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -14615,7 +14763,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -14625,156 +14773,156 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 msgid "Example" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 msgid "Reference Implementation" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 msgid "Recommendations" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " @@ -21112,8 +21260,3 @@ msgid "" "recommended to stick with *regular packages* and ``__init__.py`` (even if " "the file is empty)." msgstr "" - -#, fuzzy -#~| msgid "Project name" -#~ msgid "pyproject type" -#~ msgstr "परियोजना" diff --git a/locales/id/LC_MESSAGES/messages.po b/locales/id/LC_MESSAGES/messages.po index 7ada5e371..7c662e735 100644 --- a/locales/id/LC_MESSAGES/messages.po +++ b/locales/id/LC_MESSAGES/messages.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-15 16:02+0000\n" "PO-Revision-Date: 2024-01-27 05:01+0000\n" "Last-Translator: Rafael Fontenelle \n" "Language-Team: Indonesian ` and builds a source distribution or :term:" -"`wheel ` from it. The build is delegated to the backend by a :term:" +"A library that takes a source tree and builds a :term:`source distribution " +"` or :term:`built distribution ` from it. The build is delegated to the backend by a :term:" "`frontend `. All backends offer a standardized interface." msgstr "" @@ -2392,18 +2392,63 @@ msgid "" msgstr "" #: ../source/glossary.rst:56 -msgid "Distribution Package" +msgid "Built Metadata" msgstr "" #: ../source/glossary.rst:59 msgid "" +"The concrete form :term:`Core Metadata` takes when included inside an " +"installed :term:`Project` (``METADATA`` file) or a :term:`Distribution " +"Archive` (``PKG-INFO`` in a :term:`Sdist ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +msgid "Core Metadata" +msgstr "" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +msgid "Distribution Archive" +msgstr "" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 +msgid "Distribution Package" +msgstr "" + +#: ../source/glossary.rst:92 +msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " "to distribute a :term:`Release`. The archive file is what an end-user will " "download from the internet and install." msgstr "" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2415,21 +2460,21 @@ msgid "" "breakdown of the differences." msgstr "" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2438,11 +2483,11 @@ msgid "" "Python extensions on Windows, or a Java class file for Jython extensions." msgstr "" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2451,17 +2496,17 @@ msgid "" "distributions." msgstr "" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2470,50 +2515,63 @@ msgid "" "package` for a breakdown of the differences." msgstr "" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +#, fuzzy +#| msgid "Translations" +msgid "Installed Project" +msgstr "Penerjemahan" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." msgstr "" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." msgstr "" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " "dependencies of that project." msgstr "" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " "into a :term:`Distribution `." msgstr "" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2522,7 +2580,7 @@ msgid "" "`setup.cfg` file at the root of the project source directory." msgstr "" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2530,7 +2588,7 @@ msgid "" "`distributions `." msgstr "" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2538,21 +2596,89 @@ msgid "" "and have it provide a package importable only as 'bar'." msgstr "" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +msgid "Project Root Directory" +msgstr "" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." msgstr "" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +msgid "Pyproject Metadata" +msgstr "" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +msgid "Pyproject Metadata Key" +msgstr "" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2562,48 +2688,48 @@ msgid "" "`the Python Discourse forum `__." msgstr "" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " "distribute their distributions." msgstr "" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." "python.org``, in 2017. It is powered by :ref:`warehouse`." msgstr "" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." msgstr "" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2611,11 +2737,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2624,11 +2750,11 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2636,72 +2762,72 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " "on :ref:`pip:Requirements Files`." msgstr "" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." msgstr "" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." msgstr "" -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -2710,11 +2836,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -2722,21 +2848,37 @@ msgid "" "Environments`." msgstr "" -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +msgid "Wheel Format" +msgstr "" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +msgid "Wheel Project" +msgstr "" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -11845,7 +11987,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -12851,7 +12993,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "Spesifikasi" @@ -14603,24 +14745,24 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 msgid "Inline script metadata" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -14631,7 +14773,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -14641,158 +14783,158 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 msgid "Example" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 #, fuzzy #| msgid "Documentation types" msgid "Reference Implementation" msgstr "Jenis-jenis dokumentasi" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 msgid "Recommendations" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " diff --git a/locales/ko/LC_MESSAGES/messages.po b/locales/ko/LC_MESSAGES/messages.po index a9e46f17b..fecf4e0ab 100644 --- a/locales/ko/LC_MESSAGES/messages.po +++ b/locales/ko/LC_MESSAGES/messages.po @@ -11,7 +11,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-15 16:02+0000\n" "PO-Revision-Date: 2024-03-21 03:01+0000\n" "Last-Translator: emscb \n" "Language-Team: Korean ` and builds a source distribution or :term:" -"`wheel ` from it. The build is delegated to the backend by a :term:" +"A library that takes a source tree and builds a :term:`source distribution " +"` or :term:`built distribution ` from it. The build is delegated to the backend by a :term:" "`frontend `. All backends offer a standardized interface." msgstr "" @@ -2410,18 +2410,63 @@ msgid "" msgstr "" #: ../source/glossary.rst:56 -msgid "Distribution Package" +msgid "Built Metadata" msgstr "" #: ../source/glossary.rst:59 msgid "" +"The concrete form :term:`Core Metadata` takes when included inside an " +"installed :term:`Project` (``METADATA`` file) or a :term:`Distribution " +"Archive` (``PKG-INFO`` in a :term:`Sdist ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +msgid "Core Metadata" +msgstr "" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +msgid "Distribution Archive" +msgstr "" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 +msgid "Distribution Package" +msgstr "" + +#: ../source/glossary.rst:92 +msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " "to distribute a :term:`Release`. The archive file is what an end-user will " "download from the internet and install." msgstr "" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2433,21 +2478,21 @@ msgid "" "breakdown of the differences." msgstr "" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2456,11 +2501,11 @@ msgid "" "Python extensions on Windows, or a Java class file for Jython extensions." msgstr "" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2469,18 +2514,18 @@ msgid "" "distributions." msgstr "" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 #, fuzzy msgid "Import Package" msgstr "패키지 가져오기" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2489,52 +2534,65 @@ msgid "" "package` for a breakdown of the differences." msgstr "" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +#, fuzzy +#| msgid "Translations" +msgid "Installed Project" +msgstr "번역" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "모듈" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." msgstr "" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 #, fuzzy msgid "Package Index" msgstr "패키지 인덱스" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." msgstr "" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 #, fuzzy msgid "Per Project Index" msgstr "프로젝트별 인덱스" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " "dependencies of that project." msgstr "" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "프로젝트" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " "into a :term:`Distribution `." msgstr "" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2543,7 +2601,7 @@ msgid "" "`setup.cfg` file at the root of the project source directory." msgstr "" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2551,7 +2609,7 @@ msgid "" "`distributions `." msgstr "" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2559,21 +2617,95 @@ msgid "" "and have it provide a package importable only as 'bar'." msgstr "" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +#, fuzzy +#| msgid "Project name" +msgid "Project Root Directory" +msgstr "프로젝트 이름" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." msgstr "" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +#, fuzzy +#| msgid "Project name" +msgid "Pyproject Metadata" +msgstr "프로젝트 이름" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +#, fuzzy +#| msgid "Project name" +msgid "Pyproject Metadata Key" +msgstr "프로젝트 이름" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2583,48 +2715,48 @@ msgid "" "`the Python Discourse forum `__." msgstr "" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " "distribute their distributions." msgstr "" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." "python.org``, in 2017. It is powered by :ref:`warehouse`." msgstr "" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." msgstr "" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2632,11 +2764,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2645,12 +2777,12 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 #, fuzzy msgid "Requirement Specifier" msgstr "요구 사항 지정자" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2658,72 +2790,72 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " "on :ref:`pip:Requirements Files`." msgstr "" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." msgstr "" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." msgstr "" -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -2732,11 +2864,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -2744,21 +2876,39 @@ msgid "" "Environments`." msgstr "" -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +msgid "Wheel Format" +msgstr "" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +#, fuzzy +#| msgid "Project" +msgid "Wheel Project" +msgstr "프로젝트" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -11871,7 +12021,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -12877,7 +13027,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "" @@ -14630,24 +14780,24 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 msgid "Inline script metadata" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -14658,7 +14808,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -14668,158 +14818,158 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 msgid "Example" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 #, fuzzy #| msgid "Documentation types" msgid "Reference Implementation" msgstr "문서 유형" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 msgid "Recommendations" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " diff --git a/locales/lzh/LC_MESSAGES/messages.po b/locales/lzh/LC_MESSAGES/messages.po index 312300bd8..cc6085827 100644 --- a/locales/lzh/LC_MESSAGES/messages.po +++ b/locales/lzh/LC_MESSAGES/messages.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-15 16:02+0000\n" "PO-Revision-Date: 2024-01-31 06:01+0000\n" "Last-Translator: maker \n" "Language-Team: Chinese (Literary) ` and builds a source distribution or :term:" -"`wheel ` from it. The build is delegated to the backend by a :term:" +"A library that takes a source tree and builds a :term:`source distribution " +"` or :term:`built distribution ` from it. The build is delegated to the backend by a :term:" "`frontend `. All backends offer a standardized interface." msgstr "" @@ -2356,18 +2356,63 @@ msgid "" msgstr "" #: ../source/glossary.rst:56 -msgid "Distribution Package" +msgid "Built Metadata" msgstr "" #: ../source/glossary.rst:59 msgid "" +"The concrete form :term:`Core Metadata` takes when included inside an " +"installed :term:`Project` (``METADATA`` file) or a :term:`Distribution " +"Archive` (``PKG-INFO`` in a :term:`Sdist ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +msgid "Core Metadata" +msgstr "" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +msgid "Distribution Archive" +msgstr "" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 +msgid "Distribution Package" +msgstr "" + +#: ../source/glossary.rst:92 +msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " "to distribute a :term:`Release`. The archive file is what an end-user will " "download from the internet and install." msgstr "" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2379,21 +2424,21 @@ msgid "" "breakdown of the differences." msgstr "" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2402,11 +2447,11 @@ msgid "" "Python extensions on Windows, or a Java class file for Jython extensions." msgstr "" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2415,17 +2460,17 @@ msgid "" "distributions." msgstr "" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2434,50 +2479,61 @@ msgid "" "package` for a breakdown of the differences." msgstr "" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +msgid "Installed Project" +msgstr "" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." msgstr "" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." msgstr "" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " "dependencies of that project." msgstr "" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " "into a :term:`Distribution `." msgstr "" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2486,7 +2542,7 @@ msgid "" "`setup.cfg` file at the root of the project source directory." msgstr "" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2494,7 +2550,7 @@ msgid "" "`distributions `." msgstr "" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2502,21 +2558,89 @@ msgid "" "and have it provide a package importable only as 'bar'." msgstr "" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +msgid "Project Root Directory" +msgstr "" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." msgstr "" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +msgid "Pyproject Metadata" +msgstr "" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +msgid "Pyproject Metadata Key" +msgstr "" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2526,48 +2650,48 @@ msgid "" "`the Python Discourse forum `__." msgstr "" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " "distribute their distributions." msgstr "" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." "python.org``, in 2017. It is powered by :ref:`warehouse`." msgstr "" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." msgstr "" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2575,11 +2699,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2588,11 +2712,11 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2600,72 +2724,72 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " "on :ref:`pip:Requirements Files`." msgstr "" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." msgstr "" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "源码" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." msgstr "" -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "版本指定器" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -2674,11 +2798,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -2686,21 +2810,37 @@ msgid "" "Environments`." msgstr "" -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +msgid "Wheel Format" +msgstr "" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +msgid "Wheel Project" +msgstr "" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -11801,7 +11941,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -12807,7 +12947,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "" @@ -14556,24 +14696,24 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 msgid "Inline script metadata" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -14584,7 +14724,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -14594,156 +14734,156 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 msgid "Example" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 msgid "Reference Implementation" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 msgid "Recommendations" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " diff --git a/locales/mk/LC_MESSAGES/messages.po b/locales/mk/LC_MESSAGES/messages.po index 49b7e45e5..6b594fd13 100644 --- a/locales/mk/LC_MESSAGES/messages.po +++ b/locales/mk/LC_MESSAGES/messages.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-15 16:02+0000\n" "PO-Revision-Date: 2023-10-21 04:04+0000\n" "Last-Translator: \"Kristijan \\\"Fremen\\\" Velkovski\" \n" "Language-Team: Macedonian ` and builds a source distribution or :term:" -"`wheel ` from it. The build is delegated to the backend by a :term:" +"A library that takes a source tree and builds a :term:`source distribution " +"` or :term:`built distribution ` from it. The build is delegated to the backend by a :term:" "`frontend `. All backends offer a standardized interface." msgstr "" @@ -2358,18 +2358,65 @@ msgid "" msgstr "" #: ../source/glossary.rst:56 -msgid "Distribution Package" +msgid "Built Metadata" msgstr "" #: ../source/glossary.rst:59 msgid "" +"The concrete form :term:`Core Metadata` takes when included inside an " +"installed :term:`Project` (``METADATA`` file) or a :term:`Distribution " +"Archive` (``PKG-INFO`` in a :term:`Sdist ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +msgid "Core Metadata" +msgstr "" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +#, fuzzy +#| msgid "Binary Distribution" +msgid "Distribution Archive" +msgstr "Бинарна Дистрибуција" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 +msgid "Distribution Package" +msgstr "" + +#: ../source/glossary.rst:92 +msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " "to distribute a :term:`Release`. The archive file is what an end-user will " "download from the internet and install." msgstr "" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2381,21 +2428,21 @@ msgid "" "breakdown of the differences." msgstr "" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "Jajce(Egg)" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2404,11 +2451,11 @@ msgid "" "Python extensions on Windows, or a Java class file for Jython extensions." msgstr "" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2417,17 +2464,17 @@ msgid "" "distributions." msgstr "" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2436,50 +2483,61 @@ msgid "" "package` for a breakdown of the differences." msgstr "" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +msgid "Installed Project" +msgstr "" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." msgstr "" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." msgstr "" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " "dependencies of that project." msgstr "" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " "into a :term:`Distribution `." msgstr "" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2488,7 +2546,7 @@ msgid "" "`setup.cfg` file at the root of the project source directory." msgstr "" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2496,7 +2554,7 @@ msgid "" "`distributions `." msgstr "" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2504,21 +2562,89 @@ msgid "" "and have it provide a package importable only as 'bar'." msgstr "" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +msgid "Project Root Directory" +msgstr "" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." msgstr "" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +msgid "Pyproject Metadata" +msgstr "" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +msgid "Pyproject Metadata Key" +msgstr "" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2528,48 +2654,48 @@ msgid "" "`the Python Discourse forum `__." msgstr "" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " "distribute their distributions." msgstr "" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." "python.org``, in 2017. It is powered by :ref:`warehouse`." msgstr "" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." msgstr "" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2577,11 +2703,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2590,11 +2716,11 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2602,72 +2728,72 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " "on :ref:`pip:Requirements Files`." msgstr "" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." msgstr "" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." msgstr "" -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -2676,11 +2802,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -2688,21 +2814,37 @@ msgid "" "Environments`." msgstr "" -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +msgid "Wheel Format" +msgstr "" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +msgid "Wheel Project" +msgstr "" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -11805,7 +11947,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -12811,7 +12953,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "" @@ -14560,24 +14702,24 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 msgid "Inline script metadata" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -14588,7 +14730,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -14598,156 +14740,156 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 msgid "Example" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 msgid "Reference Implementation" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 msgid "Recommendations" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " diff --git a/locales/pl/LC_MESSAGES/messages.po b/locales/pl/LC_MESSAGES/messages.po index 8eab61d9f..8e2ba6cdf 100644 --- a/locales/pl/LC_MESSAGES/messages.po +++ b/locales/pl/LC_MESSAGES/messages.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-15 16:02+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -2305,9 +2305,9 @@ msgstr "" #: ../source/glossary.rst:17 msgid "" -"A library that takes a source tree or :term:`source distribution ` and builds a source distribution or :term:" -"`wheel ` from it. The build is delegated to the backend by a :term:" +"A library that takes a source tree and builds a :term:`source distribution " +"` or :term:`built distribution ` from it. The build is delegated to the backend by a :term:" "`frontend `. All backends offer a standardized interface." msgstr "" @@ -2352,18 +2352,63 @@ msgid "" msgstr "" #: ../source/glossary.rst:56 -msgid "Distribution Package" +msgid "Built Metadata" msgstr "" #: ../source/glossary.rst:59 msgid "" +"The concrete form :term:`Core Metadata` takes when included inside an " +"installed :term:`Project` (``METADATA`` file) or a :term:`Distribution " +"Archive` (``PKG-INFO`` in a :term:`Sdist ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +msgid "Core Metadata" +msgstr "" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +msgid "Distribution Archive" +msgstr "" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 +msgid "Distribution Package" +msgstr "" + +#: ../source/glossary.rst:92 +msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " "to distribute a :term:`Release`. The archive file is what an end-user will " "download from the internet and install." msgstr "" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2375,21 +2420,21 @@ msgid "" "breakdown of the differences." msgstr "" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2398,11 +2443,11 @@ msgid "" "Python extensions on Windows, or a Java class file for Jython extensions." msgstr "" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2411,17 +2456,17 @@ msgid "" "distributions." msgstr "" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2430,50 +2475,61 @@ msgid "" "package` for a breakdown of the differences." msgstr "" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +msgid "Installed Project" +msgstr "" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." msgstr "" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." msgstr "" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " "dependencies of that project." msgstr "" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " "into a :term:`Distribution `." msgstr "" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2482,7 +2538,7 @@ msgid "" "`setup.cfg` file at the root of the project source directory." msgstr "" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2490,7 +2546,7 @@ msgid "" "`distributions `." msgstr "" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2498,21 +2554,89 @@ msgid "" "and have it provide a package importable only as 'bar'." msgstr "" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +msgid "Project Root Directory" +msgstr "" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." msgstr "" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +msgid "Pyproject Metadata" +msgstr "" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +msgid "Pyproject Metadata Key" +msgstr "" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2522,48 +2646,48 @@ msgid "" "`the Python Discourse forum `__." msgstr "" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " "distribute their distributions." msgstr "" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." "python.org``, in 2017. It is powered by :ref:`warehouse`." msgstr "" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." msgstr "" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2571,11 +2695,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2584,11 +2708,11 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2596,72 +2720,72 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " "on :ref:`pip:Requirements Files`." msgstr "" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." msgstr "" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." msgstr "" -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -2670,11 +2794,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -2682,21 +2806,37 @@ msgid "" "Environments`." msgstr "" -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +msgid "Wheel Format" +msgstr "" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +msgid "Wheel Project" +msgstr "" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -11797,7 +11937,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -12803,7 +12943,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "" @@ -14552,24 +14692,24 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 msgid "Inline script metadata" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -14580,7 +14720,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -14590,156 +14730,156 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 msgid "Example" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 msgid "Reference Implementation" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 msgid "Recommendations" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " diff --git a/locales/pt_BR/LC_MESSAGES/messages.po b/locales/pt_BR/LC_MESSAGES/messages.po index 33c3454f4..3732c869d 100644 --- a/locales/pt_BR/LC_MESSAGES/messages.po +++ b/locales/pt_BR/LC_MESSAGES/messages.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-15 16:02+0000\n" "PO-Revision-Date: 2024-04-25 06:07+0000\n" "Last-Translator: Rafael Fontenelle \n" "Language-Team: Portuguese (Brazil) `." msgstr "" -"Se você quiser detalhes técnicos sobre o formato sdist, leia a :ref:`" -"especificação de sdist `." +"Se você quiser detalhes técnicos sobre o formato sdist, leia a :ref:" +"`especificação de sdist `." #: ../source/discussions/package-formats.rst:55 msgid "What is a wheel?" @@ -1278,11 +1278,11 @@ msgid "" "files) but compiled, executable code (like ``.so`` files on Linux or DLLs on " "Windows)." msgstr "" -"Há uma grande diferença entre sdists e wheels para pacotes com :term:`" -"módulos de extensão `, escritos em linguagens compiladas " -"como C, C++ e Rust, que precisam ser compilados em código de máquina " -"dependente de plataforma. Com esses pacotes, as rodas não contêm código " -"fonte (como arquivos fonte C), mas código executável compilado (como " +"Há uma grande diferença entre sdists e wheels para pacotes com :term:" +"`módulos de extensão `, escritos em linguagens " +"compiladas como C, C++ e Rust, que precisam ser compilados em código de " +"máquina dependente de plataforma. Com esses pacotes, as rodas não contêm " +"código fonte (como arquivos fonte C), mas código executável compilado (como " "arquivos ``.so`` no Linux ou DLLs no Windows)." #: ../source/discussions/package-formats.rst:66 @@ -1364,8 +1364,8 @@ msgstr "" "para projetos \"simples e básicos\" de Python puro. Tenha em mente que " "devido à flexibilidade dos sdists, instaladores como o pip não podem " "instalar diretamente a partir dos sdists -- eles precisam primeiro construir " -"um wheel, invocando o :term:`backend de construção` que o sdist especifica (" -"o backend de construção pode fazer todo tipo de transformações durante a " +"um wheel, invocando o :term:`backend de construção` que o sdist especifica " +"(o backend de construção pode fazer todo tipo de transformações durante a " "construção do wheel, como compilar extensões C). Por esse motivo, mesmo para " "um projeto Python puro, você deve sempre enviar *ambos* sdist e wheel para o " "PyPI ou outros índices de pacotes. Isso torna a instalação muito mais rápida " @@ -1413,11 +1413,10 @@ msgid "" "any.whl`` means that:" msgstr "" "O nome do arquivo de um wheel (ignorando alguns recursos raramente usados) é " -"assim: " -":samp:`{nome_do_pacote}-{versão}-{tag_python}-{tag_abi}-{tag_plataforma}.whl`" -". Esta convenção de nomenclatura identifica com quais plataformas e versões " -"do Python a roda é compatível. Por exemplo, o nome ``pip-23.3.1-py3-none-any." -"whl`` significa que:" +"assim: :samp:`{nome_do_pacote}-{versão}-{tag_python}-{tag_abi}-" +"{tag_plataforma}.whl`. Esta convenção de nomenclatura identifica com quais " +"plataformas e versões do Python a roda é compatível. Por exemplo, o nome " +"``pip-23.3.1-py3-none-any.whl`` significa que:" #: ../source/discussions/package-formats.rst:121 msgid "" @@ -1450,8 +1449,8 @@ msgid "" "All technical details on the wheel format can be found in the :ref:`wheel " "specification `." msgstr "" -"Todos os detalhes técnicos sobre o formato do wheel podem ser encontrados na " -":ref:`especificação de wheels `." +"Todos os detalhes técnicos sobre o formato do wheel podem ser encontrados " +"na :ref:`especificação de wheels `." #: ../source/discussions/package-formats.rst:138 msgid "What about eggs?" @@ -1510,8 +1509,8 @@ msgstr "" "Os arquivos wheel não incluem arquivos ``.pyc``. Portanto, quando a " "distribuição contém apenas arquivos Python (ou seja, sem extensões " "compiladas) e é compatível com Python 2 e 3, é possível que um wheel seja " -"\"universal\", semelhante a um :term:`sdist `." +"\"universal\", semelhante a um :term:`sdist `." #: ../source/discussions/package-formats.rst:161 msgid "" @@ -1546,8 +1545,8 @@ msgid "" "org/2/library/sysconfig.html#installation-paths>`_, therefore making it " "easier to convert to other formats." msgstr "" -"Wheel é internamente organizado pelo `tipo de caminho sysconfig `_, portanto " +"Wheel é internamente organizado pelo `tipo de caminho sysconfig `_, portanto " "tornando mais fácil converter para outros formatos." #: ../source/discussions/package-formats.rst:177 @@ -2366,8 +2365,8 @@ msgid "" "A post-release of an alpha release (possible, but discouraged): ``1.2.0a1." "post1``" msgstr "" -"Um pós-lançamento de uma versão alfa (possível, mas desencorajado): ``1.2.0a1" -".post1``" +"Um pós-lançamento de uma versão alfa (possível, mas desencorajado): " +"``1.2.0a1.post1``" #: ../source/discussions/versioning.rst:28 msgid "A simple version with only two components: ``23.12``" @@ -2395,8 +2394,8 @@ msgstr "" "versões alfa, versões beta, candidatos a lançamento, versão final. Pip e " "outros instaladores modernos de pacotes Python ignoram pré-lançamentos por " "padrão ao decidir quais versões de dependências instalar, a menos que " -"solicitado explicitamente (por exemplo, com ```pip install pkg==1.1a3`` ou ``" -"pip install --pre pkg``)." +"solicitado explicitamente (por exemplo, com ```pip install pkg==1.1a3`` ou " +"``pip install --pre pkg``)." #: ../source/discussions/versioning.rst:39 msgid "" @@ -2552,8 +2551,8 @@ msgstr "" "abordagem permite que os usuários façam uso de :ref:`especificadores de " "versão de lançamento compatíveis `, " "com o operador ``~=``. Por exemplo, ``name ~= X.Y`` é aproximadamente " -"equivalente a ``name >= X.Y, == X.*``, ou seja, requer pelo menos a versão " -"X.Y, e permite qualquer versão posterior com Y maior, desde que X é o mesmo. " +"equivalente a ``name >= X.Y, == X.*``, ou seja, requer pelo menos a versão X." +"Y, e permite qualquer versão posterior com Y maior, desde que X é o mesmo. " "Da mesma forma, ``name ~= X.Y.Z`` é aproximadamente equivalente a ``name >= " "X.Y.Z, == X.Y.*``, ou seja, requer pelo menos X.Y.Z e permite uma versão " "posterior com o mesmo X e Y, mas Z superior." @@ -2563,8 +2562,8 @@ msgid "" "Python projects adopting semantic versioning should abide by clauses 1-8 of " "the `Semantic Versioning 2.0.0 specification `_." msgstr "" -"Projetos Python que adotam versões semânticas devem obedecer às cláusulas 1-" -"8 da `especificação de Versionamento Semântico 2.0.0 `_." +"Projetos Python que adotam versões semânticas devem obedecer às cláusulas " +"1-8 da `especificação de Versionamento Semântico 2.0.0 `_." #: ../source/discussions/versioning.rst:115 msgid "" @@ -2577,8 +2576,8 @@ msgid "" "`)." msgstr "" "O popular gerador de documentação :doc:`Sphinx ` é um exemplo " -"de projeto que usa controle de versionamento semântico estrito (:doc:`" -"Política de versionamento do Sphinx `). O " +"de projeto que usa controle de versionamento semântico estrito (:doc:" +"`Política de versionamento do Sphinx `). O " "famoso pacote de computação científica :doc:`NumPy ` usa " "explicitamente versionamento semântico \"folgado\", onde lançamentos " "incrementando a versão menor podem conter alterações de API incompatíveis " @@ -2616,8 +2615,8 @@ msgid "" "Calendar version numbers typically take the form *year.month* (for example, " "23.12 for December 2023)." msgstr "" -"Os números de versão do calendário normalmente assumem o formato *ano.mês* (" -"por exemplo, 23.12 para dezembro de 2023)." +"Os números de versão do calendário normalmente assumem o formato *ano.mês* " +"(por exemplo, 23.12 para dezembro de 2023)." #: ../source/discussions/versioning.rst:137 msgid "" @@ -2675,8 +2674,8 @@ msgid "" msgstr "" "Identificadores de versão pública são projetados para suportar distribuição " "via :term:`PyPI `. As ferramentas de " -"empacotamento do Python também oferecem suporte à noção de um :ref:`" -"identificador de versão local `, que pode ser " +"empacotamento do Python também oferecem suporte à noção de um :ref:" +"`identificador de versão local `, que pode ser " "usado para identificar compilações de desenvolvimento local não destinadas à " "publicação, ou variantes modificadas de uma versão mantida por um " "redistribuidor." @@ -2706,8 +2705,8 @@ msgid "" "Some more examples of unusual version numbers are given in a `blog post " "`_ by Seth Larson." msgstr "" -"Mais alguns exemplos de números de versão incomuns são fornecidos em uma `" -"postagem no blog `_ de Seth Larson." +"Mais alguns exemplos de números de versão incomuns são fornecidos em uma " +"`postagem no blog `_ de Seth Larson." #: ../source/discussions/versioning.rst:181 msgid "" @@ -3079,10 +3078,16 @@ msgid "Build Backend" msgstr "Backend de construção" #: ../source/glossary.rst:17 -msgid "" -"A library that takes a source tree or :term:`source distribution ` and builds a source distribution or :term:" -"`wheel ` from it. The build is delegated to the backend by a :term:" +#, fuzzy +#| msgid "" +#| "A library that takes a source tree or :term:`source distribution ` and builds a source distribution or :term:" +#| "`wheel ` from it. The build is delegated to the backend by a :term:" +#| "`frontend `. All backends offer a standardized interface." +msgid "" +"A library that takes a source tree and builds a :term:`source distribution " +"` or :term:`built distribution ` from it. The build is delegated to the backend by a :term:" "`frontend `. All backends offer a standardized interface." msgstr "" "Uma biblioteca que pega uma árvore de fontes ou :term:`distribuição fonte " @@ -3140,18 +3145,67 @@ msgid "" msgstr "" "Um formato de :term:`Distribuição ` contendo arquivos " "e metadados que só precisam ser movidos para o local correto no sistema de " -"destino, para serem instalados. :term:`Wheel` é esse formato, enquanto o " -":term:`Distribuição Fonte ` não é, pois " +"destino, para serem instalados. :term:`Wheel` é esse formato, enquanto o :" +"term:`Distribuição Fonte ` não é, pois " "requer uma etapa de construção antes de poder ser instalado. Este formato " -"não implica que os arquivos Python tenham que ser pré-compilados " -"(:term:`Wheel` intencionalmente não inclui arquivos Python compilados). Veja " -":ref:`package-formats` para mais informações." +"não implica que os arquivos Python tenham que ser pré-compilados (:term:" +"`Wheel` intencionalmente não inclui arquivos Python compilados). Veja :ref:" +"`package-formats` para mais informações." #: ../source/glossary.rst:56 +msgid "Built Metadata" +msgstr "" + +#: ../source/glossary.rst:59 +msgid "" +"The concrete form :term:`Core Metadata` takes when included inside an " +"installed :term:`Project` (``METADATA`` file) or a :term:`Distribution " +"Archive` (``PKG-INFO`` in a :term:`Sdist ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +#, fuzzy +#| msgid "Configuring metadata" +msgid "Core Metadata" +msgstr "Configurando metadados" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +#, fuzzy +#| msgid "Distribution Package" +msgid "Distribution Archive" +msgstr "Pacote de Distribuição" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 msgid "Distribution Package" msgstr "Pacote de Distribuição" -#: ../source/glossary.rst:59 +#: ../source/glossary.rst:92 msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " @@ -3163,7 +3217,7 @@ msgstr "" "distribuir um :term:`Release` (lançamento). O arquivo é o que um usuário " "final irá baixar da Internet e instalar." -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -3183,24 +3237,24 @@ msgstr "" "\"distribuição\". Veja :ref:`distribution-package-vs-import-package` para " "uma explicação das diferenças." -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "Egg" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -"Um formato de :term:`Distribuição Construída` introduzido pelo " -":ref:`setuptools`, que foi substituído pelo :term:`Wheel`. Para detalhes, " -"veja :ref:`egg-format`." +"Um formato de :term:`Distribuição Construída` introduzido pelo :ref:" +"`setuptools`, que foi substituído pelo :term:`Wheel`. Para detalhes, veja :" +"ref:`egg-format`." -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "Módulo de Extensão" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -3215,11 +3269,11 @@ msgstr "" "extensão .pyd) para extensões Python no Windows ou um arquivo de classe Java " "para extensões Jython." -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "Known Good Set (KGS)" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -3234,11 +3288,11 @@ msgstr "" "usado por frameworks e kits de ferramentas que são compostos de várias " "distribuições individuais." -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "Pacote de Importação" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." @@ -3246,7 +3300,7 @@ msgstr "" "Um módulo Python que pode conter outros módulos ou recursivamente, outros " "pacotes." -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -3260,11 +3314,24 @@ msgstr "" "comumente chamado de \"pacote\" . Veja :ref:`distribution-package-vs-import-" "package` para uma explicação das diferenças." -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +#, fuzzy +#| msgid "Installer" +msgid "Installed Project" +msgstr "Instalador" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "Módulo" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." @@ -3272,11 +3339,11 @@ msgstr "" "A unidade básica de reutilização de código em Python, existindo em um dos " "dois tipos: :term:`Módulo Puro` ou :term:`Módulo de Extensão`." -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "Índice de Pacotes" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." @@ -3284,11 +3351,11 @@ msgstr "" "Um repositório de distribuições com uma interface web para automatizar " "descoberta e consumo de :term:`pacotes `." -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "Índice Por Projeto" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " @@ -3298,12 +3365,12 @@ msgstr "" "term:`Projeto` específico como o índice preferido ou necessário para " "resolver dependências desse projeto." -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "Projeto" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " @@ -3313,7 +3380,7 @@ msgstr "" "outros recursos, ou alguma combinação dos mesmos que se destina a ser " "empacotado em uma :term:`Distribuição `." -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -3327,7 +3394,7 @@ msgstr "" "que contém um arquivo :term:`pyproject.toml`, :term:`setup.py` ou :term:" "`setup.cfg` na raiz do diretório fonte do projeto." -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -3339,7 +3406,7 @@ msgstr "" "`Lançamentos `, e cada lançamento pode incluir uma ou mais :term:" "`distribuições `." -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -3351,11 +3418,61 @@ msgstr "" "É possível instalar uma distribuição do projeto \"foo\" e fazer com que ele " "forneça um pacote importável apenas como \"bar\"." -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +#, fuzzy +#| msgid "Projects in subdirectories" +msgid "Project Root Directory" +msgstr "Projetos em subdiretórios" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +#, fuzzy +#| msgid "Project Summaries" +msgid "Project Source Tree" +msgstr "Resumos de projetos" + +#: ../source/glossary.rst:201 +#, fuzzy +#| msgid "" +#| "An archive containing the raw source code for a :term:`Release`, prior to " +#| "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" +"Um arquivo contendo o código-fonte bruto para um :term:`Lançamento " +"`, antes da criação de uma :term:`Distribuição Fonte ` ou :term:`Distribuição Construída `." + +#: ../source/glossary.rst:207 +#, fuzzy +#| msgid "Project Summaries" +msgid "Project Source Metadata" +msgstr "Resumos de projetos" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "Módulo Puro" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." @@ -3363,11 +3480,48 @@ msgstr "" "Um :term:`Módulo` escrito em Python e contido em um único arquivo ``.py`` (e " "possivelmente arquivos ``.pyc`` e/ou ``.pyo`` associados)." -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +#, fuzzy +#| msgid "Project name" +msgid "Pyproject Metadata" +msgstr "Nome do projeto" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +#, fuzzy +#| msgid "Declaring project metadata" +msgid "Pyproject Metadata Key" +msgstr "Declarando os metadados do projeto" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "Python Packaging Authority (PyPA)" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -3383,11 +3537,11 @@ msgstr "" "sig `_ e " "`o fórum Discourse do Python `__." -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "Python Package Index (PyPI)" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " @@ -3397,11 +3551,11 @@ msgstr "" "comunidade Python. Está aberto a todos os desenvolvedores Python para " "consumir e distribuir suas distribuições." -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "pypi.org" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." @@ -3411,22 +3565,22 @@ msgstr "" "Index (PyPI)`. Ele substituiu o nome de domínio do índice legado, ``pypi." "python.org``, em 2017. Ele é tornado possível pelo :ref:`warehouse`." -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "pyproject.toml" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" "O arquivo de especificação agnóstica de ferramenta para :term:`Projetos " "`. Definido na :pep:`518`." -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "Lançamento" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." @@ -3434,7 +3588,7 @@ msgstr "" "Um snapshot de um :term:`Projeto` em um determinado ponto no tempo, denotado " "por um identificador de versão." -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -3446,11 +3600,11 @@ msgstr "" "projeto foi lançada, ele pode estar disponível em um formato de distribuição " "fonte e um formato de distribuição de instalador do Windows." -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "Requisito" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -3464,11 +3618,11 @@ msgstr "" "podem ser consideradas um \"requisito\". Para obter mais informações, " "consulte a referência de :ref:`pip:pip install`." -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "Especificador de Requisitos" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -3481,11 +3635,11 @@ msgstr "" "onde \"foo\" é o nome do projeto e a parte \">=1.3\" é o :term:" "`Especificador de Versão`" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "Arquivo de Requisitos" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " @@ -3495,17 +3649,17 @@ msgstr "" "ser instalados usando :ref:`pip`. Para mais informações, veja a " "documentação :ref:`pip` em :ref:`pip:Requirements Files`." -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "setup.py" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "setup.cfg" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." @@ -3513,11 +3667,11 @@ msgstr "" "Os arquivos de especificação do projeto para :ref:`distutils` e :ref:" "`setuptools`. Veja também :term:`pyproject.toml`." -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "Arquivo Fonte" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` ou :term:`Distribuição Construída `." -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "Distribuição Fonte (ou \"sdist\")" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 +#, fuzzy +#| msgid "" +#| "A :term:`distribution ` format (usually generated " +#| "using ``python -m build --sdist``) that provides metadata and the " +#| "essential source files needed for installing by a tool like :ref:`pip`, " +#| "or for generating a :term:`Built Distribution`. See :ref:`package-" +#| "formats` for more information." msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " @@ -3543,14 +3704,14 @@ msgstr "" "Um formato de :term:`distribuição ` (geralmente gerado " "usando ``python -m build sdist``) que fornece metadados e os arquivos-fonte " "essenciais necessários para a instalação por uma ferramenta como :ref:`pip`, " -"ou para gerar uma :term:`Distribuição Construída `. Veja " -":ref:`package-formats` para mais informações." +"ou para gerar uma :term:`Distribuição Construída `. " +"Veja :ref:`package-formats` para mais informações." -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "Pacote de Sistemas" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." @@ -3558,11 +3719,11 @@ msgstr "" "Um pacote fornecido em um formato nativo para o sistema operacional, por " "exemplo, um arquivo rpm ou dpkg." -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "Especificador de Versão" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -3577,11 +3738,11 @@ msgstr "" "oferece suporte atualmente. O suporte para esta especificação foi " "implementado no :ref:`setuptools` v8.0 e no :ref:`pip` v6.0." -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "Ambiente Virtual" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -3593,23 +3754,41 @@ msgstr "" "sistema. Para obter mais informações, consulte a seção sobre :ref:`Creating " "and using Virtual Environments`." -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +#, fuzzy +#| msgid "File Format" +msgid "Wheel Format" +msgstr "Formato de arquivos" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "Wheel" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -"O formato padrão de :term:`Distribuição Construída`. Veja :ref:`package-" -"formats` para mais informações." -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +#, fuzzy +#| msgid "Project" +msgid "Wheel Project" +msgstr "Projeto" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "Conjunto de Trabalho" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -5883,9 +6062,9 @@ msgid "" "Apache server" msgstr "" "usando `mod_rewrite `_ e " -"`mod_cache_disk `_, você pode armazenar em cache as solicitações para " -"índices de pacotes por meio de um servidor Apache" +"`mod_cache_disk `_, você pode armazenar em cache as solicitações para índices de " +"pacotes por meio de um servidor Apache" #: ../source/guides/hosting-your-own-index.rst:131 msgid "" @@ -9389,12 +9568,11 @@ msgid "" msgstr "" "Pode ser necessário gerenciar suas permissões do ``GITHUB_TOKEN`` para " "permitir a criação da versão do GitHub. Consulte a `documentação do GitHub " -"`_ para " -"obter instruções. Especificamente, o token precisa da permissão ``contents: " -"write``." +"`_ para obter instruções. Especificamente, o token precisa da " +"permissão ``contents: write``." #: ../source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst:182 msgid "Finally, the signed distributions are uploaded to the GitHub Release." @@ -10467,8 +10645,8 @@ msgid "" "`virtualenv` (PyPA project) and :doc:`venv ` (part of " "the Python standard library, though missing some features of virtualenv)." msgstr "" -"As ferramentas padrão para criar e usar ambientes virtuais manualmente são " -":ref:`virtualenv` (projeto PyPA) e :doc:`venv ` (parte " +"As ferramentas padrão para criar e usar ambientes virtuais manualmente são :" +"ref:`virtualenv` (projeto PyPA) e :doc:`venv ` (parte " "da biblioteca padrão Python, embora falte alguns recursos do virtualenv) ." #: ../source/guides/tool-recommendations.rst:28 @@ -10504,15 +10682,15 @@ msgstr "" "executados a partir da linha de comando. Pipx é um wrapper em torno de pip e " "venv que instala cada aplicativo em um ambiente virtual dedicado. Isso evita " "conflitos entre as dependências de diferentes aplicações, e também com " -"aplicações de todo o sistema que utilizam o mesmo interpretador Python (" -"especialmente no Linux)." +"aplicações de todo o sistema que utilizam o mesmo interpretador Python " +"(especialmente no Linux)." #: ../source/guides/tool-recommendations.rst:43 msgid "" "For scientific software specifically, consider :ref:`Conda` or :ref:`Spack`." msgstr "" -"Especificamente para software científico, considere :ref:`Conda` ou " -":ref:`Spack`." +"Especificamente para software científico, considere :ref:`Conda` ou :ref:" +"`Spack`." #: ../source/guides/tool-recommendations.rst:45 msgid "Write a \"pip vs. Conda\" comparison, here or in a new discussion." @@ -10528,11 +10706,11 @@ msgid "" "background and :ref:`modernize-setup-py-project` for migration advice)." msgstr "" "**Não** use ``easy_install`` (parte de :ref:`setuptools`), que foi " -"descontinuado em favor do pip (veja :ref:`pip vs easy_install` para detalhes)" -". Da mesma forma, **não** use ``python setup.py install`` ou ``python " -"setup.py development``, que também foram descontinuados (veja :ref:`setup-py-" -"deprecated` para aprofundamento e :ref :`modernize-setup-py-project` para " -"aconselhamento sobre migração)." +"descontinuado em favor do pip (veja :ref:`pip vs easy_install` para " +"detalhes). Da mesma forma, **não** use ``python setup.py install`` ou " +"``python setup.py development``, que também foram descontinuados (veja :ref:" +"`setup-py-deprecated` para aprofundamento e :ref :`modernize-setup-py-" +"project` para aconselhamento sobre migração)." #: ../source/guides/tool-recommendations.rst:55 msgid "Lock files" @@ -15852,7 +16030,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -17182,7 +17360,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "Especificação" @@ -19392,25 +19570,25 @@ msgstr "" "padrões e de proposição de novos está documentado em `pypa.io `__." -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 #, fuzzy msgid "Inline script metadata" msgstr "Declarando os metadados do projeto" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -19421,7 +19599,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -19431,158 +19609,158 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 msgid "Example" msgstr "Exemplo" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 #, fuzzy msgid "Reference Implementation" msgstr "Tipos de documentação" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 #, fuzzy msgid "Recommendations" msgstr "Recomendações de ferramentas" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " @@ -26964,6 +27142,13 @@ msgid "" "the file is empty)." msgstr "" +#~ msgid "" +#~ "The standard :term:`Built Distribution` format. See :ref:`package-" +#~ "formats` for more information." +#~ msgstr "" +#~ "O formato padrão de :term:`Distribuição Construída`. Veja :ref:`package-" +#~ "formats` para mais informações." + #~ msgid "The summary description of the project." #~ msgstr "A descrição resumida do projeto." @@ -28157,9 +28342,6 @@ msgstr "" #~ "declarar quaisquer dependências de nível Python que devem ser instaladas " #~ "para executar o sistema de construção do projeto com sucesso." -#~ msgid "Declaring project metadata" -#~ msgstr "Declarando os metadados do projeto" - #~ msgid "" #~ ":pep:`621` specifies how to write a project's :ref:`core metadata ` in a ``pyproject.toml`` file for packaging-related tools to " diff --git a/locales/ro/LC_MESSAGES/messages.po b/locales/ro/LC_MESSAGES/messages.po index 8afa06960..8e6d88d3c 100644 --- a/locales/ro/LC_MESSAGES/messages.po +++ b/locales/ro/LC_MESSAGES/messages.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-15 16:02+0000\n" "PO-Revision-Date: 2021-08-20 01:32+0000\n" "Last-Translator: GUILHERME FERNANDES NETO \n" "Language-Team: Romanian ` and builds a source distribution or :term:" -"`wheel ` from it. The build is delegated to the backend by a :term:" +"A library that takes a source tree and builds a :term:`source distribution " +"` or :term:`built distribution ` from it. The build is delegated to the backend by a :term:" "`frontend `. All backends offer a standardized interface." msgstr "" @@ -2356,18 +2356,63 @@ msgid "" msgstr "" #: ../source/glossary.rst:56 -msgid "Distribution Package" +msgid "Built Metadata" msgstr "" #: ../source/glossary.rst:59 msgid "" +"The concrete form :term:`Core Metadata` takes when included inside an " +"installed :term:`Project` (``METADATA`` file) or a :term:`Distribution " +"Archive` (``PKG-INFO`` in a :term:`Sdist ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +msgid "Core Metadata" +msgstr "" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +msgid "Distribution Archive" +msgstr "" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 +msgid "Distribution Package" +msgstr "" + +#: ../source/glossary.rst:92 +msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " "to distribute a :term:`Release`. The archive file is what an end-user will " "download from the internet and install." msgstr "" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2379,21 +2424,21 @@ msgid "" "breakdown of the differences." msgstr "" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2402,11 +2447,11 @@ msgid "" "Python extensions on Windows, or a Java class file for Jython extensions." msgstr "" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2415,17 +2460,17 @@ msgid "" "distributions." msgstr "" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2434,50 +2479,61 @@ msgid "" "package` for a breakdown of the differences." msgstr "" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +msgid "Installed Project" +msgstr "" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." msgstr "" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." msgstr "" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "Pe Indexul Proiectului" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " "dependencies of that project." msgstr "" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " "into a :term:`Distribution `." msgstr "" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2486,7 +2542,7 @@ msgid "" "`setup.cfg` file at the root of the project source directory." msgstr "" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2494,7 +2550,7 @@ msgid "" "`distributions `." msgstr "" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2502,21 +2558,89 @@ msgid "" "and have it provide a package importable only as 'bar'." msgstr "" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +msgid "Project Root Directory" +msgstr "" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "Modul Pur" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." msgstr "" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +msgid "Pyproject Metadata" +msgstr "" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +msgid "Pyproject Metadata Key" +msgstr "" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2526,48 +2650,48 @@ msgid "" "`the Python Discourse forum `__." msgstr "" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " "distribute their distributions." msgstr "" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." "python.org``, in 2017. It is powered by :ref:`warehouse`." msgstr "" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." msgstr "" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2575,11 +2699,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2588,11 +2712,11 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "Specificator Cerință" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2600,72 +2724,72 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " "on :ref:`pip:Requirements Files`." msgstr "" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." msgstr "" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." msgstr "" -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -2674,11 +2798,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -2686,21 +2810,39 @@ msgid "" "Environments`." msgstr "" -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +msgid "Wheel Format" +msgstr "" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +#, fuzzy +#| msgid "Per Project Index" +msgid "Wheel Project" +msgstr "Pe Indexul Proiectului" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -11803,7 +11945,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -12809,7 +12951,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "" @@ -14558,24 +14700,24 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 msgid "Inline script metadata" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -14586,7 +14728,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -14596,156 +14738,156 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 msgid "Example" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 msgid "Reference Implementation" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 msgid "Recommendations" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " diff --git a/locales/ru/LC_MESSAGES/messages.po b/locales/ru/LC_MESSAGES/messages.po index 8db3b5072..2b9b1a86b 100644 --- a/locales/ru/LC_MESSAGES/messages.po +++ b/locales/ru/LC_MESSAGES/messages.po @@ -13,11 +13,11 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-15 16:02+0000\n" "PO-Revision-Date: 2024-04-28 16:07+0000\n" "Last-Translator: gfbdrgng \n" -"Language-Team: Russian \n" +"Language-Team: Russian \n" "Language: ru\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -2268,8 +2268,8 @@ msgstr "" "Различные Python-проекты могут использовать различные схемы версионирования " "в зависимости от потребностей конкретного проекта, но для совместимости с " "такими инструментами, как :ref:`pip`, все они должны соответствовать гибкому " -"формату идентификаторов версий, для которого авторитетной ссылкой является " -":ref:`specification of version specifiers `. Вот " +"формату идентификаторов версий, для которого авторитетной ссылкой является :" +"ref:`specification of version specifiers `. Вот " "несколько примеров номеров версий [#version-examples]_:" #: ../source/discussions/versioning.rst:21 @@ -2969,10 +2969,16 @@ msgid "Build Backend" msgstr "Создание бэкэнда" #: ../source/glossary.rst:17 -msgid "" -"A library that takes a source tree or :term:`source distribution ` and builds a source distribution or :term:" -"`wheel ` from it. The build is delegated to the backend by a :term:" +#, fuzzy +#| msgid "" +#| "A library that takes a source tree or :term:`source distribution ` and builds a source distribution or :term:" +#| "`wheel ` from it. The build is delegated to the backend by a :term:" +#| "`frontend `. All backends offer a standardized interface." +msgid "" +"A library that takes a source tree and builds a :term:`source distribution " +"` or :term:`built distribution ` from it. The build is delegated to the backend by a :term:" "`frontend `. All backends offer a standardized interface." msgstr "" "Библиотека, которая принимает дерево исходных текстов или :term:`source " @@ -3048,10 +3054,59 @@ msgstr "" "Python)." #: ../source/glossary.rst:56 +msgid "Built Metadata" +msgstr "" + +#: ../source/glossary.rst:59 +msgid "" +"The concrete form :term:`Core Metadata` takes when included inside an " +"installed :term:`Project` (``METADATA`` file) or a :term:`Distribution " +"Archive` (``PKG-INFO`` in a :term:`Sdist ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +#, fuzzy +#| msgid "Configuring metadata" +msgid "Core Metadata" +msgstr "Конфигурирование метаданных" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +#, fuzzy +#| msgid "Distribution Package" +msgid "Distribution Archive" +msgstr "Пакет дистрибутива" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 msgid "Distribution Package" msgstr "Пакет дистрибутива" -#: ../source/glossary.rst:59 +#: ../source/glossary.rst:92 msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " @@ -3063,7 +3118,7 @@ msgstr "" "используются для распространения :term:`Release`. Архивный файл - это то, " "что конечный пользователь скачает из интернета и установит." -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -3082,11 +3137,11 @@ msgstr "" "Python), которые часто обозначаются одним термином \"дистрибутив\". Разбор " "различий см. в :ref:`distribution-package-vs-import-package`." -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "Яйцо" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." @@ -3094,11 +3149,11 @@ msgstr "" "Формат :term:`Built Distribution`, введенный :ref:`setuptools`, который был " "заменен :term:`Wheel`. Подробности см. в :ref:`egg-format`." -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "Модуль расширения" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -3112,11 +3167,11 @@ msgstr "" "объектов (.so) для расширений Python на Unix, DLL (с расширением .pyd) для " "расширений Python на Windows, или в файле классов Java для расширений Jython." -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "Known Good Set (KGS, Известный хороший набор)" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -3130,11 +3185,11 @@ msgstr "" "используется во фреймворках и наборах инструментов, которые состоят из " "нескольких отдельных дистрибутивов." -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "Import Package (Импортируемый пакет)" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." @@ -3142,7 +3197,7 @@ msgstr "" "Модуль Python, который может содержать другие модули или, рекурсивно, другие " "пакеты." -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -3156,11 +3211,24 @@ msgstr "" "также обычно называется \"пакет\". Различия см. в :ref:`distribution-package-" "vs-import-package`." -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +#, fuzzy +#| msgid "Installer" +msgid "Installed Project" +msgstr "Установщик" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "Модуль" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." @@ -3169,11 +3237,11 @@ msgstr "" "одном из двух типов: :термин: «чистый модуль» или :термин: «модуль " "расширения»." -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "Индекс пакета" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." @@ -3181,11 +3249,11 @@ msgstr "" "Репозиторий дистрибутивов с веб-интерфейсом для автоматизации :term:`package " "` обнаружения и потребления." -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "Индекс на проект" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " @@ -3195,12 +3263,12 @@ msgstr "" "конкретным:термин: «проект» как индекс, предпочтительный или необходимый для " "решения зависимостей этого проекта." -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "Проект" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " @@ -3210,7 +3278,7 @@ msgstr "" "других ресурсов, или определенная их комбинация, которая должна быть " "упакована в :term:`Distribution `." -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -3224,7 +3292,7 @@ msgstr "" "время является то, что содержит :term:`pyproject.toml`, :term:`setup.py` " "или :term:`setup.cfg` файл в корне исходного каталога проекта." -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -3236,7 +3304,7 @@ msgstr "" "несколько :term:`Releases `, а каждый релиз может состоять из " "одного или нескольких :term:`distributions `." -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -3248,11 +3316,60 @@ msgstr "" "обязательно так. Можно установить дистрибутив из проекта 'foo' и получить от " "него пакет, импортируемый только как 'bar'." -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +#, fuzzy +#| msgid "Projects in subdirectories" +msgid "Project Root Directory" +msgstr "Проекты в подкаталогах" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +#, fuzzy +#| msgid "Project Summaries" +msgid "Project Source Tree" +msgstr "Обзор проектов" + +#: ../source/glossary.rst:201 +#, fuzzy +#| msgid "" +#| "An archive containing the raw source code for a :term:`Release`, prior to " +#| "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" +"Архив, содержащий исходный код для :term:`Release`, до создания :term:" +"`Source Distribution ` или :term:`Built " +"Distribution`." + +#: ../source/glossary.rst:207 +#, fuzzy +#| msgid "Project Summaries" +msgid "Project Source Metadata" +msgstr "Обзор проектов" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "Чистый модуль" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." @@ -3260,11 +3377,48 @@ msgstr "" "Модуль, написанный на языке Python и содержащийся в одном файле ``.py`` (и, " "возможно, связанных с ним файлах ``.pyc`` и/или ``.pyo``)." -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +#, fuzzy +#| msgid "Project name" +msgid "Pyproject Metadata" +msgstr "Название проекта" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +#, fuzzy +#| msgid "pyproject type" +msgid "Pyproject Metadata Key" +msgstr "тип проекта" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "Python Управление по упаковке (PyPA)" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -3281,11 +3435,11 @@ msgstr "" "distutils-sig.python.org/>`_ и на форуме Python Discourse `__." -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "Индекс пакетов Python (PyPI)" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " @@ -3295,11 +3449,11 @@ msgstr "" "сообщества Python. Он открыт для всех разработчиков Python для потребления и " "распространения их дистрибутивов." -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "pypi.org" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." @@ -3309,22 +3463,22 @@ msgstr "" "Index (PyPI)`. Он заменил устаревшее доменное имя индекса, ``pypi.python." "org``, в 2017 году. Он работает на базе :ref:`warehouse`." -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "pyproject.toml" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" "Инструмент-агностик:термин: файл спецификации \"Проект\". Определен в :pep:" "`518'." -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "Выпуск" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." @@ -3332,7 +3486,7 @@ msgstr "" "Снимок :term:`Project` в определенный момент времени, обозначаемый " "идентификатором версии." -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -3344,11 +3498,11 @@ msgstr "" "была выпущена, она может быть доступна как в формате распределения " "источника, так и в формате Windows." -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "Требование" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -3362,11 +3516,11 @@ msgstr "" "считаться \"требованием\". Для получения дополнительной информации смотрите " "ссылку :ref:`pip:pip install`." -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "Спецификатор требований" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -3378,11 +3532,11 @@ msgstr "" "specifiers`. Например, \"foo>=1.3\" - это спецификатор требований, где " "\"foo\" - это имя проекта, а часть \">=1.3\" - это :term:`Version Specifier`" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "Требования к файлам" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " @@ -3392,17 +3546,17 @@ msgstr "" "быть установлен с помощью :ref:`pip'. Дополнительные сведения см. в :ref:" "`pip'''' docs on :ref:`pip:Requirements Files`." -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "setup.py" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "setup.cfg" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." @@ -3410,11 +3564,11 @@ msgstr "" "Файлы спецификаций проекта для:ref:`distutils' и :ref:`setuptools'. См. " "также :term:`pyproject.toml'." -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "Источник Архив" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` или :term:`Built " "Distribution`." -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "Распространение исходных текстов (или \"sdist\")" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 #, fuzzy #| msgid "" #| "A :term:`distribution ` format (usually generated " @@ -3436,7 +3590,7 @@ msgstr "Распространение исходных текстов (или \ #| "essential source files needed for installing by a tool like :ref:`pip`, " #| "or for generating a :term:`Built Distribution`." msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " @@ -3448,11 +3602,11 @@ msgstr "" "такого инструмента, как:ref:`pip', или для создания:term:`Built " "Distribution'." -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "Системный пакет" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." @@ -3460,11 +3614,11 @@ msgstr "" "Пакет, предоставляемый в формате, имеющем отношение к операционной системе, " "например, файл rpm или dpkg." -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "Спецификатор версии" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -3478,11 +3632,11 @@ msgstr "" "настоящее время поддерживаются. Поддержка этой спецификации была реализована " "в :ref:`setuptools` v8.0 и :ref:`pip` v6.0." -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "Виртуальная среда" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -3494,21 +3648,41 @@ msgstr "" "системы. Для получения дополнительной информации см. раздел :ref:`Создание и " "использование виртуальных сред`." -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +#, fuzzy +#| msgid "File Format" +msgid "Wheel Format" +msgstr "Формат файла" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "Колесо" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +#, fuzzy +#| msgid "Project" +msgid "Wheel Project" +msgstr "Проект" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "Рабочая группа" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -15664,7 +15838,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -16986,7 +17160,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "Спецификация" @@ -19453,11 +19627,11 @@ msgstr "" "стандартов и предложения новых задокументирован на сайте `pypa.io `__." -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 msgid "Inline script metadata" msgstr "Встроенные метаданные сценария" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " @@ -19468,7 +19642,7 @@ msgstr "" "внешним инструментам, которым может понадобиться взаимодействовать с такими " "скриптами." -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." @@ -19476,7 +19650,7 @@ msgstr "" "Эта спецификация определяет формат блока комментариев метаданных (в " "значительной степени вдохновленный `reStructuredText Directives`__)." -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -19494,7 +19668,7 @@ msgstr "" "один пробел, а затем три прямые косые черты. ``TYPE`` ДОЛЖЕН состоять только " "из букв ASCII, цифр и дефисов." -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -19510,7 +19684,7 @@ msgstr "" "противном случае - только первого символа (что означает, что строка состоит " "только из одного ``#``)." -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " @@ -19520,7 +19694,7 @@ msgstr "" "следующая строка не является допустимой строкой встроенного содержимого, как " "описано выше. Например, ниже приведен один полностью допустимый блок:" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " @@ -19530,7 +19704,7 @@ msgstr "" "линиями. В таких случаях инструменты МОГУТ выдать ошибку. Незакрытые блоки " "ДОЛЖНЫ игнорироваться." -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." @@ -19538,7 +19712,7 @@ msgstr "" "Если определено несколько блоков комментариев одного и того же ``типа``, " "инструменты ДОЛЖНЫ выдать ошибку." -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " @@ -19548,7 +19722,7 @@ msgstr "" "кодировки Python. Если они этого не делают, они ДОЛЖНЫ обрабатывать файл в " "кодировке UTF-8." -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" @@ -19556,7 +19730,7 @@ msgstr "" "Это каноническое регулярное выражение, которое МОЖЕТ быть использовано для " "разбора метаданных:" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." @@ -19564,7 +19738,7 @@ msgstr "" "В случае расхождения между текстовой спецификацией и регулярным выражением " "приоритет отдается текстовой спецификации." -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." @@ -19572,11 +19746,11 @@ msgstr "" "Инструменты НЕ ДОЛЖНЫ читать из блоков метаданных с типами, которые не были " "стандартизированы данной спецификацией." -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "тип скрипта" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." @@ -19584,7 +19758,7 @@ msgstr "" "Первый тип блока метаданных называется ``script`, он содержит метаданные " "сценария (данные о зависимостях и конфигурации инструментов)." -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." @@ -19592,18 +19766,18 @@ msgstr "" "Этот документ МОЖЕТ включать поля верхнего уровня ``зависимости`` и " "``требования-python``, и МОЖЕТ опционально включать таблицу ``[инструмент]``." -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " @@ -19613,7 +19787,7 @@ msgstr "" "выполнения. Каждая запись ДОЛЖНА быть действительным :ref:`спецификатором " "зависимости `." -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" @@ -19623,7 +19797,7 @@ msgstr "" "совместим(ы) скрипт. Значение этого поля ДОЛЖНО быть действительным :ref:" "`спецификатором версии `." -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " @@ -19634,11 +19808,11 @@ msgstr "" "если не может быть предоставлена версия Python, удовлетворяющая указанному " "``требованию-python``." -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 msgid "Example" msgstr "Пример" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 #, fuzzy #| msgid "" #| "The following is an example of a script with an embedded ``pyproject." @@ -19646,18 +19820,18 @@ msgstr "Пример" msgid "The following is an example of a script with embedded metadata:" msgstr "Ниже приведен пример сценария со встроенным ``pyproject.toml``:" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 msgid "Reference Implementation" msgstr "Справочное осуществление" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" "Ниже приведен пример того, как читать метаданные на Python 3.11 и выше." -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " @@ -19667,7 +19841,7 @@ msgstr "" "менеджеры пакетов или автоматизация обновления зависимостей в CI. Ниже " "приведен пример изменения содержимого с помощью библиотеки ``tomlkit``." -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " @@ -19677,18 +19851,18 @@ msgstr "" "форматирование TOML. Это ни в коем случае не является обязательным условием " "редактирования, а скорее \"приятная возможность\"." -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "Ниже приведен пример чтения потока произвольных блоков метаданных." -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 msgid "Recommendations" msgstr "Рекомендации" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " @@ -19698,14 +19872,14 @@ msgstr "" "пытаться использовать самую высокую доступную версию Python, совместимую с " "метаданными скрипта ``requires-python``, если они определены." -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" "Октябрь 2023 года: Эта спецификация была условно утверждена через :pep:`723`." -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " @@ -28444,9 +28618,6 @@ msgstr "" #~ "отменена. Подробности см. в ветке `PEP 723 условное принятие `_." -#~ msgid "pyproject type" -#~ msgstr "тип проекта" - #~ msgid "This document MAY include the ``[run]`` and ``[tool]`` tables." #~ msgstr "Этот документ МОЖЕТ включать таблицы ``[run]`` и ``[tool]``." diff --git a/locales/sai/LC_MESSAGES/messages.po b/locales/sai/LC_MESSAGES/messages.po index f884f20a4..5997d9739 100644 --- a/locales/sai/LC_MESSAGES/messages.po +++ b/locales/sai/LC_MESSAGES/messages.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-15 16:02+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Automatically generated\n" "Language-Team: none\n" @@ -2305,9 +2305,9 @@ msgstr "" #: ../source/glossary.rst:17 msgid "" -"A library that takes a source tree or :term:`source distribution ` and builds a source distribution or :term:" -"`wheel ` from it. The build is delegated to the backend by a :term:" +"A library that takes a source tree and builds a :term:`source distribution " +"` or :term:`built distribution ` from it. The build is delegated to the backend by a :term:" "`frontend `. All backends offer a standardized interface." msgstr "" @@ -2352,18 +2352,63 @@ msgid "" msgstr "" #: ../source/glossary.rst:56 -msgid "Distribution Package" +msgid "Built Metadata" msgstr "" #: ../source/glossary.rst:59 msgid "" +"The concrete form :term:`Core Metadata` takes when included inside an " +"installed :term:`Project` (``METADATA`` file) or a :term:`Distribution " +"Archive` (``PKG-INFO`` in a :term:`Sdist ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +msgid "Core Metadata" +msgstr "" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +msgid "Distribution Archive" +msgstr "" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 +msgid "Distribution Package" +msgstr "" + +#: ../source/glossary.rst:92 +msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " "to distribute a :term:`Release`. The archive file is what an end-user will " "download from the internet and install." msgstr "" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2375,21 +2420,21 @@ msgid "" "breakdown of the differences." msgstr "" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2398,11 +2443,11 @@ msgid "" "Python extensions on Windows, or a Java class file for Jython extensions." msgstr "" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2411,17 +2456,17 @@ msgid "" "distributions." msgstr "" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2430,50 +2475,61 @@ msgid "" "package` for a breakdown of the differences." msgstr "" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +msgid "Installed Project" +msgstr "" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." msgstr "" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." msgstr "" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " "dependencies of that project." msgstr "" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " "into a :term:`Distribution `." msgstr "" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2482,7 +2538,7 @@ msgid "" "`setup.cfg` file at the root of the project source directory." msgstr "" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2490,7 +2546,7 @@ msgid "" "`distributions `." msgstr "" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2498,21 +2554,89 @@ msgid "" "and have it provide a package importable only as 'bar'." msgstr "" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +msgid "Project Root Directory" +msgstr "" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." msgstr "" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +msgid "Pyproject Metadata" +msgstr "" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +msgid "Pyproject Metadata Key" +msgstr "" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2522,48 +2646,48 @@ msgid "" "`the Python Discourse forum `__." msgstr "" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " "distribute their distributions." msgstr "" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." "python.org``, in 2017. It is powered by :ref:`warehouse`." msgstr "" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." msgstr "" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2571,11 +2695,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2584,11 +2708,11 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2596,72 +2720,72 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " "on :ref:`pip:Requirements Files`." msgstr "" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." msgstr "" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." msgstr "" -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -2670,11 +2794,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -2682,21 +2806,37 @@ msgid "" "Environments`." msgstr "" -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +msgid "Wheel Format" +msgstr "" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +msgid "Wheel Project" +msgstr "" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -11797,7 +11937,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -12803,7 +12943,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "" @@ -14552,24 +14692,24 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 msgid "Inline script metadata" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -14580,7 +14720,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -14590,156 +14730,156 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 msgid "Example" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 msgid "Reference Implementation" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 msgid "Recommendations" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " diff --git a/locales/si/LC_MESSAGES/messages.po b/locales/si/LC_MESSAGES/messages.po index 20641a470..da5d0308b 100644 --- a/locales/si/LC_MESSAGES/messages.po +++ b/locales/si/LC_MESSAGES/messages.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-15 16:02+0000\n" "PO-Revision-Date: 2022-06-11 08:19+0000\n" "Last-Translator: Kushan Gunasekera \n" "Language-Team: Sinhala ` and builds a source distribution or :term:" -"`wheel ` from it. The build is delegated to the backend by a :term:" +"A library that takes a source tree and builds a :term:`source distribution " +"` or :term:`built distribution ` from it. The build is delegated to the backend by a :term:" "`frontend `. All backends offer a standardized interface." msgstr "" @@ -2356,18 +2356,63 @@ msgid "" msgstr "" #: ../source/glossary.rst:56 -msgid "Distribution Package" +msgid "Built Metadata" msgstr "" #: ../source/glossary.rst:59 msgid "" +"The concrete form :term:`Core Metadata` takes when included inside an " +"installed :term:`Project` (``METADATA`` file) or a :term:`Distribution " +"Archive` (``PKG-INFO`` in a :term:`Sdist ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +msgid "Core Metadata" +msgstr "" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +msgid "Distribution Archive" +msgstr "" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 +msgid "Distribution Package" +msgstr "" + +#: ../source/glossary.rst:92 +msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " "to distribute a :term:`Release`. The archive file is what an end-user will " "download from the internet and install." msgstr "" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2379,21 +2424,21 @@ msgid "" "breakdown of the differences." msgstr "" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2402,11 +2447,11 @@ msgid "" "Python extensions on Windows, or a Java class file for Jython extensions." msgstr "" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2415,17 +2460,17 @@ msgid "" "distributions." msgstr "" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2434,50 +2479,61 @@ msgid "" "package` for a breakdown of the differences." msgstr "" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +msgid "Installed Project" +msgstr "" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." msgstr "" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." msgstr "" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " "dependencies of that project." msgstr "" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " "into a :term:`Distribution `." msgstr "" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2486,7 +2542,7 @@ msgid "" "`setup.cfg` file at the root of the project source directory." msgstr "" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2494,7 +2550,7 @@ msgid "" "`distributions `." msgstr "" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2502,21 +2558,89 @@ msgid "" "and have it provide a package importable only as 'bar'." msgstr "" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +msgid "Project Root Directory" +msgstr "" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." msgstr "" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +msgid "Pyproject Metadata" +msgstr "" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +msgid "Pyproject Metadata Key" +msgstr "" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2526,48 +2650,48 @@ msgid "" "`the Python Discourse forum `__." msgstr "" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " "distribute their distributions." msgstr "" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." "python.org``, in 2017. It is powered by :ref:`warehouse`." msgstr "" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." msgstr "" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2575,11 +2699,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2588,11 +2712,11 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2600,72 +2724,72 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " "on :ref:`pip:Requirements Files`." msgstr "" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." msgstr "" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." msgstr "" -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -2674,11 +2798,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -2686,21 +2810,37 @@ msgid "" "Environments`." msgstr "" -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +msgid "Wheel Format" +msgstr "" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +msgid "Wheel Project" +msgstr "" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -11801,7 +11941,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -12807,7 +12947,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "" @@ -14556,24 +14696,24 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 msgid "Inline script metadata" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -14584,7 +14724,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -14594,156 +14734,156 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 msgid "Example" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 msgid "Reference Implementation" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 msgid "Recommendations" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " diff --git a/locales/sk/LC_MESSAGES/messages.po b/locales/sk/LC_MESSAGES/messages.po index 2b3f56ca9..17bb75b92 100644 --- a/locales/sk/LC_MESSAGES/messages.po +++ b/locales/sk/LC_MESSAGES/messages.po @@ -7,11 +7,11 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-15 16:02+0000\n" "PO-Revision-Date: 2024-04-25 06:07+0000\n" "Last-Translator: Rafael Fontenelle \n" -"Language-Team: Slovak \n" +"Language-Team: Slovak \n" "Language: sk\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -2417,9 +2417,9 @@ msgstr "" #: ../source/glossary.rst:17 msgid "" -"A library that takes a source tree or :term:`source distribution ` and builds a source distribution or :term:" -"`wheel ` from it. The build is delegated to the backend by a :term:" +"A library that takes a source tree and builds a :term:`source distribution " +"` or :term:`built distribution ` from it. The build is delegated to the backend by a :term:" "`frontend `. All backends offer a standardized interface." msgstr "" @@ -2464,18 +2464,63 @@ msgid "" msgstr "" #: ../source/glossary.rst:56 -msgid "Distribution Package" +msgid "Built Metadata" msgstr "" #: ../source/glossary.rst:59 msgid "" +"The concrete form :term:`Core Metadata` takes when included inside an " +"installed :term:`Project` (``METADATA`` file) or a :term:`Distribution " +"Archive` (``PKG-INFO`` in a :term:`Sdist ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +msgid "Core Metadata" +msgstr "" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +msgid "Distribution Archive" +msgstr "" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 +msgid "Distribution Package" +msgstr "" + +#: ../source/glossary.rst:92 +msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " "to distribute a :term:`Release`. The archive file is what an end-user will " "download from the internet and install." msgstr "" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2487,21 +2532,21 @@ msgid "" "breakdown of the differences." msgstr "" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2510,11 +2555,11 @@ msgid "" "Python extensions on Windows, or a Java class file for Jython extensions." msgstr "" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2523,17 +2568,17 @@ msgid "" "distributions." msgstr "" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2542,50 +2587,63 @@ msgid "" "package` for a breakdown of the differences." msgstr "" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +#, fuzzy +#| msgid "Translations" +msgid "Installed Project" +msgstr "Preklady" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." msgstr "" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." msgstr "" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " "dependencies of that project." msgstr "" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "Projekt" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " "into a :term:`Distribution `." msgstr "" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2594,7 +2652,7 @@ msgid "" "`setup.cfg` file at the root of the project source directory." msgstr "" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2602,7 +2660,7 @@ msgid "" "`distributions `." msgstr "" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2610,21 +2668,95 @@ msgid "" "and have it provide a package importable only as 'bar'." msgstr "" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +#, fuzzy +#| msgid "Project name" +msgid "Project Root Directory" +msgstr "Meno projektu" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." msgstr "" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +#, fuzzy +#| msgid "Project name" +msgid "Pyproject Metadata" +msgstr "Meno projektu" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +#, fuzzy +#| msgid "Project name" +msgid "Pyproject Metadata Key" +msgstr "Meno projektu" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2634,48 +2766,48 @@ msgid "" "`the Python Discourse forum `__." msgstr "" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " "distribute their distributions." msgstr "" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." "python.org``, in 2017. It is powered by :ref:`warehouse`." msgstr "" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." msgstr "" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2683,11 +2815,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2696,11 +2828,11 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2708,72 +2840,72 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " "on :ref:`pip:Requirements Files`." msgstr "" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." msgstr "" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." msgstr "" -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -2782,11 +2914,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -2794,21 +2926,39 @@ msgid "" "Environments`." msgstr "" -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +msgid "Wheel Format" +msgstr "" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +#, fuzzy +#| msgid "Project" +msgid "Wheel Project" +msgstr "Projekt" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -11935,7 +12085,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -12941,7 +13091,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "" @@ -14694,24 +14844,24 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 msgid "Inline script metadata" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -14722,7 +14872,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -14732,158 +14882,158 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 msgid "Example" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 #, fuzzy #| msgid "Documentation types" msgid "Reference Implementation" msgstr "Typy dokumentov" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 msgid "Recommendations" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " @@ -21223,8 +21373,3 @@ msgid "" "recommended to stick with *regular packages* and ``__init__.py`` (even if " "the file is empty)." msgstr "" - -#, fuzzy -#~| msgid "Project name" -#~ msgid "pyproject type" -#~ msgstr "Meno projektu" diff --git a/locales/uk/LC_MESSAGES/messages.po b/locales/uk/LC_MESSAGES/messages.po index 9c3d352e3..7ad43b821 100644 --- a/locales/uk/LC_MESSAGES/messages.po +++ b/locales/uk/LC_MESSAGES/messages.po @@ -15,7 +15,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-15 16:02+0000\n" "PO-Revision-Date: 2024-03-01 20:00+0000\n" "Last-Translator: Sviatoslav Sydorenko \n" "Language-Team: Ukrainian ` and builds a source distribution or :term:" -"`wheel ` from it. The build is delegated to the backend by a :term:" +"A library that takes a source tree and builds a :term:`source distribution " +"` or :term:`built distribution ` from it. The build is delegated to the backend by a :term:" "`frontend `. All backends offer a standardized interface." msgstr "" @@ -2705,10 +2705,57 @@ msgid "" msgstr "" #: ../source/glossary.rst:56 +msgid "Built Metadata" +msgstr "" + +#: ../source/glossary.rst:59 +msgid "" +"The concrete form :term:`Core Metadata` takes when included inside an " +"installed :term:`Project` (``METADATA`` file) or a :term:`Distribution " +"Archive` (``PKG-INFO`` in a :term:`Sdist ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +msgid "Core Metadata" +msgstr "" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +#, fuzzy +#| msgid "Distribution Package" +msgid "Distribution Archive" +msgstr "Дистриб'юторський пакет" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 msgid "Distribution Package" msgstr "Дистриб'юторський пакет" -#: ../source/glossary.rst:59 +#: ../source/glossary.rst:92 msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " @@ -2716,7 +2763,7 @@ msgid "" "download from the internet and install." msgstr "" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2728,11 +2775,11 @@ msgid "" "breakdown of the differences." msgstr "" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "Яйце" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 #, fuzzy #| msgid "" #| "The :term:`Egg` format was introduced by :ref:`setuptools` in 2004, " @@ -2744,11 +2791,11 @@ msgstr "" "Формат :term:`Egg` був представлений :ref:`setuptools` у 2004 році, тоді як " "формат :term:`Wheel` був представлений :pep:`427` у 2012 році." -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "Модуль розширення" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2757,11 +2804,11 @@ msgid "" "Python extensions on Windows, or a Java class file for Jython extensions." msgstr "" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2770,17 +2817,17 @@ msgid "" "distributions." msgstr "" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "Імпорт пакету" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2789,50 +2836,63 @@ msgid "" "package` for a breakdown of the differences." msgstr "" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +#, fuzzy +#| msgid "Installer" +msgid "Installed Project" +msgstr "Встановлювач" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "Модуль" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." msgstr "" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "Реєстр Пакунків" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." msgstr "" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "Індекс за проєктом" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " "dependencies of that project." msgstr "" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "Проєкт" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " "into a :term:`Distribution `." msgstr "" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2841,7 +2901,7 @@ msgid "" "`setup.cfg` file at the root of the project source directory." msgstr "" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2849,7 +2909,7 @@ msgid "" "`distributions `." msgstr "" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2857,21 +2917,95 @@ msgid "" "and have it provide a package importable only as 'bar'." msgstr "" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +#, fuzzy +#| msgid "Project name" +msgid "Project Root Directory" +msgstr "Назва проєкту" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "Чистий модуль" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." msgstr "" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +#, fuzzy +#| msgid "Project name" +msgid "Pyproject Metadata" +msgstr "Назва проєкту" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +#, fuzzy +#| msgid "pyproject.toml" +msgid "Pyproject Metadata Key" +msgstr "pyproject.toml" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "Управління з пакування Python (PyPA)" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2881,48 +3015,48 @@ msgid "" "`the Python Discourse forum `__." msgstr "" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "Реєстр Python-пакунків (PyPI)" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " "distribute their distributions." msgstr "" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "pypi.org" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." "python.org``, in 2017. It is powered by :ref:`warehouse`." msgstr "" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "pyproject.toml" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "Випуск" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." msgstr "" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2930,11 +3064,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2943,11 +3077,11 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "Специфікатор вимоги" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2955,72 +3089,72 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " "on :ref:`pip:Requirements Files`." msgstr "" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "setup.py" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "setup.cfg" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." msgstr "" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "Вихідний архів" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." msgstr "" -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "Специфікатор версії" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -3029,11 +3163,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -3041,21 +3175,41 @@ msgid "" "Environments`." msgstr "" -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +#, fuzzy +#| msgid "Format::" +msgid "Wheel Format" +msgstr "Формат::" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "Колесо" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +#, fuzzy +#| msgid "Project" +msgid "Wheel Project" +msgstr "Проєкт" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -12286,7 +12440,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -13294,7 +13448,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "Специфікація" @@ -15077,24 +15231,24 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 msgid "Inline script metadata" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -15105,7 +15259,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -15115,161 +15269,161 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 #, fuzzy msgid "Example" msgstr "Приклади" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 #, fuzzy #| msgid "Documentation types" msgid "Reference Implementation" msgstr "Типи документації" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 #, fuzzy #| msgid "Packaging tool recommendations" msgid "Recommendations" msgstr "Поради щодо засобу пакування" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " @@ -21732,11 +21886,6 @@ msgstr "" #~ msgid "Pre-release versioning" #~ msgstr "Версіонування попередніх випусків" -#, fuzzy -#~| msgid "pyproject.toml" -#~ msgid "pyproject type" -#~ msgstr "pyproject.toml" - #~ msgid "" #~ "`Heroku `_" diff --git a/locales/zh_Hans/LC_MESSAGES/messages.po b/locales/zh_Hans/LC_MESSAGES/messages.po index f4e59e575..474cd8a0f 100644 --- a/locales/zh_Hans/LC_MESSAGES/messages.po +++ b/locales/zh_Hans/LC_MESSAGES/messages.po @@ -29,7 +29,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-15 16:02+0000\n" "PO-Revision-Date: 2024-04-04 03:43+0000\n" "Last-Translator: 大王叫我来巡山 \n" @@ -2566,9 +2566,9 @@ msgstr "" #: ../source/glossary.rst:17 msgid "" -"A library that takes a source tree or :term:`source distribution ` and builds a source distribution or :term:" -"`wheel ` from it. The build is delegated to the backend by a :term:" +"A library that takes a source tree and builds a :term:`source distribution " +"` or :term:`built distribution ` from it. The build is delegated to the backend by a :term:" "`frontend `. All backends offer a standardized interface." msgstr "" @@ -2628,10 +2628,57 @@ msgstr "" "编译 Python 文件（:term:` Wheel ` 故意不包括编译的 Python 文件）。" #: ../source/glossary.rst:56 +msgid "Built Metadata" +msgstr "" + +#: ../source/glossary.rst:59 +msgid "" +"The concrete form :term:`Core Metadata` takes when included inside an " +"installed :term:`Project` (``METADATA`` file) or a :term:`Distribution " +"Archive` (``PKG-INFO`` in a :term:`Sdist ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +msgid "Core Metadata" +msgstr "" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +#, fuzzy +#| msgid "Distribution Package" +msgid "Distribution Archive" +msgstr "发行版" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 msgid "Distribution Package" msgstr "发行版" -#: ../source/glossary.rst:59 +#: ../source/glossary.rst:92 msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " @@ -2642,7 +2689,7 @@ msgstr "" "`modules ` 和其他用于分发:term:`Release` 的资源文件的版本化存档文件。" "存档文件是最终用户将从 Internet 下载并安装的文件。" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 #, fuzzy #| msgid "" #| "A distribution package is more commonly referred to with the single words " @@ -2666,11 +2713,11 @@ msgstr "" "Package` 混淆时，本指南可能会使用扩展术语（通常也称为“包”）或另一种发行版（例" "如 Linux 发行版或 Python 语言发行版），通常用单个术语“发行版”来指代。" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "Egg" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." @@ -2678,11 +2725,11 @@ msgstr "" "一种 :term:`构建分发` 格式，由 :ref:`setuptools` 引入，已被 :term:`Wheel` 替" "代。详见： :ref:`egg-format`." -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "扩展模块" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2695,11 +2742,11 @@ msgstr "" "享对象 (.so) 文件、Windows 上 Python 扩展的 DLL（给定 .pyd 扩展）或 Jython 扩" "展的 Java 类文件。" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "已知良好集 (KGS)" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2711,17 +2758,17 @@ msgstr "" "包被声明为已知良好集之前通过所有测试。 该术语通常用于由多个单独发行版组成的框" "架和工具包。" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "导入包" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "一个Python模块，可以包含其他模块或递归地包含其他包。" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 #, fuzzy #| msgid "" #| "An import package is more commonly referred to with the single word " @@ -2738,11 +2785,24 @@ msgstr "" "导入包通常用单个词“包”来指代，但本指南将在需要更清楚地说明时使用扩展术语，以" "防止与通常也称为“包”的 :term:`分发包` 混淆." -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +#, fuzzy +#| msgid "Installer" +msgid "Installed Project" +msgstr "安装程序" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "模块" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." @@ -2750,11 +2810,11 @@ msgstr "" "Python 中代码可重用性的基本单元，存在于以下两种类型之一：:term:`Pure Module` " "或 :term:`Extension Module`。" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "包索引" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." @@ -2762,11 +2822,11 @@ msgstr "" "一个带有 Web 界面的发行版存储库，用于自动化 :term:`package ` 发现和消费。" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "每个项目索引（Per Project Index）" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " @@ -2775,12 +2835,12 @@ msgstr "" "专用或其他非规范的：term:`Package Index`由特定的：term:`Project`表示，作为首" "选索引或解决该项目依赖关系所需的索引。" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "项目" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " @@ -2789,7 +2849,7 @@ msgstr "" "数据或其他资源的库、框架、脚本、插件、应用程序或集合，或其组合，旨在打包成:" "term:`Distribution `。" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2802,7 +2862,7 @@ msgstr "" "另一个实际方式是在项目源目录下包含 :term:`pyproject.toml`、 :term:`setup.py`" "或 :term:`setup.cfg` 文件的东西。" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2814,7 +2874,7 @@ msgstr "" "` ，每个版本可能包括一个或多个 :term:`套件 ` 。" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2825,11 +2885,52 @@ msgstr "" "这并不一定是真的。可以从项目“foo”安装一个发行版，并让它提供一个只能作" "为“bar”导入的包。" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +#, fuzzy +#| msgid "Projects in subdirectories" +msgid "Project Root Directory" +msgstr "子目录中的项目" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +#, fuzzy +#| msgid "Project Summaries" +msgid "Project Source Tree" +msgstr "项目摘要" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +#, fuzzy +#| msgid "Project Summaries" +msgid "Project Source Metadata" +msgstr "项目摘要" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "纯模块 (Pure Module)" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." @@ -2837,11 +2938,47 @@ msgstr "" "一个 :term:`Module`，使用 Python 编写并包含在单个 ``.py`` 文件 中（可能还有相" "关的 ``.pyc`` 和/或者 ``.pyo`` 文件）。" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +#, fuzzy +#| msgid "Project name" +msgid "Pyproject Metadata" +msgstr "项目名称" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +#, fuzzy +msgid "Pyproject Metadata Key" +msgstr "pyproject.toml" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "Python 包装管理局 （PyPA）" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2857,11 +2994,11 @@ msgstr "" "和 `Python Discourse 论坛 `__ 上讨论" "问题。" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "Python 包索引 (PyPI)" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " @@ -2870,11 +3007,11 @@ msgstr "" "`PyPI `_ 是 Python 社区的默认 :term:`包索引 (Package " "Index) ` 。所有 Python 开发人员都可以使用和分发他们的发行版。" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "pypi.org" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." @@ -2884,26 +3021,26 @@ msgstr "" "名。它在2017年取代了旧的索引域名， ``pypi.python.org`` ，并由 :ref:" "`warehouse` 提供支持。" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "pyproject.toml" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "发行版 （Release）" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." msgstr "" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2911,11 +3048,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "要求 (Requirement)" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2924,11 +3061,11 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "需求说明符" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2936,11 +3073,11 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "需求文件" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " @@ -2950,17 +3087,17 @@ msgstr "" "使用 :ref:`pip` 来安装。更多信息，请参阅 :ref:`pip` 文档的 :ref:`pip:" "Requirements Files` 。" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "setup.py" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "setup.cfg" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." @@ -2968,45 +3105,45 @@ msgstr "" ":ref:`distutils` 和 :ref:`setuptools` 的项目规范文件。另见 :term:`pyproject." "toml`。" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "源代码归档" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "源代码分发（或“sdist”）" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "系统包 (System Package)" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." msgstr "以操作系统本地格式提供的软件包，例如 rpm 或 dpkg 文件。" -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "版本说明符 (Version Specifier)" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -3015,11 +3152,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "虚拟环境 (Virtual Environment)" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -3029,21 +3166,39 @@ msgstr "" "一个隔离的 Python 环境，允许安装软件包以供特定的应用程序使用，而不是在系统中" "安装。更多信息，请参见章节 :ref:`Creating and using Virtual Environments`." -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +msgid "Wheel Format" +msgstr "" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "Wheel" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +#, fuzzy +#| msgid "Project" +msgid "Wheel Project" +msgstr "项目" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "工作集 (Working Set)" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -12541,7 +12696,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -13548,7 +13703,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "技术参数" @@ -15310,24 +15465,24 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 msgid "Inline script metadata" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -15338,7 +15493,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -15348,158 +15503,158 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 msgid "Example" msgstr "例子" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 #, fuzzy msgid "Reference Implementation" msgstr "文档类型" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 #, fuzzy msgid "Recommendations" msgstr "创建文档" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " @@ -21938,10 +22093,6 @@ msgstr "" #~ msgid "Caching with devpi" #~ msgstr "使用 devpi 进行缓存" -#, fuzzy -#~ msgid "pyproject type" -#~ msgstr "pyproject.toml" - #~ msgid "`OpenShift `_" #~ msgstr "`OpenShift `_" diff --git a/locales/zh_Hant/LC_MESSAGES/messages.po b/locales/zh_Hant/LC_MESSAGES/messages.po index 8e2b382f4..aca79a985 100644 --- a/locales/zh_Hant/LC_MESSAGES/messages.po +++ b/locales/zh_Hant/LC_MESSAGES/messages.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python Packaging User Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-04-18 14:36+0000\n" +"POT-Creation-Date: 2024-05-15 16:02+0000\n" "PO-Revision-Date: 2022-07-30 20:04+0000\n" "Last-Translator: meowmeowmeowcat \n" "Language-Team: Chinese (Traditional) ` and builds a source distribution or :term:" -"`wheel ` from it. The build is delegated to the backend by a :term:" +"A library that takes a source tree and builds a :term:`source distribution " +"` or :term:`built distribution ` from it. The build is delegated to the backend by a :term:" "`frontend `. All backends offer a standardized interface." msgstr "" @@ -2397,18 +2397,63 @@ msgid "" msgstr "" #: ../source/glossary.rst:56 -msgid "Distribution Package" +msgid "Built Metadata" msgstr "" #: ../source/glossary.rst:59 msgid "" +"The concrete form :term:`Core Metadata` takes when included inside an " +"installed :term:`Project` (``METADATA`` file) or a :term:`Distribution " +"Archive` (``PKG-INFO`` in a :term:`Sdist ` and ``METADATA`` in a :term:`Wheel`)." +msgstr "" + +#: ../source/glossary.rst:66 +msgid "Core Metadata" +msgstr "" + +#: ../source/glossary.rst:69 +msgid "" +"The :ref:`specification ` and the set of :term:`Core Metadata " +"Field`\\s it defines that describe key static attributes of a :term:" +"`Distribution Package` or :term:`Installed Project`." +msgstr "" + +#: ../source/glossary.rst:74 +msgid "Core Metadata Field" +msgstr "" + +#: ../source/glossary.rst:77 +msgid "" +"A single key-value pair (or sequence of such with the same name, for " +"multiple-use fields) defined in the :term:`Core Metadata` spec and stored in " +"the :term:`Built Metadata`. Notably, distinct from a :term:`Pyproject " +"Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:83 +msgid "Distribution Archive" +msgstr "" + +#: ../source/glossary.rst:86 +msgid "" +"The physical distribution artifact (i.e. a file on disk) for a :term:" +"`Distribution Package`." +msgstr "" + +#: ../source/glossary.rst:89 +msgid "Distribution Package" +msgstr "" + +#: ../source/glossary.rst:92 +msgid "" "A versioned archive file that contains Python :term:`packages `, :term:`modules `, and other resource files that are used " "to distribute a :term:`Release`. The archive file is what an end-user will " "download from the internet and install." msgstr "" -#: ../source/glossary.rst:64 +#: ../source/glossary.rst:97 msgid "" "A distribution package is more commonly referred to with the single words " "\"package\" or \"distribution\", but this guide may use the expanded term " @@ -2420,21 +2465,21 @@ msgid "" "breakdown of the differences." msgstr "" -#: ../source/glossary.rst:72 +#: ../source/glossary.rst:105 msgid "Egg" msgstr "" -#: ../source/glossary.rst:75 +#: ../source/glossary.rst:108 msgid "" "A :term:`Built Distribution` format introduced by :ref:`setuptools`, which " "has been replaced by :term:`Wheel`. For details, see :ref:`egg-format`." msgstr "" -#: ../source/glossary.rst:78 +#: ../source/glossary.rst:111 msgid "Extension Module" msgstr "" -#: ../source/glossary.rst:81 +#: ../source/glossary.rst:114 msgid "" "A :term:`Module` written in the low-level language of the Python " "implementation: C/C++ for Python, Java for Jython. Typically contained in a " @@ -2443,11 +2488,11 @@ msgid "" "Python extensions on Windows, or a Java class file for Jython extensions." msgstr "" -#: ../source/glossary.rst:88 +#: ../source/glossary.rst:121 msgid "Known Good Set (KGS)" msgstr "" -#: ../source/glossary.rst:91 +#: ../source/glossary.rst:124 msgid "" "A set of distributions at specified versions which are compatible with each " "other. Typically a test suite will be run which passes all tests before a " @@ -2456,17 +2501,17 @@ msgid "" "distributions." msgstr "" -#: ../source/glossary.rst:97 +#: ../source/glossary.rst:130 msgid "Import Package" msgstr "" -#: ../source/glossary.rst:100 +#: ../source/glossary.rst:133 msgid "" "A Python module which can contain other modules or recursively, other " "packages." msgstr "" -#: ../source/glossary.rst:103 +#: ../source/glossary.rst:136 msgid "" "An import package is more commonly referred to with the single word " "\"package\", but this guide will use the expanded term when more clarity is " @@ -2475,50 +2520,62 @@ msgid "" "package` for a breakdown of the differences." msgstr "" -#: ../source/glossary.rst:108 +#: ../source/glossary.rst:142 +#, fuzzy +msgid "Installed Project" +msgstr "安裝軟體套件" + +#: ../source/glossary.rst:145 +msgid "" +"A :term:`Project` that is installed for use with a Python interpreter or :" +"term:`Virtual Environment`, as described in the specicifcation :ref:" +"`recording-installed-packages`." +msgstr "" + +#: ../source/glossary.rst:149 msgid "Module" msgstr "" -#: ../source/glossary.rst:111 +#: ../source/glossary.rst:152 msgid "" "The basic unit of code reusability in Python, existing in one of two types: :" "term:`Pure Module`, or :term:`Extension Module`." msgstr "" -#: ../source/glossary.rst:114 +#: ../source/glossary.rst:155 msgid "Package Index" msgstr "套件索引" -#: ../source/glossary.rst:117 +#: ../source/glossary.rst:158 msgid "" "A repository of distributions with a web interface to automate :term:" "`package ` discovery and consumption." msgstr "" -#: ../source/glossary.rst:120 +#: ../source/glossary.rst:161 msgid "Per Project Index" msgstr "" -#: ../source/glossary.rst:123 +#: ../source/glossary.rst:164 msgid "" "A private or other non-canonical :term:`Package Index` indicated by a " "specific :term:`Project` as the index preferred or required to resolve " "dependencies of that project." msgstr "" -#: ../source/glossary.rst:127 ../source/guides/hosting-your-own-index.rst:62 +#: ../source/glossary.rst:168 ../source/guides/hosting-your-own-index.rst:62 #: ../source/guides/index-mirrors-and-caches.rst:52 msgid "Project" msgstr "" -#: ../source/glossary.rst:130 +#: ../source/glossary.rst:171 msgid "" "A library, framework, script, plugin, application, or collection of data or " "other resources, or some combination thereof that is intended to be packaged " "into a :term:`Distribution `." msgstr "" -#: ../source/glossary.rst:134 +#: ../source/glossary.rst:175 msgid "" "Since most projects create :term:`Distributions ` " "using either :pep:`518` ``build-system``, :ref:`distutils` or :ref:" @@ -2527,7 +2584,7 @@ msgid "" "`setup.cfg` file at the root of the project source directory." msgstr "" -#: ../source/glossary.rst:140 +#: ../source/glossary.rst:181 msgid "" "Python projects must have unique names, which are registered on :term:`PyPI " "`. Each project will then contain one or more :" @@ -2535,7 +2592,7 @@ msgid "" "`distributions `." msgstr "" -#: ../source/glossary.rst:145 +#: ../source/glossary.rst:186 msgid "" "Note that there is a strong convention to name a project after the name of " "the package that is imported to run that project. However, this doesn't have " @@ -2543,21 +2600,95 @@ msgid "" "and have it provide a package importable only as 'bar'." msgstr "" -#: ../source/glossary.rst:151 +#: ../source/glossary.rst:192 +#, fuzzy +#| msgid "Project name" +msgid "Project Root Directory" +msgstr "專案名稱" + +#: ../source/glossary.rst:195 +msgid "" +"The filesystem directory in which a :term:`Project`'s :term:`source tree " +"` is located." +msgstr "" + +#: ../source/glossary.rst:198 +msgid "Project Source Tree" +msgstr "" + +#: ../source/glossary.rst:201 +msgid "" +"The on-disk format of a :term:`Project` used for development, containing its " +"raw source code before being packaged into a :term:`Source Distribution " +"` or :term:`Built Distribution`." +msgstr "" + +#: ../source/glossary.rst:207 +msgid "Project Source Metadata" +msgstr "" + +#: ../source/glossary.rst:210 +msgid "" +"Metadata defined by the package author in a :term:`Project`'s :term:`source " +"tree `, to be transformed into :term:`Core Metadata " +"field`\\s in the :term:`Built Metadata` by the project's :term:`build " +"backend `. Can be written as :term:`Pyproject Metadata`, or " +"in a tool-specific format (under the ``[tool]`` table in ``pyproject.toml``, " +"or in a tool's own configuration file)." +msgstr "" + +#: ../source/glossary.rst:220 msgid "Pure Module" msgstr "" -#: ../source/glossary.rst:154 +#: ../source/glossary.rst:223 msgid "" "A :term:`Module` written in Python and contained in a single ``.py`` file " "(and possibly associated ``.pyc`` and/or ``.pyo`` files)." msgstr "" -#: ../source/glossary.rst:157 +#: ../source/glossary.rst:226 +#, fuzzy +#| msgid "Project name" +msgid "Pyproject Metadata" +msgstr "專案名稱" + +#: ../source/glossary.rst:229 +msgid "" +"The :term:`Project Source Metadata` format defined by the :ref:`declaring-" +"project-metadata` specification and originally introduced in :pep:`621`, " +"stored as :term:`Pyproject Metadata Key`\\s under the ``[project]`` table of " +"a :term:`pyproject.toml` file. Notably, *not* a tool-specific source " +"metadata format under the ``[tool]`` table in ``pyproject.toml``." +msgstr "" + +#: ../source/glossary.rst:237 +#, fuzzy +#| msgid "Project name" +msgid "Pyproject Metadata Key" +msgstr "專案名稱" + +#: ../source/glossary.rst:240 +msgid "" +"A top-level TOML key in the ``[project]`` table in ``pyproject.toml``; part " +"of the :term:`Pyproject Metadata`. Notably, distinct from a :term:`Core " +"Metadata Field`." +msgstr "" + +#: ../source/glossary.rst:244 +msgid "Pyproject Metadata Subkey" +msgstr "" + +#: ../source/glossary.rst:247 +msgid "" +"A second-level TOML key under a table-valued :term:`Pyproject Metadata Key`." +msgstr "" + +#: ../source/glossary.rst:250 msgid "Python Packaging Authority (PyPA)" msgstr "" -#: ../source/glossary.rst:160 +#: ../source/glossary.rst:253 msgid "" "PyPA is a working group that maintains many of the relevant projects in " "Python packaging. They maintain a site at :doc:`pypa.io `, host " @@ -2567,48 +2698,48 @@ msgid "" "`the Python Discourse forum `__." msgstr "" -#: ../source/glossary.rst:169 +#: ../source/glossary.rst:262 msgid "Python Package Index (PyPI)" msgstr "" -#: ../source/glossary.rst:172 +#: ../source/glossary.rst:265 msgid "" "`PyPI `_ is the default :term:`Package Index` for the " "Python community. It is open to all Python developers to consume and " "distribute their distributions." msgstr "" -#: ../source/glossary.rst:175 +#: ../source/glossary.rst:268 msgid "pypi.org" msgstr "" -#: ../source/glossary.rst:178 +#: ../source/glossary.rst:271 msgid "" "`pypi.org `_ is the domain name for the :term:`Python " "Package Index (PyPI)`. It replaced the legacy index domain name, ``pypi." "python.org``, in 2017. It is powered by :ref:`warehouse`." msgstr "" -#: ../source/glossary.rst:182 +#: ../source/glossary.rst:275 msgid "pyproject.toml" msgstr "" -#: ../source/glossary.rst:185 +#: ../source/glossary.rst:278 msgid "" "The tool-agnostic :term:`Project` specification file. Defined in :pep:`518`." msgstr "" -#: ../source/glossary.rst:187 +#: ../source/glossary.rst:280 msgid "Release" msgstr "" -#: ../source/glossary.rst:190 +#: ../source/glossary.rst:283 msgid "" "A snapshot of a :term:`Project` at a particular point in time, denoted by a " "version identifier." msgstr "" -#: ../source/glossary.rst:193 +#: ../source/glossary.rst:286 msgid "" "Making a release may entail the publishing of multiple :term:`Distributions " "`. For example, if version 1.0 of a project was " @@ -2616,11 +2747,11 @@ msgid "" "Windows installer distribution format." msgstr "" -#: ../source/glossary.rst:198 +#: ../source/glossary.rst:291 msgid "Requirement" msgstr "" -#: ../source/glossary.rst:201 +#: ../source/glossary.rst:294 msgid "" "A specification for a :term:`package ` to be " "installed. :ref:`pip`, the :term:`PYPA ` " @@ -2629,11 +2760,11 @@ msgid "" "install` reference." msgstr "" -#: ../source/glossary.rst:207 +#: ../source/glossary.rst:300 msgid "Requirement Specifier" msgstr "" -#: ../source/glossary.rst:210 +#: ../source/glossary.rst:303 msgid "" "A format used by :ref:`pip` to install packages from a :term:`Package " "Index`. For an EBNF diagram of the format, see :ref:`dependency-specifiers`. " @@ -2641,72 +2772,72 @@ msgid "" "project name, and the \">=1.3\" portion is the :term:`Version Specifier`" msgstr "" -#: ../source/glossary.rst:215 +#: ../source/glossary.rst:308 msgid "Requirements File" msgstr "" -#: ../source/glossary.rst:218 +#: ../source/glossary.rst:311 msgid "" "A file containing a list of :term:`Requirements ` that can be " "installed using :ref:`pip`. For more information, see the :ref:`pip` docs " "on :ref:`pip:Requirements Files`." msgstr "" -#: ../source/glossary.rst:222 +#: ../source/glossary.rst:315 #: ../source/guides/distributing-packages-using-setuptools.rst:59 msgid "setup.py" msgstr "" -#: ../source/glossary.rst:223 +#: ../source/glossary.rst:316 #: ../source/guides/distributing-packages-using-setuptools.rst:80 msgid "setup.cfg" msgstr "" -#: ../source/glossary.rst:226 +#: ../source/glossary.rst:319 msgid "" "The project specification files for :ref:`distutils` and :ref:`setuptools`. " "See also :term:`pyproject.toml`." msgstr "" -#: ../source/glossary.rst:229 +#: ../source/glossary.rst:322 msgid "Source Archive" msgstr "" -#: ../source/glossary.rst:232 +#: ../source/glossary.rst:325 msgid "" "An archive containing the raw source code for a :term:`Release`, prior to " "creation of a :term:`Source Distribution ` or :term:`Built Distribution`." msgstr "" -#: ../source/glossary.rst:236 +#: ../source/glossary.rst:329 msgid "Source Distribution (or \"sdist\")" msgstr "" -#: ../source/glossary.rst:239 +#: ../source/glossary.rst:332 msgid "" -"A :term:`distribution ` format (usually generated " +"A :term:`distribution ` format (usually generated " "using ``python -m build --sdist``) that provides metadata and the essential " "source files needed for installing by a tool like :ref:`pip`, or for " "generating a :term:`Built Distribution`. See :ref:`package-formats` for more " "information." msgstr "" -#: ../source/glossary.rst:245 +#: ../source/glossary.rst:338 msgid "System Package" msgstr "" -#: ../source/glossary.rst:248 +#: ../source/glossary.rst:341 msgid "" "A package provided in a format native to the operating system, e.g. an rpm " "or dpkg file." msgstr "" -#: ../source/glossary.rst:251 +#: ../source/glossary.rst:344 msgid "Version Specifier" msgstr "" -#: ../source/glossary.rst:254 +#: ../source/glossary.rst:347 msgid "" "The version component of a :term:`Requirement Specifier`. For example, the " "\">=1.3\" portion of \"foo>=1.3\". Read the :ref:`Version specifier " @@ -2715,11 +2846,11 @@ msgid "" "was implemented in :ref:`setuptools` v8.0 and :ref:`pip` v6.0." msgstr "" -#: ../source/glossary.rst:259 +#: ../source/glossary.rst:352 msgid "Virtual Environment" msgstr "" -#: ../source/glossary.rst:262 +#: ../source/glossary.rst:355 msgid "" "An isolated Python environment that allows packages to be installed for use " "by a particular application, rather than being installed system wide. For " @@ -2727,21 +2858,37 @@ msgid "" "Environments`." msgstr "" -#: ../source/glossary.rst:266 +#: ../source/glossary.rst:360 +msgid "Wheel Format" +msgstr "" + +#: ../source/glossary.rst:361 msgid "Wheel" msgstr "" -#: ../source/glossary.rst:269 +#: ../source/glossary.rst:364 msgid "" -"The standard :term:`Built Distribution` format. See :ref:`package-formats` " -"for more information." +"The standard :term:`Built Distribution` format originally introduced in :pep:" +"`427` and defined by the :ref:`binary-distribution-format` specification. " +"See :ref:`package-formats` for more information. Not to be confused with its " +"reference implementation, the :term:`Wheel Project`." msgstr "" -#: ../source/glossary.rst:271 +#: ../source/glossary.rst:371 +msgid "Wheel Project" +msgstr "" + +#: ../source/glossary.rst:374 +msgid "" +"The PyPA reference implementation of the :term:`Wheel Format`; see :ref:" +"`wheel`." +msgstr "" + +#: ../source/glossary.rst:376 msgid "Working Set" msgstr "" -#: ../source/glossary.rst:274 +#: ../source/glossary.rst:379 msgid "" "A collection of :term:`distributions ` available for " "importing. These are the distributions that are on the `sys.path` variable. " @@ -11912,7 +12059,7 @@ msgstr "" #: ../source/specifications/direct-url.rst:67 #: ../source/specifications/entry-points.rst:164 #: ../source/specifications/externally-managed-environments.rst:472 -#: ../source/specifications/inline-script-metadata.rst:211 +#: ../source/specifications/inline-script-metadata.rst:213 #: ../source/specifications/name-normalization.rst:50 #: ../source/specifications/platform-compatibility-tags.rst:332 #: ../source/specifications/pyproject-toml.rst:443 @@ -12918,7 +13065,7 @@ msgstr "" #: ../source/specifications/dependency-specifiers.rst:26 #: ../source/specifications/direct-url-data-structure.rst:19 #: ../source/specifications/direct-url.rst:15 -#: ../source/specifications/inline-script-metadata.rst:11 +#: ../source/specifications/inline-script-metadata.rst:13 msgid "Specification" msgstr "" @@ -14677,24 +14824,24 @@ msgid "" "www.pypa.io/en/latest/specifications/>`__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:3 +#: ../source/specifications/inline-script-metadata.rst:5 msgid "Inline script metadata" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:5 +#: ../source/specifications/inline-script-metadata.rst:7 msgid "" "This specification defines a metadata format that can be embedded in single-" "file Python scripts to assist launchers, IDEs and other external tools which " "may need to interact with such scripts." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:13 +#: ../source/specifications/inline-script-metadata.rst:15 msgid "" "This specification defines a metadata comment block format (loosely inspired " "by `reStructuredText Directives`__)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:18 +#: ../source/specifications/inline-script-metadata.rst:20 msgid "" "Any Python script may have top-level comment blocks that MUST start with the " "line ``# /// TYPE`` where ``TYPE`` determines how to process the content. " @@ -14705,7 +14852,7 @@ msgid "" "MUST only consist of ASCII letters, numbers and hyphens." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:26 +#: ../source/specifications/inline-script-metadata.rst:28 msgid "" "Every line between these two lines (``# /// TYPE`` and ``# ///``) MUST be a " "comment starting with ``#``. If there are characters after the ``#`` then " @@ -14715,158 +14862,158 @@ msgid "" "of only a single ``#``)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:33 +#: ../source/specifications/inline-script-metadata.rst:35 msgid "" "Precedence for an ending line ``# ///`` is given when the next line is not a " "valid embedded content line as described above. For example, the following " "is a single fully valid block:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:49 +#: ../source/specifications/inline-script-metadata.rst:51 msgid "" "A starting line MUST NOT be placed between another starting line and its " "ending line. In such cases tools MAY produce an error. Unclosed blocks MUST " "be ignored." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:52 +#: ../source/specifications/inline-script-metadata.rst:54 msgid "" "When there are multiple comment blocks of the same ``TYPE`` defined, tools " "MUST produce an error." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:55 +#: ../source/specifications/inline-script-metadata.rst:57 msgid "" "Tools reading embedded metadata MAY respect the standard Python encoding " "declaration. If they choose not to do so, they MUST process the file as " "UTF-8." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:58 +#: ../source/specifications/inline-script-metadata.rst:60 msgid "" "This is the canonical regular expression that MAY be used to parse the " "metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:65 +#: ../source/specifications/inline-script-metadata.rst:67 msgid "" "In circumstances where there is a discrepancy between the text specification " "and the regular expression, the text specification takes precedence." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:68 +#: ../source/specifications/inline-script-metadata.rst:70 msgid "" "Tools MUST NOT read from metadata blocks with types that have not been " "standardized by this specification." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:72 +#: ../source/specifications/inline-script-metadata.rst:74 msgid "script type" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:74 +#: ../source/specifications/inline-script-metadata.rst:76 msgid "" "The first type of metadata block is named ``script``, which contains script " "metadata (dependency data and tool configuration)." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:77 +#: ../source/specifications/inline-script-metadata.rst:79 msgid "" "This document MAY include the top-level fields ``dependencies`` and " "``requires-python``, and MAY optionally include a ``[tool]`` table." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:80 +#: ../source/specifications/inline-script-metadata.rst:82 msgid "" "The ``[tool]`` MAY be used by any tool, script runner or otherwise, to " "configure behavior. It has the same semantics as the :ref:`[tool] table in " "pyproject.toml `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:84 +#: ../source/specifications/inline-script-metadata.rst:86 msgid "The top-level fields are:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:86 +#: ../source/specifications/inline-script-metadata.rst:88 msgid "" "``dependencies``: A list of strings that specifies the runtime dependencies " "of the script. Each entry MUST be a valid :ref:`dependency specifier " "`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:89 +#: ../source/specifications/inline-script-metadata.rst:91 msgid "" "``requires-python``: A string that specifies the Python version(s) with " "which the script is compatible. The value of this field MUST be a valid :ref:" "`version specifier `." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:93 +#: ../source/specifications/inline-script-metadata.rst:95 msgid "" "Script runners MUST error if the specified ``dependencies`` cannot be " "provided. Script runners SHOULD error if no version of Python that satisfies " "the specified ``requires-python`` can be provided." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:98 +#: ../source/specifications/inline-script-metadata.rst:100 msgid "Example" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:100 +#: ../source/specifications/inline-script-metadata.rst:102 msgid "The following is an example of a script with embedded metadata:" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:121 +#: ../source/specifications/inline-script-metadata.rst:123 #, fuzzy #| msgid "Documentation types" msgid "Reference Implementation" msgstr "文件類型" -#: ../source/specifications/inline-script-metadata.rst:123 +#: ../source/specifications/inline-script-metadata.rst:125 msgid "" "The following is an example of how to read the metadata on Python 3.11 or " "higher." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:149 +#: ../source/specifications/inline-script-metadata.rst:151 msgid "" "Often tools will edit dependencies like package managers or dependency " "update automation in CI. The following is a crude example of modifying the " "content using the ``tomlkit`` library__." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:180 +#: ../source/specifications/inline-script-metadata.rst:182 msgid "" "Note that this example used a library that preserves TOML formatting. This " "is not a requirement for editing by any means but rather is a \"nice to " "have\" feature." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:184 +#: ../source/specifications/inline-script-metadata.rst:186 msgid "" "The following is an example of how to read a stream of arbitrary metadata " "blocks." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:203 +#: ../source/specifications/inline-script-metadata.rst:205 #: ../source/specifications/simple-repository-api.rst:815 msgid "Recommendations" msgstr "" -#: ../source/specifications/inline-script-metadata.rst:205 +#: ../source/specifications/inline-script-metadata.rst:207 msgid "" "Tools that support managing different versions of Python should attempt to " "use the highest available version of Python that is compatible with the " "script's ``requires-python`` metadata, if defined." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:213 +#: ../source/specifications/inline-script-metadata.rst:215 msgid "" "October 2023: This specification was conditionally approved through :pep:" "`723`." msgstr "" -#: ../source/specifications/inline-script-metadata.rst:214 +#: ../source/specifications/inline-script-metadata.rst:216 msgid "" "January 2024: Through amendments to :pep:`723`, the ``pyproject`` metadata " "block type was renamed to ``script``, and the ``[run]`` table was dropped, " @@ -21228,11 +21375,6 @@ msgid "" "the file is empty)." msgstr "" -#, fuzzy -#~| msgid "Project name" -#~ msgid "pyproject type" -#~ msgstr "專案名稱" - #~ msgid "List keywords that describe your project." #~ msgstr "列出描述您的項目的關鍵字。"