fedora-docs-l10n/packaging-guidelines/master/pages/Python — Portuguese (Brazil) @ Fedora Weblate: *Every* package that uses Python (at run-time and/or build-time) and/or …

Zen

Translation

Source change

English type: Plain text

Portuguese (Brazil)

Needs editing

Skip

	English	Portuguese (Brazil)	Actions
	Python Packaging Guidelines	Diretrizes de Empacotamento Python
	This version of Python Packaging Guidelines is in effect since 2021 and represents a major rewrite and paradigm shift. Not all packages are updated to reflect this. Older guidelines are still being kept up to date, and existing packages MAY use them instead of this document:	Esta versão das Diretrizes de Empacotamento Python está em vigor desde 2021 e representa uma grande reescrita e mudança de paradigma. Nem todos os pacotes são atualizados para refletir isso. As diretrizes mais antigas ainda estão sendo atualizadas e os pacotes existentes PODEM usá-las em vez deste documento:
	xref:Python_201x.adoc[“201x-era” Python packaging guidelines] (Packages using these usually use the <<py3_install,`+%py3_install+`>> or <<py3_install_wheel,`+%py3_install_wheel+` macro>> or call `+setup.py install+`.)	As xref:Python_201x.adoc[diretrizes de empacotamento do Python “da era 201x”] (Pacotes que os usam geralmente usam a macro <<py3_install,`+%py3_install+`>> ou <<py3_install_wheel,`+%py3_install_wheel+`>> ou chamam `+setup.py install+`.)
	xref:Python_Appendix.adoc#_python_2_packages[Python 2 appendix] Note that Python 2 packages require a FESCo exception.	xref:Python_Appendix.adoc#_python_2_packages[AApêndice do Python 2] Observe que os pacotes Python 2 requerem uma exceção do FESCo.
	These guidelines only support current Fedora releases. For older releases (such as in EPEL 8), consult the xref:Python_201x.adoc[201x-era guidelines].	Estas diretrizes suportam apenas as versões atuais do Fedora. Para versões mais antigas (como no EPEL 8), consulte xref:Python_201x.adoc[diretrizes da era 201x].
	The two <<Distro-wide guidelines>> below apply to all software in Fedora that uses Python at build- or run-time.	As duas <<Distro-wide guidelines, diretrizes para toda a distribuição>> abaixo se aplicam a todos os softwares no Fedora que usam Python em tempo de compilação ou execução.
	The rest of the Guidelines apply to packages that ship code that can be imported with Python’s `+import+` statement. Specifically, that is all packages that install files under `+/usr/lib/python/+`.	O restante das Diretrizes se aplica a pacotes que enviam código que pode ser importado com a instrução `+import+` do Python. Especificamente, são todos os pacotes que instalam arquivos em `+/usr/lib/python/+`.
	Except for the two “Distro-wide guidelines”, these Guidelines do not apply to simple one-file scripts or utilities, especially if these are included with software not written in Python. However, if an application (e.g. CLI tool, script or GUI app) needs a more complex Python library, the library SHOULD be packaged as an importable library under these guidelines.	Exceto pelas duas “diretrizes para toda a distribuição”, estas Diretrizes não se aplicam a scripts ou utilitários simples de um arquivo, especialmente se estes estiverem incluídos em software não escrito em Python. No entanto, se um aplicativo (por exemplo, ferramenta CLI, script ou aplicativo GUI) precisar de uma biblioteca Python mais complexa, RECOMENDA-SE que a biblioteca seja empacotada como uma biblioteca importável de acordo com estas diretrizes.
	A major goal for Python packaging in Fedora is to _harmonize with the wider Python ecosystem_, that is, the https://pypa.io[Python Packaging Authority] (PyPA) standards and the https://pypi.org/[Python Package Index] (PyPI). Packagers SHOULD be prepared to get involved with upstream projects to establish best practices as outlined here. We wish to improve both Fedora and the wider Python ecosystem.	Um dos principais objetivos do empacotamento Python no Fedora é _harmonizar-se com o ecossistema Python mais amplo_, ou seja, os padrões https://pypa.io[Python Packaging Authority] (PyPA) e o https://pypi.org/[Python Package Índice] (PyPI). RECOMENDA-SE que os empacotadores estejam preparados para se envolver em projetos upstream para estabelecer as melhores práticas conforme descrito aqui. Queremos melhorar tanto o Fedora quanto o ecossistema Python mais amplo.
	Some build tools (like CMake or autotools) may not work with the latest PyPA standards yet. (For example, they might generate `+.egg-info+` directories rather than `+.dist-info+`.) While this document's normative points (MUST/SHOULD) are tool-agnostic, many of the practical tips and helper macros will not be applicable. If this affects you, consider contacting the https://lists.fedoraproject.org/archives/list/python-devel@lists.fedoraproject.org/[Python SIG] for guidance and/or following the xref:Python_201x.adoc[older guidelines] for the time being.	Algumas ferramentas de construção (como CMake ou autotools) podem ainda não funcionar com os padrões PyPA mais recentes. (Por exemplo, eles podem gerar diretórios `+.egg-info+` em vez de `+.dist-info+`.) Embora os pontos normativos deste documento (RECOMENDA-SE/DEVE) sejam independentes de ferramentas, muitas das dicas práticas e macros auxiliares serão não ser aplicável. Se isso afetar você, considere entrar em contato com https://lists.fedoraproject.org/archives/list/python-devel@lists.fedoraproject.org/[Python SIG] para orientação e/ou seguir o xref:Python_201x.adoc[diretrizes mais antigas] por enquanto.
	Fedora’s Python SIG not only develops these guidelines, but it’s also involved in PyPA standards and Python packaging best practices. Check out https://fedoraproject.org/wiki/SIGs/Python[the wiki] or https://lists.fedoraproject.org/archives/list/python-devel@lists.fedoraproject.org/[mailing list] if you need help or wish to help out.	O Python SIG do Fedora não apenas desenvolve essas diretrizes, mas também está envolvido nos padrões PyPA e nas melhores práticas de empacotamento do Python. Confira o https://fedoraproject.org/wiki/SIGs/Python[wiki] ou a https://lists.fedoraproject.org/archives/list/python-devel@lists.fedoraproject.org/[lista de discussão] se você precisar de ajuda ou deseja ajudar.
	Distro-wide guidelines	Diretrizes para toda a distribuição
	Build-time dependency on python3-devel	BuildRequire python3-devel
	Every package that uses Python (at run-time and/or build-time) and/or installs Python modules MUST have a build-time dependency on `+python3-devel+`, even if Python is not actually invoked during build-time. Such a package MUST use one of the following in its `+.spec+` file:	Todo pacote que usa Python (em tempo de execução e/ou tempo de compilação) e/ou instala módulos Python DEVE incluir explicitamente `+BuildRequires: python3-devel+` em seu arquivo `+.spec+`, mesmo que o Python não seja realmente invocado durante o tempo de construção.
	<<pyproject_buildrequires,`+%pyproject_buildrequires+`>> in the `+%generate_buildrequires+` section
	`+BuildRequires: python3-devel+`	BuildRequire python3-devel
	Only having a transitive build-time dependency on `+python3-devel+` is not sufficient. If the package uses an alternate Python interpreter instead of `+python3+` (e.g. `+pypy+`, `+jython+`, `+python2.7+`), it MAY instead require the corresponding `+*-devel+` package.	Se o pacote usar um interpretador Python alternativo em vez de `+python3+` (por exemplo, `+pypy+`, `+jython+`, `+python2.7+`), ele PODE exigir o pacote `+*-devel+` correspondente.
	The `+*-devel+` package brings in relevant RPM macros. It may also enable automated or manual checks: for example, Python maintainers use this requirement to list packages that use Python in some way and might be affected by planned changes.	O pacote `+*-devel+` traz macros RPM relevantes. Também pode permitir verificações automatizadas ou manuais: por exemplo, os mantenedores do Python usam esse requisito para listar pacotes que usam o Python de alguma forma e podem ser afetados por mudanças planejadas.
	Mandatory macros	Macros obrigatórias
	The following macros MUST be used where applicable.	As macros a seguir DEVEM ser usadas quando aplicável.
	The expansions in parentheses are provided only as reference/examples.	As expansões entre parênteses são fornecidas apenas como referência/exemplos.
	The macros are defined for you in all supported Fedora and EPEL versions.	As macros são definidas para você em todas as versões suportadas do Fedora e EPEL.
	`+%{python3}+` (`+/usr/bin/python3+`): The Python interpreter. For example, this macro should be used for invoking Python from a `+spec+` file script, passed to `+configure+` scripts to select a Python executable, or used as `+%{python3} -m pip+` to run a Python-based tool.	`+%{python3}+` (`+/usr/bin/python3+`): O interpretador Python. Por exemplo, esta macro deve ser usada para invocar Python a partir de um script de arquivo `+spec+`, passada para scripts `+configure+` para selecionar um executável Python ou usada como `+%{python3} -m pip+` para executar uma ferramenta baseada no Python.
	If the packaged software invokes Python at _run time_ (as opposed to running Python to build/test it), it might be necessary to pass flags to `+%{python3}+` to isolate it from user-installed packages. See <<Shebangs>> for details.	Se o software empacotado invocar o Python em _tempo de execução_ (em vez de executar o Python para compilá-lo/testá-lo), pode ser necessário passar sinalizadores para `+%{python3}+` para isolá-lo dos pacotes instalados pelo usuário. Veja <<Shebangs>> para detalhes.
	`+%{python3_version}+` (e.g. `+3.9+`, `+3.10+`): Version of the Python interpreter.	`+%{python3_version}+` (por exemplo, `+3.9+`, `+3.10+`): versão do interpretador Python.
	`+%{python3_version_nodots}+` (e.g. `+39+`, `+310+`): Version of the Python interpreter without the dot.	`+%{python3_version_nodots}+` (por exemplo `+39+`, `+310+`): Versão do interpretador Python sem o ponto.
	`+%{python3_sitelib}+` (e.g. `+/usr/lib/python3.9/site-packages+`): Where pure-Python modules are installed.	`+%{python3_sitelib}+` (por exemplo, `+/usr/lib/python3.9/site-packages+`): onde os módulos Python puros são instalados.
	`+%{python3_sitearch}+` (e.g. `+/usr/lib64/python3.9/site-packages+`): Where Python extension modules (native code, e.g. compiled from C) are installed.	`+%{python3_sitearch}+` (por exemplo, `+/usr/lib64/python3.9/site-packages+`): onde os módulos de extensão Python (código nativo, por exemplo, compilado de C) são instalados.
	The rest of this document uses these macros, along with `+%{_bindir}+` (`+/usr/bin/+`), instead of the raw path names.	O restante deste documento usa essas macros, junto com `+%{_bindir}+` (`+/usr/bin/+`), em vez dos nomes de caminho brutos.

