.\" -*- coding: UTF-8 -*- .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH PYTHON 1 .\" To view this file while editing, run it through groff: .\" groff -Tascii -man python.man | less .SH NOME python \- uma linguagem de programação interpretada, interativa e orientada a objetos .SH SINOPSE \fBpython\fP [ \fB\-B\fP ] [ \fB\-b\fP ] [ \fB\-d\fP ] [ \fB\-E\fP ] [ \fB\-h\fP ] [ \fB\-i\fP ] [ \fB\-I\fP ] .br [ \fB\-m\fP \fInome\-do\-módulo\fP ] [ \fB\-q\fP ] [ \fB\-R\fP ] [ \fB\-O\fP ] [ \fB\-OO\fP ] [ \fB\-P\fP ] [ \fB\-s\fP ] [ \fB\-S\fP ] [ \fB\-u\fP ] .br [ \fB\-v\fP ] [ \fB\-V\fP ] [ \fB\-W\fP \fIargumento\fP ] [ \fB\-x\fP ] [ \fB\-X\fP \fIopção\fP ] [ \fB\-?\fP ] .br [ \fB\-\-check\-hash\-based\-pycs\fP \fIdefault\fP | \fIalways\fP | \fInever\fP ] .br [ \fB\-\-help\fP ] [ \fB\-\-help\-env\fP ] [ \fB\-\-help\-xoptions\fP ] [ \fB\-\-help\-all\fP ] .br [ \fB\-c\fP \fIcomando\fP | \fIscript\fP | \- ] [ \fIargumentos\fP ] .SH DESCRIÇÃO Python é uma linguagem de programação interpretada, interativa e orientada a objetos que combina um poder notável com uma sintaxe muito clara. Para uma introdução à programação em Python, consulte o Tutorial do Python. A Referência da Biblioteca do Python documenta tipos, constantes, funções e módulos padrão e embutidos. Por fim, o Manual de Referências do Python descreve a sintaxe e a semântica da linguagem principal com detalhes (talvez até demais). (Esses documentos podem ser encontrados em \fBRECURSOS NA INTERNET\fP abaixo; eles também podem estar instalados no seu sistema.) .PP O poder básico do Python pode ser expandido com seus próprios módulos escritos em C ou C++. Na maioria dos sistemas, esses módulos podem ser carregados dinamicamente. O Python também é adaptável como uma linguagem de extensão para aplicações existentes. Consulte a documentação interna para obter dicas. .PP A documentação dos módulos e pacotes Python instalados pode ser visualizada executando o programa \fBpydoc\fP. .SH "OPÇÕES DA LINHA DE COMANDOS" .TP \fB\-B\fP Não escreve arquivos \fI.pyc\fP na importação. Veja também PYTHONDONTWRITEBYTECODE. .TP \fB\-b\fP Emite avisos sobre str(bytes_instance), str(bytearray_instance) e compara bytes/bytearray com str. (\-bb: emite erros) .TP \fB\-c \fP\fIcomando\fP Especifica o comando a ser executado (veja a próxima seção). Isso encerra a lista de opções (as seguintes opções são passadas como argumentos para o comando). .TP \fB\-\-check\-hash\-based\-pycs \fP\fImodo\fP Configura como o Python avalia a atualização dos arquivos .pyc baseados em hash. .TP \fB\-d\fP Ativa a saída de depuração do analisador (somente para especialistas, dependendo das opções de compilação). .TP \fB\-E\fP Ignora variáveis ​​de ambiente como PYTHONPATH e PYTHONHOME que modificam o comportamento do interpretador. .TP \fB\-h , \-? , \-\-help\fP Exibe o uso do executável do interpretador e sai. .TP \fB\-\-help\-env\fP Exibe ajuda sobre variáveis ​​de ambiente específicas do Python e sai. .TP \fB\-\-help\-xoptions\fP Exibe ajuda sobre opções de \fB\-X\fP específicas da implementação e sai. .TP .TP \fB\-\-help\-all\fP Exibe informações completas de uso e sai. .TP \fB\-i\fP Quando um script é passado como primeiro argumento ou a opção \fB\-c\fP é usada, entra no modo interativo após executar o script ou o comando. O arquivo $PYTHONSTARTUP não é lido. Isso pode ser útil para inspecionar variáveis ​​globais ou um rastreamento de pilha quando um script levanta uma exceção. .TP \fB\-I\fP Executa o Python em modo isolado. Isso também implica em \fB\-E\fP, \fB\-P\fP e \fB\-s\fP. No modo isolado, sys.path não contém o diretório do script nem o diretório site\-packages do usuário. Todas as variáveis ​​de ambiente PYTHON* também são ignoradas. Restrições adicionais podem ser impostas para impedir que o usuário injete código malicioso. .TP \fB\-m \fP\fInome\-do\-módulo\fP Pesquisa o módulo nomeado em \fIsys.path\fP e executa o arquivo \fI.py\fP correspondente como um script. Isso encerra a lista de opções (as seguintes opções são passadas como argumentos para o módulo). .TP \fB\-O\fP Remova instruções assert e qualquer código condicional ao valor de __debug__; aumente o nome do arquivo para arquivos compilados (bytecode) adicionando .opt\-1 antes da extensão .pyc. .TP \fB\-OO\fP Faz o mesmo de \fB\-O\fP e também descarta docstrings; altera o nome do arquivo para arquivos compilados (bytecode) adicionando .opt\-2 antes da extensão \&.pyc. .TP \fB\-P\fP Não adiciona automaticamente um caminho potencialmente inseguro a \fBsys.path\fP, como o diretório atual, o diretório do script ou uma string vazia. Veja também a variável de ambiente \fBPYTHONSAFEPATH\fP. .TP \fB\-q\fP Não exibe as mensagens de versão e direitos autorais. Essas mensagens também são suprimidas no modo não interativo. .TP \fB\-R\fP Ativa a randomização de hash. Esta opção só terá efeito se a variável de ambiente \fBPYTHONHASHSEED\fP estiver definida como \fB0\fP, já que a randomização de hash está habilitada por padrão. .TP \fB\-s\fP Não adiciona o diretório do site do usuário ao sys.path. .TP \fB\-S\fP Desabilita a importação do módulo \fIsite\fP e as manipulações dependentes do site de \fIsys.path\fP que ele envolve. Desabilite também essas manipulações se \fIsite\fP for importado explicitamente posteriormente. .TP \fB\-u\fP Força os fluxos stdout e stderr a serem descompactados. Esta opção não tem efeito no fluxo stdin. .TP \fB\-v\fP Exibe uma mensagem sempre que um módulo é inicializado, mostrando o local (nome do arquivo ou módulo embutido) de onde ele é carregado. Quando especificado duas vezes, exibe uma mensagem para cada arquivo verificado na busca por um módulo. Também fornece informações sobre a limpeza do módulo ao sair. .TP \fB\-V , \-\-version\fP Exibe o número da versão Python do executável e encerra. Quando fornecido duas vezes, exibe mais informações sobre a construído. .TP \fB\-W \fP\fIargumento\fP Controle de avisos. O mecanismo de aviso do Python, por padrão, exibe mensagens de aviso em \fIsys.stderr\fP. As configurações mais simples aplicam uma ação específica incondicionalmente a todos os avisos emitidos por um processo (mesmo aqueles que são ignorados por padrão): \-Wdefault # Avisa uma vez por local de chamada \-Werror # Converte para exceções \-Walways # Avisa toda vez \-Wall # Mesmo que \-Walways \-Wmodule # Avisa uma vez por módulo chamador \-Wonce # Avisa uma vez por processo do Python \-Wignore # Nunca avisa Os nomes das ações podem ser abreviados conforme desejado e o interpretador os resolverá para o nome de ação apropriado. Por exemplo, \fB\-Wi\fP é o mesmo que \fB\-Wignore\fP. A forma completa do argumento é: \fIação:mensagem:categoria:módulo:número\-da\-linha\fP Campos vazios correspondem a todos os valores; campos vazios à direita podem ser omitidos. Por exemplo, \fB\-W ignore::DeprecationWarning\fP ignora todos os avisos de DeprecationWarning. O campo \fIação\fP é como explicado acima, mas só se aplica a avisos que correspondem aos campos restantes. O campo \fImensagem\fP deve corresponder a toda a mensagem de aviso impressa; essa correspondência não diferencia maiúsculas de minúsculas. O campo \fIcategoria\fP corresponde à categoria de aviso (ex: "DeprecationWarning"). Deve ser um nome de classe; a correspondência testa se a categoria de aviso real da mensagem é uma subclasse da categoria de aviso especificada. O campo \fImódulo\fP corresponde ao nome do módulo (totalmente qualificado); essa correspondência diferencia maiúsculas de minúsculas. O campo \fInúmero\-da\-linha\fP corresponde ao número da linha, onde zero corresponde a todos os números de linha e, portanto, equivale a um número de linha omitido. A opção \fB\-W\fP pode ser fornecida várias vezes; quando um aviso corresponde a mais de uma opção, a ação para a última opção correspondente é executada. Opções \fB\-W\fP inválidas são ignoradas (embora uma mensagem de aviso seja exibidas sobre opções inválidas quando o primeiro aviso é emitido). Avisos também podem ser controlados usando a variável de ambiente \fBPYTHONWARNINGS\fP e de dentro de um programa Python usando o módulo warnings. Por exemplo, a função warnings.filterwarnings() pode ser usada para aplicar uma expressão regular na mensagem de aviso. .TP \fB\-X \fP\fIopção\fP Define uma opção específica para a implementação. As seguintes opções estão disponíveis: \fB\-X cpu_count=\fP\fIN\fP: substitui o valor de retorno de \fIos.cpu_count()\fP; \fB\-X cpu_count=default\fP cancela a substituição; também \fBPYTHON_CPU_COUNT\fP \fI \fP\fB\-X dev\fP: habilita o "modo de desenvolvimento" do CPython, adicionando verificações adicionais em tempo de execução que são muito caras para serem habilitadas por padrão. Não será mais verboso que o padrão se o código estiver correto: novos avisos só serão emitidos quando um problema for detectado. Efeito do modo de desenvolvedor: * Adicionar filtro padrão de avisos, como \fB\-W default\fP * Instala ganchos de depuração em alocadores de memória: veja a função C PyMem_SetupDebugHooks() * Habilita o módulo faulthandler para obter o traceback Python em um travamento * Habilita o modo de depuração de asyncio * Define o atributo dev_mode de sys.flags para True * io.IOBase destructor registra exceções de close() \fB\-X importtime\fP: mostra quanto tempo cada importação leva. Mostra o nome do módulo, o tempo cumulativo (incluindo importações aninhadas) e o tempo próprio (excluindo importações aninhadas). Observe que sua saída pode ser interrompida em aplicações multithread. O uso típico é: \fBpython3 \-X importtime \-c 'import asyncio'\fP \fB\-X importtime=2\fP habilita uma saída adicional que indica quando um módulo importado já foi carregado. Nesses casos, a string \fBcached\fP será impressa em ambas as colunas de tempo. \fB\-X faulthandler\fP: habilita faulthandler \fB\-X frozen_modules=\fP[\fBon\fP|\fBoff\fP]: se os módulos congelados devem ou não ser usados. O padrão é "on" (ou "off" ao fazer uma construção local). \fB\-X gil=\fP[\fB0\fP|\fB1\fP]: habilita (1) ou desabilita (0) a GIL; também \fBPYTHON_GIL\fP Só disponível em construções configuradas com \fB\-\-disable\-gil\fP. \fB\-X int_max_str_digits=\fP\fInúmero\fP: limita o tamanho das conversões int<\->str. Isso ajuda a evitar ataques de negação de serviço ao analisar dados não confiáveis. O padrão é sys.int_info.default_max_str_digits. 0 desabilita. \fB\-X no_debug_ranges\fP: desabilita a inclusão das tabelas que mapeiam informações extras de localização (linha final, deslocamento da coluna inicial e deslocamento da coluna final) para cada instrução em objetos de código. Isso é útil quando objetos de código menores e arquivos pyc são desejados, além de suprimir os indicadores visuais extras de localização quando o interpretador exibe tracebacks. \fB\-X perf\fP: suporte ao perfilador do Linux "perf"; também \fBPYTHONPERFSUPPORT=1\fP \fB\-X perf_jit\fP: suporte ao perfilador do Linux "perf" com suporte a DWARF; também \fBPYTHON_PERF_JIT_SUPPORT=1\fP \fB\-X presite=\fP\fIMOD\fP: importa este módulo antes de site. Também \fBPYTHON_PRESITE\fP. Só funciona em construções de depuração. \fB\-X pycache_prefix=\fP\fIPATH\fP: permite erscrever arquivos .pyc em uma árvore paralela com raiz no diretório fornecido, em vez de na árvore de código. \fB\-X showrefcount\fP: exibe a contagem total de referências e o número de blocos de memória usados ​​quando o programa termina ou após cada instrução no interpretador interativo. Isso só funciona em construções de depuração. \fB\-X tracemalloc\fP: inicia o rastreamento das alocações de memória do Python usando o módulo tracemalloc. Por padrão, apenas o quadro mais recente é armazenado no traceback de um trace. Use \-X tracemalloc=NUM_QUADROS para iniciar o rastreamento com um limite de quadros de NUM_QUADROS \fB\-X utf8\fP: habilita o modo UTF\-8 para interfaces do sistema operacional, substituindo o modo padrão com reconhecimento de localidade. \fB\-X utf8=0\fP desabilita explicitamente o modo UTF\-8 (mesmo quando, de outra forma, ele seria ativado automaticamente). Veja \fBPYTHONUTF8\fP para mais detalhes. \fB\-X warn_default_encoding\fP: habilita o recurso opcional EncodingWarning para "encoding=None" .TP \fB\-x\fP Pula a primeira linha do código\-fonte. Isto é destinado apenas a um hack específico para DOS. Aviso: a numeração das linhas nas mensagens de erro estará incorreta em um! .SH "INTERFACE DO INTERPRETADOR" A interface do interpretador assemelha\-se à do shell UNIX: quando chamado com uma entrada padrão conectada a um dispositivo tty, ele recebe comandos e os executa até que um EOF seja lido; quando chamado com um argumento de nome de arquivo ou com um arquivo como entrada padrão, ele lê e executa um \fIscript\fP desse arquivo; quando chamado com \fB\-c\fP \fIcomando\fP, ele executa a(s) instrução(ões) Python fornecida(s) como \fIcomando\fP. Aqui, \fIcomando\fP pode conter várias instruções separadas por quebras de linha. Espaços em branco à esquerda são significativos em instruções Python! No modo não interativo, toda a entrada é analisada antes de ser executada. .PP Se disponível, o nome do script e os argumentos adicionais subsequentes são passados ​​para o script na variável Python \fIsys.argv\fP, que é uma lista de strings (você deve primeiro usar \fIimport sys\fP para poder acessá\-la). Se nenhum nome de script for fornecido, \fIsys.argv[0]\fP será uma string vazia; se \fB\-c\fP for usado, \fIsys.argv[0]\fP conterá a string \fI'\-c'\fP. Observe que as opções interpretadas pelo próprio interpretador Python não são colocadas em \fIsys.argv\fP. .PP No modo interativo, o prompt principal é ">>>"; o segundo prompt (que aparece quando um comando não está completo) é "...". Os prompts podem ser alterados por atribuição a \fIsys.ps1\fP ou \fIsys.ps2\fP. O interpretador encerra ao ler um EOF em um prompt. Quando ocorre uma exceção não tratada, um rastreamento de pilha é impresso e o controle retorna ao prompt principal; no modo não interativo, o interpretador encerra após imprimir o rastreamento de pilha. O sinal de interrupção gera a exceção \fIKeyboard\%Interrupt\fP; outros sinais UNIX não são capturados (exceto que SIGPIPE às vezes é ignorado, em favor da exceção \fIIOError\fP). Mensagens de erro são gravadas em stderr. .SH "ARQUIVOS E DIRETÓRIOS" Estes estão sujeitos a diferenças dependendo das convenções de instalação local; ${prefix} e ${exec_prefix} dependem da instalação e devem ser interpretados como para software GNU; podem ser os mesmos. O padrão para ambos é \fI/usr/local\fP. .IP \fI${exec_prefix}/bin/python\fP Local recomendado do interpretador. .PP \fI${prefix}/lib/python\fP .br \fI${exec_prefix}/lib/python\fP .RS Locais recomendados dos diretórios que contêm os módulos padrão. .RE .PP \fI${prefix}/include/python\fP .br \fI${exec_prefix}/include/python\fP .RS Locais recomendados dos diretórios que contêm os arquivos de inclusão necessários para desenvolver extensões Python e incorporar o interpretador. .RE .SH "VARIÁVEIS DE AMBIENTE" .IP PYTHONASYNCIODEBUG Se esta variável de ambiente estiver definida como uma string não vazia, habilita o modo de depuração do módulo asyncio. .IP PYTHON_BASIC_REPL Se esta variável for definida como qualquer valor, o interpretador não tentará carregar o REPL baseado em Python que requer curses e readline e, em vez disso, usará o REPL tradicional baseado em analisador. .IP PYTHONBREAKPOINT Se esta variável de ambiente for definida como 0, ela desabilitará o depurador padrão. Ela pode ser definida como o valor chamável do depurador de sua escolha. .IP PYTHONCOERCECLOCALE Se definido como o valor 0, faz com que o aplicativo de linha de comando Python principal ignore a coerção dos locais C e POSIX baseados em ASCII legados para uma alternativa baseada em UTF\-8 mais capaz. .IP PYTHON_COLORS Se esta variável for definida como 1, o interpretador colorirá vários tipos de saída. Definir como 0 desativa esse comportamento. .IP PYTHON_CPU_COUNT Se esta variável for definida como um número inteiro positivo, ela substituirá os valores de retorno de \fIos.cpu_count\fP e \fIos.process_cpu_count\fP. .IP Veja também a opção \fB\-X cpu_count\fP. .IP PYTHONDEBUG Se definido como uma string não vazia, equivale a especificar a opção \fB\-d\fP. Se definido como um inteiro, equivale a especificar \fB\-d\fP várias vezes. .IP PYTHONEXECUTABLE Se esta variável de ambiente for definida, \fIsys.argv[0]\fP será definido como seu valor em vez do valor obtido pelo tempo de execução C. Funciona apenas no Mac OS X. .IP PYTHONFAULTHANDLER Se esta variável de ambiente for definida como uma string não vazia, \fIfaulthandler.enable()\fP será chamado na inicialização: instala um manipulador para sinais SIGSEGV, SIGFPE, SIGABRT, SIGBUS e SIGILL para despejar o traceback do Python. .IP Isso equivale à opção \fB\-X faulthandler\fP. .IP PYTHON_FROZEN_MODULES Se esta variável for definida como \fBon\fP ou \fBoff\fP, ela determinará se os módulos congelados serão ou não ignorados pelo mecanismo de importação. Um valor \fBon\fP significa que eles serão importados e \fBoff\fP significa que serão ignorados. O padrão é \fBon\fP para compilações sem depuração (o caso normal) e \fBoff\fP para construções de depuração. .IP Veja também a opção \fB\-X frozen_modules\fP. .IP PYTHON_GIL Se esta variável for definida como 1, a trava global do interpretador (GIL) será forçada a ser ativada. Defini\-la como 0 força a GIL a ser desativada. Disponível apenas em construções configuradas com \fB\-\-disable\-gil\fP. .IP Isso equivale à opção \fB\-X gil\fP. .IP PYTHON_HISTORY Esta variável de ambiente pode ser usada para definir o local de um arquivo de histórico (no Unix, é \fI~/.python_history\fP por padrão). .IP PYTHONNODEBUGRANGES Se esta variável for definida, ela desabilitará a inclusão das tabelas que mapeiam informações extras de local (linha final, posição inicial da coluna e posição final da coluna) para cada instrução em objetos de código. Isso é útil quando objetos de código menores e arquivos pyc são desejados, além de suprimir os indicadores visuais extras de local quando o interpretador exibe tracebacks. .IP PYTHONDONTWRITEBYTECODE Se isso for definido como uma string não vazia, será equivalente a especificar a opção \fB\-B\fP (não tente escrever arquivos \fI.pyc\fP). .IP PYTHONDEVMODE Se esta variável de ambiente for definida como uma string não vazia, habilita o "modo de desenvolvimento" do Python, introduzindo verificações de tempo de execução adicionais que são muito caras para serem habilitadas por padrão. .IP Isso equivale à opção \fB\-X dev\fP. .IP PYTHONHASHSEED Se esta variável for definida como "random", um valor aleatório será usado para semear os hashes dos objetos str e bytes. Se PYTHONHASHSEED for definido como um valor inteiro, ele será usado como uma semente fixa para gerar o hash() dos tipos abrangidos pela randomização de hash. Sua finalidade é permitir hash repetível, como para autotestes do próprio interpretador, ou permitir que um cluster de processos Python compartilhe valores de hash. O inteiro deve ser um número decimal no intervalo [0,4294967295]. Especificar o valor 0 desabilitará a randomização de hash. .IP PYTHONHOME Altera o local das bibliotecas padrão do Python. Por padrão, as bibliotecas são pesquisadas em ${prefix}/lib/python e ${exec_prefix}/lib/python, onde ${prefix} e ${exec_prefix} são diretórios dependentes da instalação, ambos com o padrão \fI/usr/local\fP. Quando $PYTHONHOME é definido como um único diretório, seu valor substitui ${prefix} e ${exec_prefix}. Para especificar valores diferentes para eles, defina $PYTHONHOME como ${prefix}:${exec_prefix}. .IP PYTHONINSPECT Se isso for definido como uma string não vazia, equivale a especificar a opção \fB\-i\fP. .IP PYTHONINTMAXSTRDIGITS Limita o número máximo de caracteres em um valor int ao converter de uma string e ao converter um int de volta para uma string. Um valor 0 desabilita o limite. Conversões de ou para as bases 2, 4, 8, 16 e 32 nunca são limitadas. .IP Isso equivale à opãço \fB\-X int_max_str_digits=\fP\fINÚMERO\fP. .IP PYTHONIOENCODING Se isso for definido antes de executar o interpretador, ele substituirá a codificação usada para stdin/stdout/stderr, na sintaxe \fInomedacodificação\fP\fB:\fP\fItratadordeerro\fP. A parte \fItratadordeerro\fP é opcional e tem o mesmo significado que em str.encode. Para stderr, a parte \fItratadordeerro\fP é ignorada; o tratador será sempre \'backslashreplace\'. .IP PYTHONMALLOC Define os alocadores de memória do Python e/ou instala ganchos de depuração. Os alocadores de memória disponíveis são \fImalloc\fP e \fIpymalloc\fP. Os ganchos de depuração disponíveis são \fIdebug\fP, \fImalloc_debug\fP e \fIpymalloc_debug\fP. .IP Quando o Python é compilado no modo de depuração, o padrão é \fIpymalloc_debug\fP e os ganchos de depuração são usados ​​automaticamente. Caso contrário, o padrão é \fIpymalloc\fP. .IP PYTHONMALLOCSTATS Se definido como uma string não vazia, o Python exibirá estatísticas do alocador de memória pymalloc toda vez que um novo objeto pymalloc arena for criado e no desligamento. .IP Esta variável será ignorada se a variável de ambiente $\fBPYTHONMALLOC\fP for usada para forçar o alocador \fBmalloc\fP(3) da biblioteca C, ou se o Python estiver configurado sem suporte a pymalloc. .IP PYTHONNOUSERSITE Se isso for definido como uma string não vazia, será equivalente a especificar a opção \fB\-s\fP (Não adiciona o diretório do site do usuário ao sys.path). .IP PYTHONOPTIMIZE Se definido como uma string não vazia, equivale a especificar a opção \fB\-O\fP. Se definido como um inteiro, equivale a especificar \fB\-O\fP várias vezes. .IP PYTHONPATH Aumenta o caminho de pesquisa padrão para arquivos de módulo. O formato é o mesmo do $PATH do shell: um ou mais caminhos de diretório separados por dois pontos. Diretórios inexistentes são ignorados silenciosamente. O caminho de pesquisa padrão depende da instalação, mas geralmente começa com ${prefix}/lib/python (veja PYTHONHOME acima). O caminho de pesquisa padrão é sempre anexado a $PYTHONPATH. Se um argumento de script for fornecido, o diretório que contém o script será inserido no caminho antes de $PYTHONPATH. O caminho de pesquisa pode ser manipulado de dentro de um programa Python como a variável \fIsys.path\fP. .IP PYTHON_PERF_JIT_SUPPORT Se esta variável for definida com um valor diferente de zero, ela habilitará o suporte ao perfilador de desempenho do Linux para que chamadas Python possam ser detectadas por ele usando informações DWARF. Definir como 0 desabilita. .IP Veja também a opção \fB\-X perf_jit\fP. .IP PYTHONPERFSUPPORT Se esta variável for definida com um valor diferente de zero, ela habilitará o suporte ao perfilador de desempenho do Linux para que chamadas Python possam ser detectadas por ele. Definir como 0 desabilita. .IP Veja também a opção \fB\-X perf\fP. .IP PYTHONPLATLIBDIR Substitui sys.platlibdir. .IP PYTHONPROFILEIMPORTTIME Se esta variável de ambiente for definida como \fB1\fP, o Python mostrará quanto tempo cada importação leva. Se definida como \fB2\fP, o Python incluirá a saída para os módulos importados que já foram carregados. Isso é exatamente equivalente a definir \fB\-X importtime\fP na linha de comando. .IP PYTHONPYCACHEPREFIX Se isso for definido, o Python escreverá arquivos \fB.pyc\fP em uma árvore de diretórios espelho neste caminho, em vez de em diretórios \fB__pycache__\fP dentro da árvore de fontes. .IP Isso equivale a especificar a opção \fB\-X pycache_prefix=\fP\fIPATH\fP. .IP PYTHONSAFEPATH Se esta opção for definida como uma string não vazia, não adiciona automaticamente um caminho potencialmente inseguro a \fBsys.path\fP, como o diretório atual, o diretório do script ou uma string vazia. Veja também a opção \fB\-P\fP. .IP PYTHONSTARTUP Se este for o nome de um arquivo legível, os comandos Python contidos nesse arquivo serão executados antes que o primeiro prompt seja exibido no modo interativo. O arquivo é executado no mesmo espaço de nomes em que os comandos interativos são executados, para que os objetos definidos ou importados nele possam ser usados ​​sem qualificação na sessão interativa. Você também pode alterar os prompts \fIsys.ps1\fP e \fIsys.ps2\fP neste arquivo. .IP PYTHONTRACEMALLOC Se esta variável de ambiente estiver definida como uma string não vazia, comece a rastrear as alocações de memória do Python usando o módulo tracemalloc. .IP O valor da variável é o número máximo de quadros armazenados em um traceback de um trace. Por exemplo, \fIPYTHONTRACEMALLOC=1\fP armazena apenas o quadro mais recente. .IP PYTHONUNBUFFERED Se isso for definido como uma string não vazia, será equivalente a especificar a opção \fB\-u\fP. .IP PYTHONUSERBASE Define o diretório base do usuário, que é usado para calcular o caminho do diretório do usuário \fIsite\-packages\fP e os caminhos de instalação para \fIpython \-m pip install \-\-user\fP. .IP PYTHONUTF8 Se definido como 1, habilita o "Modo UTF\-8" do Python. Definir como 0 desabilita. .IP PYTHONVERBOSE Se definido como uma string não vazia, equivale a especificar a opção \fB\-v\fP. Se definido como um inteiro, equivale a especificar \fB\-v\fP várias vezes. .IP PYTHONWARNDEFAULTENCODING Se esta variável de ambiente for definida como uma string não vazia, emite um \fIEncodingWarning\fP quando a codificação padrão específica do local for usada. .IP PYTHONWARNINGS Se isso for definido como uma string separada por vírgulas, será equivalente a especificar a opção \fB\-W\fP para cada valor separado. .SS "Variáveis do modo de depuração" Definir essas variáveis ​​só tem efeito em uma construção de depuração do Python, ou seja, se o Python foi configurado com a opção de construção \fB\-\-with\-pydebug\fP. .IP PYTHONDUMPREFS Se esta variável de ambiente estiver definida, o Python despejará objetos e contagens de referências ainda ativos após desligar o interpretador. .IP PYTHONDUMPREFSFILE Se definido, o Python despejará objetos e contagens de referências ainda ativos após desligar o interpretador em um arquivo no caminho fornecido como valor para esta variável de ambiente. .IP PYTHON_PRESITE Se esta variável for definida como um módulo, esse módulo será importado no início do ciclo de vida do interpretador, antes da execução do módulo \fIsite\fP e antes da criação do módulo \fI__main__\fP. Isso só funciona em construções de depuração. .IP Isso equivale à opção \fB\-X presite=\fP\fImódulo\fP. .SH AUTOR A Python Software Foundation: https://www.python.org/psf/ .SH "RECURSOS NA INTERNET" Site principal: https://www.python.org/ .br Documentação: https://docs.python.org/pt\-br .br Recursos de desenvolvedor: https://devguide.python.org/ .br Downloads: https://www.python.org/downloads/ .br Repositório de módulos: https://pypi.org/ .br Newsgroups: comp.lang.python, comp.lang.python.announce .SH LICENCIAMENTO O Python é distribuído sob uma licença de código aberto. Consulte o arquivo "LICENSE" na distribuição do código\-fonte do Python para obter informações sobre os termos e condições de acesso e uso do Python, bem como para uma ISENÇÃO DE RESPONSABILIDADE POR TODAS AS GARANTIAS. .PP .SH TRADUÇÃO A tradução para português brasileiro desta página man foi criada por Rafael Fontenelle . .PP Esta tradução é uma documentação livre; leia a .UR https://www.gnu.org/licenses/gpl-3.0.html Licença Pública Geral GNU Versão 3 .UE ou posterior para as condições de direitos autorais. Nenhuma responsabilidade é aceita. .PP Se você encontrar algum erro na tradução desta página de manual, envie um e-mail para .MT debian-l10n-portuguese@lists.debian.org a lista de discussão de tradutores .ME .