# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2023, Xorbits Inc.
# This file is distributed under the same license as the Xinference package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2024.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Xinference\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2024-03-07 15:03+0800\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: pt_BR <LL@li.org>\n"
"Language: pt_BR\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"
"Generated-By: Babel 2.18.0\n"

#: ../../source/development/contributing_codebase.rst:3
msgid "Contributing to the code base"
msgstr "Guia de Desenvolvimento do Repositório de Código"

#: ../../source/development/contributing_codebase.rst:6
msgid "Table of contents:"
msgstr "índice"

#: ../../source/development/contributing_codebase.rst:9
msgid "Code standards"
msgstr "Padrões de código"

#: ../../source/development/contributing_codebase.rst:11
msgid ""
"Writing good code is not just about what you write. It is also about *how* "
"you write it. During Continuous Integration testing, several tools will be "
"run to check your code for stylistic errors. Good style is a requirement for"
" submitting code to Xinference."
msgstr ""
"Escrever um bom código não se resume apenas ao que você escreve, mas também "
"a como escreve. Durante os testes de integração contínua, diversas "
"ferramentas verificam seu código quanto a erros de estilo. Um bom estilo de "
"programação é um dos requisitos para enviar código ao Xinference."

#: ../../source/development/contributing_codebase.rst:15
msgid ""
"In addition, it is important that we do not make sudden changes to the code "
"that could have the potential to break a lot of user code as a result. "
"Therefore we need it to be as backwards compatible as possible to avoid mass"
" breakages."
msgstr ""
"Além disso, não faça alterações repentinas no código, pois isso pode causar "
"problemas em uma grande quantidade de códigos de usuários. Portanto, "
"precisamos manter a compatibilidade reversa tanto quanto possível para "
"evitar falhas em larga escala."

#: ../../source/development/contributing_codebase.rst:20
msgid "Autofixing formatting errors"
msgstr "Correção automática de erros de formato"

#: ../../source/development/contributing_codebase.rst:22
msgid ""
"Moreover, Continuous Integration will run code formatting checks like "
"``black``, ``flake8``, ``isort``, and others using `pre-commit hooks "
"<https://pre-commit.com/>`_ Any warnings generated by these checks will "
"cause the Continuous Integration to fail. Therefore, it is advisable to run "
"the check yourself before submitting code. This can be done by installing "
"``pre-commit``::"
msgstr ""
"Além disso, a integração contínua usará hooks do `pre-commit <https://pre-"
"commit.com/>`_ para executar ferramentas de verificação de formato de "
"código, como ``black``, ``flake8``, ``isort``. Qualquer aviso gerado por "
"essas verificações resultará em falha na integração contínua. Portanto, é "
"recomendável executar essas verificações por conta própria antes de enviar o"
" código. Isso pode ser feito instalando o ``pre-commit`` no diretório raiz "
"do repositório Xinference::"

#: ../../source/development/contributing_codebase.rst:30
msgid "and then running::"
msgstr "Em seguida, execute o comando::"

#: ../../source/development/contributing_codebase.rst:34
msgid ""
"from the root of the Xinference repository. This setup ensures that all "
"styling checks are automatically executed each time you commit changes "
"without your needing to run each one manually. In addition, using ``pre-"
"commit`` will also allow you to more easily remain up-to-date with our code "
"checks as they change."
msgstr ""
"Depois de instalado, você pode garantir que todas as verificações de estilo "
"sejam executadas automaticamente a cada commit, sem precisar executá-las "
"manualmente uma por uma. Além disso, o uso do ``pre-commit`` também facilita"
" a manutenção da sincronização quando nossas verificações de código forem "
"alteradas."

#: ../../source/development/contributing_codebase.rst:39
msgid ""
"Note that if needed, you can skip these checks with ``git commit --no-"
"verify``."
msgstr ""
"Observe que, se necessário, você pode pular essas verificações usando o "
"comando ``git commit --no-verify``."

#: ../../source/development/contributing_codebase.rst:41
msgid ""
"If you don't want to use ``pre-commit`` as part of your workflow, you can "
"still use it to run its checks with::"
msgstr ""
"Se você não quiser incluir o ``pre-commit`` como parte do seu fluxo de "
"trabalho, ainda pode executar o comando abaixo para usá-lo na verificação::"

#: ../../source/development/contributing_codebase.rst:46
#: ../../source/development/contributing_codebase.rst:52
msgid "without needing to have done ``pre-commit install`` beforehand."
msgstr "sem precisar executar `pre-commit install` previamente."

#: ../../source/development/contributing_codebase.rst:48
msgid ""
"If you want to run checks on all recently committed files on upstream/main "
"you can use::"
msgstr ""
"Se você deseja executar uma verificação em todos os arquivos submetidos "
"recentemente, pode usar o seguinte comando::"

#: ../../source/development/contributing_codebase.rst:56
msgid ""
"You may consider periodically running ``pre-commit gc`` to clean up repos "
"which are no longer used."
msgstr ""
"Você pode considerar executar periodicamente o comando ``pre-commit gc`` "
"para limpar repositórios que não estão mais em uso."