Loading…

None

String added in the repository

English

Portuguese (Brazil) 272 characters edited Current translation Needs editing

3 months ago

None

Source string changed

English 128 characters edited Needs editing

3 months ago

Browse all string changes

Things to check

Mismatching line breaks

Number of new lines in translation does not match source

Reset

Placeholders

The following format strings are missing: `+python3-devel+`
The following format strings are extra: `+BuildRequires: python3-devel+`

Reset

Glossary

English	Portuguese (Brazil)
build	construir	fedora-docs-l10n/packaging-guidelines
must	deve	fedora-docs-l10n/packaging-guidelines
rfc2119

18363211 String information

Source string description

type: Plain text

Flags

no-wrap, placeholders:r"`pass:\[.\]`":r"\`\+[\w\d/\*-_%\.{}\(\) \']*\+\`":r"`[\w-]*`":r"xref\:[\w\d_-]*(\.adoc)?(#[\w\d_-]*)?":r"\[\[[\w_-]*\]\]"

Source string location

pages/Python.adoc:110

String age

3 months ago

Last updated

3 months ago

Source string age

3 months ago

Translation file

po/pt_BR/master/pages/Python.po, string 14

Shortcut	Action
`?`	Open available keyboard shortcuts.
`Alt` + `Home`	Navigate to the first translation in the current search.
`Alt` + `End`	Navigate to the last translation in the current search.
`Alt` + `PageUp` or `Ctrl` + `↑` or `Alt` + `↑` or `Cmd` + `↑` or	Navigate to the last translation in the current search.
`Alt` + `PageDown` or `Ctrl` + `↓` or `Alt` + `↓` or `Cmd` + `↓` or	Navigate to the next translation in the current search.
`Ctrl` + `Enter` or `Cmd` + `Enter`	Submit current form; this works the same as pressing Save and continue while editing translation.
`Ctrl` + `Shift` + `Enter` or `Cmd` + `Shift` +`Enter`	Unmark translation as Needing edit and submit it.
`Alt` + `Enter` or `Option` + `Enter`	Submit the string as a suggestion; this works the same as pressing Suggest while editing translation.
`Ctrl` + `E` or `Cmd` + `E`	Focus on translation editor.
`Ctrl` + `U` or `Cmd` + `U`	Focus on comment editor.
`Ctrl` + `M` or `Cmd` + `M`	Shows Automatic suggestions tab.
`Ctrl` + `1` to `Ctrl` + `9` or `Cmd` + `1` to `Cmd` + `9`	Copies placeable of a given number from source string.
`Ctrl` + `M` followed by `1` to `9` or `Cmd` + `M` followed by `1` to `9`	Copy the machine translation of a given number to current translation.
`Ctrl` + `I` followed by `1` to `9` or `Cmd` + `I` followed by `1` to `9`	Ignore one item in the list of failing checks.
`Ctrl` + `J` or `Cmd` + `J`	Shows the Nearby strings tab.
`Ctrl` + `S` or `Cmd` + `S`	Focus on search field.
`Ctrl` + `O` or `Cmd` + `O`	Copy the source string.
`Ctrl` + `Y` or `Cmd` + `Y`	Toggle the Needs editing checkbox.
`→`	Browse the next translation string.
`←`	Browse the previous translation string.