This project is in a trial period, be cautious while contributing. Setup can still change before being approved as a libre project.
Zen

Translation

``main`` functions are often used to create command-line tools by specifying them as entry points for console scripts. When this is done, `pip <https://pip.pypa.io/>`_ inserts the function call into a template script, where the return value of ``main`` is passed into :func:`sys.exit`. For example::
337/3000 · 300

Sign in to save the translation.

English Portuguese (Brazil) Actions
This is where using the ``if __name__ == '__main__'`` code block comes in handy. Code within this block won't run unless the module is executed in the top-level environment.
É aqui onde o uso do trecho de código ``if __name__ == '__main__'`` revela-se útil. Os códigos dentro desta condicional não rodarão ao não ser que o módulo seja executado através do ambiente principal.
Putting as few statements as possible in the block below ``if __name__ == '__main__'`` can improve code clarity and correctness. Most often, a function named ``main`` encapsulates the program's primary behavior::
Colocar o mínimo de instruções possível no bloco abaixo de ``if __name__ == '__main__'`` pode melhorar a clareza e a precisão do código. Na maioria das vezes, uma função chamada de ``main`` encapsula o comportamento principal do programa::
Note that if the module didn't encapsulate code inside the ``main`` function but instead put it directly within the ``if __name__ == '__main__'`` block, the ``phrase`` variable would be global to the entire module. This is error-prone as other functions within the module could be unintentionally using the global variable instead of a local name. A ``main`` function solves this problem.
Repare quem se o módulo, ao invés de ter encapsulado o código dentro da função ``main``, fosse colocado direto dentro do bloco ``if __name__ == '__main__'``, a variável ``phrase`` seria global para todo o módulo. Isto é suscetível à erros pois outras funções dentro do módulo poderiam inadvertidamente usar a variável global ao invés da local. A função ``main`` resolve este problema.
Using a ``main`` function has the added benefit of the ``echo`` function itself being isolated and importable elsewhere. When ``echo.py`` is imported, the ``echo`` and ``main`` functions will be defined, but neither of them will be called, because ``__name__ != '__main__'``.
O uso da função ``main`` tem o benefício adicional de a própria função ``echo`` ser isolada e importável em outro lugar. Quando ``echo.py`` é importado, as funções ``echo`` e ``main`` serão definidas, mas nenhuma delas será chamada por conta do bloco ``__name__ != '__main__'``.
Packaging Considerations
Considerações sobre pacotes
``main`` functions are often used to create command-line tools by specifying them as entry points for console scripts. When this is done, `pip <https://pip.pypa.io/>`_ inserts the function call into a template script, where the return value of ``main`` is passed into :func:`sys.exit`. For example::
``main`` são funções frequentemente usadas ​​para criar ferramentas de linha de comando especificando-as como pontos de entrada para scripts de console. Quando isto é feito, `pip <https://pip.pypa.io/>`_ insere a chamada da função em um modelo de script, onde o valor de retorno de ``main`` é passado para :func:`sys.exit`. Por exemplo::
Since the call to ``main`` is wrapped in :func:`sys.exit`, the expectation is that your function will return some value acceptable as an input to :func:`sys.exit`; typically, an integer or ``None`` (which is implicitly returned if your function does not have a return statement).
Uma vez que a chamada à ``main`` está embutida dentro de :func:`sys.exit`, a expectativa é que a sua função retorne somente valores aceitável para :func:`sys.exit`; normalmente um inteiro ou ``None`` (retornado de forma implícita, caso a sua função não tenha uma instrução de retorno).
By proactively following this convention ourselves, our module will have the same behavior when run directly (i.e. ``python echo.py``) as it will have if we later package it as a console script entry-point in a pip-installable package.
 
In particular, be careful about returning strings from your ``main`` function. :func:`sys.exit` will interpret a string argument as a failure message, so your program will have an exit code of ``1``, indicating failure, and the string will be written to :data:`sys.stderr`. The ``echo.py`` example from earlier exemplifies using the ``sys.exit(main())`` convention.
Em particular, tenha cuidado ao retornar strings de sua função ``main``. :func:`sys.exit` interpretará um argumento de string como uma mensagem de falha, então seu programa terá um código de saída ``1``, indicando falha, e a string será escrita em :data:`sys.stderr`. O exemplo anterior de ``echo.py`` exemplifica o uso da convenção ``sys.exit(main())``.
`Python Packaging User Guide <https://packaging.python.org/>`_ contains a collection of tutorials and references on how to distribute and install Python packages with modern tools.
O `Guia de Usuário para Empacotamento de Python <https://packaging.python.org/>`_ contém uma coleção de tutoriais e referências sobre como distribuir e instalar pacotes Python com ferramentas modernas.
``__main__.py`` in Python Packages
``__main__.py`` em pacotes Python

Loading…

User avatar None

String updated in the repository

  1. Python documentation
  2. 3.12
  3. latest/library/__main__
  4. Portuguese (Brazil)
``main`` functions are often used to create command-line tools by specifying them as entry points for console scripts. When this is done, `pip <https://pip.pypa.io/>`_ inserts the function call into a template script, where the return value of ``main`` is passed into :func:`sys.exit`. For example::
``main`` são funções frequentemente usadas ​​para criar ferramentas de linha de comando especificando-as como pontos de entrada para scripts de console. Quando isto é feito, `pip <https://pip.pypa.io/>`_ insere a chamada da função em um modelo de script, onde o valor de retorno de ``main`` é passado para :func:`sys.exit`. Por exemplo::
7 months ago
Browse all string changes

Things to check

Zero-width space

Translation contains extra zero-width space character

Fix string

Reset

Glossary

English Portuguese (Brazil)
No related strings found in the glossary.

String information

Flags
rst-text
Source string location
../../library/__main__.rst:167
String age
7 months ago
Last updated
7 months ago
Source string age
7 months ago
Translation file
pt-br/latest/library/__main__.po, string 28