#: ../../source/development/contributing_codebase.rst:61
msgid ""
"If you have conflicting installations of ``virtualenv``, if could lead to "
"errors - refer to `here <https://github.com/pypa/virtualenv/issues/1875>`_."
msgstr ""
"Se você instalou uma versão conflitante do ``virtualenv``, isso pode causar "
"erros - consulte `aqui <https://github.com/pypa/virtualenv/issues/1875>`_ ."

#: ../../source/development/contributing_codebase.rst:64
msgid ""
"Also, due to a `bug in virtualenv "
"<https://github.com/pypa/virtualenv/issues/1986>`_, you may run into issues "
"if you're using conda. To solve this, you can downgrade ``virtualenv`` to "
"version ``20.0.33``."
msgstr ""
"Além disso, devido a um `erro "
"<https://github.com/pypa/virtualenv/issues/1986>`_ no ``virtualenv``, você "
"pode encontrar problemas se estiver usando o conda. Para resolver isso, faça"
" o downgrade do ``virtualenv`` para a versão ``20.0.33``."

#: ../../source/development/contributing_codebase.rst:69
msgid "Backwards compatibility"
msgstr "Retrocompatibilidade"

#: ../../source/development/contributing_codebase.rst:71
msgid ""
"Please try to maintain backward compatibility. If you think breakage is "
"necessary, clearly state why as part of the pull request. Also, be careful "
"when changing method signatures and add deprecation warnings where needed. "
"Also, add the deprecated sphinx directive to the deprecated functions or "
"methods."
msgstr ""
"Por favor, mantenha a compatibilidade com versões anteriores tanto quanto "
"possível. Se considerar que uma alteração é necessária, explique claramente "
"o motivo no pull request. Além disso, tenha cuidado ao alterar assinaturas "
"de métodos e adicione avisos de depreciação quando necessário. Adicione "
"também diretivas de depreciação do Sphinx para funções ou métodos obsoletos."

#: ../../source/development/contributing_codebase.rst:76
msgid "You'll also need to"
msgstr "Você também precisa"

#: ../../source/development/contributing_codebase.rst:78
msgid ""
"Write a new test that asserts a warning is issued when calling with the "
"deprecated argument"
msgstr ""
"Escreva um novo caso de teste em que um aviso seja emitido ao chamar um "
"parâmetro obsoleto."

#: ../../source/development/contributing_codebase.rst:79
msgid ""
"Update all of Xinference existing tests and code to use the new argument"
msgstr ""
"Atualize todos os exemplos de teste e códigos existentes do Xinference para "
"usar os novos parâmetros."

#: ../../source/development/contributing_codebase.rst:82
msgid "Type hints"
msgstr "Anotações de tipo"

#: ../../source/development/contributing_codebase.rst:84
msgid ""
"Xinference strongly encourages the use of :pep:`484` style type hints. New "
"development should contain type hints and pull requests to annotate existing"
" code are accepted as well!"
msgstr ""
"Xinference incentiva fortemente o uso de dicas de tipo no estilo :pep:`484`."
" Novos desenvolvimentos devem incluir dicas de tipo, e pull requests que "
"anotem código existente também são aceitáveis!"

#: ../../source/development/contributing_codebase.rst:88
msgid "Test-driven development"
msgstr "Desenvolvimento Orientado a Testes"

#: ../../source/development/contributing_codebase.rst:90
msgid ""
"Xinference is serious about testing and strongly encourages contributors to "
"embrace `test-driven development (TDD) <https://en.wikipedia.org/wiki/Test-"
"driven_development>`_. This development process \"relies on the repetition "
"of a very short development cycle: first the developer writes an (initially "
"failing) automated test case that defines a desired improvement or new "
"function, then produces the minimum amount of code to pass that test.\" So, "
"before actually writing any code, you should write your tests. Often the "
"test can be taken from the original GitHub issue. However, it is always "
"worth considering additional use cases and writing corresponding tests."
msgstr ""
"O Xinference dá grande importância aos testes e incentiva fortemente os "
"contribuidores a adotarem o `Desenvolvimento Orientado por Testes (TDD) "
"<https://en.wikipedia.org/wiki/Test-driven_development>`_. Esse processo de "
"desenvolvimento \"depende da repetição de ciclos de desenvolvimento muito "
"curtos: primeiro, o desenvolvedor escreve um caso de teste automatizado "
"(inicialmente falho) para definir a melhoria ou nova funcionalidade "
"desejada, e depois usa o mínimo de código para passar nesse teste.\" "
"Portanto, antes de realmente escrever qualquer código, você deve escrever "
"seus casos de teste. Normalmente, os casos de teste podem ser obtidos a "
"partir da issue original do GitHub. No entanto, vale a pena considerar "
"situações adicionais e escrever os casos de teste correspondentes."

#: ../../source/development/contributing_codebase.rst:99
msgid ""
"Adding tests is frequently requested after code is pushed to Xinference. "
"Thus, it is worth getting in the habit of writing tests ahead of time so "
"this is never an issue."
msgstr ""
"Após enviar o código para o Xinference, frequentemente é solicitado "
"adicionar exemplos de teste. Portanto, é muito importante adquirir o hábito "
"de escrever exemplos de teste com antecedência, para que não surjam "
"problemas."

#~ msgid "Pre-commit"
#~ msgstr "Pre-commit"
