Python Setup and Usage

Release 3.13.0

Guido van Rossum and the Python development team

novembro 09, 2024

Python Software Foundation

Email: [email protected]
 Sumário

1 Linha de comando e ambiente 3

1.1 Linha de comando . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.1.1 Opçõ es de interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.1.2 Opçõ es gené ricas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.1.3 Opçõ es diversas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
1.1.4 Controlando cores . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
1.1.5 Opçõ es que você nã o deve usar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
1.2 Variá veis de ambiente . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
1.2.1 Variá veis de modo de depuraçã o . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

2 Utilizando Python em plataformas Unix 19

2.1 Obtendo e instalando a versã o mais recente do Python . . . . . . . . . . . . . . . . . . . . . . . . 19
2.1.1 No Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
2.1.2 No FreeBSD e OpenBSD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
2.2 Compilando o Python . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
2.3 Paths e arquivos relacionados com o Python . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
2.4 Diversos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
2.5 OpenSSL personalizado . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

3 Configurar o Python 23
3.1 Requisitos de construçã o . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
3.2 Arquivos gerados . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
3.2.1 Script configure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
3.3 Opçõ es de configuraçã o . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
3.3.1 Opçõ es gerais . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
3.3.2 Opçõ es do compilador C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
3.3.3 Opçõ es da ligaçã o . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
3.3.4 Opçõ es para dependê ncias de terceiros . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
3.3.5 Opçõ es de WebAssembly . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
3.3.6 Opçõ es de instalaçã o . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
3.3.7 Opçõ es de desempenho . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
3.3.8 Compilaçã o de depuraçã o do Python . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
3.3.9 Opçõ es de depuraçã o . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
3.3.10 Opçõ es da ligaçã o . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
3.3.11 Opçõ es da biblioteca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
3.3.12 Opçõ es de segurança . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
3.3.13 Opçõ es do macOS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
3.3.14 Opçõ es do iOS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
3.3.15 Opçõ es de compilaçã o cruzada . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
3.4 Sistema de Construçã o Python . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
3.4.1 Arquivos principais do sistema de construçã o . . . . . . . . . . . . . . . . . . . . . . . . 37

i
 3.4.2 Principais etapas de construçã o . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
3.4.3 Alvos principais do Makefile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
3.4.4 Extensõ es C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
3.5 Sinalizadores do compilador e do vinculador . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
3.5.1 Sinalizadores do pré -processador . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
3.5.2 Sinalizadores do compilador . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
3.5.3 Sinalizadores do vinculador . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

4 Utilizando Python no Windows 43

4.1 O instalador completo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
4.1.1 Etapas de instalaçã o . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
4.1.2 Removendo a Limitaçã o do MAX_PATH . . . . . . . . . . . . . . . . . . . . . . . . . 45
4.1.3 Instalando sem UI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
4.1.4 Instalando Sem Download . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
4.1.5 Modificando uma instalaçã o . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
4.1.6 Instalando biná rios com threads livres . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
4.2 O pacote Microsoft Store . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
4.2.1 Problemas conhecidos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
4.3 Os pacotes nuget.org . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
4.3.1 Pacotes com threads livres . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
4.4 O pacote embutível . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
4.4.1 Aplicaçã o Python . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
4.4.2 Incorporando Python . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
4.5 Pacotes Alternativos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
4.6 Configurando o Python . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
4.6.1 Excursus: Configurando variá veis de ambiente . . . . . . . . . . . . . . . . . . . . . . . 52
4.6.2 Encontrando o executá vel do Python . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
4.7 Modo UTF-8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
4.8 Inicializador Python para Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
4.8.1 Começando . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
4.8.2 Linhas Shebang . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
4.8.3 Argumentos em linhas shebang . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
4.8.4 Personalizaçã o . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
4.8.5 Diagnó sticos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
4.8.6 Teste de simulaçã o . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
4.8.7 Instalar sob demanda . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
4.8.8 Có digos de retorno . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
4.9 Encontrando mó dulos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
4.10 Mó dulos adicionais . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
4.10.1 PyWin32 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
4.10.2 cx_Freeze . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
4.11 Compilando Python no Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
4.12 Outras plataformas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

5 Usando Python em macOS 63

5.1 Usando Python para macOS do python.org . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
5.1.1 Etapas de instalaçã o . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
5.1.2 Como executar um script Python . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
5.2 Distribuiçõ es alternativas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
5.3 Instalando pacotes adicionais ao python . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
5.4 Programaçã o de GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
5.5 Tó picos Avançados . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
5.5.1 Instalando biná rios com threads livres . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
5.5.2 Instalaçã o usando a linha de comando . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
5.5.3 Distribuindo aplicaçõ es Python . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
5.5.4 Conformidade com a App Store . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
5.6 Outros recursos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

ii
6 Utilizando Python no Android 77
6.1 Adicionando Python a uma aplicaçã o Android . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

7 Usando Python no iOS 79

7.1 Python em tempo de execuçã o no iOS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
7.1.1 Compatibilidade com a versã o do iOS . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
7.1.2 Identificaçã o da plataforma . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
7.1.3 Disponibilidade da biblioteca padrã o . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
7.1.4 Mó dulos de extensã o biná ria . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
7.1.5 Biná rios stub do compilador . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
7.2 Instalando Python no iOS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
7.2.1 Ferramentas para construir aplicaçõ es de iOS . . . . . . . . . . . . . . . . . . . . . . . . 81
7.2.2 Adicionando Python a um projeto iOS . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
7.3 Conformidade com a App Store . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

8 Editores e IDEs 85

A Glossário 87

B Sobre esses documentos 105

B.1 Contribuidores da Documentaçã o Python . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

C História e Licença 107

C.1 Histó ria do software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
C.2 Termos e condiçõ es para acessar ou usar Python . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
C.2.1 ACORDO DE LICENCIAMENTO DA PSF PARA PYTHON 3.13.0 . . . . . . . . . . 108
C.2.2 ACORDO DE LICENCIAMENTO DA BEOPEN.COM PARA PYTHON 2.0 . . . . . . 109
C.2.3 CONTRATO DE LICENÇA DA CNRI PARA O PYTHON 1.6.1 . . . . . . . . . . . . 109
C.2.4 ACORDO DE LICENÇA DA CWI PARA PYTHON 0.9.0 A 1.2 . . . . . . . . . . . . . 111
C.2.5 LICENÇA BSD DE ZERO CLÁUSULA PARA CÓDIGO NA DOCUMENTAÇÃO DO
PYTHON 3.13.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
C.3 Licenças e Reconhecimentos para Software Incorporado . . . . . . . . . . . . . . . . . . . . . . 111
C.3.1 Mersenne Twister . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
C.3.2 Soquetes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
C.3.3 Serviços de soquete assíncrono . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
C.3.4 Gerenciamento de cookies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
C.3.5 Rastreamento de execuçã o . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
C.3.6 Funçõ es UUencode e UUdecode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
C.3.7 Chamadas de procedimento remoto XML . . . . . . . . . . . . . . . . . . . . . . . . . 115
C.3.8 test_epoll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
C.3.9 kqueue de seleçã o . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
C.3.10 SipHash24 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
C.3.11 strtod e dtoa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
C.3.12 OpenSSL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
C.3.13 expat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
C.3.14 libffi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
C.3.15 zlib . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
C.3.16 cfuhash . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
C.3.17 libmpdec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
C.3.18 Conjunto de testes C14N do W3C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
C.3.19 mimalloc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
C.3.20 asyncio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
C.3.21 Global Unbounded Sequences (GUS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125

D Direitos autorais 127

Índice 129

iii
iv
 Python Setup and Usage, Release 3.13.0

Esta parte da documentaçã o é dedicada a informaçõ es gerais sobre a configuraçã o do ambiente Python em diferentes
plataformas, a chamada do interpretador e outras coisas que facilitam o trabalho com o Python.

Sumário 1
Python Setup and Usage, Release 3.13.0

2 Sumário
 CAPÍTULO 1

Linha de comando e ambiente

O interpretador do CPython verifica a linha de comando e o ambiente em busca de vá rias configuraçõ es.
Detalhes da implementação do CPython: Os esquemas de linha de comando de outras implementaçõ es podem
ser diferentes. Consulte implementations para mais recursos.

1.1 Linha de comando

Ao invocar o Python, você pode especificar qualquer uma destas opçõ es:

python [-bBdEhiIOPqRsSuvVWx?] [-c comando | -m nome-módulo | script | - ] [args]

O caso de uso mais comum é , obviamente, uma simples invocaçã o de um script:

python meuscript.py

1.1.1 Opções de interface

A interface do interpretador é semelhante à do console do UNIX, mas fornece alguns mé todos adicionais de chamada:
• Quando chamado com a entrada padrã o conectada a um dispositivo tty, ele solicita comandos e os executa até
um EOF (um caractere de fim de arquivo, você pode produzi-lo com Ctrl-D no UNIX ou Ctrl-Z, Enter
no Windows) ser lido. Para mais sobre o modo interativo, veja tut-interac.
• Quando chamado com um argumento de nome de arquivo ou com um arquivo como entrada padrã o, ele lê e
executa um script desse arquivo.
• Quando chamado com um argumento de nome de diretó rio, ele lê e executa um script nomeado adequadamente
desse diretó rio.
• Quando chamado com -c command, ele executa as instruçõ es Python fornecidas como command. Aqui com-
mand pode conter vá rias instruçõ es separadas por novas linhas. O espaço em branco à esquerda é significativo
nas instruçõ es do Python!
• Quando chamado com -m module-name, o mó dulo fornecido está localizado no caminho do mó dulo Python
e é executado como um script.
No modo nã o interativo, toda a entrada é analisada antes de ser executada.

3
Python Setup and Usage, Release 3.13.0

Uma opçã o de interface termina a lista de opçõ es consumidas pelo interpretador, todos os argumentos consecutivos
terminam em sys.argv – observe que o primeiro elemento, subscrito zero (sys.argv[0]) , é uma string que
reflete a fonte do programa.
-c <command>
Executa o có digo Python em command. command pode ser uma ou mais instruçõ es separadas por novas linhas,
com espaços em branco à esquerda significativos, como no có digo normal do mó dulo.
Se esta opçã o for fornecida, o primeiro elemento de sys.argv será "-c" e o diretó rio atual será adicionado ao
início de sys.path (permitindo mó dulos nesse diretó rio para ser importado como mó dulos de nível superior).
Levanta um evento de auditoria cpython.run_command com o argumento command.
-m <module-name>
Procura sys.path pelo mó dulo nomeado e executa seu conteú do como o mó dulo __main__.
Como o argumento é um nome de module, você nã o deve fornecer uma extensã o de arquivo (.py). O nome do
mó dulo deve ser um nome de mó dulo Python absoluto vá lido, mas a implementaçã o nem sempre pode impor
isso (por exemplo, pode permitir que você use um nome que inclua um hífen).
Nomes de pacotes (incluindo pacotes de espaço de nomes) també m sã o permitidos. Quando um nome de
pacote é fornecido ao invé s de um mó dulo normal, o interpretador irá executar <pkg>.__main__ como o
mó dulo principal. Esse comportamento é deliberadamente semelhante ao tratamento de diretó rios e arquivos
zip que sã o passados para o interpretador como o argumento do script.

® Nota

Esta opçã o nã o pode ser usada com mó dulos embutidos e mó dulos de extensã o escritos em C, uma vez
que eles nã o possuem arquivos de mó dulo Python. No entanto, ele ainda pode ser usado para mó dulos
pré -compilados, mesmo se o arquivo fonte original nã o estiver disponível.

Se esta opçã o for fornecida, o primeiro elemento de sys.argv será o caminho completo para o arquivo do
mó dulo (enquanto o arquivo do mó dulo está sendo localizado, o primeiro elemento será definido como "-m").
Como com a opçã o -c, o diretó rio atual será adicionado ao início de sys.path.
A opçã o -I pode ser usada para executar o script em modo isolado onde sys.path nã o conté m nem o diretó rio
atual nem o diretó rio de pacotes de sites do usuá rio. Todas as variá veis de ambiente PYTHON* sã o ignoradas
també m.
Muitos mó dulos de biblioteca padrã o contê m có digo que é chamado em sua execuçã o como um script. Um
exemplo é o mó dulo timeit:

python -m timeit -s "configuração inicial aqui" "código a ser analisado aqui"

python -m timeit -h # para detalhes

Levanta um evento de auditoria cpython.run_module com o argumento module-name.

µ Ver também

runpy.run_module()
Funcionalidade equivalente diretamente disponível para o có digo Python

PEP 338 – Executando mó dulos como scripts

Alterado na versã o 3.1: Forneça o nome do pacote para executar um submó dulo __main__.
Alterado na versã o 3.4: pacotes de espaço de nomes també m sã o suportados

4 Capítulo 1. Linha de comando e ambiente

 Python Setup and Usage, Release 3.13.0

-
Lê os comandos da entrada padrã o (sys.stdin). Se a entrada padrã o for um terminal, -i está implícito.
Se esta opçã o for fornecida, o primeiro elemento de sys.argv será "-" e o diretó rio atual será adicionado
ao início de sys.path.
Levanta um evento de auditoria cpython.run_stdin sem argumentos.
<script>
Executa o có digo Python contido em script, que deve ser um caminho do sistema de arquivos (absoluto ou
relativo) referindo-se a um arquivo Python, um diretó rio contendo um arquivo __main__.py, ou um arquivo
zip contendo um arquivo __main__.py.
Se esta opçã o for fornecida, o primeiro elemento de sys.argv será o nome do script conforme fornecido na
linha de comando.
Se o nome do script se referir diretamente a um arquivo Python, o diretó rio que conté m esse arquivo é adici-
onado ao início de sys.path, e o arquivo é executado como o mó dulo __main__.
Se o nome do script se referir a um diretó rio ou arquivo zip, o nome do script será adicionado ao início de
sys.path e o arquivo __main__.py nesse local será executado como o mó dulo __main__.

A opçã o -I pode ser usada para executar o script em modo isolado onde sys.path nã o conté m nem o
diretó rio do script nem o diretó rio de pacotes de sites do usuá rio. Todas as variá veis de ambiente PYTHON*
sã o ignoradas també m.
Levanta um evento de auditoria cpython.run_file com o argumento filename.

µ Ver também

runpy.run_path()
Funcionalidade equivalente diretamente disponível para o có digo Python

Se nenhuma opçã o de interface for fornecida, -i está implícito, sys.argv[0] é uma string vazia ("") e o diretó rio
atual será adicionado ao início de sys.path. Alé m disso, o preenchimento por tab e a ediçã o do histó rico sã o
habilitados automaticamente, se disponíveis em sua plataforma (veja rlcompleter-config).

µ Ver também

tut-invoking

Alterado na versã o 3.4: Ativaçã o automá tica de preenchimento com tab e ediçã o de histó rico.

1.1.2 Opções genéricas

-?
-h
--help
Imprime uma breve descriçã o de todas as opçõ es de linha de comando e variá veis de ambiente correspondentes
e sai.
--help-env
Imprime uma breve descriçã o das variá veis de ambiente específicas do Python e sai.
Adicionado na versã o 3.11.
--help-xoptions
Imprime uma descriçã o das opçõ es -X específica da implementaçã o e sai.
Adicionado na versã o 3.11.

1.1. Linha de comando 5

Python Setup and Usage, Release 3.13.0

--help-all
Imprime as informaçõ es de uso completas e sai.
Adicionado na versã o 3.11.
-V
--version
Exibe o nú mero da versã o do Python e saia. O exemplo de saída poderia ser:

Python 3.8.0b2+

Quando fornecido duas vezes, exibe mais informaçõ es sobre a construçã o, como:

Python 3.8.0b2+ (3.8:0c076caaa8, Apr 20 2019, 21:55:00)

[GCC 6.2.0 20161005]

Adicionado na versã o 3.6: A opçã o -VV.

1.1.3 Opções diversas

-b
Emite um aviso ao converter bytes ou bytearray para str sem especificar codificaçã o ou comparar bytes
ou bytearray com str ou bytes com int. Emite um erro quando a opçã o é fornecida duas vezes (-bb).
Alterado na versã o 3.5: Afeta també m comparaçõ es de bytes com int.
-B
Se fornecido, Python nã o tentará escrever arquivos .pyc na importaçã o de mó dulos fonte. Veja també m
PYTHONDONTWRITEBYTECODE.

--check-hash-based-pycs default|always|never
Controla o comportamento de validaçã o de arquivos .pyc baseados em hash. Veja pyc-invalidation. Quando
definido como default, os arquivos de cache bytecode baseados em hash verificados e nã o verificados sã o
validados de acordo com sua semâ ntica padrã o. Quando definido como always, todos os arquivos .pyc
baseados em hash, sejam verificados ou nã o verificados, sã o validados para seus arquivos fonte correspondentes.
Quando definido como never, os arquivos .pyc baseados em hash nã o sã o validados para seus arquivos fonte
correspondentes.
A semâ ntica dos arquivos .pyc baseados em marca de tempo nã o é afetada por esta opçã o.
-d
Ativa a saída analisador sintá tico de depuraçã o (uso avançado). Consulte també m a variá vel de ambiente
PYTHONDEBUG .

Essa opçã o requer uma construção de depuração do Python, caso contrá rio, será ignorada.
-E
Ignora todas as variá veis de ambiente PYTHON*, por exemplo PYTHONPATH e PYTHONHOME, que pode ser
definido.
Veja també m as opçõ es -P e -I (isolado).
-i
Quando um script é passado como primeiro argumento ou a opçã o -c é usada, entre no modo interativo
depois de executar o script ou o comando, mesmo quando sys.stdin nã o parece ser um terminal. O arquivo
PYTHONSTARTUP nã o foi lido.

Isso pode ser ú til para inspecionar variá veis globais ou um stack trace (situaçã o da pilha de execuçã o) quando
um script levanta uma exceçã o. Veja també m PYTHONINSPECT .

6 Capítulo 1. Linha de comando e ambiente

 Python Setup and Usage, Release 3.13.0

-I
Executa o Python no modo isolado. Isso també m implica nas opçõ es -E, -P e -s.
No modo isolado, sys.path nã o conté m o diretó rio do script nem o diretó rio de pacotes do site do usuá rio.
Todas as variá veis de ambiente PYTHON* sã o ignoradas també m. Outras restriçõ es podem ser impostas para
evitar que o usuá rio injete có digo malicioso.
Adicionado na versã o 3.4.
-O
Remova as instruçõ es de asserçã o e qualquer có digo condicional ao valor de __debug__. Aumenta o nome
do arquivo para arquivos compilados (bytecode) adicionando .opt-1 antes da extensã o .pyc (veja PEP 488).
Veja també m PYTHONOPTIMIZE.
Alterado na versã o 3.5: Modifica nomes de arquivos .pyc conforme a PEP 488.
-OO
Faz o mesmo que -O e també m descarta docstrings. Aumenta o nome do arquivo para arquivos compilados
(bytecode) adicionando .opt-2 antes da extensã o .pyc (veja PEP 488).
Alterado na versã o 3.5: Modifica nomes de arquivos .pyc conforme a PEP 488.
-P
Nã o anexa um caminho potencialmente inseguro a sys.path:
• A linha de comando python -m módulo: Nã o anexa o diretó rio atual.
• A linha de comando python script.py: nã o anexa o diretó rio do script. Se for um link simbó lico,
resolve os links simbó licos.
• Linhas de comando python -c código e python (REPL): Nã o anexa uma string vazia, o que significa
o diretó rio de trabalho atual.
Veja també m a variá vel de ambiente PYTHONSAFEPATH e as opçõ es -E e -I (isolado).
Adicionado na versã o 3.11.
-q
Nã o exibe as mensagens de direitos autorais e de versã o nem mesmo no modo interativo.
Adicionado na versã o 3.2.
-R
Habilita a aleatorizaçã o com hash. Esta opçã o só tem efeito se a variá vel de ambiente PYTHONHASHSEED
estiver configurada para 0, uma vez que a aleatorizaçã o com hash é habilitada por padrã o.
Em versõ es anteriores do Python, esta opçã o ativa a aleatorizaçã o com hash, para que os valores __hash__()
dos objetos str e bytes sejam “salgados” com um valor aleató rio imprevisível. Embora permaneçam constantes
em um processo Python individual, eles nã o sã o previsíveis entre invocaçõ es repetidas de Python.
A aleatorizaçã o com hash se destina a fornecer proteçã o contra uma negaçã o de serviço causada por entradas
cuidadosamente escolhidas que exploram o pior caso de desempenho de uma inserçã o de dicioná rio, comple-
xidade O(n2 ). Consulte http://ocert.org/advisories/ocert-2011-003.html para obter detalhes.
PYTHONHASHSEED permite que você defina um valor fixo para o segredo da semente de hash.

Adicionado na versã o 3.2.3.

Alterado na versã o 3.7: A opçã o nã o é mais ignorada.
-s
Nã o adiciona o diretório site-packages de usuário a sys.path.
Veja també m PYTHONNOUSERSITE.

1.1. Linha de comando 7

Python Setup and Usage, Release 3.13.0

µ Ver também

PEP 370 – Diretó rio site-packages por usuá rio.

-S
Desabilita a importaçã o do mó dulo site e as manipulaçõ es dependentes do site de sys.path que isso acar-
reta. També m desabilita essas manipulaçõ es se site for explicitamente importado mais tarde (chame site.
main() se você quiser que eles sejam acionados).
-u
Força os fluxos stdout e stderr a serem sem buffer. Esta opçã o nã o tem efeito no fluxo stdin.
Veja també m PYTHONUNBUFFERED.
Alterado na versã o 3.7: A camada de texto dos fluxos stdout e stderr agora é sem buffer.
-v
Exibe uma mensagem cada vez que um mó dulo é inicializado, mostrando o local (nome do arquivo ou mó dulo
embutido) de onde ele é carregado. Quando fornecido duas vezes (-vv), exibe uma mensagem para cada
arquivo que é verificado durante a busca por um mó dulo. També m fornece informaçõ es sobre a limpeza do
mó dulo na saída.
Alterado na versã o 3.10: O mó dulo site relata os caminhos específicos do site e os arquivos .pth sendo
processados.
Veja també m PYTHONVERBOSE.
-W arg
Controle de advertê ncia. O mecanismo de aviso do Python por padrã o exibe mensagens de aviso para sys.
stderr.

As configuraçõ es mais simples aplicam uma determinada açã o 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 avisar

Os nomes das açõ es podem ser abreviados conforme desejado e o interpretador irá resolvê -los para o nome da
açã o apropriado. Por exemplo, -Wi é o mesmo que -Wignore.
A forma completa de argumento é :

ação:mensagem:categoria:módulo:número-da-linha

Os campos vazios correspondem a todos os valores; campos vazios à direita podem ser omitidos. Por exemplo,
-W ignore::DeprecationWarning ignora todos os avisos de DeprecationWarning.

O campo action é explicado acima, mas se aplica apenas a avisos que correspondem aos campos restantes.
O campo message deve corresponder a toda a mensagem de aviso; essa correspondê ncia nã o diferencia maiú s-
culas de minú sculas.
O campo category corresponde à categoria de aviso (ex: DeprecationWarning). Deve ser um nome de
classe; o teste de correspondê ncia se a categoria de aviso real da mensagem é uma subclasse da categoria de
aviso especificada.
O campo module corresponde ao nome do mó dulo (totalmente qualificado); esta correspondê ncia diferencia
maiú sculas de minú sculas.

8 Capítulo 1. Linha de comando e ambiente

 Python Setup and Usage, Release 3.13.0

O campo lineno corresponde ao nú mero da linha, onde zero corresponde a todos os nú meros da linha e, por-
tanto, é equivalente a um nú mero da linha omitido.
Mú ltiplas opçõ es -W podem ser fornecidas; quando um aviso corresponde a mais de uma opçã o, a açã o para a
ú ltima opçã o correspondente é executada. As opçõ es -W invá lidas sã o ignoradas (embora, uma mensagem de
aviso seja exibida sobre opçõ es invá lidas quando o primeiro aviso for emitido).
Os avisos també m podem ser controlados usando a variá vel de ambiente PYTHONWARNINGS e de dentro de
um programa Python usando o mó dulo warnings. Por exemplo, a funçã o warnings.filterwarnings()
pode ser usada para usar uma expressã o regular na mensagem de aviso.
Veja warning-filter e describing-warning-filters para mais detalhes.
-x
Pula a primeira linha do có digo-fonte, permitindo o uso de formas nã o-Unix de #!cmd. Isso se destina apenas
a um hack específico do DOS.
-X
Reservado para vá rias opçõ es específicas de implementaçã o. CPython atualmente define os seguintes valores
possíveis:
• -X faulthandler para habilitar faulthandler. Veja també m PYTHONFAULTHANDLER.
Adicionado na versã o 3.3.
• -X showrefcount para emitir a contagem de referê ncias total 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.
Adicionado na versã o 3.4.
• -X tracemalloc para começar a rastrear alocaçõ es de memó ria do Python usando o mó dulo
tracemalloc. Por padrã o, apenas o quadro mais recente é armazenado no traceback (situaçã o da
pilha de execuçã o) de um rastro. Use -X tracemalloc=NFRAME para iniciar o rastreamento com um
limite de traceback de quadros NFRAME. Veja o tracemalloc.start() e PYTHONTRACEMALLOC
para mais informaçõ es.
Adicionado na versã o 3.4.
• -X int_max_str_digits configura a limitaçã o de comprimento de string na conversã o para inteiro.
Veja també m PYTHONINTMAXSTRDIGITS.
Adicionado na versã o 3.11.
• -X importtime para mostrar quanto tempo leva cada importaçã o. Mostra o nome do mó dulo, tempo
cumulativo (incluindo importaçõ es aninhadas) e tempo pró prio (excluindo importaçõ es aninhadas). Ob-
serve que sua saída pode ser interrompida em aplicaçõ es multithread. O uso típico é python3 -X
importtime -c 'import asyncio'. Veja també m PYTHONPROFILEIMPORTTIME.

Adicionado na versã o 3.7.

• -X dev: habilita Modo de Desenvolvimento do Python, introduzindo verificaçõ es adicionais de tempo
de execuçã o que sã o muito custosas para serem habilitadas por padrã o. Veja també m PYTHONDEVMODE.
Adicionado na versã o 3.7.
• -X utf8 habilita o Modo UTF-8 do Python. -X utf8=0 explicitamente desabilita o Modo UTF-8 do
Python (mesmo quando de outra forma seria ativado automaticamente). Veja també m PYTHONUTF8.
Adicionado na versã o 3.7.
• -X pycache_prefix=PATH permite a escrita de arquivos .pyc em uma á rvore paralela enraizada em
um determinado diretó rio em vez de na á rvore de có digo. Veja també m PYTHONPYCACHEPREFIX .
Adicionado na versã o 3.8.
• -X warn_default_encoding emite uma EncodingWarning quando a codificaçã o padrã o específica
da localidade é usada para abrir arquivos. Veja també m PYTHONWARNDEFAULTENCODING .

1.1. Linha de comando 9

Python Setup and Usage, Release 3.13.0

Adicionado na versã o 3.10.

• -X no_debug_ranges desabilita a inclusã o das tabelas que mapeiam informaçõ es de localizaçã o ex-
tra (linha final, deslocamento da coluna inicial e deslocamento da coluna final) para cada instruçã o em
objetos có digo. Isso é ú til quando objetos có digo menores e arquivos pyc sã o desejados, bem como su-
primir os indicadores de localizaçã o visual extra quando o interpretador exibe tracebacks. Veja també m
PYTHONNODEBUGRANGES.

Adicionado na versã o 3.11.

• -X frozen_modules determina se os mó dulos congelados sã o ou nã o ignorados pelo maquiná rio
de importaçã o. Um valor de on significa que eles sã o importados e off significa que eles sã o igno-
rados. O padrã o é on se este for um Python instalado (o caso normal). Se estiver em desenvolvi-
mento (executando a partir da á rvore de origem), o padrã o é off. Observe que os mó dulos congelados
importlib_bootstrap e importlib_bootstrap_external sã o sempre usados, mesmo que esse
sinalizador esteja definido como off. Veja també m PYTHON_FROZEN_MODULES.
Adicionado na versã o 3.11.
• -X perf habilita o suporte para o perfilador do Linux perf. Quando essa opçã o for fornecida, o perfila-
dor perf poderá relatar chamadas Python. Essa opçã o está disponível somente em algumas plataformas
e nã o fará nada se nã o for compatível com o sistema atual. A opçã o padrã o valor é “off”. Consulte
també m PYTHONPERFSUPPORT e perf_profiling.
Adicionado na versã o 3.12.
• -X perf_jit habilita o suporte para o perfilador do Linux perf com suporte a DWARF. Quando
essa opçã o for fornecida, o perfilador perf poderá relatar chamadas do Python usando informaçõ es de
DWARF. Essa opçã o está disponível somente em algumas plataformas e nã o fará nada se nã o for compa-
tível com o sistema atual. A opçã o padrã o valor é “off”. Veja també m PYTHON_PERF_JIT_SUPPORT
e perf_profiling.
Adicionado na versã o 3.13.
• -X cpu_count=n substitui os.cpu_count(), os.process_cpu_count() e multiprocessing.
cpu_count(). n deve ser maior ou igual a 1. Esta opçã o pode ser ú til para usuá rios que precisam limitar
os recursos da CPU de um sistema contê iner. Veja també m PYTHON_CPU_COUNT . Se n for default,
nada será substituído.
Adicionado na versã o 3.13.
• -X presite=pacote.,módulo especifica um mó dulo que deve ser importado antes do mó dulo site
ser executado e antes do mó dulo __main__ existir. Portanto, o mó dulo importado nã o é __main__. Isso
pode ser usado para executar có digo antecipadamente durante a inicializaçã o do Python. Python precisa
ser construído no modo de depuração para que esta opçã o exista. Veja també m PYTHON_PRESITE.
Adicionado na versã o 3.13.
• -X gil=0,1 força a GIL a ser desabilitada ou habilitada, respectivamente. A definiçã o para 0 está
disponível apenas em construçõ es configuradas com --disable-gil. Veja també m PYTHON_GIL e
whatsnew313-free-threaded-cpython.
Adicionado na versã o 3.13.
També m permite passar valores arbitrá rios e recuperá -los atravé s do dicioná rio sys._xoptions.
Adicionado na versã o 3.2.
Alterado na versã o 3.9: Removida a opçã o -X showalloccount.
Alterado na versã o 3.10: Removida a opçã o -X oldparser.

10 Capítulo 1. Linha de comando e ambiente

 Python Setup and Usage, Release 3.13.0

1.1.4 Controlando cores

O interpretador Python é configurado por padrã o para usar cores para destacar a saída em determinadas situaçõ es,
como ao exibir tracebacks. Este comportamento pode ser controlado definindo diferentes variá veis de ambiente.
Definir a variá vel de ambiente TERM como dumb desativará cores.
Se a variá vel de ambiente FORCE_COLOR estiver definida, a cor será habilitada independentemente do valor de TERM.
Isso é ú til em sistemas CI que nã o sã o terminais, mas ainda podem exibir sequê ncias de escape ANSI.
Se a variá vel de ambiente NO_COLOR estiver definida, o Python desativará todas as cores na saída. Isto tem prece-
dê ncia sobre FORCE_COLOR.
Todas essas variá veis de ambiente també m sã o usadas por outras ferramentas para controlar a saída de cores. Para
controlar a saída de cores apenas no interpretador Python, a variá vel de ambiente PYTHON_COLORS pode ser usada.
Esta variá vel tem precedê ncia sobre NO_COLOR, que por sua vez tem precedê ncia sobre FORCE_COLOR.

1.1.5 Opções que você não deve usar

-J
Reservado para uso pelo Jython.

1.2 Variáveis de ambiente

Essas variá veis de ambiente influenciam o comportamento do Python, elas sã o processadas antes das opçõ es de linha
de comando diferentes de -E ou -I. É comum que as opçõ es de linha de comando substituam as variá veis ambientais
onde há um conflito.
PYTHONHOME
Altera a localizaçã o das bibliotecas Python padrã o. Por padrã o, as bibliotecas sã o pesquisadas em prefix/
lib/pythonversion e exec_prefix/lib/pythonversion, onde prefix e exec_prefix sã o diretó -
rios dependentes da instalaçã o, ambos padronizando para /usr/local.
Quando PYTHONHOME é definido como um ú nico diretó rio, seu valor substitui prefix e exec_prefix. Para
especificar valores diferentes para estes, defina PYTHONHOME para prefix:exec_prefix.
PYTHONPATH
Aumenta o caminho de pesquisa padrã o para arquivos de mó dulo. O formato é o mesmo PATH do shell: um ou
mais caminhos de diretó rio separados por os.pathsep (por exemplo, dois pontos no Unix ou ponto e vírgula
no Windows). Os diretó rios inexistentes sã o ignorados silenciosamente.
Alé m dos diretó rios normais, entradas individuais PYTHONPATH podem referir-se a arquivos zip contendo
mó dulos Python puros (tanto no có digo-fonte quanto na forma compilada). Mó dulos de extensã o nã o podem
ser importados de arquivos zip.
O caminho de pesquisa padrã o depende da instalaçã o, mas geralmente começa com prefix/lib/
pythonversion (veja PYTHONHOME acima). É sempre anexado a PYTHONPATH .
Um diretó rio adicional será inserido no caminho de pesquisa antes de PYTHONPATH como descrito acima em
Opções de interface. O caminho de pesquisa pode ser manipulado de dentro de um programa Python como a
variá vel sys.path.
PYTHONSAFEPATH
Se for definido como uma string nã o vazia, nã o anexa um caminho potencialmente inseguro para sys.path:
consulte a opçã o -P para obter detalhes.
Adicionado na versã o 3.11.
PYTHONPLATLIBDIR
Se for definido como uma string nã o vazia, ela substitui o valor sys.platlibdir.
Adicionado na versã o 3.9.

1.2. Variáveis de ambiente 11

Python Setup and Usage, Release 3.13.0

PYTHONSTARTUP
Se este for o nome de um arquivo legível, os comandos Python nesse arquivo serã o executados antes que o
primeiro prompt seja exibido no modo interativo. O arquivo é executado no mesmo espaço de nomes onde
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 sys.ps1 e sys.ps2 e o gancho
sys.__interactivehook__ neste arquivo.

Levanta um evento de auditoria cpython.run_startup com o nome de arquivo como argumento quando
chamado na inicializaçã o.
PYTHONOPTIMIZE
Se for definido como uma string nã o vazia, é equivalente a especificar a opçã o -O. Se definido como um inteiro,
é equivalente a especificar -O vá rias vezes.
PYTHONBREAKPOINT
Se estiver definida, ela nomeia um chamá vel usando a notaçã o de caminho com pontos. O mó dulo que
conté m o chamá vel será importado e entã o o chamá vel será executado pela implementaçã o padrã o de sys.
breakpointhook() que é chamado pelo breakpoint() embutido. Se nã o for definido, ou definido como
uma string vazia, é equivalente ao valor “pdb.set_trace”. Definir isso para a string “0” faz com que a imple-
mentaçã o padrã o de sys.breakpointhook() nã o faça nada alé m de retornar imediatamente.
Adicionado na versã o 3.7.
PYTHONDEBUG
Se for definido como uma string nã o vazia, é equivalente a especificar a opçã o -d. Se definido como um inteiro,
é equivalente a especificar -d vá rias vezes.
Essa variá vel de ambiente requer uma construção de depuração do Python, caso contrá rio, será ignorada.
PYTHONINSPECT
Se for definido como uma string nã o vazia, é equivalente a especificar a opçã o -i.
Esta variá vel també m pode ser modificada pelo có digo Python usando os.environ para forçar o modo de
inspeçã o no encerramento do programa.
Levanta um evento de auditoria cpython.run_stdin sem argumentos.
Alterado na versã o 3.12.5: (també m 3.11.10, 3.10.15, 3.9.20 e 3.8.20) Emite eventos de auditoria.
Alterado na versã o 3.13: Usa PyrePL, se possível, nesse caso PYTHONSTARTUP també m é executado. Emite
eventos de auditoria.
PYTHONUNBUFFERED
Se for definido como uma string nã o vazia, é equivalente a especificar a opçã o -u.
PYTHONVERBOSE
Se for definido como uma string nã o vazia, é equivalente a especificar a opçã o -v . Se definido como um inteiro,
é equivalente a especificar -v vá rias vezes.
PYTHONCASEOK
Se estiver definido, Python nã o diferencia letras maiú sculas e minú sculas nas instruçõ es import. Isso só
funciona no Windows e OS X.
PYTHONDONTWRITEBYTECODE
Se for definido como uma string nã o vazia, o Python nã o tentará escrever arquivos .pyc na importaçã o de
mó dulos fonte. Isso é equivalente a especificar a opçã o -B.
PYTHONPYCACHEPREFIX
Se estiver definido, o Python escreverá os arquivos .pyc em uma á rvore de diretó rio espelho neste caminho,
em vez de nos diretó rios __pycache__ dentro da á rvore de fontes. Isso é equivalente a especificar a opçã o
-X pycache_prefix=PATH.

Adicionado na versã o 3.8.

12 Capítulo 1. Linha de comando e ambiente

 Python Setup and Usage, Release 3.13.0

PYTHONHASHSEED
Se esta variá vel nã o for definida ou definida como random, um valor aleató rio é usado para semear os hashes
de objetos str e bytes.
Se PYTHONHASHSEED for definido como um valor inteiro, ele é usado como uma semente fixa para gerar o
hash() dos tipos cobertos pela aleatorizaçã o do hash.
Sua finalidade é permitir hash repetível, como autotestes do pró prio interpretador, ou permitir que um cluster
de processos Python compartilhe valores de hash.
O nú mero inteiro deve ser um nú mero decimal no intervalo [0,4294967295]. Especificar o valor 0 desabilitará
a aleatorizaçã o de hash.
Adicionado na versã o 3.2.3.
PYTHONINTMAXSTRDIGITS
Se esta variá vel estiver definida para um inteiro, é usada para configurar a limitaçã o de comprimento de string
na conversã o para inteiro global do interpretador.
Adicionado na versã o 3.11.
PYTHONIOENCODING
Se for definido antes de executar o interpretador, ele substitui a codificaçã o usada para stdin/stdout/stderr, na
sintaxe encodingname:errorhandler. Ambas as partes encodingname e :errorhandler sã o opcio-
nais e tê m o mesmo significado que em str.encode().
Para stderr, a parte :errorhandler é ignorada; o tratador sempre será 'backslashreplace'.
Alterado na versã o 3.4: A parte encodingname é agora opcional.
Alterado na versã o 3.6: No Windows, a codificaçã o especificada por esta variá vel é ignorada para buffers de
console interativo, a menos que PYTHONLEGACYWINDOWSSTDIO també m seja especificado. Arquivos e canais
redirecionados por meio de fluxos padrã o nã o sã o afetados.
PYTHONNOUSERSITE
Se estiver definido, o Python nã o adicionará o diretório site-packages do usuário a sys.path.

µ Ver também

PEP 370 – Diretó rio site-packages por usuá rio.

PYTHONUSERBASE
Define o diretório base do usuário, que é usado para calcular o caminho do diretório
site-packages do usuário e caminhos de instalaçã o para python -m pip install --user.

µ Ver também

PEP 370 – Diretó rio site-packages por usuá rio.

PYTHONEXECUTABLE
Se esta variá vel de ambiente for definida, sys.argv[0] será definido com seu valor em vez do valor obtido
atravé s do tempo de execuçã o C. Funciona apenas no macOS.
PYTHONWARNINGS
Isso é equivalente à opçã o -W . Se definido como uma string separada por vírgulas, é equivalente a especificar
-W vá rias vezes, com os filtros posteriores na lista tendo precedê ncia sobre os anteriores na lista.
As configuraçõ es mais simples aplicam uma determinada açã o incondicionalmente a todos os avisos emitidos
por um processo (mesmo aqueles que sã o ignorados por padrã o):

1.2. Variáveis de ambiente 13

Python Setup and Usage, Release 3.13.0

PYTHONWARNINGS=default # Avisa uma vez por local de chamada

PYTHONWARNINGS=error # Converte para exceções
PYTHONWARNINGS=always # Avisa toda vez
PYTHONWARNINGS=all # Mesmo que PYTHONWARNINGS=always
PYTHONWARNINGS=module # Avisa uma vez por módulo chamador
PYTHONWARNINGS=once # Avisa uma vez por processo do Python
PYTHONWARNINGS=ignore # Nunca avisar

Veja warning-filter e describing-warning-filters para mais detalhes.

PYTHONFAULTHANDLER
Se esta variá vel de ambiente for definida como uma string nã o vazia, faulthandler.enable() é chamado
na inicializaçã o: instale um tratador para os sinais SIGSEGV, SIGFPE, SIGABRT, SIGBUS e SIGILL para
despejar o traceback (situaçã o da pilha de execuçã o) do Python. Isso é equivalente à opçã o -X faulthandler.
Adicionado na versã o 3.3.
PYTHONTRACEMALLOC
Se esta variá vel de ambiente for definida como uma string nã o vazia, começa a rastrear as alocaçõ es de memó ria
Python usando o mó dulo tracemalloc. O valor da variá vel é o nú mero má ximo de quadros armazenados
em um traceback de um rastreamento. Por exemplo, PYTHONTRACEMALLOC=1 armazena apenas o quadro
mais recente. Veja a funçã o tracemalloc.start() para mais informaçõ es. Isso é o equivalente a definir a
opçã o -X tracemalloc.
Adicionado na versã o 3.4.
PYTHONPROFILEIMPORTTIME
Se esta variá vel de ambiente for definida como uma string nã o vazia, o Python mostrará quanto tempo leva
cada importaçã o. Isso é o equivalente a definir a opçã o -X importtime.
Adicionado na versã o 3.7.
PYTHONASYNCIODEBUG
Se esta variá vel de ambiente for definida como uma string nã o vazia, habilita o modo de depuraçã o do mó dulo
asyncio.
Adicionado na versã o 3.4.
PYTHONMALLOC
Define os alocadores de memó ria Python e/ou instale ganchos de depuraçã o.
Define a família de alocadores de memó ria usados pelo Python:
• default: usa os alocadores padrã o de memó ria.
• malloc: usa a funçã o malloc() da biblioteca C para todos os domínios (PYMEM_DOMAIN_RAW,
PYMEM_DOMAIN_MEM, PYMEM_DOMAIN_OBJ).
• pymalloc: usa o alocador pymalloc para domínios PYMEM_DOMAIN_MEM e PYMEM_DOMAIN_OBJ e usa
a funçã o malloc() para o domínio PYMEM_DOMAIN_RAW.
• mimalloc: usa o alocador mimalloc para domínios PYMEM_DOMAIN_MEM e PYMEM_DOMAIN_OBJ e usa
a funçã o malloc() para o domínio PYMEM_DOMAIN_RAW.
Instala ganchos de depuraçã o:
• debug: instala os ganchos de depuraçã o sobre os alocadores padrã o de memó ria.
• malloc_debug: o mesmo que malloc, mas també m instala ganchos de depuraçã o.
• pymalloc_debug: o mesmo que pymalloc, mas també m instala ganchos de depuraçã o.
• mimalloc_debug: o mesmo que mimalloc, mas també m instala ganchos de depuraçã o.
Adicionado na versã o 3.6.
Alterado na versã o 3.7: Adicionado o alocador "default".

14 Capítulo 1. Linha de comando e ambiente

 Python Setup and Usage, Release 3.13.0

PYTHONMALLOCSTATS
Se definido como uma string nã o vazia, o Python exibe estatísticas do alocador de memó ria pymalloc toda vez
que uma nova arena de objeto pymalloc for criada e ao no desligamento.
Esta variá vel é ignorada se a variá vel de ambiente PYTHONMALLOC é usada para forçar o alocador malloc()
da biblioteca C, ou se Python está configurado sem suporte a pymalloc.
Alterado na versã o 3.6: Esta variá vel agora també m pode ser usada em Python compilado no modo de lança-
mento. Agora nã o tem efeito se definido como uma string vazia.
PYTHONLEGACYWINDOWSFSENCODING
Se definido como uma string nã o vazia, o modo padrã o do tratador de erros e codificação do sistema de arquivos
irá reverter para seus valores pré -3.6 de “mbcs” e “replace”, respectivamente. Caso contrá rio, os novos padrõ es
“utf-8” e “surrogatepass” serã o usados.
Isso també m pode ser habilitado em tempo de execuçã o com sys.
_enablelegacywindowsfsencoding().
Disponibilidade
Adicionado na versã o 3.6: Veja PEP 529 para mais detalhes.
PYTHONLEGACYWINDOWSSTDIO
Se definido como uma string nã o vazia, nã o usa o novo leitor e escritor de console. Isso significa que os
caracteres Unicode serã o codificados de acordo com a pá gina de có digo do console ativo, em vez de usar utf-8.
Esta variá vel é ignorada se os fluxos padrã o forem redirecionados (para arquivos ou canais) em vez de se referir
aos buffers do console.
Disponibilidade
Adicionado na versã o 3.6.
PYTHONCOERCECLOCALE
Se definido com o valor 0, faz com que a aplicaçã o principal de linha de comando Python ignore a coerçã o
dos có digos de idioma legados C e POSIX baseados em ASCII para uma alternativa baseada em UTF-8 mais
capaz.
Se esta variá vel não estiver definida (ou estiver definida para um valor diferente de 0), a variá vel de ambiente
de substituiçã o de localidade LC_ALL també m nã o será definida, e a localidade atual relatada para a categoria
LC_CTYPE é a localidade C padrã o, ou entã o a localidade POSIX explicitamente baseada em ASCII, entã o a
CLI do Python tentará configurar as seguintes localidades para a categoria LC_CTYPE na ordem listada antes
de carregar o tempo de execuçã o do interpretador:
• C.UTF-8
• C.utf8
• UTF-8
Se a configuraçã o de uma dessas categorias de local for bem-sucedida, a variá vel de ambiente LC_CTYPE tam-
bé m será configurada de acordo no ambiente de processo atual antes que o tempo de execuçã o do Python seja
inicializado. Isso garante que, alé m de ser visto pelo pró prio interpretador e outros componentes com reconhe-
cimento de localidade em execuçã o no mesmo processo (como a biblioteca GNU readline), a configuraçã o
atualizada també m é vista em subprocessos (independentemente de ou nã o esses processos estã o executando
um interpretador Python), bem como em operaçõ es que consultam o ambiente em vez da localidade C atual
(como o locale.getdefaultlocale() do pró prio Python).
Configurar uma dessas localidades (explicitamente ou por meio da coerçã o de localidade implícita acima)
habilita automaticamente o tratador de erros surrogateescape para sys.stdin e sys.stdout (sys.
stderr continua a usar backslashreplace como faz em qualquer outra localidade). Este comportamento
de tratamento de fluxo pode ser substituído usando PYTHONIOENCODING como de costume.
Para fins de depuraçã o, definir PYTHONCOERCECLOCALE=warn fará com que o Python emita mensagens de
aviso em stderr se a coerçã o de localidade for ativada ou se uma localidade que teria acionado a coerçã o
ainda estiver ativa quando o Python o tempo de execuçã o é inicializado.

1.2. Variáveis de ambiente 15

Python Setup and Usage, Release 3.13.0

Observe també m que mesmo quando a coerçã o de localidade está desabilitada, ou quando nã o consegue encon-
trar uma localidade de destino adequada, PYTHONUTF8 ainda será ativado por padrã o em localidades baseadas
em ASCII legadas. Ambos os recursos devem ser desabilitados para forçar o interpretador a usar ASCII ao
invé s de UTF-8 para interfaces de sistema.
Disponibilidade
Adicionado na versã o 3.7: Veja PEP 538 para mais detalhes.
PYTHONDEVMODE
Se esta variá vel de ambiente for definida como uma string nã o vazia, habilita Modo de Desenvolvimento do
Python, introduzindo verificaçõ es adicionais de tempo de execuçã o que sã o muito caras para serem habilitadas
por padrã o. Isso é o equivalente a definir a opçã o -X dev.
Adicionado na versã o 3.7.
PYTHONUTF8
Se definido para 1, habilita o modo UTF-8 do Python.
Se definido para 0, desabilita o modo UTF-8 do Python.
Definir qualquer outra string nã o vazia causa um erro durante a inicializaçã o do interpretador.
Adicionado na versã o 3.7.
PYTHONWARNDEFAULTENCODING
Se esta variá vel de ambiente for definida como uma string nã o vazia, emite uma EncodingWarning quando
a codificaçã o padrã o específica da localidade é usada.
Veja io-encoding-warning para detalhes.
Adicionado na versã o 3.10.
PYTHONNODEBUGRANGES
Se esta variá vel estiver definida, ela desabilita a inclusã o das tabelas que mapeiam informaçõ es de localizaçã o
extra (linha final, deslocamento da coluna inicial e deslocamento da coluna final) para cada instruçã o em ob-
jetos có digo. Isso é ú til quando objetos có digo menores e arquivos pyc sã o desejados, bem como suprimir os
indicadores de localizaçã o visual extra quando o interpretador exibe tracebacks.
Adicionado na versã o 3.11.
PYTHONPERFSUPPORT
Se essa variá vel for definida como valor diferente de zero, ela habilitará suporte para o perfilador do Linux
perf para que as chamadas Python possam ser detectadas por ele.
Se definido como 0, desativa o suporte ao perfilador do Linux perf.
Consulte també m a opçã o de linha de comando -X perf e perf_profiling.
Adicionado na versã o 3.12.
PYTHON_PERF_JIT_SUPPORT
Se essa variá vel for definida como valor diferente de zero, ela habilitará suporte para o perfilador do Linux
perf para que as chamadas Python possam ser detectadas por ele usando informaçõ es de DWARF.

Se definido como 0, desativa o suporte ao perfilador do Linux perf.

Veja també m a opçã o de linha de comando -X perf_jit e perf_profiling.
Adicionado na versã o 3.13.
PYTHON_CPU_COUNT
Se esta variá vel for definida como um nú mero inteiro positivo, ela substitui os valores de retorno de os.
cpu_count() e os.process_cpu_count().

Veja també m a opçã o de linha de comando -X cpu_count.

Adicionado na versã o 3.13.

16 Capítulo 1. Linha de comando e ambiente

 Python Setup and Usage, Release 3.13.0

PYTHON_FROZEN_MODULES
Se esta variá vel for definida como on ou off, ela determina se os mó dulos congelados serã o ou nã o ignorados
pela maquiná rio de importaçã o. Um valor on significa que eles serã o importados e off significa que serã o igno-
rados. O padrã o é on para construçõ es sem depuraçã o (o caso normal) e off para construçõ es com depuraçã o.
Observe que os mó dulos congelados importlib_bootstrap e importlib_bootstrap_external sã o
sempre usados, mesmo se este sinalizador estiver definido como off.
Veja també m a opçã o de linha de comando -X frozen_modules.
Adicionado na versã o 3.13.
PYTHON_COLORS
Se esta variá vel for definida como 1, o interpretador irá colorir vá rios tipos de saída. Definir como 0 desativa
este comportamento. Veja també m Controlando cores.
Adicionado na versã o 3.13.
PYTHON_BASIC_REPL
Se esta variá vel for definida como 1, o interpretador nã o tentará carregar o REPL baseado em Python que
requer curses e readline, e em vez disso usará o baseado em analisador tradicional REPL.
Adicionado na versã o 3.13.
PYTHON_HISTORY
Esta variá vel de ambiente pode ser usada para definir a localizaçã o de um arquivo .python_history (por
padrã o, é .python_history no diretó rio inicial do usuá rio).
Adicionado na versã o 3.13.
PYTHON_GIL
Se esta variá vel for definida como 1, a trava global do interpretador (GIL) será forçada. Definir como 0 força
a GIL a desligar (precisa do Python configurado com a opçã o de construçã o --disable-gil).
Veja també m a opçã o de linha de comando -X gil, que tem precedê ncia sobre esta variá vel, e whatsnew313-
-free-threaded-cpython.
Adicionado na versã o 3.13.

1.2.1 Variáveis de modo de depuração

PYTHONDUMPREFS
Se definido, Python irá despejar objetos e contagens de referê ncias ainda vivas apó s desligar o interpretador.
Precisa do Python configurado com a opçã o de construçã o --with-trace-refs.
PYTHONDUMPREFSFILE
Se definido, o Python irá despejar objetos e contagens de referê ncias ainda ativas apó s desligar o interpretador
em um arquivo no caminho fornecido como valor para esta variá vel de ambiente.
Precisa do Python configurado com a opçã o de construçã o --with-trace-refs.
Adicionado na versã o 3.11.
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 do mó dulo site ser executado, e antes do mó dulo __main__ ser criado. Portanto, o
mó dulo importado nã o é tratado como __main__.
Isso pode ser usado para executar có digo antecipadamente durante a inicializaçã o do Python.
Para importar um submó dulo, use pacote.módulo como valor, como em uma instruçã o de importaçã o.
Veja també m a opçã o de linha de comando -X presite, que tem precedê ncia sobre esta variá vel.
Precisa do Python configurado com a opçã o de construçã o --with-pydebug .
Adicionado na versã o 3.13.

1.2. Variáveis de ambiente 17

Python Setup and Usage, Release 3.13.0

18 Capítulo 1. Linha de comando e ambiente

 CAPÍTULO 2

Utilizando Python em plataformas Unix

2.1 Obtendo e instalando a versão mais recente do Python

2.1.1 No Linux
O Python vem pré -instalado na maioria das distribuiçõ es Linux e está disponível como um pacote em todas as outras.
No entanto, há certos recursos que você pode querer usar que nã o estã o disponíveis no pacote da sua distribuiçã o.
Você pode compilar a versã o mais recente do Python a partir do có digo-fonte.
No caso de a versã o mais recente do Python nã o vir pré -instalada e nã o estar nos repositó rios també m, você pode
criar pacotes para sua pró pria distro. Dê uma olhada nos seguintes links:

µ Ver também

https://www.debian.org/doc/manuals/maint-guide/first.en.html
para usuá rios Debian
https://en.opensuse.org/Portal:Packaging
para usuá rios OpenSuse
https://docs.fedoraproject.org/en-US/package-maintainers/Packaging_Tutorial_GNU_Hello/
para usuá rios Fedora
https://slackbook.org/html/package-management-making-packages.html
para usuá rios do Slackware

2.1.2 No FreeBSD e OpenBSD

• usuá rios do FreeBSD, para adicionar a utilizaçã o do pacote utilize:

pkg install python3

• Usuá rios do OpenBSD, para adicionar pacotes use:

pkg_add -r python

pkg_add ftp://ftp.openbsd.org/pub/OpenBSD/4.2/packages/<insert your␣

,→architecture here>/python-<version>.tgz

19
Python Setup and Usage, Release 3.13.0

Por exemplo, usuá rios i386 podem pegar a versã o 2.5.1 do Python usando o comando:

pkg_add ftp://ftp.openbsd.org/pub/OpenBSD/4.2/packages/i386/python-2.5.1p2.tgz

2.2 Compilando o Python

Se você quer compilar o CPython, a primeira coisa que você precisa fazer é baixar o có digo-fonte. Você pode baixar
a ú ltima versã o ou usar o git para fazer um clone. (Se você pretende contribuir modificaçõ es, você vai precisar um
“clone”.)
O processo de compilaçã o consiste nos comandos usuais:

./configure
make
make install

Opções de configuração e advertê ncias para plataformas específicas do Unix estã o amplamente documentadas no
arquivo README.rst na raiz da á rvore de fontes Python.

Á Aviso

make install pode sobrescrever ou mascarar o arquivo biná rio python3. make altinstall é , portanto,
recomendado ao invé s de make install uma vez que o mesmo apenas instala o arquivo exec_prefix/bin/
pythonversion.

2.3 Paths e arquivos relacionados com o Python

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 da mesma forma que para o software GNU; eles poderã o ser os mesmos.
Por exemplo, na maioria dos sistemas Linux, o padrã o para ambos é /usr.

Arquivo/diretório Significado
exec_prefix/bin/python3 Localizaçã o recomendada do interpretador.
prefix/lib/pythonversion, A localizaçã o recomendada dos diretó rios contendo os mó dulos padrã o.
exec_prefix/lib/
pythonversion
prefix/include/ Localizaçõ es recomendadas dos diretó rios contendo os arquivos de in-
pythonversion, exec_prefix/ clusã o necessá rios para o desenvolvimento de extensõ es Python e incor-
include/pythonversion poraçã o do interpretador.

2.4 Diversos
Para usar facilmente scripts Python no Unix, você precisa torná -los executá veis, por exemplo, com

$ chmod +x script

e colocar uma linha Shebang apropriada no topo do script. Uma boa escolha normalmente é

#!/usr/bin/env python3

que procura o interpretador do Python no conjunto PATH. No entanto, alguns sistemas Unix podem nã o ter o comando
env, entã o você pode precisar codificar /usr/bin/python3 como o caminho do interpretador.

Para usar comandos Shell em seus scripts Python, veja o mó dulo subprocess.

20 Capítulo 2. Utilizando Python em plataformas Unix

 Python Setup and Usage, Release 3.13.0

2.5 OpenSSL personalizado

1. Para usar a configuraçã o OpenSSL do seu fornecedor e armazenamento confiá vel do sistema, localize o diretó -
rio com o arquivo openssl.cnf ou link simbó lico em /etc. Na maioria das distribuiçõ es o arquivo está em
/etc/ssl ou em /etc/pki/tls. O diretó rio també m deve conter um arquivo cert.pem e/ou um diretó rio
certs.

$ find /etc/ -name openssl.cnf -printf "%h\n"

/etc/ssl

2. Baixe, construa e instale o OpenSSL. Certifique-se de usar install_sw e nã o install. O destino
install_sw nã o substitui o openssl.cnf.

$ curl -O https://www.openssl.org/source/openssl-VERSÃO.tar.gz
$ tar xzf openssl-VERSÃO
$ pushd openssl-VERSÃO
$ ./config \
--prefix=/usr/local/custom-openssl \
--libdir=lib \
--openssldir=/etc/ssl
$ make -j1 depend
$ make -j8
$ make install_sw
$ popd

3. Construa o Python com o OpenSSL personalizado (veja as opçõ es configure --with-openssl e

--with-openssl-rpath)

$ pushd python-3.x.x
$ ./configure -C \
--with-openssl=/usr/local/custom-openssl \
--with-openssl-rpath=auto \
--prefix=/usr/local/python-3.x.x
$ make -j8
$ make altinstall

® Nota

As versõ es de patches do OpenSSL tê m uma ABI compatível com versõ es anteriores. Você nã o precisa recom-
pilar o Python para atualizar o OpenSSL. É suficiente substituir a instalaçã o personalizada do OpenSSL por uma
versã o mais recente.

2.5. OpenSSL personalizado 21

Python Setup and Usage, Release 3.13.0

22 Capítulo 2. Utilizando Python em plataformas Unix

 CAPÍTULO 3

Configurar o Python

3.1 Requisitos de construção

Recursos e versõ es mínimas necessá rios para construir o CPython:
• Um compilador C11. Nã o sã o necessá rios recursos opcionais do C11.
• No Windows, é necessá rio o Microsoft Visual Studio 2017 ou posterior.
• Suporte para nú meros de ponto flutuante do IEEE 754 e Not-a-Number (NaN) de ponto flutuante.
• Suporte a threads.
• OpenSSL 1.1.1 é a versã o mínima e OpenSSL 3.0.9 é a versã o mínima recomendada para os mó dulos de
extensã o ssl e hashlib.
• SQLite 3.15.2 para o mó dulo de extensã o sqlite3.
• Tcl/Tk 8.5.12 para o mó dulo tkinter.
• Autoconf 2.71 e aclocal 1.16.5 sã o necessá rios para regenerar o script configure.
Alterado na versã o 3.1: Agora é necessá ria a versã o 8.3.1 do Tcl/Tk.
Alterado na versã o 3.5: No Windows, agora é necessá rio o Visual Studio 2015 ou posterior. Agora é necessá ria a
versã o 8.4 do Tcl/Tk.
Alterado na versã o 3.6: Recursos selecionados do C99 agora sã o necessá rios, como funçõ es <stdint.h> e static
inline.

Alterado na versã o 3.7: Suporte a threads e OpenSSL 1.0.2 agora sã o necessá rios.
Alterado na versã o 3.10: OpenSSL 1.1.1 agora é necessá rio. Requer SQLite 3.7.15.
Alterado na versã o 3.11: Compilador C11, suporte a IEEE 754 e NaN agora sã o necessá rios. No Windows, é
necessá rio o Visual Studio 2017 ou posterior. A versã o 8.5.12 do Tcl/Tk agora é necessá ria para o mó dulo tkinter.
Alterado na versã o 3.13: Autoconf 2.71, aclocal 1.16.5 e SQLite 3.15.2 agora sã o necessá rios.
Veja també m PEP 7 “Guia de estilo para có digo C” e PEP 11 “Suporte do CPython a plataformas”.

23
Python Setup and Usage, Release 3.13.0

3.2 Arquivos gerados

Para reduzir as dependê ncias de construçã o, o có digo-fonte do Python conté m vá rios arquivos gerados. Comandos
para regenerar todos os arquivos gerados:

make regen-all
make regen-stdlib-module-names
make regen-limited-abi
make regen-configure

O arquivo Makefile.pre.in documenta os arquivos gerados, suas entradas e ferramentas usadas para regenerá -los.
Procure por alvos regen-* de make.

3.2.1 Script configure

O comando make regen-configure regera o arquivo aclocal.m4 e o script configure usando o shell script
Tools/build/regen-configure.sh, o qual usa um contê iner Ubuntu para obter as mesmas versõ es de ferra-
mentas e ter uma saída reproduzível.
O contê iner é opcional, o seguinte comando pode ser executado localmente:

autoreconf -ivf -Werror

Os arquivos gerados podem mudar dependendo das versõ es exatas do autoconf-archive, aclocal e
pkg-config.

3.3 Opções de configuração

Liste todas as opçõ es do configure usando:

./configure --help

Veja també m o Misc/SpecialBuilds.txt na distribuiçã o de có digo-fonte do Python.

3.3.1 Opções gerais

--enable-loadable-sqlite-extensions
Suporte a extensõ es carregá veis no mó dulo de extensã o _sqlite (o padrã o é nã o) do mó dulo sqlite3.
Veja o mé todo sqlite3.Connection.enable_load_extension() do mó dulo sqlite3.
Adicionado na versã o 3.6.
--disable-ipv6
Desabilita suporte a IPv6 (habilitado por padrã o se houver suporte), veja o mó dulo socket.
--enable-big-digits=[15|30]
Define o tamanho em bits dos dígitos de int do Python: 15 ou 30 bits.
Por padrã o, o tamanho dos dígitos é 30.
Define o PYLONG_BITS_IN_DIGIT para 15 ou 30.
Veja sys.int_info.bits_per_digit.
--with-suffix=SUFFIX
Define o sufixo do executá vel do Python para SUFFIX.
O sufixo padrã o é .exe no Windows e macOS (executá vel python.exe), .js em nó Emscripten, .html em
navegador Emscripten, .wasm em WASI e uma string vazia em outras plataformas (executá vel python).
Alterado na versã o 3.11: O sufixo padrã o na plataforma WASM é um entre .js, .html ou .wasm

24 Capítulo 3. Configurar o Python

 Python Setup and Usage, Release 3.13.0

--with-tzpath=<list of absolute paths separated by pathsep>

Seleciona o caminho de pesquisa de fuso horá rio padrã o para zoneinfo.TZPATH. Veja a Configuraçã o de
tempo de compilaçã o do mó dulo zoneinfo.
Padrã o: /usr/share/zoneinfo:/usr/lib/zoneinfo:/usr/share/lib/zoneinfo:/etc/
zoneinfo.
Veja o separador de caminhos os.pathsep.
Adicionado na versã o 3.9.
--without-decimal-contextvar
Constró i o mó dulo de extensã o _decimal usando um contexto local de thread ao invé s de um contexto local
de corrotina (padrã o), veja o mó dulo decimal.
Veja decimal.HAVE_CONTEXTVAR e o mó dulo contextvars.
Adicionado na versã o 3.9.
--with-dbmliborder=<list of backend names>
Substitui a ordem de verificaçã o de backends de banco de dados para o mó dulo dbm
Um valor vá lido é uma string separada por dois pontos (:) com os nomes de backend:
• ndbm;
• gdbm;
• bdb.
--without-c-locale-coercion
Desabilita a coerçã o de localidade C para uma localidade baseada em UTF-8 (ativada por padrã o).
Nã o define a macro PY_COERCE_C_LOCALE.
Consulte PYTHONCOERCECLOCALE e a PEP 538.
--without-freelists
Desabilita todas as listas livres, exceto o singleton de tupla vazia.
Adicionado na versã o 3.11.
--with-platlibdir=DIRNAME
Nome do diretó rio da biblioteca Python (o padrã o é lib).
Fedora e SuSE usam lib64 em plataformas de 64 bits.
Veja sys.platlibdir.
Adicionado na versã o 3.9.
--with-wheel-pkg-dir=PATH
Diretó rio de pacotes de wheel usados pelo mó dulo ensurepip (nenhum por padrã o).
Algumas políticas de empacotamento de distribuiçã o do Linux recomendam contra o empacotamento de de-
pendê ncias. Por exemplo, o Fedora instala pacotes wheel no diretó rio /usr/share/python-wheels/ e
nã o instala o pacote ensurepip._bundled.
Adicionado na versã o 3.10.
--with-pkg-config=[check|yes|no]
Se o configure deve usar pkg-config para detectar dependê ncias de construçã o.
• check (padrã o): pkg-config é opcional
• yes: pkg-config é obrigató rio
• no: configure nã o usa pkg-config mesmo quando presente
Adicionado na versã o 3.11.

3.3. Opções de configuração 25

Python Setup and Usage, Release 3.13.0

--enable-pystats
Ativa a coleta de estatísticas internas de desempenho do Python.
Por padrã o, a coleta de estatísticas está desativada. Use o comando python3 -X pystats ou defina a va-
riá vel de ambiente PYTHONSTATS=1 para ativar a coleta de estatísticas na inicializaçã o do Python.
Na saída do Python, despeja as estatísticas se a coleta de estatísticas estiver ativada e nã o apagada.
Efeitos:
• Adiciona a opçã o de linha de comando -X pystats.
• Adiciona a variá vel de ambiente PYTHONSTATS.
• Define a macro Py_STATS.
• Adiciona funçõ es ao mó dulo sys:
– sys._stats_on(): Ativa a coleta de estatísticas.
– sys._stats_off(): Desativa a coleta de estatísticas.
– sys._stats_clear(): Apaga as estatísticas.
– sys._stats_dump(): Despeja as estatísticas no arquivo e apaga as estatísticas.
As estatísticas serã o despejadas em um arquivo arbitrá rio (provavelmente ú nico) em /tmp/py_stats/ (Unix)
ou C:\temp\py_stats\ (Windows). Se aquele diretó rio nã o existir, os resultados serã o enviados para stderr.
Use Tools/scripts/summarize_stats.py para ler as estatísticas.
Estatísticas:
• Có digo de operaçã o:
– Especializaçã o: sucesso, fracasso, acerto, adiado, erro, deopt, falhas;
– Contagem de execuçõ es;
– Contagem em pares.
• Chamada:
– Chamadas Python em linha;
– Chamadas a PyEval;
– Quadros enviados;
– Objetos quadro criados;
– Chamadas de Eval: vetor, gerador, legado, funçã o VECTORCALL, classe de construçã o, slot, fun-
çã o “ex”, API, mé todo.
• Objeto:
– incref e decref;
– incref e decref do interpretador;
– alocaçõ es: tudo, 512 bytes, 4 kiB, big;
– memó ria livre;
– listas de memó ria livre para/de;
– Dicioná rio materializado/desmaterializado;
– cache de tipo;
– tentativas de otimizaçã o;
– rastros de otimizaçã o criados/executados;
– uops executados.

26 Capítulo 3. Configurar o Python

 Python Setup and Usage, Release 3.13.0

• Coletor de lixo:
– Coletas de lixo;
– Objetos visitados;
– Objetos coletados.
Adicionado na versã o 3.11.
--disable-gil
Habilita suporte experimental para execuçã o de Python sem a trava global do interpretador (GIL): construçã o
de com threads livres.
Define a macro Py_GIL_DISABLED e adiciona "t" a sys.abiflags.
Veja whatsnew313-free-threaded-cpython para mais detalhes.
Adicionado na versã o 3.13.
PKG_CONFIG
Caminho para o utilitá rio pkg-config.
PKG_CONFIG_LIBDIR

PKG_CONFIG_PATH
Opçõ es do pkg-config.

3.3.2 Opções do compilador C

CC
Comando do compilador C.
CFLAGS
Sinalizadores do compilador C.
CPP
Comando do pré -processador C.
CPPFLAGS
Sinalizadores do pré -processador C, p.ex., -Iinclude_dir.

3.3.3 Opções da ligação

LDFLAGS
Sinalizadores do vinculador. p.ex., -Llibrary_directory .
LIBS
Bibliotecas para passar para o vinculador, p.ex. -llibrary .
MACHDEP
Nome para arquivos de biblioteca dependentes de má quina.

3.3.4 Opções para dependências de terceiros

Adicionado na versã o 3.11.
BZIP2_CFLAGS

BZIP2_LIBS
Sinalizadores de compilador C e vinculador para vincular Python a libbz2, usados pelo mó dulo bz2, subs-
tituindo pkg-config.
CURSES_CFLAGS

3.3. Opções de configuração 27

Python Setup and Usage, Release 3.13.0

CURSES_LIBS
Sinalizadores de compilador C e vinculador para libncurses ou libncursesw, usados pelo mó dulo
curses, substituindo pkg-config.

GDBM_CFLAGS

GDBM_LIBS
Sinalizadores de compilador C e vinculador para gdbm.
LIBB2_CFLAGS

LIBB2_LIBS
Sinalizadores de compilador C e vinculador para libb2 (BLAKE2), usados pelo mó dulo hashlib, substi-
tuindo pkg-config.
LIBEDIT_CFLAGS

LIBEDIT_LIBS
Sinalizadores de compilador C e vinculador para libedit, usados pelo mó dulo readline, substituindo
pkg-config.

LIBFFI_CFLAGS

LIBFFI_LIBS
Sinalizadores de compilador C e vinculador para libffi, usados pelo mó dulo ctypes, substituindo
pkg-config.

LIBMPDEC_CFLAGS

LIBMPDEC_LIBS
Sinalizadores de compilador C e vinculador para libmpdec, usados pelo mó dulo decimal, substituindo
pkg-config.

® Nota

Estas variá veis de ambiente nã o tê m efeito a menos que --with-system-libmpdec seja especificado.

LIBLZMA_CFLAGS

LIBLZMA_LIBS
Sinalizadores de compilador C e vinculador para liblzma, usados pelo mó dulo lzma, substituindo
pkg-config.
LIBREADLINE_CFLAGS

LIBREADLINE_LIBS
Sinalizadores de compilador C e vinculador para libreadline, usados pelo mó dulo readline, substituindo
pkg-config.

LIBSQLITE3_CFLAGS

LIBSQLITE3_LIBS
Sinalizadores de compilador C e vinculador para libsqlite3, usados pelo mó dulo sqlite3, substituindo
pkg-config.

LIBUUID_CFLAGS

LIBUUID_LIBS
Sinalizadores de compilador C e vinculador para libuuid, usados pelo mó dulo uuid, substituindo
pkg-config.

28 Capítulo 3. Configurar o Python

 Python Setup and Usage, Release 3.13.0

PANEL_CFLAGS

PANEL_LIBS
Sinalizadores de compilador C e vinculador para PANEL, substituindo pkg-config.
Sinalizadores de compilador C e vinculador para libpanel ou libpanelw, usados pelo mó dulo curses.
panel, substituindo pkg-config.

TCLTK_CFLAGS

TCLTK_LIBS
Sinalizadores de compilador C e vinculador para TCLTK, substituindo pkg-config.;
ZLIB_CFLAGS

ZLIB_LIBS
Sinalizadores de compilador C e vinculador para libzlib, usados pelo mó dulo gzip, substituindo
pkg-config.

3.3.5 Opções de WebAssembly

--with-emscripten-target=[browser|node]
Define o “sabor” de construçã o para wasm32-emscripten.
• browser (padrã o): pré -carrega stdlib mínima, MEMFS padrã o.
• node: suporte a NODERAWFS e pthread.
Adicionado na versã o 3.11.
--enable-wasm-dynamic-linking
Ativa o suporte de vinculaçã o dinâ mica para WASM.
A vinculaçã o dinâ mica permite dlopen. O tamanho do arquivo executá vel aumenta devido à eliminaçã o
limitada de có digo morto e recursos adicionais.
Adicionado na versã o 3.11.
--enable-wasm-pthreads
Ativa o suporte a pthreads para WASM.
Adicionado na versã o 3.11.

3.3.6 Opções de instalação

--prefix=PREFIX
Instala arquivos independentes de arquitetura em PREFIX. No Unix, o padrã o é /usr/local.
Este valor pode ser recuperado em tempo de execuçã o usando sys.prefix.
Como exemplo, pode-se usar --prefix="$HOME/.local/" para instalar um Python em seu diretó rio pes-
soal (home).
--exec-prefix=EPREFIX
Instala arquivos dependentes de arquitetura no EPREFIX, o padrã o é --prefix.
Este valor pode ser recuperado em tempo de execuçã o usando sys.exec_prefix.
--disable-test-modules
Nã o constró i nem instala mó dulos de teste, como o pacote test ou o mó dulo de extensã o _testcapi (cons-
truído e instalado por padrã o).
Adicionado na versã o 3.10.

3.3. Opções de configuração 29

Python Setup and Usage, Release 3.13.0

--with-ensurepip=[upgrade|install|no]
Seleciona o comando ensurepip executado na instalaçã o do Python:
• upgrade (padrã o): executa o comando python -m ensurepip --altinstall --upgrade.
• install: executa o comando python -m ensurepip --altinstall;
• no: nã o executa ensurepip;
Adicionado na versã o 3.6.

3.3.7 Opções de desempenho

Configurar o Python usando --enable-optimizations --with-lto (PGO + LTO) é o recomendado para
melhor desempenho. O sinalizador experimental --enable-bolt també m pode ser usado para melhorar o desem-
penho.
--enable-optimizations
Habilita a otimizaçã o guiada por perfil (PGO, do inglê s Profile Guided Optimization) usando PROFILE_TASK
(desabilitado por padrã o).
O compilador C Clang requer o programa llvm-profdata para PGO. No macOS, o GCC també m exige: o
GCC é apenas um apelido para o Clang no macOS.
Desabilita també m a interposiçã o semâ ntica no libpython se --enable-shared e GCC forem usados: adi-
ciona -fno-semantic-interposition aos sinalizadores do compilador e do vinculador.

® Nota

Durante a construçã o, você poderá encontrar avisos do compilador sobre a indisponibilidade de dados
de perfil para alguns arquivos fonte. Esses avisos sã o inofensivos, pois apenas um subconjunto do có -
digo é exercido durante a aquisiçã o de dados de perfil. Para desativar esses avisos no Clang, suprima-os
manualmente adicionando -Wno-profile-instr-unprofiled a CFLAGS.

Adicionado na versã o 3.6.

Alterado na versã o 3.10: Usa -fno-semantic-interposition no GCC.
PROFILE_TASK
Variá vel de ambiente usada no Makefile: argumentos de linha de comando do Python para a tarefa de geraçã o
de PGO.
Padrã o: -m test --pgo --timeout=$(TESTTIMEOUT).
Adicionado na versã o 3.8.
Alterado na versã o 3.13: A falha da tarefa nã o é mais ignorada silenciosamente.
--with-lto=[full|thin|no|yes]
Habilita o otimizaçã o em tempo de vinculaçã o (LTO, do inglê s Link Time Optimization) em qualquer com-
pilaçã o (desabilitado por padrã o).
O compilador C Clang requer llvm-ar para LTO (ar no macOS), bem como um vinculador compatível com
LTO (ld.gold ou lld).
Adicionado na versã o 3.6.
Adicionado na versã o 3.11: Para usar o recurso ThinLTO, use --with-lto=thin no Clang.
Alterado na versã o 3.12: Usa ThinLTO como política de otimizaçã o padrã o no Clang se o compilador aceitar
o sinalizador.

30 Capítulo 3. Configurar o Python

 Python Setup and Usage, Release 3.13.0

--enable-bolt
Habilita o uso do otimizador biná rio pó s-vinculaçã o BOLT (desabilitado por padrã o).
BOLT faz parte do projeto LLVM, mas nem sempre está incluído em suas distribuiçõ es biná rias. Este sinali-
zador requer que llvm-bolt e merge-fdata estejam disponíveis.
BOLT ainda é um projeto relativamente novo, entã o este sinalizador deve ser considerado experimental por
enquanto. Como esta ferramenta opera em có digo de má quina, seu sucesso depende de uma combinaçã o do
ambiente de construçã o + os outros argumentos de configuraçã o de otimizaçã o + a arquitetura da CPU, e nem
todas as combinaçõ es sã o suportadas. Versõ es do BOLT anteriores ao LLVM 16 sã o conhecidas por travar
o BOLT em alguns cená rios. O uso do LLVM 16 ou mais recente para otimizaçã o do BOLT é fortemente
incentivado.
As variá veis BOLT_INSTRUMENT_FLAGS e BOLT_APPLY_FLAGS do configure podem ser definidas para
substituir o conjunto padrã o de argumentos para llvm-bolt para instrumentar e aplicar dados BOLT aos
biná rios , respectivamente.
Adicionado na versã o 3.12.
BOLT_APPLY_FLAGS
Argumentos para llvm-bolt ao criar um biná rio otimizado com BOLT.
Adicionado na versã o 3.12.
BOLT_INSTRUMENT_FLAGS
Argumentos para llvm-bolt ao instrumentar biná rios.
Adicionado na versã o 3.12.
--with-computed-gotos
Habilita “gotos” computados no laço de avaliaçã o (habilitado por padrã o em compiladores suportados).
--without-mimalloc
Desativa o alocador rá pido mimalloc (habilitado por padrã o).
Veja també m a variá vel de ambiente PYTHONMALLOC .
--without-pymalloc
Desabilita o alocador de memó ria especializado do Python pymalloc (habilitado por padrã o).
Veja també m a variá vel de ambiente PYTHONMALLOC .
--without-doc-strings
Desabilita as strings de documentaçã o está tica para reduzir o consumo de memó ria (habilitado por padrã o).
As strings de documentaçã o definidas em Python nã o sã o afetadas.
Nã o define a macro WITH_DOC_STRINGS.
Veja a macro PyDoc_STRVAR().
--enable-profiling
Habilita o perfil de có digo a nível C com gprof (desabilitado por padrã o).
--with-strict-overflow
Adiciona -fstrict-overflow aos sinalizadores do compilador C (por padrã o adicionamos
-fno-strict-overflow).

3.3.8 Compilação de depuração do Python

Uma compilaçã o de depuraçã o é Python compilada com a opçã o de configuraçã o --with-pydebug .
Efeitos de uma compilaçã o de depuraçã o:
• Exibe todos os avisos por padrã o: a lista de filtros de aviso padrã o está vazia no mó dulo warnings.
• Adiciona d a sys.abiflags.

3.3. Opções de configuração 31

Python Setup and Usage, Release 3.13.0

• Adiciona a funçã o sys.gettotalrefcount().

• Adiciona a opçã o de linha de comando -X showrefcount.
• Adiciona a opçã o de linha de comando -d e a variá vel de ambiente PYTHONDEBUG para depurar o analisador
sintá tico.
• Adiciona suporte para a variá vel __lltrace__: habilita o rastreamento de baixo nível no laço de avaliaçã o
de bytecode se a variá vel estiver definida.
• Instala ganchos de depuraçã o nos alocadores de memó ria para detectar estouro de buffer e outros erros de
memó ria.
• Define as macros Py_DEBUG e Py_REF_DEBUG.
• Adiciona verificaçõ es de tempo de execuçã o: có digo cercado por #ifdef Py_DEBUG e #endif. Habilita as
asserçõ es assert(...) e _PyObject_ASSERT(...): nã o define a macro NDEBUG (veja també m a confi-
guraçã o --with-assertions opçã o). Principais verificaçõ es de tempo de execuçã o:
– Adiciona verificaçõ es de sanidade nos argumentos da funçã o.
– Objetos Unicode e int sã o criados com sua memó ria preenchida com um padrã o para detectar o uso de
objetos nã o inicializados.
– Garante que as funçõ es que podem limpar ou substituir a exceçã o atual nã o sejam chamadas com uma
exceçã o levantada.
– Verifica se as funçõ es desalocadoras nã o alteram a exceçã o atual.
– O coletor de lixo (funçã o gc.collect()) executa algumas verificaçõ es bá sicas na consistê ncia dos
objetos.
– A macro Py_SAFE_DOWNCAST() verifica o underflow e o overflow de inteiros ao fazer o downcast de
tipos largos para tipos estreitos.
Veja també m o Modo de Desenvolvimento do Python e a opçã o de configuraçã o --with-trace-refs.
Alterado na versã o 3.8: Construçõ es de lançamento e construçõ es de depuraçã o agora sã o compatíveis com ABI:
definir a macro Py_DEBUG nã o implica mais na macro Py_TRACE_REFS (consulte a opçã o --with-trace-refs).

3.3.9 Opções de depuração

--with-pydebug
Construção de depuração do Python: define a macro Py_DEBUG (desabilitada por padrã o).
--with-trace-refs
Habilita referê ncias de rastreamento para fins de depuraçã o (desabilitado por padrã o).
Efeitos:
• Define a macro Py_TRACE_REFS.
• Adiciona a funçã o sys.getobjects().
• Adiciona a variá vel de ambiente PYTHONDUMPREFS.
A variá vel de ambiente PYTHONDUMPREFS pode ser usada para despejar objetos e contagens de referê ncias
ainda ativas na saída do Python.
Objetos alocados estaticamente nã o sã o rastreados.
Adicionado na versã o 3.8.
Alterado na versã o 3.13: Esta construçã o agora é compatibilidade de ABI com a construçã o de lançamento e
construção de depuração.

32 Capítulo 3. Configurar o Python

 Python Setup and Usage, Release 3.13.0

--with-assertions
Constró i com asserçõ es C habilitadas (o padrã o é nã o): assert(...); e _PyObject_ASSERT(...);.
Se definido, a macro NDEBUG nã o é definida na variá vel do compilador OPT .
Veja també m a opçã o --with-pydebug (construção de depuração) que també m habilita asserçõ es.
Adicionado na versã o 3.6.
--with-valgrind
Habilita suporte ao Valgrind (o padrã o é nã o).
--with-dtrace
Habilita suporte ao DTrace (o padrã o é nã o).
Veja Instrumentando o CPython com DTrace e SystemTap.
Adicionado na versã o 3.6.
--with-address-sanitizer
Habilita o detector de erros de memó ria AddressSanitizer, asan (o padrã o é nã o).
Adicionado na versã o 3.6.
--with-memory-sanitizer
Habilita o detector de erros de alocaçã o do MemorySanitizer, msan (o padrã o é nã o).
Adicionado na versã o 3.6.
--with-undefined-behavior-sanitizer
Habilita o detector de comportamento indefinido UndefinedBehaviorSanitizer, ubsan (o padrã o é nã o).
Adicionado na versã o 3.6.
--with-thread-sanitizer
Habilita o detector de corrida de dados ThreadSanitizer, tsan (o padrã o é nã o).
Adicionado na versã o 3.13.

3.3.10 Opções da ligação

--enable-shared
Habilita a construçã o de uma biblioteca Python compartilhada: libpython (o padrã o é nã o).
--without-static-libpython
Nã o constró i libpythonMAJOR.MINOR.a e nã o instala python.o (construído e habilitado por padrã o).
Adicionado na versã o 3.10.

3.3.11 Opções da biblioteca

--with-libs='lib1 ...'
Vincula bibliotecas adicionais (o padrã o é nã o).
--with-system-expat
Constró i o mó dulo pyexpat usando uma biblioteca expat instalada (o padrã o é nã o).
--with-system-libmpdec
Constró i o mó dulo de extensã o _decimal usando uma biblioteca mpdecimal instalada, veja o mó dulo
decimal (o padrã o é sim).
Adicionado na versã o 3.3.
Alterado na versã o 3.13: O padrã o é usar a biblioteca mpdecimal instalada.

3.3. Opções de configuração 33

Python Setup and Usage, Release 3.13.0

Deprecated since version 3.13, will be removed in version 3.15: Uma có pia dos fontes da biblioteca
mpdecimal nã o será mais distribuída com Python 3.15.

µ Ver também
LIBMPDEC_CFLAGS e LIBMPDEC_LIBS.

--with-readline=readline|editline
Designa uma biblioteca backend para o mó dulo readline.
• readline: Usa readline como o backend.
• editline: Usa editline como o backend.
Adicionado na versã o 3.10.
--without-readline
Nã o constró i o mó dulo readline (construído por padrã o).
Nã o define a macro HAVE_LIBREADLINE.
Adicionado na versã o 3.10.
--with-libm=STRING
Substitui a biblioteca matemá tica libm por STRING (o padrã o depende do sistema).
--with-libc=STRING
Substitui a biblioteca C libc por STRING (o padrã o depende do sistema).
--with-openssl=DIR
Raiz do diretó rio OpenSSL.
Adicionado na versã o 3.7.
--with-openssl-rpath=[no|auto|DIR]
Define o diretó rio da biblioteca de tempo de execuçã o (rpath) para bibliotecas OpenSSL:
• no (padrã o): nã o define o rpath;
• auto: detecta automaticamente o rpath de --with-openssl e pkg-config;
• DIR: define um rpath explícito.
Adicionado na versã o 3.10.

3.3.12 Opções de segurança

--with-hash-algorithm=[fnv|siphash13|siphash24]
Seleciona o algoritmo de hash para usar em Python/pyhash.c:
• siphash13 (padrã o);
• siphash24;
• fnv.
Adicionado na versã o 3.4.
Adicionado na versã o 3.11: siphash13 é adicionado e é o novo padrã o.
--with-builtin-hashlib-hashes=md5,sha1,sha256,sha512,sha3,blake2
Mó dulos embutidos de hash
• md5;
• sha1;

34 Capítulo 3. Configurar o Python

 Python Setup and Usage, Release 3.13.0

• sha256;
• sha512;
• sha3 (com shake);
• blake2.
Adicionado na versã o 3.9.
--with-ssl-default-suites=[python|openssl|STRING]
Substitui a string dos conjuntos de criptografia padrã o do OpenSSL:
• python (padrã o): use a seleciona preferida do Python;
• openssl: manté m inalterados os padrõ es do OpenSSL;
• STRING: usa uma string personalizada
Veja o mó dulo ssl.
Adicionado na versã o 3.7.
Alterado na versã o 3.10: As configuraçõ es python e STRING també m definem TLS 1.2 como versã o mínima
do protocolo.

3.3.13 Opções do macOS

Veja Mac/README.rst.
--enable-universalsdk

--enable-universalsdk=SDKDIR
Cria uma construçã o biná ria universal. SDKDIR especifica qual SDK do macOS deve ser usado para executar
a construçã o (o padrã o é nã o).
--enable-framework

--enable-framework=INSTALLDIR
Cria um Python.framework em vez de uma instalaçã o tradicional do Unix. O INSTALLDIR opcional especifica
o caminho de instalaçã o (o padrã o é nã o).
--with-universal-archs=ARCH
Especifica o tipo de biná rio universal que deve ser criado. Esta opçã o só é vá lida quando
--enable-universalsdk está definido.

Opçõ es:
• universal2;
• 32-bit;
• 64-bit;
• 3-way;
• intel;
• intel-32;
• intel-64;
• all.
--with-framework-name=FRAMEWORK
Especifica o nome do framework python no macOS vá lido apenas quando --enable-framework está defi-
nido (padrã o: Python).
--with-app-store-compliance

3.3. Opções de configuração 35

Python Setup and Usage, Release 3.13.0

--with-app-store-compliance=PATCH-FILE
A biblioteca padrã o do Python conté m strings que sã o conhecidas por acionar erros de ferramentas de inspeçã o
automatizadas quando enviadas para distribuiçã o pelas App Stores do macOS e do iOS. Se ativada, esta opçã o
aplicará a lista de patches que corrigem a conformidade da app store. Um arquivo de patch personalizado
també m pode ser especificado. Esta opçã o está desativada por padrã o.
Adicionado na versã o 3.13.

3.3.14 Opções do iOS

Veja iOS/README.rst.
--enable-framework=INSTALLDIR
Cria um Python.framework. Ao contrá rio do macOS, o argumento INSTALLDIR que especifica o caminho de
instalaçã o é obrigató rio.
--with-framework-name=FRAMEWORK
Especifica o nome do framework (padrã o: Python).

3.3.15 Opções de compilação cruzada

A compilaçã o cruzada, també m conhecida como construçã o cruzada, pode ser usada para construir Python para
outra arquitetura ou plataforma de CPU. A compilaçã o cruzada requer um interpretador Python para a plataforma
de construçã o. A versã o do Python para construçã o deve corresponder à versã o do Python da compilaçã o cruzada
do host.
--build=BUILD
configura para construir em BUILD, geralmente adivinhado por config.guess.
--host=HOST
faz compilaçã o cruzada para construir programas para executar no HOST (plataforma de destino)
--with-build-python=path/to/python
caminho para construir o biná rio python para compilaçã o cruzada
Adicionado na versã o 3.11.
CONFIG_SITE=file
Uma variá vel de ambiente que aponta para um arquivo com substituiçõ es de configuraçã o.
Exemplo de arquivo config.site:

# config.site-aarch64
ac_cv_buggy_getaddrinfo=no
ac_cv_file__dev_ptmx=yes
ac_cv_file__dev_ptc=no

HOSTRUNNER
Programa para executar CPython para a plataforma host para compilaçã o cruzada.
Adicionado na versã o 3.11.
Exemplo de compilaçã o cruzada:

CONFIG_SITE=config.site-aarch64 ../configure \
--build=x86_64-pc-linux-gnu \
--host=aarch64-unknown-linux-gnu \
--with-build-python=../x86_64/python

36 Capítulo 3. Configurar o Python

 Python Setup and Usage, Release 3.13.0

3.4 Sistema de Construção Python

3.4.1 Arquivos principais do sistema de construção
• configure.ac => configure;
• Makefile.pre.in => Makefile (criado por configure);
• pyconfig.h (criado por configure);
• Modules/Setup: Extensõ es C construídas pelo Makefile usando o shell script Module/makesetup;

3.4.2 Principais etapas de construção

• Arquivos C (.c) sã o construídos como arquivos objeto (.o).
• Uma biblioteca está tica libpython (.a) é criada a partir de arquivos de objetos.
• python.o e a biblioteca está tica libpython estã o vinculadas ao programa final python.
• Extensõ es C sã o construídas pelo Makefile (veja Modules/Setup).

3.4.3 Alvos principais do Makefile

make
Na maioria das vezes, ao reconstruir apó s editar algum có digo ou atualizar seu checkout do upstream, tudo que você
precisa fazer é executar make, que (pela semâ ntica do Make) constró i o alvo padrã o, o primeiro definido no Makefile.
Por tradiçã o (inclusive no projeto CPython) este é geralmente o alvo all. O script configure expande uma variá vel
autoconf, @DEF_MAKE_ALL_RULE@ para descrever precisamente quais alvos make all serã o construídos. As trê s
opçõ es sã o:
• profile-opt (configurado com --enable-optimizations)
• build_wasm (configurado com --with-emscripten-target)
• build_all (configurado sem usar explicitamente nenhum dos outros)
Dependendo das alteraçõ es mais recentes no arquivo fonte, o Make irá reconstruir quaisquer alvos (arquivos objetos
e executá veis) considerados desatualizados, incluindo executar configure novamente se necessá rio. As dependê n-
cias de origem/alvo sã o muitas e mantidas manualmente, portanto, à s vezes, o Make nã o tem todas as informaçõ es
necessá rias para detectar corretamente todos os alvos que precisam ser reconstruídos. Dependendo de quais des-
tinos nã o sã o reconstruídos, você poderá enfrentar vá rios problemas. Se você tiver problemas de construçã o ou
teste que você nã o pode explicar de outra forma, make clean && make deve resolver a maioria dos problemas de
dependê ncia, à s custas de tempos de construçã o mais longos.

make platform
Constró i o programa python, mas nã o constró i os mó dulos de extensã o da biblioteca padrã o. Isto gera um arquivo
chamado platform que conté m uma ú nica linha descrevendo os detalhes da plataforma de construçã o, por exemplo,
macosx-14.3-arm64-3.12 ou linux-x86_64-3.13.

make profile-opt
Constró i Python usando otimizaçã o guiada por perfil (PGO). Você pode usar a opçã o --enable-optimizations
do configure para tornar este o alvo padrã o do comando make (make all ou apenas make).

make clean
Remove arquivos construídos.

3.4. Sistema de Construção Python 37

Python Setup and Usage, Release 3.13.0

make distclean
Alé m do trabalho feito por make clean, remove os arquivos criados pelo script configure. configure terá que ser
executado antes de construir novamente.1

make install
Constró i o alvo all e instala o Python.

make test
Constró i o alvo all e execute o conjunto de testes Python com a opçã o --fast-ci. Variá veis:
• TESTOPTS: opçõ es adicionais de linha de comando regrtest.
• TESTPYTHONOPTS: opçõ es adicionais de linha de comando do Python.
• TESTTIMEOUT: tempo limite em segundos (padrã o: 10 minutos).

make buildbottest
Isto é semelhante ao make test, mas usa a opçã o --slow-ci e o tempo limite padrã o de 20 minutos, em vez da
opçã o --fast-ci.

make regen-all
Gera novamente (quase) todos os arquivos gerados. Isso inclui (mas nã o está limitado a) casos de bytecode e ar-
quivo gerador de analisador sintá tico. make regen-stdlib-module-names e autoconf devem ser executados
separadamente para os restantes arquivos gerados.

3.4.4 Extensões C
Algumas extensõ es C sã o construídas como mó dulos embutidos, como o mó dulo sys. Eles sã o construídos com a
macro Py_BUILD_CORE_BUILTIN definida. Mó dulos embutidos nã o possuem nenhum atributo __file__:

>>> import sys

>>> sys
<module 'sys' (built-in)>
>>> sys.__file__
Traceback (most recent call last):
File "<stdin>", line 1, in <module>
AttributeError: module 'sys' has no attribute '__file__'

Outras extensõ es C sã o construídas como bibliotecas dinâ micas, como o mó dulo _asyncio. Eles sã o construídos
com a macro Py_BUILD_CORE_MODULE definida. Exemplo no Linux x86-64:

>>> import _asyncio

>>> _asyncio
<module '_asyncio' from '/usr/lib64/python3.9/lib-dynload/_asyncio.cpython-39-x86_
,→64-linux-gnu.so'>

>>> _asyncio.__file__
'/usr/lib64/python3.9/lib-dynload/_asyncio.cpython-39-x86_64-linux-gnu.so'

Modules/Setup é usado para gerar alvos Makefile para construir extensõ es C. No início dos arquivos, as extensõ es
C sã o construídas como mó dulos embutidos. Extensõ es definidas apó s o marcador *shared* sã o construídas como
bibliotecas dinâ micas.
As macros PyAPI_FUNC(), PyAPI_DATA() e PyMODINIT_FUNC de Include/exports.h sã o definidas de forma
diferente dependendo se a macro Py_BUILD_CORE_MODULE está definida:
1 git clean -fdx é uma maneira ainda mais extrema de “limpar” seu checkout. Ele remove todos os arquivos nã o conhecidos pelo Git.

Ao procurar bugs usando git bisect, isso é recomendado entre testes para garantir uma construçã o completamente limpa. Use com cuidado,
pois isso excluirá todos os arquivos nã o registrados no Git, incluindo seu trabalho novo e nã o confirmado.

38 Capítulo 3. Configurar o Python

 Python Setup and Usage, Release 3.13.0

• Usa Py_EXPORTED_SYMBOL se Py_BUILD_CORE_MODULE estiver definido

• Do contrá rio, usa Py_IMPORTED_SYMBOL.
Se a macro Py_BUILD_CORE_BUILTIN for usada por engano em uma extensã o C construída como uma biblioteca
compartilhada, sua funçã o PyInit_xxx() nã o será exportada, causando um ImportError na importaçã o.

3.5 Sinalizadores do compilador e do vinculador

Opçõ es definidas pelo script ./configure e variá veis de ambiente e usadas por Makefile.

3.5.1 Sinalizadores do pré-processador

CONFIGURE_CPPFLAGS
Valor da variá vel CPPFLAGS passado para o script ./configure.
Adicionado na versã o 3.6.
CPPFLAGS
Sinalizadores de pré -processador C++ / (Objective) C, p.ex. -Iinclude_dir se você tiver cabeçalhos em
um diretó rio nã o padrã o include_dir.
Tanto CPPFLAGS quanto LDFLAGS precisam conter o valor do shell para poder construir mó dulos de extensã o
usando os diretó rios especificados nas variá veis de ambiente.
BASECPPFLAGS
Adicionado na versã o 3.4.
PY_CPPFLAGS
Sinalizadores extras de pré -processador adicionados para construir os arquivos de objeto do interpretador.
Padrã o: $(BASECPPFLAGS) -I. -I$(srcdir)/Include $(CONFIGURE_CPPFLAGS)
$(CPPFLAGS).

Adicionado na versã o 3.2.

3.5.2 Sinalizadores do compilador

CC
Comando do compilador C.
Exemplo: gcc -pthread.
CXX
Comando do compilador C++.
Exemplo: g++ -pthread.
CFLAGS
Sinalizadores do compilador C.
CFLAGS_NODIST
CFLAGS_NODIST é usado para construir o interpretador e extensõ es C da stdlib. Use-o quando um sinalizador
do compilador não deve fazer parte de CFLAGS depois que o Python estiver instalado (gh-65320).
Em particular, CFLAGS nã o deve conter:
• o sinalizador do compilador -I (para definir o caminho de pesquisa para arquivos incluídos). Os si-
nalizadores -I sã o processadas da esquerda para a direita, e quaisquer sinalizadores em CFLAGS terã o
precedê ncia sobre os sinalizadores -I fornecidos pelo usuá rio e pelo pacote.
• sinalizadores de segurança como -Werror porque as distribuiçõ es nã o podem controlar se os pacotes
instalados pelos usuá rios estã o em conformidade com esses padrõ es elevados.

3.5. Sinalizadores do compilador e do vinculador 39

Python Setup and Usage, Release 3.13.0

Adicionado na versã o 3.5.

COMPILEALL_OPTS
Opçõ es passadas para a linha de comando compileall ao construir arquivos PYC em make install.
Padrã o: -j0.
Adicionado na versã o 3.12.
EXTRA_CFLAGS
Sinalizadores extra do compilador C.
CONFIGURE_CFLAGS
Valor da variá vel CFLAGS passado para o script ./configure.
Adicionado na versã o 3.2.
CONFIGURE_CFLAGS_NODIST
Valor da variá vel CFLAGS_NODIST passado para o script ./configure.
Adicionado na versã o 3.5.
BASECFLAGS
Sinalizadores base do compilador.
OPT
Sinalizadores de otimizaçã o.
CFLAGS_ALIASING
Sinalizadores de alias estritos ou nã o estritos usados para compilar Python/dtoa.c.
Adicionado na versã o 3.7.
CCSHARED
Sinalizadores de compilador usados para construir uma biblioteca compartilhada.
Por exemplo, -fPIC é usado no Linux e no BSD.
CFLAGSFORSHARED
Sinalizadores extras de C adicionados para construir os arquivos de objeto do interpretador.
Padrã o: $(CCSHARED) quando --enable-shared é usado, ou uma string vazia caso contrá rio.
PY_CFLAGS
Padrã o: $(BASECFLAGS) $(OPT) $(CONFIGURE_CFLAGS) $(CFLAGS) $(EXTRA_CFLAGS).
PY_CFLAGS_NODIST
Padrã o: $(CONFIGURE_CFLAGS_NODIST) $(CFLAGS_NODIST) -I$(srcdir)/Include/internal.
Adicionado na versã o 3.5.
PY_STDMODULE_CFLAGS
Sinalizadores do C usados para construir os arquivos de objeto do interpretador.
Padrã o: $(PY_CFLAGS) $(PY_CFLAGS_NODIST) $(PY_CPPFLAGS) $(CFLAGSFORSHARED).
Adicionado na versã o 3.7.
PY_CORE_CFLAGS
Padrã o: $(PY_STDMODULE_CFLAGS) -DPy_BUILD_CORE.
Adicionado na versã o 3.2.
PY_BUILTIN_MODULE_CFLAGS
Sinalizadores do compilador para construir um mó dulo de extensã o de biblioteca padrã o como um mó dulo
embutido, como o mó dulo posix.
Padrã o: $(PY_STDMODULE_CFLAGS) -DPy_BUILD_CORE_BUILTIN.

40 Capítulo 3. Configurar o Python

 Python Setup and Usage, Release 3.13.0

Adicionado na versã o 3.8.

PURIFY
Comando de Purify. Purify é um programa depurador de memó ria.
Padrã o: string vazia (nã o usada).

3.5.3 Sinalizadores do vinculador

LINKCC
Comando do vinculador usado para construir programas como python e _testembed.
Padrã o: $(PURIFY) $(CC).
CONFIGURE_LDFLAGS
Valor da variá vel LDFLAGS passado para o script ./configure.
Evite atribuir CFLAGS, LDFLAGS, etc. para que os usuá rios possam usá -los na linha de comando para anexar
a esses valores sem pisotear os valores predefinidos.
Adicionado na versã o 3.2.
LDFLAGS_NODIST
LDFLAGS_NODIST é usado da mesma maneira que CFLAGS_NODIST . Use-o quando um sinalizador de vin-
culador não fizer parte de LDFLAGS depois que o Python estiver instalado (gh-65320).
Em particular, LDFLAGS nã o deve conter:
• o sinalizador do compilador -L (para definir o caminho de pesquisa para arquivos incluídos). Os sina-
lizadores -L sã o processadas da esquerda para a direita, e quaisquer sinalizadores em LDFLAGS terã o
precedê ncia sobre os sinalizadores -L fornecidos pelo usuá rio e pelo pacote.
CONFIGURE_LDFLAGS_NODIST
Valor da variá vel LDFLAGS_NODIST passado para o script ./configure.
Adicionado na versã o 3.8.
LDFLAGS
Sinalizadores do vinculador, p.ex. -Llib_dir, se você tiver bibliotecas em um diretó rio nã o padrã o lib_dir.
Tanto CPPFLAGS quanto LDFLAGS precisam conter o valor do shell para poder construir mó dulos de extensã o
usando os diretó rios especificados nas variá veis de ambiente.
LIBS
Sinalizadores do vinculador para passar bibliotecas para o vinculador ao vincular o executá vel Python.
Exemplo: -lrt.
LDSHARED
Comando para construir uma biblioteca compartilhada.
Padrã o: @LDSHARED@ $(PY_LDFLAGS).
BLDSHARED
Comando para construir a biblioteca compartilhada libpython.
Padrã o: @BLDSHARED@ $(PY_CORE_LDFLAGS).
PY_LDFLAGS
Padrã o: $(CONFIGURE_LDFLAGS) $(LDFLAGS).
PY_LDFLAGS_NODIST
Padrã o: $(CONFIGURE_LDFLAGS_NODIST) $(LDFLAGS_NODIST).
Adicionado na versã o 3.8.

3.5. Sinalizadores do compilador e do vinculador 41

Python Setup and Usage, Release 3.13.0

PY_CORE_LDFLAGS
Sinalizadores de vinculador usados para construir os arquivos de objeto do interpretador.
Adicionado na versã o 3.8.

42 Capítulo 3. Configurar o Python

 CAPÍTULO 4

Utilizando Python no Windows

Este documento pretende dar uma visã o geral do comportamento específico do Windows que você deve conhecer
quando fores utilizar o Python no sistema operacional Microsoft Windows.
Diferente da maioria dos sistemas e serviços Unix, o Windows nã o inclui uma instalaçã o suportada do Python. Para
deixar o Python disponível, o time CPython compilou os instaladores do Windows com cada versã o por vá rios anos.
Esses instaladores tê m a intençã o primá ria de adicionar uma instalaçã o de Python por usuá rio, com o interpretador
e as bibliotecas nú cleo sendo utilizadas por um ú nico usuá rio. O instalador també m é capaz de instalar para todos os
usuá rios de uma ú nica má quina, e um arquivo ZIP separado está disponível para distribuiçõ es locais de aplicaçã o.
Como especificado na PEP 11, uma versã o Python suporta apenas uma plataforma Windows enquanto a Microsoft
considera a plataforma sob suporte estendido. Isso significa que o Python 3.13 suporta Windows 8.1 ou superiores.
Se você requer suporte à Windows 7, por favor instale o Python 3.8.
Há uma quantidade de instaladores diferentes disponíveis para Windows, cada um com algumas vantagens e desvan-
tagens.
O instalador completo conté m todos os componentes e é a melhor opçã o para desenvolvedores usando Python para
qualquer tipo de projeto.
O pacote Microsoft Store é uma instalaçã o simples do Python que é adequada para executar scripts e pacotes, e para
usar a IDLE ou outros ambientes de desenvolvimento. Ela requer Windows 10 e superior, mas pode ser instalada de
forma segura sem corromper outros programas. Ela també m fornece vá rios comandos convenientes para iniciar o
Python e suas ferramentas.
Os pacotes nuget.org sã o instalaçõ es leves criadas para integraçã o contínua de sistemas. Elas podem ser usadas para
construir pacotes Python ou executar scripts, mas nã o sã o atualizá veis e nã o possuem ferramentas de interface de
usuá rio.
O pacote embutível é um pacote mínimo de Python adequado para ser incorporado em uma aplicaçã o maior.

4.1 O instalador completo

4.1.1 Etapas de instalação
Quatro instaladores Python 3.13 estã o disponíveis para download - dois de cada para as versõ es 32-bit e 64-bit do
interpretador. O instalador web é um download inicial menor, e ele irá automaticamente fazer o download dos
componentes solicitados na medida do necessá rio. O instalador offline inclui os componentes necessá rios para uma
instalaçã o padrã o e requer apenas uma conexã o de internet para recursos opcionais. Veja Instalando Sem Download
para outras formas de evitar o download durante a instalaçã o.

43
Python Setup and Usage, Release 3.13.0

Apó s iniciar o instalador, uma de duas opçõ es deve ser selecionada:

Se você selecionar “Install Now”:

• Você não precisará ser um administrador (a menos que uma atualizaçã o de sistema para a Biblioteca em Tempo
de Execuçã o C seja necessá ria ou que você instale o Inicializador Python para Windows para todos os usuá rios)
• Python será instalado dentro do seu diretó rio de usuá rio
• O Inicializador Python para Windows será instalado de acordo com a opçã o ao final da primeira pá gina
• A biblioteca padrã o, a suíte de testes, o inicializador e o pip serã o instalados
• Se selecionado, o diretó rio de instalaçã o será adicionado no seu PATH
• Atalhos serã o visíveis apenas para o usuá rio atual
Selecionando “Customize installation” irá permitir que você selecione os recursos a serem instalados, o local da
instalaçã o e outras opçõ es ou açõ es pó s-instalaçã o. Para instalar símbolos de depuraçã o ou biná rios, você precisará
usar essa opçã o.
Para realizar uma instalaçã o para todos os usuá rios, você deve selecionar “Customize installation”. Neste caso:
• Você pode ser solicitado a providenciar credenciais administrativas ou aprovaçã o
• Python será instalado dentro do diretó rio Program Files (Arquivos de Programa)
• O Inicializador Python para Windows será instalado dentro do diretó rio Windows
• Recursos opcionais podem ser selecionados durante a instalaçã o
• A biblioteca padrã o pode ser pré -compilada em bytecode
• Se selecionado, o diretó rio de instalaçã o será adicionado ao PATH do sistema
• Atalhos estã o disponíveis para todos os usuá rios

44 Capítulo 4. Utilizando Python no Windows

 Python Setup and Usage, Release 3.13.0

4.1.2 Removendo a Limitação do MAX_PATH

O Windows historicamente tem limitado os comprimentos dos caminhos de arquivos em 260 caracteres. Isso signi-
ficava que caminhos maiores que isso nã o seriam resolvidos e resultariam em erros.
Nas ú ltimas versõ es do Windows, essa limitaçã o pode ser expandida para aproximadamente 32.000 caracteres. Seu
administrador irá precisar ativar a política de grupo “Enable Win32 long paths”, ou definir LongPathsEnabled
para 1 na chave de registro HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem.
Isso permite que a funçã o open(), o mó dulo os e a maior parte das outras funcionalidades de caminho aceitem e
retornem caminhos maiores que 260 caracteres quando usando strings.
Apó s alterar a opçã o acima, nenhuma configuraçã o adicional é necessá ria.
Alterado na versã o 3.6: Suporte para caminhos longos foi ativado no Python.

4.1.3 Instalando sem UI

Todas as opçõ es disponíveis na IU do instalador també m podem ser especificadas a partir da linha de comando,
permitindo que instaladores por script repliquem uma instalaçã o em vá rias má quinas sem interaçã o do usuá rio. Essas
opçõ es també m podem ser definidas sem suprimir a IU para alterar alguns dos padrõ es.
As seguintes opçõ es (encontradas executando o instalador com /?) podem ser passadas para o instalador:

Nome Descrição
/passive para exibir o progresso sem exigir interaçã o do usuá rio
/quiet para instalar/desinstalar sem exibir nenhuma UI
/simple para evitar a personalizaçã o do usuá rio
/uninstall para remover o Python (sem exigir confirmaçã o)
/layout [diretó rio] para pré -baixar todos os componentes
/log [nome-de-arquivo] para especificar a localizaçã o dos arquivos de log

Todas as outras opçõ es sã o passadas como name=value, onde o valor é usualmente 0 para desabilitar o recurso, 1
para ativar o recurso, ou um caminho. A lista completa de opçõ es disponíveis é mostrada abaixo.

4.1. O instalador completo 45

Python Setup and Usage, Release 3.13.0

Nome Descrição Default (padrão)

InstallAllUsers (Insta- Execute uma instalaçã o em 0
lar para Todos usuá - todo o sistema.
rios)
TargetDir (Diretó rio O diretó rio de instalaçã o Selecionado com base em “Instalar para Todos os
Alvo) Usuá rios”
DefaultAllUsersTar- O diretó rio de instalaçã o pa- %ProgramFiles%\Python X.Y or
getDir (Diretó rio de drã o para instalaçõ es de todos %ProgramFiles(x86)%\Python X.Y
Destino Padrã o para os usuá rios
Todos os usuá rios)
DefaultJustForMeTar- O diretó rio de instalaçã o pa- %LocalAppData%\Programs\Python\
getDir (Diretó rio Alvo drã o para instalaçõ es just-for- PythonXY ou %LocalAppData%\Programs\
Padrã o Apenas Para -me Python\PythonXY-32 ou %LocalAppData%\
Mim) Programs\Python\PythonXY-64
DefaultCustomTar- Diretó rio de instalaçã o perso- (vazio)
getDir (Diretó rio de nalizado padrã o exibido na in-
destino personalizado terface do usuá rio
padrã o)
AssociateFiles (Arqui- Criar associaçõ es de arquivos 1
vos Associados) se o launcher també m estiver
instalado.
CompileAll (Compilar Compile todos os arquivos .py 0
Tudo) para .pyc.
PrependPath (path a ser Anexa os diretó rios de instala- 0
percorrido) çã o e Scripts ao início de PATH
e adiciona .PY a PATHEXT
AppendPath Anexa os diretó rios de instala- 0
çã o e Scripts ao final de PATH e
adiciona .PY a PATHEXT
Shortcuts (atalhos) Crie atalhos para o interpreta- 1
dor, documentaçã o e IDLE se
instalado.
Include_doc Install Python manual (Instala- 1
çã o Manual do Python)
Include_debug (Incluir Instalar biná rios de Depuraçã o 0
o Modo de Depuraçã o)
Include_dev Instala cabeçalhos e bibliote- 1
cas do desenvolvedor. Omitir
isso pode levar a uma instala-
çã o inutilizá vel.
Include_exe Instala python.exe e arqui- 1
vos relacionados. Omitir isso
pode levar a uma instalaçã o
inutilizá vel.
Include_launcher Instalar Inicializador Python 1
para Windows.
InstallLauncherAllU- Instala o iniciador para todos 1
sers os usuá rios. També m requer
Include_launcher para ser
definido como 1
Include_lib Instala a biblioteca padrã o e os 1
mó dulos de extensã o. Omitir
isso pode levar a uma instala-
çã o inutilizá vel.
Include_pip Instale o pacote pip e setuptools 1
Include_symbols Instala símbolos de depuraçã o 0
(*.pdb)
Include_tcltk Instale o suporte Tcl/Tk e o 1
IDLE
46
Include_test Instalar o conjunto de testes da 1 Capítulo 4. Utilizando Python no Windows
biblioteca padrã o
Include_tools Instalar scripts com utilitá rios 1
LauncherOnly Instala apenas o launcher. Isso 0
 Python Setup and Usage, Release 3.13.0

Por exemplo, para instalar silenciosamente uma instalaçã o de Python padrã o e em todo o sistema, você pode usar o
seguinte comando (a partir de um terminal de comando autorizado):

python-3.9.0.exe /quiet InstallAllUsers=1 PrependPath=1 Include_test=0

Para permitir que usuá rios instalem facilmente uma có pia do Python sem a suíte de testes, você pode fornecer um
atalho com o seguinte comando. Isso irá exibir uma pá gina inicial simplificado e bloquear a personalizaçã o:

python-3.9.0.exe InstallAllUsers=0 Include_launcher=0 Include_test=0

SimpleInstall=1 SimpleInstallDescription="Just for me, no test suite."

(Observe que omitir o inicializador també m omite associaçõ es de arquivos, e só é recomendado para instalaçõ es por
usuá rios quando també m existe uma instalaçã o por todo o sistema que inclui o inicializador.)
As opçõ es listadas acima també m podem ser fornecidas em um arquivo chamado unattend.xml juntamente com
o executá vel. Esse arquivo especifica uma lista de opçõ es e valores. Quando um valor é fornecido como um atributo,
ele será convertido para um nú mero se possível. Valores fornecidos como elementos de texto sã o sempre deixados
como strings. Esse arquivo de exemplo define as mesmas opçõ es que o exemplo anterior:

<Options>
<Option Name="InstallAllUsers" Value="no" />
<Option Name="Include_launcher" Value="0" />
<Option Name="Include_test" Value="no" />
<Option Name="SimpleInstall" Value="yes" />
<Option Name="SimpleInstallDescription">Just for me, no test suite</Option>
</Options>

4.1.4 Instalando Sem Download

Como alguns recursos do Python nã o estã o inclusos no download inicial do instalador, selecionar esses recursos
pode exigir uma conexã o com a internet. Para evitar isso, todos os possíveis componentes podem ser baixados sob
demanda para criar um layout completo que nã o irá precisar de uma conexã o de internet independentemente dos
recursos selecionados. Note que este download pode ser maior que o necessá rio, mas onde um grande nú mero de
instalaçõ es serã o realizadas é bem ú til ter uma có pia em cache local.
Execute o seguinte comando a partir do Prompt de Comando para fazer o download de todos os possíveis arquivos
necessá rios. Lembre-se de substituir python-3.9.0.exe pelo nome real do seu instalador, e de criar layouts nos
respectivos diretó rios para evitar colisã o entre arquivos com o mesmo nome.

python-3.9.0.exe /layout [diretório alvo opcional]

Você també m pode especificar a opçã o /quiet para esconder o acompanhamento de progresso.

4.1.5 Modificando uma instalação

Uma vez que o Python foi instalado, você pode adicionar ou remover recursos atravé s da ferramenta Programas e
Recursos que é parte do Windows. Selecione o registro do Python e escolha “Uninstall/Change” para abrir o instalador
no modo de manutençã o.
“Modify” permite que você adicione ou remova recursos modificando as caixas de entrada - caixas de entrada nã o
modificadas nã o irã o instalar ou remover nada. Algumas opçõ es nã o podem ser modificadas dessa forma, como o
diretó rio de instalaçã o; para modificá -las, você precisará remover e entã o reinstalar o Python completamente.
“Repair” irá verificar todos os arquivos que devem ser instalados usando as configuraçõ es atuais e substituir qualquer
um que tiver sido removido ou modificado.
“Uninstall” irá remover o Python completamente, com a exceçã o do Inicializador Python para Windows, que tem seu
pró prio registro nos Programas e Recursos.

4.1. O instalador completo 47

Python Setup and Usage, Release 3.13.0

4.1.6 Instalando binários com threads livres

Adicionado na versã o 3.13: (Experimental)

® Nota

Tudo descrito nesta seçã o é considerado experimental e espera-se que mude em versõ es futuras.

Para instalar biná rios pré -construídos com recurso de threads livres habilitado (veja PEP 703), você deve selecionar
“Customize installation” (Instalaçã o personalizada). A segunda pá gina de opçõ es inclui a caixa de seleçã o “Download
free-threaded binaries” (Baixar biná rios de threads livres).

Selecionar esta opçã o fará o download e instalará biná rios adicionais no mesmo local da instalaçã o principal do
Python. O executá vel principal é chamado python3.13t.exe, e outros biná rios recebem um sufixo t ou um sufixo
ABI completo. Arquivos de origem do Python e dependê ncias de terceiros empacotadas sã o compartilhadas com a
instalaçã o principal.
A versã o com threads livres é registrada como uma instalaçã o regular do Python com a tag 3.13t (com um sufixo -32
ou -arm64 como normal para essas plataformas). Isso permite que as ferramentas o descubram e que o Inicializador
Python para Windows ofereça suporte a py.exe -3.13t. Observe que o inicializador interpretará py.exe -3
(ou um shebang python3) como “a instalaçã o 3.x mais recente”, que preferirá os biná rios com threads livres aos
normais, enquanto py.exe -3.13 nã o. Se você usar o estilo curto da opçã o, talvez prefira nã o instalar os biná rios
com threads livres neste momento.
Para especificar a opçã o de instalaçã o na linha de comando, use Include_freethreaded=1. Veja Instalando
Sem Download para instruçõ es sobre como baixar preventivamente os biná rios adicionais para instalaçã o offline. As
opçõ es para incluir símbolos de depuraçã o e biná rios també m se aplicam à s construçõ es com threads livres.
Biná rios com threads livres també m estã o disponíveis em nuget.org.

48 Capítulo 4. Utilizando Python no Windows

 Python Setup and Usage, Release 3.13.0

4.2 O pacote Microsoft Store

Adicionado na versã o 3.7.2.
O pacote Microsoft Store é um interpretador Python facilmente instalá vel criado principalmente para uso interativo,
por exemplo, por estudantes.
Para instalar o pacote, certifique-se de que você possui as ú ltimas 10 atualizaçõ es do Windows e procure o app
“Python 3.13” na Microsoft Store. Certifique-se que o app que você selecionou foi publicado pela Python Software
Foundation, e instale-o.

Á Aviso

Python sempre estará disponível gratuitamente na Microsoft Store. Se você for solicitado a pagar por ele, você
nã o selecionou o pacote correto.

Apó s a instalaçã o, o Python pode ser inicializado por pesquisa no menu Iniciar. Alternativamente, ele estará dispo-
nível a partir de qualquer Prompt de Comando ou sessã o PowerShell apenas digitando python. Alé m disso, o pip e
a IDLE podem ser usados digitando pip ou idle. A IDLE també m pode ser encontrada no menu Iniciar.
Todos os trê s comandos també m estã o disponíveis com sufixos do nú mero da versã o, por exemplo, como em
python3.exe e python3.x.exe bem como python.exe (onde 3.x é a versã o específica que você quer ini-
ciar, como a 3.13). Abra o “Gerenciar aliases de execuçã o de aplicativo” atravé s do menu Iniciar para selecionar
qual versã o do Python está associada com cada comando. É recomendado que você se certifique que pip e idle
sã o consistentes com qualquer versã o do python que seja selecionada.
Ambientes virtuais podem ser criados com python -m venv e ativados e usados normalmente.
Se você instalou outra versã o do Python e adicionou ela à sua variá vel PATH, ela estará disponível com python.exe
ao invé s de uma instalada pela Microsoft Store. Para acessar a nova instalaçã o, use python3.exe ou python3.x.
exe.

O instalador py.exe irá detectar essa instalaçã o do Python, mas irá preferir instalaçõ es feitas pelo instalador tradi-
cional.
Para remover o Python, abra as Configuraçõ es e use Aplicativos e Recursos, ou encontre o Python no menu Iniciar
e clique com o botã o direito para selecionar Desinstalar. A desinstalaçã o irá remover todos os pacotes que você
instalou diretamente dentro dessa instalaçã o do Python, mas nã o irá remover nenhum ambiente virtual.

4.2.1 Problemas conhecidos

Redirecionamento de dados locais, registro e caminhos temporários
Por causa de restriçõ es nos aplicativos da Microsoft Store, scripts Python podem nã o ter acesso de escrita completo
em locais compartilhados como TEMP ou o registro. Ao invé s disso, ele irá escrever uma có pia privada. Se seus
scripts precisam modificar locais compartilhados, você terá que instalar o instalador completo.
No tempo de execuçã o, o Python usará uma có pia privada de pastas conhecidas do Windows e do re-
gistro. Por exemplo, se a variá vel de ambiente %APPDATA% for c:\Users\<user>\AppData\, ao gra-
var em C:\Users\<user>\AppData\Local gravará em C:\Users\<user>\AppData\Local\Packages\
PythonSoftwareFoundation.Python.3.8_qbz5n2kfra8p0\LocalCache\Local\

Ao ler arquivos, o Windows retornará o arquivo da pasta privada ou, se nã o existir, o diretó rio real do Windows.
Por exemplo, ler C:\Windows\System32 retorna o conteú do de C:\Windows\System32 mais o conteú do de
C:\Program Files\WindowsApps \nome_pacote\VFS\SystemX86.
Você pode encontrar o caminho real de qualquer arquivo existente usando os.path.realpath():

>>> import os
>>> test_file = 'C:\\Users\\exemplo\\AppData\\Local\\test.txt'
>>> os.path.realpath(test_file)
(continua na pró xima pá gina)

4.2. O pacote Microsoft Store 49

Python Setup and Usage, Release 3.13.0

(continuaçã o da pá gina anterior)

'C:\\Users\\exemplo\\AppData\\Local\\Packages\\PythonSoftwareFoundation.Python.3.8_
,→qbz5n2kfra8p0\\LocalCache\\Local\\test.txt'

Ao gravar no Registro do Windows, existem os seguintes comportamentos:

• A leitura de HKLM\\Software é permitida e os resultados sã o mesclados com o arquivo registry.dat no
pacote.
• Gravar em HKLM\\Software nã o é permitido se a chave/valor correspondente existir, ou seja, modificar
chaves existentes.
• Gravar em HKLM\\Software é permitido desde que uma chave/valor correspondente nã o exista no pacote e
o usuá rio tenha as permissõ es de acesso corretas.
Para obter mais detalhes sobre a base té cnica dessas limitaçõ es, consulte a documentaçã o da Micro-
soft sobre aplicativos de confiança total empacotados, atualmente disponíveis em docs.microsoft.com/pt-
-br/windows/msix/desktop/desktop-to-uwp-behind-the-scenes

4.3 Os pacotes nuget.org

Adicionado na versã o 3.5.2.
O pacote nuget.org é um ambiente Python de tamanho reduzido criado para uso em integraçã o contínua e construçã o
de sistemas que nã o precisam de uma instalaçã o de Python por todo o sistema da má quina. Enquanto nuget é o
“gerenciador de pacotes para .NET”, ele també m funciona perfeitamente bem para pacotes contendo ferramentas em
tempo de construçã o.
Visite nuget.org para informaçõ es mais atualizadas sobre utilizaçã o do nuget. A seguir está um sumá rio que é sufi-
ciente para desenvolvedores Python.
A ferramenta de linha de comando nuget.exe pode ser baixada diretamente de https://aka.ms/nugetclidl,
por exemplo, usando o curl ou PowerShell. Com a ferramenta, a versã o mais recente do Python para má quinas 64-bit
ou 32-bit é instalada usando:

nuget.exe install python -ExcludeVersion -OutputDirectory .

nuget.exe install pythonx86 -ExcludeVersion -OutputDirectory .

Para selecionar uma versã o específica, adicione -Version 3.x.y. O diretó rio de saída pode ser mudado de ., e
o pacote será instalado em um subdiretó rio. Por padrã o, o subdiretó rio é nomeado igual ao pacote, e sem a opçã o
-ExcludeVersion esse nome irá incluir a versã o específica instalada. Dentro do subdiretó rio está um diretó rio
tools que conté m a instalaçã o do Python:

# Sem -ExcludeVersion
> .\python.3.5.2\tools\python.exe -V
Python 3.5.2

# Com -ExcludeVersion
> .\python\tools\python.exe -V
Python 3.5.2

Em geral, pacotes nuget nã o sã o atualizá veis, e novas versõ es devem ser instaladas lado-a-lado e referenciadas usando
o caminho completo. Alternativamente, delete o diretó rio do pacote manualmente e instale novamente. Muitos
sistemas CI irã o fazer isso automaticamente se eles nã o preservam arquivos entre construçõ es de projetos.
Juntamente com o diretó rio tools está o diretó rio build\native. Ele conté m um arquivo de propriedades MS-
Build python.props que pode ser usado em um projeto C++ para referenciar a instalaçã o do Python. Incluir as
configuraçõ es irá automaticamente usar os cabeçalhos e importar as bibliotecas na sua construçã o de projeto.
As pá ginas de informaçã o dos pacotes em nuget.org sã o www.nuget.org/packages/python para a versã o 64 bits,
www.nuget.org/packages/pythonx86 para a versã o 32 bits e www.nuget.org/packages/pythonarm64 para a versã o
ARM64

50 Capítulo 4. Utilizando Python no Windows

 Python Setup and Usage, Release 3.13.0

4.3.1 Pacotes com threads livres

Adicionado na versã o 3.13: (Experimental)

® Nota

Tudo descrito nesta seçã o é considerado experimental e espera-se que mude em versõ es futuras.

Pacotes contendo biná rios com threads livres sã o chamados python-freethreaded para a versã o de 64 bits, pythonx86-
-freethreaded para a versã o de 32 bits e pythonarm64-freethreaded para a versã o ARM64. Esses dois pacotes contê m
os pontos de entrada python3.13t.exe e python.exe, os quais sã o executados com threads livres.

4.4 O pacote embutível

Adicionado na versã o 3.5.
A distribuiçã o embutida é um arquivo ZIP contendo um ambiente Python mínimo. Ela foi criada para atuar como
parte de outra aplicaçã o, ao invé s de ser diretamente acessada por usuá rios finais.
Quando extraída, a distribuiçã o embutida é (quase) completamente isolada do sistema do usuá rio, incluindo va-
riá veis de ambiente, configuraçõ es de registro de sistema, e pacotes instalados. A biblioteca padrã o está inclusa
como arquivos .pyc pré -compilados e otimizados em um ZIP, e python3.dll, python37.dll, python.exe e
pythonw.exe estã o todos disponíveis. Tcl/tk (incluindo todas as dependê ncias, como a Idle), pip e a documentaçã o
do Python nã o estã o inclusos.

® Nota

A distribuiçã o embutida nã o inclui o Microsoft C Runtime e é de responsabilidade do instalador da aplicaçã o

providenciar isso. O aplicativo de tempo de execuçã o pode já ter sido instalado no sistema de um usuá rio pre-
viamente ou automaticamente via Windows Update, e pode ser detectado procurando por ucrtbase.dll no
diretó rio do sistema.

Pacotes de terceiros devem ser instalados pelo instalador da aplicaçã o juntamente com a distribuiçã o embutida. Usar
o pip para gerenciar as dependê ncias como em uma instalaçã o regular do Python nã o é suportado nessa distribuiçã o,
apesar de que com algum cuidado pode ser possível incluir e usar o pip para atualizaçõ es automá ticas. Em geral,
pacotes de terceiros devem ser tratados como parte da aplicaçã o (“vendoring”) para que o desenvolvedor consiga
garantir compatibilidade com versõ es mais recentes antes de fornecer atualizaçõ es para os usuá rios.
Os dois casos de uso recomendados para essa distribuiçã o sã o descritos abaixo.

4.4.1 Aplicação Python

Uma aplicaçã o escrita em Python nã o requer necessariamente que os usuá rios estejam cientes deste fato. A dis-
tribuiçã o embutida pode ser usada neste caso para incluir uma versã o privada do pacote de instalaçã o do Python.
Dependendo de quã o transparente deve ser (ou pelo contrá rio, quã o profissional deve parecer), existem duas opçõ es.
Usar um executá vel especializado como inicializador requer um pouco de có digo, mas fornece a experiê ncia mais
transparente para os usuá rios. Com um inicializador personalizado, nã o existem indicaçõ es ó bvias que o programa
está rodando em Python: ícones podem ser personalizados, informaçõ es da empresa e versã o podem ser especificadas,
e associaçõ es de arquivo se comportam de forma apropriada. Na maioria dos casos, um inicializador personalizado
deve simplesmente ser capaz de chamar Py_Main com uma linha de comando predefinida (hard-coded).
A abordagem mais simples é fornecer um arquivo batch ou um atalho gerado que chama diretamente o python.exe
ou pythonw.exe com os argumentos de linha de comando necessá rios. Neste caso, a aplicaçã o irá aparecer como
Python e nã o seu nome real, e os usuá rios podem ter problemas em distinguir ela de outros processos ou associaçõ es
de arquivo em Python.
Com a abordagem anterior, pacotes devem ser instalados como diretó rios juntamente do executá vel do Python para
garantir que estarã o disponíveis no caminho do ambiente. Com o instalador especializado, pacotes podem ser ar-

4.4. O pacote embutível 51

Python Setup and Usage, Release 3.13.0

mazenados em outras localidades já que há uma oportunidade de especificar o caminho de busca antes de executar
a aplicaçã o.

4.4.2 Incorporando Python

Aplicaçõ es escritas em có digo nativo frequentemente precisam de alguma forma de linguagem de script, e a distri-
buiçã o embutida do Python pode ser usada para esse propó sito. Em geral, a maior parte da aplicaçã o é em có digo
nativo, e uma parte irá ou invocar python.exe ou usar diretamente python3.dll. Para ambos os casos, extrair a
distribuiçã o embutida em um subdiretó rio da instalaçã o da aplicaçã o é suficiente para providenciar um interpretador
Python carregá vel.
Para uso da aplicaçã o, pacotes podem ser instalados em qualquer local já que há uma oportunidade de especificar
caminhos de busca antes de inicializar o interpretador. De outra forma, nã o existem diferenças fundamentais entre
usar a distribuiçã o embutida ou a instalaçã o regular.

4.5 Pacotes Alternativos

À parte da distribuiçã o padrã o CPython, existem pacotes modificados incluindo funcionalidades adicionais. A seguir
está uma lista de versõ es populares e seus recursos chave:
ActivePython
Instalador com compatibilidade multi-plataforma, documentaçã o, PyWin32
Anaconda
Mó dulos científicos populares (como o numpy, scipy e pandas) e o gerenciador de pacotes conda.
Enthought Deployment Manager
“A pró xima geraçã o de ambiente Python e gerenciador de pacotes”.
Anteriormente, a Enthought fornecia Canopy, mas este chegou ao fim de vida em 2016.
WinPython
Distribuiçã o específica do Windows com pacotes científicos pré -construídos e ferramentas para construir pa-
cotes.
Note que esses pacotes podem nã o incluir as ú ltimas versõ es do Python ou outras bibliotecas, e nã o sã o mantidos ou
suportados pelo time do nú cleo do Python.

4.6 Configurando o Python

Para executar o Python convenientemente de um prompt de comando, você pode considerar mudar algumas variá veis
de ambiente padrã o do Windows. Ainda que o instalador forneça uma opçã o para configurar as variá veis PATH e
PATHEXT para você , isso só é confiá vel para uma instalaçã o ú nica e global no sistema. Se você usa regularmente
mú ltiplas versõ es do Python, considere usar o Inicializador Python para Windows.

4.6.1 Excursus: Configurando variáveis de ambiente

O Windows permite que variá veis de ambiente sejam configuradas de forma permanente em ambos os níveis de
Usuá rio e de Sistema, ou temporariamente em um prompt de comando.
Para definir as variá veis de ambiente temporariamente, abra um Prompt de Comando e use o comando set:

C:\>set PATH=C:\Program Files\Python 3.9;%PATH%

C:\>set PYTHONPATH=%PYTHONPATH%;C:\My_python_lib
C:\>python

Essas mudanças serã o aplicadas em quaisquer comandos posteriores que forem executados neste console, e serã o
herdadas por quaisquer aplicaçõ es iniciadas pelo console.

52 Capítulo 4. Utilizando Python no Windows

 Python Setup and Usage, Release 3.13.0

Incluir o nome da variá vel com sinais de porcentagem irá expandir o valor existente, permitindo que você adicione
seu novo valor ao início ou final. Modificar o PATH adicionando o diretó rio contendo python.exe ao início é o
modo mais comum de garantir que a versã o correta do Python seja iniciada.
Para modificar permanentemente as variá veis de ambiente padrã o, clique em Iniciar e procure por ‘Editar as variá veis
de ambiente do sistema‘, ou abra as propriedades do Sistema, Configurações avançadas do sistema e clique no botã o
Variáveis de Ambiente. Neste diá logo, você pode adicionar ou modificar as variá veis de Usuá rio ou Sistema. Para
mudar as variá veis do Sistema, você precisa de acesso nã o-restrito à sua má quina (isto é , direitos de Administrador).

® Nota

O Windows irá concatenar as variá veis de Usuá rio após as variá veis de Sistema, o que pode causar resultados
inesperados quando modificando o PATH.
A variá vel PYTHONPATH é usada por todas as versõ es do Python, portanto, você nã o deve configurá -la permanen-
temente, a menos que os caminhos listados incluam apenas có digo compatível com todas as versõ es instaladas
do Python.

µ Ver também

https://docs.microsoft.com/en-us/windows/win32/procthread/environment-variables
Visã o geral das variá veis de ambiente no Windows
https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/set_1
O comando set, para modificar temporariamente as variá veis de ambiente
https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/setx
O comando setx, para modificar permanentemente as variá veis de ambiente

4.6.2 Encontrando o executável do Python

Alterado na versã o 3.5.
Alé m de usar o registro do menu Iniciar criado automaticamente para o interpretador do Python, você pode querer
iniciar o Python no prompt de comando. O instalador possui uma opçã o para configurar isso pra você .
Na primeira pá gina do instalador, uma opçã o chamada “Add Python to PATH” pode ser selecionada para que o
instalador adicione o local de instalaçã o na sua variá vel PATH. O local da pasta de Scripts\ també m é adicionado.
Isso permite que você digite python para executar o interpretador, e pip para o instalador de pacotes. Alé m disso,
você pode també m executar seus scripts com as opçõ es de linha de comando, veja a documentaçã o Linha de comando.
Se você nã o habilitar essa opçã o no momento de instalaçã o, você sempre pode re-executar o instalador, selecionar
Modify, e habilitá -la. Alternativamente, você pode modificar manualmente a variá vel PATH usando os direciona-
mentos em Excursus: Configurando variáveis de ambiente. Você precisa definir sua variá vel de ambiente PATH para
incluir o diretó rio da sua instalaçã o Python, delimitado por um ponto e vírgula de outras entradas. Uma variá vel
exemplo pode parecer com isso (presumindo que as duas primeiras entradas já existem):

C:\WINDOWS\system32;C:\WINDOWS;C:\Program Files\Python 3.9

4.7 Modo UTF-8

Adicionado na versã o 3.7.
O Windows ainda usa codificaçõ es legadas para a codificaçã o do sistema (a Pá gina de Có digo ANSI). O Python usa-o
para a codificaçã o padrã o de arquivos de texto (por exemplo, locale.getencoding()).
Isso pode causar problemas, porque o UTF-8 é amplamente usado na Internet e na maioria dos sistemas Unix,
incluindo o WSL (Subsistema Windows para Linux).

4.7. Modo UTF-8 53

Python Setup and Usage, Release 3.13.0

Você pode usar o Modo UTF-8 do Python para alterar a codificaçã o de texto padrã o para UTF-8. Você pode habilitar
Modo UTF-8 do Python atravé s da opçã o de linha de comando -X utf8 ou da variá vel de ambiente PYTHONUTF8=1.
Veja PYTHONUTF8 para habilitar o modo UTF-8, e Excursus: Configurando variáveis de ambiente para saber como
modificar variá veis de ambiente.
Quando o Modo UTF-8 do Python está habilitado, você ainda pode usar a codificaçã o do sistema (a pá gina de có digo
ANSI) atravé s do codec “mbcs”.
Observe que adicionar PYTHONUTF8=1 à s variá veis de ambiente padrã o afetará todas as aplicaçõ es Python 3.7+ em
seu sistema. Se você tiver aplicaçõ es Python 3.7+ que dependem da codificaçã o do sistema legado, é recomendá vel
definir a variá vel de ambiente temporariamente ou usar a opçã o de linha de comando -X utf8.

® Nota

Mesmo quando o modo UTF-8 está desativado, o Python usa o UTF-8 por padrã o no Windows para:
• E/S do console, incluindo E/S padrã o (consulte PEP 528 para detalhes).
• A codificação do sistema de arquivos (veja a PEP 529 para detalhes).

4.8 Inicializador Python para Windows

Adicionado na versã o 3.3.
O inicializador Python para Windows é um utilitá rio que auxilia na localizaçã o e execuçã o de diferentes versõ es
do Python. Ele permite que scripts (ou a linha de comando) indiquem uma preferê ncia por uma versã o do Python
específica, e irá localizar e executar essa versã o.
Ao contrá rio da variá vel PATH, o inicializador irá corretamente selecionar a versã o mais apropriada do Python. Ele
irá preferir instalaçõ es por usuá rio ao invé s de instalaçõ es globais no sistema, e ordenará por versã o da linguagem ao
invé s de usar a versã o instalada mais recentemente.
O inicializador foi originalmente especificado na PEP 397.

4.8.1 Começando
Pela linha de comando
Alterado na versã o 3.6.
Instalaçõ es globais no sistema do Python 3.3 ou posterior irã o colocar o inicializador no seu PATH. O inicializador é
compatível com todas as versõ es disponíveis do Python, entã o nã o importa qual versã o está instalada. Para verificar
se o inicializador está disponível, execute o seguinte comando no Prompt de Comando:

py

Você deve perceber que a ú ltima versã o do Python que você tem é iniciada - ela pode ser fechada normalmente, e
qualquer argumento da linha de comando adicional especificado será enviado diretamente para o Python.
Se você tem mú ltiplas versõ es do Python instaladas (por exemplo, 3.7 e 3.13) você deve ter notado que o Python
3.13 foi iniciado – para iniciar o Python 3.7, use o comando:

py -3.7

Se você quer a versã o mais recente do Python 2 que você tem instalada, tente o comando:

py -2

Se você ver o seguinte erro, você nã o tem o inicializador instalado:

'py' is not recognized as an internal or external command,

operable program or batch file.

54 Capítulo 4. Utilizando Python no Windows

 Python Setup and Usage, Release 3.13.0

O comando:

py --list

exibe a(s) versã o(õ es) atualmente instalada(s) do Python.

O argumento -x.y é a forma abreviada do argumento -V:Empresa/Tag, que permite selecionar um tempo de
execuçã o Python específico, incluindo aqueles que podem ter vindo de algum lugar diferente de python.org. Qualquer
tempo de execuçã o registrado seguindo a PEP 514 será detectá vel. O comando --list lista todos os tempos de
execuçã o disponíveis usando o formato -V:.
Ao usar o argumento -V:, especificar a Empresa limitará a seleçã o aos tempos de execuçã o desse provedor, enquanto
especificar apenas a Tag selecionará de todos os provedores. Observe que omitir a barra implica uma tag:

# Seleciona qualquer runtime sinalizado como '3.*'

py -V:3

# Seleciona qualquer runtime lançado como 'PythonCore'

py -V:PythonCore/

# Seleciona o runtime Python 3 mais recente de PythonCore

py -V:PythonCore/3

A forma abreviada do argumento (-3) só seleciona a partir de versõ es principais do Python, e nã o de outras distri-
buiçõ es. No entanto, a forma mais longa (-V:3) selecionará qualquer um.
A Empresa é correspondida na string completa, sem distinçã o entre maiú sculas e minú sculas. A Tag corresponde a
uma string completa ou a um prefixo, desde que o pró ximo caractere seja um ponto ou um hífen. Isso permite que
-V:3.1 corresponda a 3.1-32, mas nã o a 3.10. As tags sã o classificadas usando ordenaçã o numé rica (3.10 é mais
recente que 3.1), mas sã o comparadas usando texto (-V:3.01 nã o corresponde a 3.1).

Ambientes virtuais
Adicionado na versã o 3.5.
Se o inicializador é executado sem versã o explícita do Python especificada, e um ambiente virtual (criado com o
mó dulo da biblioteca padrã o venv ou da ferramenta externa virtualenv) está ativo, o inicializador irá executar o
interpretador do ambiente virtual ao invé s do global. Para executar o interpretador global, ou desative o ambiente
virtual, ou explicitamente especifique a versã o global do Python.

Por um script
Vamos criar um script teste de Python - crie um arquivo chamado hello.py com os seguintes conteú dos:

#! python
import sys
sys.stdout.write("olá do Python %s\n" % (sys.version,))

A partir do diretó rio onde hello.py está , execute o comando:

py hello.py

Você deve notar que o nú mero da versã o da sua instalaçã o mais recente do Python 2.x é exibido. Agora tente mudar
a primeira linha para ser:

#! python3

Re-executar o comando agora deve exibir informaçõ es da ú ltima versã o do Python 3.x. Como nos exemplos da linha
de comando acima, você pode especificar um qualificador de versã o mais explícito. Presumindo que você tem o
Python 3.7 instalado, tente mudar a primeira linha para #! python3.7 e você deve ver as informaçõ es da versã o
3.7 sendo exibidas.

4.8. Inicializador Python para Windows 55

Python Setup and Usage, Release 3.13.0

Note que diferentemente do uso interativo, um simples “python” irá usar a ú ltima versã o do Python 2.x que você tem
instalada. Isso é para retrocompatibilidade e para compatibilidade com Unix, onde o comando python tipicamente
se refere ao Python 2.

Por associação de arquivos

O inicializador deve ter sido associado com arquivos Python (isto é , arquivos .py, .pyw, .pyc) quando foi instalado.
Isso significa que quando você clica duas vezes em um desses arquivos a partir do Explorador de Arquivos do Windows
o inicializador será usado, e assim você pode usar as mesmas facilidades descritas acima para que o script especifique
qual versã o deve ser usada.
O benefício chave disso é que um ú nico inicializador pode suportar mú ltiplas versõ es do Python ao mesmo tempo
dependendo dos conteú dos da primeira linha.

4.8.2 Linhas Shebang

Se a primeira linha de um arquivo de script começa com #!, ela é conhecida como linha “shebang”. Linux e outros
tipos de sistemas operacionais Unix tê m suporte nativo para essas linhas e elas sã o comumente usadas nesses sistemas
para indicar como um script deve ser executado. Esse inicializador permite que as mesmas facilidades sejam usadas
com scripts Python no Windows e os exemplos acima demonstram seu uso.
Para permitir que linhas shebang em scripts Python sejam portá veis entre Unix e Windows, este inicializador su-
porta um nú mero de comandos ‘virtuais’ para especificar qual interpretador deve ser usado. Os comandos virtuais
suportados sã o:
• /usr/bin/env
• /usr/bin/python
• /usr/local/bin/python
• python
Por exemplo, se a primeira linha do seu script começa com

#! /usr/bin/python

O Python padrã o ou um ambiente virtual ativo será localizado e utilizado. Como muitos scripts Python escritos para
funcionar no Unix já terã o essa linha, você deve perceber que esses scripts podem ser usados pelo inicializador sem
modificaçã o. Se você está escrevendo um novo script no Windows que você espera que seja ú til no Unix, você deve
usar uma dessas linhas shebang começando com /usr.
Qualquer um dos comandos virtuais acima pode ser sufixado com uma versã o explícita (ou apenas a maior versã o,
ou a maior e a menor versã o). Alé m disso, a versã o de 32 bits pode ser solicitada adicionando “-32” apó s a menor
versã o. Isto é , /usr/bin/python3.7-32 irá solicitar o uso do python 3.7 32-bit. Se um ambiente virtual estiver
ativo, a versã o será ignorada e o ambiente será usado.
Adicionado na versã o 3.7: A partir do inicializador do python 3.7 é possível solicitar a versã o 64-bit adicionando
o sufixo “-64”. Alé m disso é possível especificar uma versã o maior e arquitetura sem a menor (isto é , /usr/bin/
python3-64).

Alterado na versã o 3.11: O sufixo “-64” foi descontinuado e agora implica “qualquer arquitetura que nã o seja compro-
vadamente i386/32 bits”. Para solicitar um ambiente específico, use o novo argumento -V:TAG com a tag completa.
Alterado na versã o 3.13: Comandos virtuais que referenciam python agora preferem um ambiente virtual ativo em
vez de pesquisar PATH. Isso lida com casos em que o shebang especifica /usr/bin/env python3, mas python3.
exe nã o está presente no ambiente ativo.

A forma /usr/bin/env da linha shebang tem mais uma propriedade especial. Antes de procurar por interpretadores
Python instalados, este formulá rio pesquisará o executá vel PATH por um executá vel Python correspondente ao nome
fornecido como o primeiro argumento. Isso corresponde ao comportamento do programa Unix env, que executa
uma pesquisa PATH. Se um executá vel correspondente ao primeiro argumento apó s o comando env nã o puder ser
encontrado, mas o argumento começar com python, ele será tratado conforme descrito para os outros comandos
virtuais. A variá vel de ambiente PYLAUNCHER_NO_SEARCH_PATH pode ser definida (para qualquer valor) para
ignorar esta pesquisa de PATH.

56 Capítulo 4. Utilizando Python no Windows

 Python Setup and Usage, Release 3.13.0

As linhas Shebang que nã o correspondem a nenhum desses padrõ es sã o procuradas na seçã o [commands] do arquivo
.INI do lançador. Isso pode ser usado para lidar com certos comandos de uma maneira que faça sentido para o seu
sistema. O nome do comando deve ser um ú nico argumento (sem espaços no executá vel shebang) e o valor substituído
é o caminho completo para o executá vel (argumentos adicionais especificados no .INI serã o citados como parte do
nome do arquivo).

[commands]
/bin/xpython=C:\Program Files\XPython\python.exe

Quaisquer comandos nã o encontrados no arquivo .INI sã o tratados como caminhos executá veis do Windows que sã o
absolutos ou relativos ao diretó rio que conté m o arquivo de script. Isso é uma conveniê ncia para scripts somente
do Windows, como aqueles gerados por um instalador, pois o comportamento nã o é compatível com shells de estilo
Unix. Esses caminhos podem ser citados e podem incluir vá rios argumentos, apó s os quais o caminho para o script
e quaisquer argumentos adicionais serã o anexados.

4.8.3 Argumentos em linhas shebang

As linhas shebang també m podem especificar opçõ es adicionais a serem passadas ao interpretador Python. Por
exemplo, se você tem uma linha shebang:

#! /usr/bin/python -v

O Python será iniciado com a opçã o -v

4.8.4 Personalização
Personalização via arquivos INI
Dois arquivos .ini serã o pesquisados pelo inicializador - py.ini no diretó rio de dados de aplicaçõ es do usuá rio
atual (%LOCALAPPDATA% ou $env:LocalAppData) e py.ini no mesmo diretó rio que o inicializador. Os mesmos
arquivos .ini sã o usados para ambas a versã o ‘console’ do inicializador (isto é , py.exe) e a versã o ‘windows’ (isto é ,
pyw.exe).
Personalizaçã o especificada no “diretó rio da aplicaçã o” terã o precedê ncia sobre à quela especificada junto do execu-
tá vel, portanto um usuá rio, que pode nã o ter acesso de escrita ao arquivo .ini junto do inicializador, pode sobrescrever
comandos naquele arquivo .ini global.

Personalizando versões padrão do Python

Em alguns casos, um qualificador de versã o pode ser incluído em um comando para ditar qual versã o do Python deve
ser usada pelo comando. Um qualificador de versã o começa com um nú mero maior de versã o e pode opcionalmente
ser seguido por um ponto (‘.’) e uma especificaçã o de versã o menor. Alé m disso, é possível especificar se uma
implementaçã o de 32 ou 64 bit deve ser solicitada adicionando “-32” ou “-64”.
Por exemplo, uma linha shebang #!python nã o tem qualificador de versã o, enquanto #!python3 tem um qualifi-
cador de versã o que especifica apenas uma versã o maior.
Se nenhum qualificador de versã o é encontrado em um comando, a variá vel de ambiente PY_PYTHON pode ser
definida para especificar o qualificador de versã o padrã o. Se ela nã o está definida, o padrã o é “3”. A variá vel pode
especificar qualquer valor que pode ser passado para a linha de comando, como “3”, “3.7”, “3.7-32” ou “3.7-64”.
(Note que a opçã o “-64” está disponível apenas com o inicializador incluso no Python 3.7 ou mais recente.)
Se nenhum qualificador de versã o menor é encontrado, a variá vel de ambiente PY_PYTHON{major} (onde {major}
é o qualificador da versã o maior atual, como determinado acima) pode ser definida para especificar a versã o completa.
Se nenhuma opçã o é encontrada, o inicializador irá enumerar as versõ es do Python instaladas e usar a ú ltima versã o
menor encontrada como versã o maior, o que é provavelmente, ainda que nã o garantido, a versã o instalada mais
recentemente naquela família.
Em um Windows 64-bit com ambas as implementaçõ es de 32-bit e 64-bit da mesma (maior.menor) versã o do Python
instaladas, a versã o 64-bit sempre será preferida. Isso será verdadeiro para ambas as implementaçõ es de 32-bit
e 64-bit do inicializador - um inicializador 32-bit irá preferir executar uma instalaçã o 64-bit do Python da versã o
especificada, se disponível. Isso é para que o comportamento do inicializador possa ser previsto sabendo apenas

4.8. Inicializador Python para Windows 57

Python Setup and Usage, Release 3.13.0

quais versõ es estã o instaladas no PC e sem considerar a ordem com que elas foram instaladas (isto é , sem saber se a
ú ltima a ser instalada foi a versã o 32 ou 64-bit do Python e do instalador correspondente). Como observado acima,
um sufixo opcional “-32” ou “-64” pode ser usado como especificador de versã o para mudar esse comportamento.
Exemplos:
• Se nenhuma opçã o relevante for definida, os comandos python e python2 irã o usar a ú ltima versã o instalada
do Python 2.x e o comando python3 irá usar o ú ltimo Python 3.x instalado.
• O comando python3.7 nã o vai consultar nenhuma opçã o já que as versõ es estã o completamente especifica-
das.
• Se PY_PYTHON=3, os comandos python e python3 irã o ambos usar a ú ltima versã o do Python 3 instalada.
• Se PY_PYTHON=3.7-32, o comando python irá usar a implementaçã o 32 bits do 3.7 enquanto o comando
python3 irá usar o ú ltimo Python instalado (PY_PYTHON nã o foi considerado porque uma versã o maior foi
especificada).
• Se PY_PYTHON=3 e PY_PYTHON3=3.7, os comandos python e python3 irã o ambos usar especificamente
3.7
Em adiçã o à s variá veis de ambiente, as mesmas configuraçõ es podem ser feitas no arquivo .INI usado pelo inicializa-
dor. A seçã o nos arquivos INI é chamada [defaults] e o nome da chave será o mesmo que as variá veis de ambiente
sem o prefixo PY_ (e observe que os nomes das chaves no arquivo INI nã o diferem maiú sculas e minú sculas). Os
conteú dos de uma variá vel de ambiente irã o sobrescrever coisas especificadas em um arquivo INI.
Por exemplo:
• Configurar PY_PYTHON=3.7 é o equivalente ao arquivo INI contendo:

[defaults]
python=3.7

• Configurar PY_PYTHON=3 e PY_PYTHON3=3.7 é o equivalente ao arquivo INI contendo:

[defaults]
python=3
python3=3.7

4.8.5 Diagnósticos
Se uma variá vel de ambiente PYLAUNCHER_DEBUG é configurada (para qualquer valor), o inicializador irá exibir a
informaçã o de diagnó stico do stderr (isto é , no console). Enquanto essa informaçã o consegue ser simultaneamente
verbosa e concisa, ela deve permitir que você veja quais versõ es do Python foram localizadas, porquê uma versã o
particular foi escolhida e qual linha de comando exatamente foi usada para executar o Python alvo. Destina-se
principalmente para testes e depuraçã o.

4.8.6 Teste de simulação

Se uma variá vel de ambiente PYLAUNCHER_DRYRUN for definida (para qualquer valor), o inicializador emitirá o
comando que ele teria executado, mas nã o iniciará o Python de fato. Isso pode ser ú til para ferramentas que desejam
usar o inicializador para detectar e entã o iniciar o Python diretamente. Observe que o comando escrito na saída
padrã o é sempre codificado usando UTF-8 e pode nã o ser renderizado corretamente no console.

4.8.7 Instalar sob demanda

Se uma variá vel de ambiente PYLAUNCHER_ALLOW_INSTALL for definida (para qualquer valor), e a versã o do Python
solicitada nã o estiver instalada, mas estiver disponível na Microsoft Store, o inicializador tentará instalá -la. Isso pode
exigir interaçã o do usuá rio para ser concluído, e você pode precisar executar o comando novamente.
Uma variá vel adicional PYLAUNCHER_ALWAYS_INSTALL faz com que o inicializador sempre tente instalar o Python,
mesmo se for detectado. Isso é destinado principalmente para teste (e deve ser usado com PYLAUNCHER_DRYRUN).

58 Capítulo 4. Utilizando Python no Windows

 Python Setup and Usage, Release 3.13.0

4.8.8 Códigos de retorno

Os seguintes có digos de saída podem ser retornados pelo inicializador do Python. Infelizmente, nã o há como distin-
gui-los do có digo de saída do pró prio Python.
Os nomes dos có digos sã o como usados nas fontes e sã o apenas para referê ncia. Nã o há como acessá -los ou resolvê -los
alé m de ler esta pá gina. As entradas sã o listadas em ordem alfabé tica de nomes.

Nome Va- Descrição

lor
RC_BAD_VENV_CFG 107 Um pyvenv.cfg foi encontrado, mas está corrompido.
RC_CREATE_PROCESS101 Falha ao iniciar o Python.
RC_INSTALLING 111 Uma instalaçã o foi iniciada, mas o comando precisará ser executado novamente
apó s sua conclusã o.
RC_INTERNAL_ERROR109 Erro inesperado. Por favor, relate um bug.
RC_NO_COMMANDLINE108 Nã o é possível obter a linha de comando do sistema operacional.
RC_NO_PYTHON 103 Nã o foi possível localizar a versã o solicitada.
RC_NO_VENV_CFG 106 Um pyvenv.cfg era necessá rio, mas nã o foi encontrado.

4.9 Encontrando módulos

Estas notas complementam a descriçã o em sys-path-init com notas detalhadas do Windows.
Quando nenhum arquivo ._pth é encontrado, assim é como sys.path é populado no Windows:
• Uma entrada em branco é adicionada ao início, que corresponde ao diretó rio atual.
• Se a variá vel de ambiente PYTHONPATH existe, como descrito em Variáveis de ambiente, suas entradas sã o
adicionadas em seguida. Note que no Windows, caminhos nessa variá vel devem ser separados por ponto e
vírgula, para distinguir eles dos dois pontos usados nos identificadores de drivers (C:\ etc.).
• “Caminhos da aplicaçã o” adicionais podem ser adicionados ao registro como subchaves de \
SOFTWARE\Python\PythonCore{version}\PythonPath sob ambas HKEY_CURRENT_USER e
HKEY_LOCAL_MACHINE. Subchaves que possuem string de caminhos delimitados por ponto e vírgula como
seu valor padrã o farã o com que cada caminho seja adicionado ao sys.path. (Note que todos os instaladores
conhecidos usam apenas HKLM, portanto HKCU está tipicamente vazio.)
• Se a variá vel de ambiente PYTHONHOME está definida, ela é presumida como “Python Home”. Caso contrá rio,
o caminho do principal executá vel do Python é usado para localizar um “arquivo de referê ncia” (ou Lib\os.
py ou pythonXY.zip) para deduzir o “Python Home”. Se um Python Home é encontrado, os subdiretó rios
relevantes adicionados ao sys.path (Lib, plat-win, etc) sã o baseados naquela pasta. Se nã o, o caminho
nú cleo do Python é construído a partir do PythonPath armazenado no registro.
• Se o Python Home nã o puder ser localizado, nenhum PYTHONPATH está especificado no ambiente, e nenhuma
entrada de registro pô de ser encontrada, um caminho padrã o com entradas relativas é usado (por exemplo,
.\Lib;.\plat-win, etc).

Se um arquivo pyvenv.cfg for encontrado juntamente com o principal executá vel ou no diretó rio um nível acima
do executá vel, as seguintes variaçõ es se aplicam:
• Se home é um caminho absoluto e PYTHONHOME nã o está definido, o caminho é usado ao invé s do caminho ao
principal executá vel quando deduzindo a localizaçã o do Home.
O resultado final de tudo isso é :
• Quando executando python.exe, ou qualquer outro .exe no diretó rio principal do Python (ou uma versã o
instalada, ou diretamente do diretó rio PCbuild), o caminho nú cleo é deduzido, e os caminhos nú cleo no registro
sã o ignorados. Outros “caminhos da aplicaçã o” no registro sã o sempre lidos.
• Quando Python é hospedado em outro .exe (diretó rio diferente, embutido via COM, etc), o “Python Home”
nã o será deduzido, entã o o caminho nú cleo do registro é usado. Outros “caminhos da aplicaçã o” no registro
sempre sã o lidos.

4.9. Encontrando módulos 59

Python Setup and Usage, Release 3.13.0

• Se o Python nã o puder encontrar seu Home e nã o existem valores no registro (.exe imutá veis, algumas configu-
raçõ es de instalaçã o bem estranhas) você recebe um caminho com alguns caminhos padrã o, poré m relativos.
Para aqueles que querem empacotar o Python em suas aplicaçõ es ou distribuiçõ es, o seguinte conselho irá prevenir
conflitos com outras instalaçõ es:
• Inclua um arquivo ._pth juntamente do executá vel contendo os diretó rios a serem incluídos. Isso irá ignorar
caminhos listados no registro e variá veis de ambiente, e també m ignorar sites a nã o ser que import site
seja listado.
• Se você estiver carregando python3.dll ou python37.dll em seu pró prio executá vel, defina explicita-
mente PyConfig.module_search_paths antes de Py_InitializeFromConfig().
• Limpe e/ou sobrescreva PYTHONPATH e defina PYTHONHOME antes de iniciar o python.exe a partir da sua
aplicaçã o.
• Se você nã o puder usar as sugestõ es anteriores (por exemplo, você é uma distribuiçã o que permite que as
pessoas executem o arquivo python.exe diretamente), certifique-se de que o arquivo de referê ncia (Lib\
os.py) existe no seu diretó rio de instalaçã o. (Note que ele nã o será detectado dentro de um arquivo ZIP, mas
um arquivo ZIP corretamente nomeado será detectado ao invé s disso.)
Isso irá garantir que seus arquivos em uma instalaçã o global no sistema nã o terã o precedê ncia sobre uma có pia da
biblioteca padrã o empacotada com a sua aplicaçã o. Caso contrá rio, seus usuá rios podem experienciar problemas
usando sua aplicaçã o. Note que a primeira sugestã o é a melhor, pois as outras podem ainda estar suscetíveis a
caminhos nã o-padrã o no registro e no site-packages do usuá rio.
Alterado na versã o 3.6: Adiciona suporte a arquivos ._pth e remove a opçã o applocal do pyvenv.cfg.
Alterado na versã o 3.6: Adiciona pythonXX.zip como uma possível referê ncia quando diretamente adjacente ao
executá vel.
Obsoleto desde a versã o 3.6: Mó dulos especificados no registro sob Modules (nã o PythonPath) podem ser impor-
tados por importlib.machinery.WindowsRegistryFinder. Este localizador está ativo no Windows no 3.6.0
e anteriores, mas pode precisar ser explicitamente adicionado ao sys.meta_path no futuro.

4.10 Módulos adicionais

Mesmo que o Python tenha como objetivo ser portá vel atravé s de todas as plataformas, existem recursos que sã o
ú nicos para o Windows. Alguns mó dulos, em ambas as bibliotecas padrã o e externa, e trechos de có digo existem
para usar esses recursos.
Os mó dulos padrã o específicos para Windows estã o documentados em mswin-specific-services.

4.10.1 PyWin32
O mó dulo PyWin32 de Mark Hammond é uma coleçã o de mó dulos para suporte avançado específico para Windows.
Isso inclui utilitá rios para:
• Component Object Model (COM)
• Chamadas à API Win32
• Registro
• Log de Eventos
• Microsoft Foundation Classes (MFC) user interfaces
PythonWin é uma aplicaçã o MFC de exemplo enviada com o PyWin32. É uma IDE embutível com um depurador
embutido.

µ Ver também

60 Capítulo 4. Utilizando Python no Windows

 Python Setup and Usage, Release 3.13.0

Win32 How Do I…?

por Tim Golden
Python e COM
by David and Paul Boddie

4.10.2 cx_Freeze
cx_Freeze encapsula scripts Python em programas executá veis do Windows (arquivos *.exe). Quando você tiver
feito isso, você pode distribuir sua aplicaçã o sem solicitar que os seus usuá rios instalem o Python.

4.11 Compilando Python no Windows

Se você quer compilar o CPython por conta pró pria, a primeira coisa que você precisa ter é a fonte. Você pode fazer
o download tanto da fonte da ú ltima versã o quanto pegar um novo checkout.
A á rvore de fontes conté m uma soluçã o de construçã o e arquivos de projeto para o Microsoft Visual Studio, que é o
compilador usado para construir as versõ es do Python oficiais. Esses arquivos estã o no diretó rio PCbuild.
Confira o PCbuild/readme.txt para informaçõ es gerais sobre o processo de construçã o.
Para mó dulos de extensã o, consulte building-on-windows.

4.12 Outras plataformas

Com o desenvolvimento do Python em andamento, algumas plataformas que costumavam ser suportadas anterior-
mente nã o sã o mais suportadas (devido à falta de usuá rio ou desenvolvedores). Confira a PEP 11 para detalhes de
todas as plataformas nã o suportadas.
• Windows CE nã o é mais suportado desde o Python 3 (se é que foi em algum momento).
• O instalador do Cygwin oferece instalar o interpretador do Python també m
Veja Python for Windows para informaçã o detalhada sobre as plataformas com instaladores pré -compilados.

4.11. Compilando Python no Windows 61

Python Setup and Usage, Release 3.13.0

62 Capítulo 4. Utilizando Python no Windows

 CAPÍTULO 5

Usando Python em macOS

Este documento tem o objetivo de fornecer uma visã o geral dos comportamentos específicos do macOS que você
deve conhecer para começar a usar o Python em computadores Mac. O Python em um Mac com macOS é muito
semelhante ao Python em outras plataformas derivadas do Unix, mas há algumas diferenças na instalaçã o e alguns
recursos.
Há vá rias maneiras de obter e instalar o Python para macOS. Versõ es pré -construídas das versõ es mais recentes do
Python estã o disponíveis em vá rios distribuidores. Grande parte deste documento descreve o uso dos Pythons forne-
cidos pela equipe de lançamento do CPython, disponíveis para download no site python.org. Consulte Distribuições
alternativas para conhecer outras opçõ es.

5.1 Usando Python para macOS do python.org

5.1.1 Etapas de instalação
Para as versõ es atuais de Python (exceto as com status security), a equipe de lançamento produz um pacote de
instalaçã o Python para macOS em cada novo lançamento. Uma lista dos instaladores disponíveis está disponível
aqui. Recomendamos usar a versã o suportada mais recente de Python sempre que possível. Os instaladores atuais
fornecem uma versã o de Python como biná rio universal 2 que é executado nativamente em todos os Macs (Apple
Silicon e Intel) compatíveis com uma ampla gama de versõ es do macOS, atualmente do macOS 10.13 High Sierra
em diante.
O arquivo baixado é um arquivo padrã o do instalador de pacotes do macOS (.pkg). As informaçõ es de integridade
do arquivo (soma de verificaçã o, tamanho, assinatura de Sigstore, etc.) de cada arquivo estã o inclusas na pá gina de
download dos lançamentos. Os pacotes de instalaçã o e seus conteú dos sã o assinados e autenticados com certificados
Apple Developer ID Python Software Foundation para atender aos requisitos do macOS Gatekeeper.
Para uma instalaçã o padrã o, clique duas vezes no arquivo instalador de pacotes baixado. Isso deverá abrir o aplicativo
padrã o de instalaçã o do macOS e exibir o primeiro de vá rios passos de instalaçã o.

63
Python Setup and Usage, Release 3.13.0

Ao clicar no botã o Continuar, é exibido o Read Me desse instalador. Alé m de outras informaçõ es importantes, o
Read Me documenta qual versã o de Python será instalada e em quais versõ es do macOS ele é compatível. Talvez você
precise rolar a tela para ler o arquivo inteiro. Por padrã o, esse Read Me també m será instalado em /Applications/
Python 3.13/ e estará disponível para leitura a qualquer momento.

64 Capítulo 5. Usando Python em macOS

 Python Setup and Usage, Release 3.13.0

Ao clicar em Continuar, o instalador exibe a licença do Python e de outros softwares incluídos. Você precisará
Concordar com os termos da licença antes de prosseguir para a pró xima etapa. Esse arquivo de licença també m será
instalado e estará disponível para leitura a qualquer momento.

5.1. Usando Python para macOS do python.org 65

Python Setup and Usage, Release 3.13.0

Apó s aceitar os termos da licença, a pró xima etapa será a tela Tipo de instalação. Para a maioria dos usos, o conjunto
padrã o de operaçõ es de instalaçã o é adequado.

66 Capítulo 5. Usando Python em macOS

 Python Setup and Usage, Release 3.13.0

Ao pressionar o botã o Personalizar, você pode optar por omitir ou selecionar determinados componentes de pacote
do instalador. Clique em cada nome de pacote para ver uma descriçã o do que ele instala. Para també m instalar o
suporte para o recurso experimental opcional de threads livres, consulte Instalando binários com threads livres.

5.1. Usando Python para macOS do python.org 67

Python Setup and Usage, Release 3.13.0

Em ambos os casos, clicar em Instalar iniciará o processo de instalaçã o solicitando a permissã o para instalar um
novo software. É necessá rio um nome de usuá rio do macOS com privilé gio de Administrador, pois o Python
instalado estará disponível para todos os usuá rios do Mac.
Quando a instalaçã o for concluída, a janela Resumo será exibida.

68 Capítulo 5. Usando Python em macOS

 Python Setup and Usage, Release 3.13.0

Clique duas vezes no ícone ou arquivo Install Certificates.command na janela /Applications/Python

3.13/ para concluir a instalaçã o.

Isso abrirá uma janela temporá ria do console Terminal que usará o novo Python para baixar e instalar certificados
raiz SSL para seu uso.

5.1. Usando Python para macOS do python.org 69

Python Setup and Usage, Release 3.13.0

Se Successfully installed certifi e update complete aparecerem na janela do terminal, a instalaçã o

estará concluída. Feche essa janela do terminal e a janela do instalador.
Uma instalaçã o do padrã o incluirá :
• Uma pasta Python 3.13 em sua pasta Applications. Aqui você encontra o IDLE, o ambiente de de-
senvolvimento que é parte das distribuiçõ es oficiais do Python; e o Python Launcher, que executa scripts
Python quando sã o clicados duas vezes dentro do Finder .
• Uma framework /Library/Frameworks/Python.framework, que inclui o executá vel Python e suas bibli-
otecas. O instalador adiciona esse local ao seu path do console. Para desinstalar o Python, você pode remover
esses trê s itens. É um link simbó lico para o executá vel Python armazenado na pasta /usr/local/bin/.

® Nota

As versõ es recentes do macOS incluem um comando python3 em /usr/bin/python3 que aponta para uma
versã o geralmente mais antiga e incompleta de Python fornecida por e para uso pelas ferramentas de desenvol-
vimento da Apple, Xcode ou o Command Line Tools for Xcode. Você nunca deve modificar ou tentar
excluir essa instalaçã o por ser controlada pela Apple e é usada por softwares da Apple ou de terceiros. Se você
optar por instalar uma versã o mais recente do Python a partir de python.org, você terá duas instalaçõ es dife-
rentes, mas funcionais, de Python no computador que podem coexistir. As opçõ es do instalador padrã o devem
garantir que o comando python3 seja usado em vez do python3 do sistema.

70 Capítulo 5. Usando Python em macOS

 Python Setup and Usage, Release 3.13.0

5.1.2 Como executar um script Python

Há duas maneiras de invocar o interpretador Python. Se você estiver familiarizado com o uso de um console Unix
em terminal, você pode invocar python3.13 ou python3, opcionalmente seguido por uma ou mais opçõ es da linha
de comando (descritas em Linha de comando e ambiente). O tutorial de Python també m tem uma seçã o ú til sobre o
uso interativo do Python a partir de um console.
Você també m pode invocar o interpretador por um ambiente de desenvolvimento integrado (IDE). O idle é um editor
e ambiente de desenvolvimento bá sico incluído com a distribuiçã o padrã o de Python. IDLE inclui um menu Ajuda
que te permite acessar a documentaçã o de Python. Se você for completamente iniciante em Python, você pode ler o
tutorial de introduçã o na documentaçã o.
Há muitos outros editores e IDEs disponíveis. Consulte Editores e IDEs para mais informaçõ es.
Para executar um script Python na janela do terminal, você pode invocar o interpretador com o nome do arquivo de
script:
python3.13 myscript.py

Para executar seu script a partir do Finder, você pode:

• Arrastá -lo para o Python Launcher.
• Selecione Python Launcher como a aplicaçã o padrã o para abrir seu script (ou qualquer script .py) na
janela de informaçõ es Finder Info, e clique duas vezes nele. O Python Launcher tem vá rias preferê ncias
para controlar como o script é iniciado. Você pode arrastar opçõ es para alterá -las por uma invocaçã o, ou usar
o menu Preferências para alterar configuraçõ es globalmente.
Saiba que executar o script diretamente do Finder pode produzir resultados diferentes daqueles obtidos em uma
janela de terminal, pois o script nã o será executado no ambiente normal do console, incluindo qualquer configuraçã o
de variá veis de ambiente nos perfis do console. E, como em qualquer outro script ou programa, certifique-se do que
está prestes a executar.

5.2 Distribuições alternativas

Alé m do instalador padrã o do python.org para macOS, existem distribuiçõ es de terceiros para macOS que podem
incluir funcionalidades adicionais. Algumas distribuiçõ es populares e seus recursos-chave sã o:
ActivePython
Instalador com compatibilidade multiplataforma, documentaçã o
Anaconda
Mó dulos científicos populares (como numpy, scipy e pandas) e o gerenciador de pacotes conda.
Homebrew
Gerenciador de pacotes para macOS que inclui vá rias versõ es do Python e muitos pacotes Python de terceiros
(incluindo numpy, scipy e pandas).
MacPorts
Outro gerenciador de pacotes para macOS, incluindo vá rias versõ es de Python e muitos pacotes Python de ter-
ceiros. Pode incluir versõ es pré -construídas do Python e muitos pacotes para versõ es mais antigas do macOS.
Note que distribuiçõ es podem nã o incluir versõ es mais recentes de Python ou de outras bibliotecas, e nã o sã o mantidas
ou providas pela equipe do Python.

5.3 Instalando pacotes adicionais ao python

Consulte o Guia de Usuá rio para Empacotamento de Python para mais informaçõ es.

5.2. Distribuições alternativas 71

Python Setup and Usage, Release 3.13.0

5.4 Programação de GUI

Existem vá rias opçõ es para criar aplicaçõ es GUI no Mac com Python.
O kit de ferramentas GUI padrã o de Python é o mó dulo tkinter, baseado no kit de ferramentas multiplataforma
Tk (https://www.tcl.tk). Uma versã o nativa do Tk para macOS está incluída no instalador.
O PyObjC é uma ligaçã o em Python para o Objective-C/Cocoa da Apple framework. Informaçõ es sobre o PyObjC
estã o disponíveis em pyobjc.
Há vá rios kits de ferramentas GUI alternativas disponíveis para o macOS, incluindo:
• PySide: Ligaçõ es oficiais em Python ao kit de ferramentas Qt GUI .
• PyQt: Ligaçõ es alternativas em Python ao Qt.
• Kivy: Um kit de ferramentas GUI multiplataforma que dá suporte a plataformas de desktop e dispositivos
mó veis.
• Toga: Parte do BeeWare Project; dá suporte a aplicativos para desktop, dispositivos mó veis, Web e console.
• wxPython: Um kit de ferramentas multiplataforma que dá suporte a sistemas operacionais desktop.

5.5 Tópicos Avançados

5.5.1 Instalando binários com threads livres
Adicionado na versã o 3.13: (Experimental)

® Nota

Tudo descrito nesta seçã o é considerado experimental e espera-se que mude em lançamentos futuros.

O pacote de instalaçã o do Python para macOS em python.org pode, opcionalmente, instalar uma compilaçã o
adicional do Python 3.13 que dá suporte à PEP 703, o recurso experimental de threads livres (executado com o trava
global do interpretador desativado). Verifique a pá gina de lançamento em python.org para obter informaçõ es
atualizadas.
Como esse recurso ainda é considerado experimental, seu suporte nã o é instalado por padrã o. Ele é empacotado
como uma opçã o de instalaçã o separada, disponível clicando no botã o Personalizar na etapa Tipo de instalação do
instalador, como descrito acima.

72 Capítulo 5. Usando Python em macOS

 Python Setup and Usage, Release 3.13.0

Se a caixa ao lado do nome Free-Threaded Python for marcada, um arquivo PythonT.framework també m será
instalado junto ao arquivo Python.framework em /Library/Frameworks. Essa configuraçã o permite que a
compilaçã o de Python 3.13 com threads livres coexista no seu sistema com a compilaçã o de Python 3.13 tradicional
(com GIL) com risco mínimo durante instalaçã o ou testagem. Esse layout de instalaçã o é experimental, e sujeito a
mudanças em lançamentos futuros.
Precauçõ es e limitaçõ es conhecidas:
• O pacote Unix command-line tools, que é selecionado por padrã o, instalará links em /usr/local/bin para
python3.13t, o interpretador com threads livres e python3.13t-config, um utilitá rio de configuraçã o
que pode ser ú til para criadores de pacote. Como /usr/local/bin é normalmente incluído em seu PATH
do console, geralmente nã o é necessá rio alterar as variá veis de ambiente do PATH para usar o python3.13t.
• Neste lançamento, o pacote Shell profile updater e o comando Update Shell Profile.command em
/Applications/Python 3.13/ nã o dã o suporte ao pacote de threads livres.

• A compilaçã o com threads livres e a compilaçã o tradicional tê m caminhos de pesquisa separados e diretó -
rios site-packages separados, portanto, por padrã o, se você precisar de um pacote disponível em ambas
compilaçõ es, talvez seja necessá rio instalá -lo em ambos. O pacote com threads livres instalará uma instâ ncia
separada do pip para uso com o python3.13t.
– Para instalar um pacote usando pip sem um venv:
python3.13t -m pip install <package_name>
• Ao trabalhar com vá rios ambientes Python, geralmente é mais seguro e mais fá cil criar e usar ambientes
virtuais. Isso pode tanto evitar possíveis conflitos de comandos, quanto evitar a confusã o sobre qual Python
está sendo usado:
python3.13t -m venv <venv_name>

e, em seguida, activate.
• Para executar uma versã o do IDLE com threads livres:

5.5. Tópicos Avançados 73

Python Setup and Usage, Release 3.13.0

python3.13t -m idlelib
• Os inté rpretes em ambos as compilaçõ es respondem à s mesmas variá veis de ambiente PYTHON, o que pode
gerar resultados inesperados, por exemplo, se você tiver PYTHONPATH definido em um perfil de console. Se
necessá rio, há opções de linha de comando como -E para ignorar essas variá veis de ambiente.
• A compilaçã o com threads livres é ligada à s bibliotecas compartilhadas de terceiros, como OpenSSL e Tk, ins-
taladas no framework tradicional. Isso significa que ambas as compilaçõ es també m compartilham um conjunto
de certificados, como instalados pelo script Install Certificates.command, portanto, ele só precisa ser
executado uma vez.
• Se você nã o puder depender do link em /usr/local/bin apontando para python3.13t com threads livres
do python.org (por exemplo, se quiser instalar sua pró pria versã o lá ou se alguma outra distribuiçã o instalá -
-lo lá ), você poderá definir explicitamente sua variá vel de ambiente de console PATH para incluir o diretó rio
da framework PythonT bin:

export PATH="/Library/Frameworks/PythonT.framework/Versions/3.13/bin":"$PATH"

A instalaçã o tradicional do framework por padrã o faz algo semelhante, exceto pelo arquivo Python.
framework. Observe que ter dois diretó rios bin do framework em PATH pode gerar confusã o se houver
nomes duplicados, como python3.13, em ambos; qual deles é realmente usado depende da ordem em que
aparecem em PATH. Os comandos which python3.x ou which python3.xt pode mostrar qual caminho
está sendo usado. Usar ambientes virtuais pode ajudar a evitar essas ambiguidades. Outra opçã o pode ser criar
um alias no console para o interpretador desejado, como:

alias py3.13="/Library/Frameworks/Python.framework/Versions/3.13/bin/python3.13
,→"

alias py3.13t="/Library/Frameworks/PythonT.framework/Versions/3.13/bin/python3.
,→13t"

5.5.2 Instalação usando a linha de comando

Se você quiser usar automaçã o para instalar o pacote de instalaçã o python.org (em vez de usar o aplicativo GUI
Installer do macOS), o utilitá rio para linha de comando installer permite que você selecione opçõ es que nã o
sejam do padrã o. Se você nã o estiver familiarizado com o installer, ele pode ser um tanto enigmá tico (consulte:
command:man installer para obter mais informaçõ es). Como exemplo, o seguinte trecho de console mostra uma
maneira de fazer isso, usando a versã o 3.13.0b2 e selecionando a opçã o de interpretador com threads livres:

RELEASE="python-3.13.0b2-macos11.pkg"

# baixa o pkg do instalador

curl -O https://www.python.org/ftp/python/3.13.0/${RELEASE}

# cria o choicechanges do instalador para personalizar a instalação:

# habilita o pacote PythonTFramework-3.13
# enquanto aceita outros padrões (instala todos os outros apcotes)
cat > ./choicechanges.plist <<EOF
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/
,→PropertyList-1.0.dtd">

<plist version="1.0">
<array>
<dict>
<key>attributeSetting</key>
<integer>1</integer>
<key>choiceAttribute</key>
<string>selected</string>
<key>choiceIdentifier</key>
<string>org.python.Python.PythonTFramework-3.13</string>
(continua na pró xima pá gina)

74 Capítulo 5. Usando Python em macOS

 Python Setup and Usage, Release 3.13.0

(continuaçã o da pá gina anterior)

</dict>
</array>
</plist>
EOF

sudo installer -pkg ./${RELEASE} -applyChoiceChangesXML ./choicechanges.plist -

,→target /

Você pode entã o testar que ambas as compilaçõ es de instaladores estã o disponíveis com algo como:

$ # teste que o interpretador com threads livres foi instalado se o pacote Unix␣
,→Command Tools foi habilitado

$ /usr/local/bin/python3.13t -VV
Python 3.13.0b2 experimental free-threading build (v3.13.0b2:3a83b172af, Jun 5␣
,→2024, 12:57:31) [Clang 15.0.0 (clang-1500.3.9.4)]

$ # e o interpretador tradicional
$ /usr/local/bin/python3.13 -VV
Python 3.13.0b2 (v3.13.0b2:3a83b172af, Jun 5 2024, 12:50:24) [Clang 15.0.0 (clang-
,→1500.3.9.4)]

$ # teste que também eles estão disponíveis sem o prefixo se /usr/local/bin␣

,→estiver no $PATH

$ python3.13t -VV
Python 3.13.0b2 experimental free-threading build (v3.13.0b2:3a83b172af, Jun 5␣
,→2024, 12:57:31) [Clang 15.0.0 (clang-1500.3.9.4)]

$ python3.13 -VV
Python 3.13.0b2 (v3.13.0b2:3a83b172af, Jun 5 2024, 12:50:24) [Clang 15.0.0 (clang-
,→1500.3.9.4)]

® Nota

Os instaladores atuais do python.org só instalam em locais fixos, como /Library/Frameworks/, /

Applications e /usr/local/bin. Nã o é possível usar a opçã o -domain do installer para instalar em
outros locais.

5.5.3 Distribuindo aplicações Python

Existe uma variedade de ferramentas para converter seu có digo Python em uma aplicaçã o distribuível independente:
• py2app: Oferece suporte à criaçã o de pacotes .app do macOS a partir de um projeto Python.
• Briefcase: Parte do BeeWare Project; uma ferramenta de empacotamento multiplataforma que permite criar
bundles .app no macOS, alé m de gerenciar assinaturas digitais e a notarizaçã o.
• PyInstaller: Uma ferramenta de empacotamento multiplataforma que cria um ú nico arquivo ou pasta como um
artefato distribuível.

5.5.4 Conformidade com a App Store

As aplicaçõ es enviadas para distribuiçã o pela macOS App Store devem passar pelo processo de revisã o de aplicativos
da Apple. Esse processo inclui um conjunto de regras de validaçã o automatizadas que inspecionam o pacote de
aplicativos enviado em busca de có digo problemá tico.
A biblioteca padrã o do Python conté m alguns có digos que violam essas regras automatizadas. Embora essas viola-
çõ es pareçam ser falsos positivos, as regras de revisã o da Apple nã o podem ser contestadas. Portanto, é necessá rio
modificar a biblioteca padrã o do Python para que uma aplicaçã o passe na revisã o da App Store.
A á rvore de fontes do Python conté m um arquivo de patch que removerá todo o có digo que é conhecido por cau-
sar problemas no processo de revisã o da App Store. Este patch é aplicado automaticamente quando o CPython é

5.5. Tópicos Avançados 75

Python Setup and Usage, Release 3.13.0

configurado com a opçã o --with-app-store-compliance.

Este patch normalmente nã o é necessá rio para usar o CPython em um Mac; nem é necessá rio se você estiver dis-
tribuindo uma aplicaçã o fora da App Store do macOS. É necessá rio apenas se você estiver usando a App Store do
macOS como canal de distribuiçã o.

5.6 Outros recursos

A pá gina de ajuda do python.org conté m links para vá rios recursos ú teis. A lista de discussã o Pythonmac-SIG é
outro recurso específico de suporte para usuá rios e desenvolvedores de Python no Mac.

76 Capítulo 5. Usando Python em macOS

 CAPÍTULO 6

Utilizando Python no Android

Python no Android é diferente do Python em plataformas de desktop. Em uma plataforma desktop, o Python geral-
mente é instalado como um recurso do sistema que pode ser usado por qualquer usuá rio daquele computador. Os
usuá rios entã o interagem com o Python executando um executá vel python e inserindo comandos em um prompt
interativo ou executando um script Python.
No Android, nã o existe o conceito de instalaçã o como recurso do sistema. A ú nica unidade de distribuiçã o de software
é uma aplicaçã o, ou “app”. També m nã o há console onde você possa executar um executá vel python ou interagir
com um REPL do Python.
Como resultado, a ú nica maneira de usar Python no Andoid é no modo incorporado – ou seja, escrevendo uma
aplicaçã o Android nativo, incorporando um interpretador Python usando libpython e invocando o có digo Python
usando API de incorporaçã o do Python. O interpretador Python completo, a biblioteca padrã o e todo o seu có digo
Python sã o entã o empacotados para sua aplicaçã o para seu pró prio uso privado.
A biblioteca padrã o do Python tem algumas omissõ es e restriçõ es notá veis no Andoid. Consulte o guia de disponi-
bilidade de API para Android para obter detalhes.

6.1 Adicionando Python a uma aplicação Android

Essas instruçõ es sã o necessá rias somente se você estiver planejando compilar Python para Android você mesmo. A
maioria dos usuá rios não precisa fazer isso. Em vez disso, use uma das seguintes ferramentas, que fornecerã o uma
experiê ncia muito mais fá cil:
• Briefcase, do projeto BeeWare
• Buildozer, do projeto Kivy
• Chaquopy
• pyqtdeploy
• Termux
Se você tem certeza de que quer fazer tudo isso manualmente, continue lendo. Você pode usar a aplicaçã o testbed
como um guia; cada passo abaixo conté m um link para o arquivo relevante.
• Construa o Python seguindo as instruçõ es em Android/README.md.
• Adicione có digo ao seu arquivo build.gradle para copiar os seguintes itens para o seu projeto. Todos, exceto
seu pró prio có digo Python, podem ser copiados de cross-build/HOST/prefix/lib:
– Em suas bibliotecas JNI:

77
Python Setup and Usage, Release 3.13.0

∗ libpython*.*.so
∗ lib*_python.so (bibliotecas externas, tal como OpenSSL)
– Em seus ativos (assets):
∗ python*.* (a biblioteca padrã o do Python)
∗ python*.*/site-packages (seu pró prio có digo Python)
• Adicione có digo ao seu aplicativo para extrair os ativos para o sistema de arquivos.
• Adicione có digo a sua aplicaçã o para iniciar o Python em modo incorporado. Isso precisará ser có digo C
chamado via JNI.

78 Capítulo 6. Utilizando Python no Android

 CAPÍTULO 7

Usando Python no iOS

Autores
Russell Keith-Magee (2024-03)
Python no iOS é diferente do Python em plataformas de desktop. Em uma plataforma desktop, o Python geralmente
é instalado como um recurso do sistema que pode ser usado por qualquer usuá rio daquele computador. Os usuá rios
entã o interagem com o Python executando um executá vel python e inserindo comandos em um prompt interativo
ou executando um script Python.
No iOS, nã o existe o conceito de instalaçã o como recurso do sistema. A ú nica unidade de distribuiçã o de software
é uma aplicaçã o, ou “app”. També m nã o há console onde você possa executar um executá vel python ou interagir
com um REPL do Python.
Como resultado, a ú nica maneira de usar Python no iOS é no modo incorporado – ou seja, escrevendo uma aplicaçã o
iOS nativo e incorporando um interpretador Python usando libPython e invocando o có digo Python usando API
de incorporaçã o do Python. O interpretador Python completo, a biblioteca padrã o e todo o seu có digo Python sã o
entã o empacotados como um pacote independente que pode ser distribuído pela iOS App Store.
Se você deseja experimentar pela primeira vez escrever uma aplicaçã o iOS em Python, projetos como BeeWare e
Kivy irã o fornecer uma experiê ncia de usuá rio muito mais acessível. Esses projetos gerenciam as complexidades
associadas à execuçã o de um projeto iOS, portanto, você só precisa lidar com o pró prio có digo Python.

7.1 Python em tempo de execução no iOS

7.1.1 Compatibilidade com a versão do iOS
A versã o mínima suportada do iOS é especificada em tempo de compilaçã o, usando a opçã o --host do configure.
Por padrã o, quando compilado para iOS, Python será compilado com uma versã o iOS mínima suportada de 13.0.
Para usar uma versã o mínima diferente do iOS, forneça o nú mero da versã o como parte do argumento --host - por
exemplo, --host=arm64-apple-ios15.4-simulator compilaria um simulador ARM64 construído com uma
meta de implantaçã o de 15.4.

7.1.2 Identificação da plataforma

Ao executar no iOS, sys.platform reportará como ios. Este valor será retornado em um iPhone ou iPad, inde-
pendentemente da aplicaçã o estar execitando no simulador ou em um dispositivo físico.
Informaçõ es sobre o ambiente de execuçã o específico, incluindo a versã o do iOS, modelo do dispositivo e se o
dispositivo é um simulador, podem ser obtidas usando platform.ios_ver(). platform.system() reportará

79
Python Setup and Usage, Release 3.13.0

iOS ou iPadOS, dependendo do dispositivo.

os.uname() reporta detalhes em nível de kernel; ele reportará o nome Darwin.

7.1.3 Disponibilidade da biblioteca padrão

A biblioteca padrã o do Python tem algumas omissõ es e restriçõ es notá veis no iOS. Consulte o guia de disponibilidade
de API para iOS para obter detalhes.

7.1.4 Módulos de extensão binária

Uma diferença notá vel sobre o iOS como plataforma é que a distribuiçã o da App Store impõ e requisitos rígidos ao
empacotamento de uma aplicaçã o. Um desses requisitos rege como os mó dulos de extensã o biná ria sã o distribuídos.
A iOS App Store exige que todos os mó dulos biná rios em uma aplicaçã o iOS sejam bibliotecas dinâ micas, contidas
em um framework com metadados apropriados, armazenados na pasta Frameworks da aplicaçã o empacotada. Pode
haver apenas um ú nico biná rio por framework, e nã o pode haver nenhum material biná rio executá vel fora da pasta
Frameworks.

Isto entra em conflito com a abordagem usual do Python para distribuiçã o de biná rios, que permite que um mó dulo
de extensã o biná ria seja carregado de qualquer local em sys.path. Para garantir a conformidade com as políticas
da App Store, um projeto iOS deve pó s-processar quaisquer pacotes Python, convertendo mó dulos biná rios .so
em estruturas independentes individuais com metadados e assinatura apropriados. Para obter detalhes sobre como
realizar esse pó s-processamento, consulte o guia para adicionar Python ao seu projeto.
Para ajudar o Python a descobrir biná rios em seu novo local, o arquivo .so original em sys.path é substituído por
um arquivo .fwork. Este arquivo é um arquivo texto que conté m a localizaçã o do biná rio do framework, relativo ao
pacote de aplicaçõ es. Para permitir que o framework retorne ao local original, o framework deve conter um arquivo
.origin que conté m a localizaçã o do arquivo .fwork, relativo ao pacote da aplicaçã o.
Por exemplo, considere o caso de uma importaçã o from foo.bar import _whiz, onde _whiz é implemen-
tado com o mó dulo biná rio sources/foo/bar/_whiz.abi3.so, com sources sendo o local registrado em
sys.path, relativo ao pacote da aplicaçã o. Este mó dulo deve ser distribuído como Frameworks/foo.bar.
_whiz.framework/foo.bar._whiz (criando o nome do framework a partir do caminho de importaçã o com-
pleto do mó dulo), com um arquivo Info.plist no diretó rio .framework identificando o biná rio como um fra-
mework. O mó dulo foo.bar._whiz seria representado no local original com um arquivo marcador sources/
foo/bar/_whiz.abi3.fwork, contendo o caminho Frameworks/foo.bar._whiz/foo.bar._whiz. O fra-
mework també m conteria Frameworks/foo.bar._whiz.framework/foo.bar._whiz.origin, contendo o
caminho para o arquivo .fwork.
Ao executar no iOS, o interpretador Python instalará um AppleFrameworkLoader que é capaz de ler e importar
arquivos .fwork. Uma vez importado, o atributo __file__ do mó dulo biná rio reportará como a localizaçã o do
arquivo .fwork. Entretanto, o ModuleSpec para o mó dulo carregado reportará a origin como a localizaçã o do
biná rio na pasta do framework.

7.1.5 Binários stub do compilador

O Xcode nã o expõ e compiladores explícitos para iOS; em vez disso, ele usa um script xcrun que resolve um caminho
do compilador (por exemplo, xcrun --sdk iphoneos clang para obter o clang para um dispositivo iPhone).
No entanto, usar este script apresenta dois problemas:
• A saída de xcrun inclui caminhos que sã o específicos da má quina, resultando em um mó dulo sysconfig que
nã o pode ser compartilhado entre usuá rios; e
• Isso resulta em definiçõ es CC/CPP/LD/AR que incluem espaços. Existem muitas ferramentas do ecossistema C
que pressupõ em que você pode dividir uma linha de comando no primeiro espaço para obter o caminho para
o executá vel do compilador; este nã o é o caso ao usar xcrun.
Para evitar esses problemas, o Python forneceu stubs para essas ferramentas. Esses stubs sã o wrappers de script de
shell em torno das ferramentas subjacentes xcrun, distribuídos em uma pasta bin distribuída junto com a estrutura
iOS compilada. Esses scripts sã o relocá veis e sempre serã o resolvidos para os caminhos apropriados do sistema local.
Ao incluir esses scripts na pasta bin que acompanha um framework, o conteú do do mó dulo sysconfig se torna ú til

80 Capítulo 7. Usando Python no iOS

 Python Setup and Usage, Release 3.13.0

para usuá rios finais compilarem seus pró prios mó dulos. Ao compilar mó dulos Python de terceiros para iOS, você
deve garantir que esses biná rios stub estejam no seu caminho.

7.2 Instalando Python no iOS

7.2.1 Ferramentas para construir aplicações de iOS
A construçã o para iOS requer o uso das ferramentas Xcode da Apple. É altamente recomendá vel que você use a
versã o está vel mais recente do Xcode. Isso exigirá o uso da versã o mais recente (ou segunda) do macOS lançada
recentemente, já que a Apple nã o manté m o Xcode para versõ es mais antigas do macOS. As ferramentas de linha
de comando do Xcode nã o sã o suficientes para o desenvolvimento iOS; você precisa de uma instalaçã o completa do
Xcode.
Se quiser executar seu có digo no simulador iOS, você també m precisará instalar um iOS Simulator Platform. Você
deverá ser solicitado a selecionar um iOS Simulator Platform ao executar o Xcode pela primeira vez. Alternati-
vamente, você pode adicionar um iOS Simulator Platform selecionando na guia Platforms do painel Settings do
Xcode.

7.2.2 Adicionando Python a um projeto iOS

Python pode ser adicionado a qualquer projeto iOS, usando Swift ou Objective C. Os exemplos a seguir usarã o
Objective C; se você estiver usando Swift, poderá achar uma biblioteca como PythonKit ú til.
Para adicionar Python a um projeto Xcode de iOS:
1. Construa ou obtenha um XCFramework em Python. Veja as instruçõ es em iOS/README.rst (na distribuiçã o
fonte do CPython) para detalhes sobre como construir um XCFramework em Python. No mínimo, você pre-
cisará de uma construçã o que tenha suporte arm64-apple-ios, alé m de arm64-apple-ios-simulator
ou x86_64-apple-ios-simulator.
2. Arraste o XCframework para o seu projeto iOS. Nas instruçõ es a seguir, presumiremos que você colocou o
XCframework na raiz do seu projeto; no entanto, você pode usar qualquer outro local desejado ajustando os
caminhos conforme necessá rio.
3. Arraste o arquivo iOS/Resources/dylib-Info-template.plist para o seu projeto e certifique-se de
que ele esteja associado ao destino da aplicaçã o.
4. Adicione o có digo da sua aplicaçã o como uma pasta no seu projeto Xcode. Nas instruçõ es a seguir, presumire-
mos que seu có digo de usuá rio está em uma pasta chamada app na raiz do seu projeto; você pode usar qualquer
outro local ajustando os caminhos conforme necessá rio. Certifique-se de que esta pasta esteja associada ao
destino da sua aplicaçã o.
5. Selecione o destino da aplicaçã o selecionando o nó raiz do seu projeto Xcode e, em seguida, o nome do destino
na barra lateral que aparece.
6. Nas configuraçõ es de “General”, em “Frameworks, Libraries and Embedded Content”, adicione Python.
xcframework, com “Embed & Sign” selecionado.

7. Na guia “Build Settings”, modifique o seguinte:

• Build Options
– User Script Sandboxing: No
– Enable Testability: Yes
• Search Paths
– Framework Search Paths: $(PROJECT_DIR)
– Header Search Paths: "$(BUILT_PRODUCTS_DIR)/Python.framework/Headers"
• Apple Clang - Warnings - All languages
– Quoted Include In Framework Header: No

7.2. Instalando Python no iOS 81

Python Setup and Usage, Release 3.13.0

8. Adicione uma etapa de construçã o que copie a biblioteca padrã o do Python em sua aplicaçã o. Na aba “Build
Phases”, adicione uma nova etapa de construçã o “Run Script” antes da etapa “Embed Frameworks”, mas depois
da etapa “Copy Bundle Resources”. Nomeie a etapa como “Install Target Specific Python Standard Library”,
desative a caixa de seleçã o “Based on dependency analysis” e defina o conteú do do script como:

set -e

mkdir -p "$CODESIGNING_FOLDER_PATH/python/lib"
if [ "$EFFECTIVE_PLATFORM_NAME" = "-iphonesimulator" ]; then
echo "Instalando módulos Python para iOS Simulator"
rsync -au --delete "$PROJECT_DIR/Python.xcframework/ios-arm64_x86_64-
,→simulator/lib/" "$CODESIGNING_FOLDER_PATH/python/lib/"

else
echo "Instalando módulos Python para iOS Device"
rsync -au --delete "$PROJECT_DIR/Python.xcframework/ios-arm64/lib/" "
,→$CODESIGNING_FOLDER_PATH/python/lib/"

fi

Note que o nome da “fatia” do simulador no XCframework pode ser diferente, dependendo das arquiteturas
de CPU que seu XCFramework provê suporte.
9. Adicione uma segunda etapa de construçã o que processe os mó dulos de extensã o biná ria na biblioteca padrã o
no formato “Framework”. Adicione uma etapa de construçã o “Run Script” diretamente após aquela que você
adicionou na etapa 8, chamada “Prepare Python Binary Modules”. També m deve ter “Based on dependency
analysis” desmarcado, com o seguinte conteú do de script:

set -e

install_dylib () {
INSTALL_BASE=$1
FULL_EXT=$2

# O nome do arquivo da extensão

EXT=$(basename "$FULL_EXT")
# A localização do arquivo da extensão, relativo ao pacote
RELATIVE_EXT=${FULL_EXT#$CODESIGNING_FOLDER_PATH/}
# O caminho para o arquivo da extensão, relativo à base de instalação
PYTHON_EXT=${RELATIVE_EXT/$INSTALL_BASE/}
# O nome completo e pontilhado do módulo de extensão, construído a partir␣
,→do caminho do arquivo.

FULL_MODULE_NAME=$(echo $PYTHON_EXT | cut -d "." -f 1 | tr "/" ".");

# Um identificador de pacote; não é realmente usado, mas é necessário para␣
,→empacotamento de frameworks no Xcode

FRAMEWORK_BUNDLE_ID=$(echo $PRODUCT_BUNDLE_IDENTIFIER.$FULL_MODULE_NAME |␣
,→tr "_" "-")

# O nome da pasta do framework.

FRAMEWORK_FOLDER="Frameworks/$FULL_MODULE_NAME.framework"

# Se a pasta do framework não existir, cria-a.

if [ ! -d "$CODESIGNING_FOLDER_PATH/$FRAMEWORK_FOLDER" ]; then
echo "Criando framework para $RELATIVE_EXT"
mkdir -p "$CODESIGNING_FOLDER_PATH/$FRAMEWORK_FOLDER"
cp "$CODESIGNING_FOLDER_PATH/dylib-Info-template.plist" "$CODESIGNING_
,→FOLDER_PATH/$FRAMEWORK_FOLDER/Info.plist"

plutil -replace CFBundleExecutable -string "$FULL_MODULE_NAME" "

,→$CODESIGNING_FOLDER_PATH/$FRAMEWORK_FOLDER/Info.plist"

plutil -replace CFBundleIdentifier -string "$FRAMEWORK_BUNDLE_ID" "

,→$CODESIGNING_FOLDER_PATH/$FRAMEWORK_FOLDER/Info.plist"

(continua na pró xima pá gina)

82 Capítulo 7. Usando Python no iOS

 Python Setup and Usage, Release 3.13.0

(continuaçã o da pá gina anterior)

fi

echo "Instalando binário para $FRAMEWORK_FOLDER/$FULL_MODULE_NAME"

mv "$FULL_EXT" "$CODESIGNING_FOLDER_PATH/$FRAMEWORK_FOLDER/$FULL_MODULE_
,→NAME"

# Cria um arquivo substituto .fwork onde o .so estava

echo "$FRAMEWORK_FOLDER/$FULL_MODULE_NAME" > ${FULL_EXT%.so}.fwork
# Cria uma referência para o local do arquivo .so no framework
echo "${RELATIVE_EXT%.so}.fwork" > "$CODESIGNING_FOLDER_PATH/$FRAMEWORK_
,→FOLDER/$FULL_MODULE_NAME.origin"

PYTHON_VER=$(ls -1 "$CODESIGNING_FOLDER_PATH/python/lib")
echo "Instalando módulos de extensão da biblioteca padrão para Python $PYTHON_
,→VER..."

find "$CODESIGNING_FOLDER_PATH/python/lib/$PYTHON_VER/lib-dynload" -name "*.so

,→" | while read FULL_EXT; do

install_dylib python/lib/$PYTHON_VER/lib-dynload/ "$FULL_EXT"

done

# Remove o modelo dylib

rm -f "$CODESIGNING_FOLDER_PATH/dylib-Info-template.plist"

echo "Assinando frameworks como $EXPANDED_CODE_SIGN_IDENTITY_NAME ($EXPANDED_

,→CODE_SIGN_IDENTITY)..."

find "$CODESIGNING_FOLDER_PATH/Frameworks" -name "*.framework" -exec /usr/bin/

,→codesign --force --sign "$EXPANDED_CODE_SIGN_IDENTITY" ${OTHER_CODE_SIGN_

,→FLAGS:-} -o runtime --timestamp=none --preserve-metadata=identifier,

,→entitlements,flags --generate-entitlement-der "{}" \;

10. Adicione có digo Objective C para inicializar e usar um interpretador Python em modo embarcado. Você deve
garantir que:
• Modo UTF-8 esteja enabled;
• Buffered stdio esteja disabled;
• Escrita de bytecode esteja disabled;
• Manipuladores de sinais estejam enabled;
• PYTHONHOME para o interpretador esteja configurado para apontar para a subpasta python do
pacote da sua aplicaçã o; e
• O PYTHONPATH para o interpretador inclui:
– a subpasta python/lib/python3.X do pacote da sua aplicaçã o,
– a subpasta python/lib/python3.X/lib-dynload do pacote da sua aplicaçã o, e
– a subpasta app do pacote da sua aplicaçã o
O local do pacote da sua aplicaçã o pode ser determinada usando [[NSBundle mainBundle]
resourcePath].

Os passos 8, 9 e 10 destas instruçõ es presumem que você tem uma ú nica pasta de có digo de aplicaçã o Python
puro, chamada app. Se você tiver mó dulos biná rios de terceiros em sua aplicaçã o, serã o necessá rias algumas etapas
adicionais:
• Você precisa garantir que todas as pastas que contenham biná rios de terceiros sejam associadas ao destino
da aplicaçã o ou copiadas como parte da etapa 8. A etapa 8 també m deve limpar quaisquer biná rios que nã o
sejam apropriados para a plataforma que uma construçã o específica está direcionando (ou seja, exclua todos
os biná rios do dispositivo se estiver criando uma aplicaçã o direcionado ao simulador).

7.2. Instalando Python no iOS 83

Python Setup and Usage, Release 3.13.0

• Quaisquer pastas que contenham biná rios de terceiros devem ser processadas no formato framework no passo
9. A invocaçã o de install_dylib que processa a pasta lib-dynload pode ser copiada e adaptada para
este propó sito.
• Se você estiver usando uma pasta separada para pacotes de terceiros, certifique-se de que essa pasta esteja
incluída como parte da configuraçã o PYTHONPATH no passo 10.

7.3 Conformidade com a App Store

O ú nico mecanismo para distribuir aplicaçõ es para dispositivos iOS de terceiros é enviar a aplicaçã o para a App Store
do iOS; as aplicaçõ es enviadas para distribuiçã o devem passar pelo processo de revisã o de aplicaçõ es da Apple. Esse
processo inclui um conjunto de regras de validaçã o automatizadas que inspecionam o pacote de aplicaçã o enviado
em busca de có digo problemá tico.
A biblioteca padrã o do Python conté m alguns có digos que violam essas regras automatizadas. Embora essas viola-
çõ es pareçam ser falsos positivos, as regras de revisã o da Apple nã o podem ser contestadas; portanto, é necessá rio
modificar a biblioteca padrã o do Python para que uma aplicaçã o passe na revisã o da App Store.
A á rvore de fontes do Python conté m um arquivo de patch que removerá todo o có digo que é conhecido por causar
problemas no processo de revisã o da App Store. Este patch é aplicado automaticamente quando o ao construir para
o iOS.

84 Capítulo 7. Usando Python no iOS

 CAPÍTULO 8

Editores e IDEs

Há um grande nú mero de IDEs que suportam a linguagem de programaçã o Python. Vá rios editores e IDEs provê em
destaques coloridos de sintaxe, ferramentas de depuraçã o, e checagem do có digo frente à PEP 8.
Por favor, vá para Python Editors and Integrated Development Environments para obter uma lista completa.

85
Python Setup and Usage, Release 3.13.0

86 Capítulo 8. Editores e IDEs

 APÊNDICE A

Glossário

>>>
O prompt padrã o do console interativo do Python. Normalmente visto em exemplos de có digo que podem ser
executados interativamente no interpretador.
...
Pode se referir a:
• O prompt padrã o do console interativo do Python ao inserir o có digo para um bloco de có digo recuado,
quando dentro de um par de delimitadores correspondentes esquerdo e direito (parê nteses, colchetes,
chaves ou aspas triplas) ou apó s especificar um decorador.
• A constante embutida Ellipsis.
classe base abstrata
Classes bases abstratas complementam tipagem pato, fornecendo uma maneira de definir interfaces quando
outras té cnicas, como hasattr(), seriam desajeitadas ou sutilmente erradas (por exemplo, com mé todos
má gicos). CBAs introduzem subclasses virtuais, classes que nã o herdam de uma classe mas ainda sã o reconhe-
cidas por isinstance() e issubclass(); veja a documentaçã o do mó dulo abc. Python vem com muitas
CBAs embutidas para estruturas de dados (no mó dulo collections.abc), nú meros (no mó dulo numbers),
fluxos (no mó dulo io), localizadores e carregadores de importaçã o (no mó dulo importlib.abc). Você pode
criar suas pró prias CBAs com o mó dulo abc.
anotação
Um ró tulo associado a uma variá vel, um atributo de classe ou um parâ metro de funçã o ou valor de retorno,
usado por convençã o como dica de tipo.
Anotaçõ es de variá veis locais nã o podem ser acessadas em tempo de execuçã o, mas anotaçõ es de variá veis
globais, atributos de classe e funçõ es sã o armazenadas no atributo especial __annotations__ de mó dulos,
classes e funçõ es, respectivamente.
Veja anotação de variável, anotação de função, PEP 484 e PEP 526, que descrevem esta funcionalidade.
Veja també m annotations-howto para as melhores prá ticas sobre como trabalhar com anotaçõ es.
argumento
Um valor passado para uma função (ou método) ao chamar a funçã o. Existem dois tipos de argumento:
• argumento nomeado: um argumento precedido por um identificador (por exemplo, name=) na chamada
de uma funçã o ou passada como um valor em um dicioná rio precedido por **. Por exemplo, 3 e 5 sã o
ambos argumentos nomeados na chamada da funçã o complex() a seguir:

87
Python Setup and Usage, Release 3.13.0

complex(real=3, imag=5)
complex(**{'real': 3, 'imag': 5})

• argumento posicional: um argumento que nã o é um argumento nomeado. Argumentos posicionais po-
dem aparecer no início da lista de argumentos e/ou podem ser passados com elementos de um iterável
precedido por *. Por exemplo, 3 e 5 sã o ambos argumentos posicionais nas chamadas a seguir:

complex(3, 5)
complex(*(3, 5))

Argumentos sã o atribuídos à s variá veis locais nomeadas no corpo da funçã o. Veja a seçã o calls para as regras
de atribuiçã o. Sintaticamente, qualquer expressã o pode ser usada para representar um argumento; avaliada a
expressã o, o valor é atribuído à variá vel local.
Veja també m o termo parâmetro no glossá rio, a pergunta no FAQ sobre a diferença entre argumentos e parâ -
metros e PEP 362.
gerenciador de contexto assíncrono
Um objeto que controla o ambiente visto numa instruçã o async with por meio da definiçã o dos mé todos
__aenter__() e __aexit__(). Introduzido pela PEP 492.

gerador assíncrono
Uma funçã o que retorna um iterador gerador assíncrono. É parecida com uma funçã o de corrotina definida
com async def exceto pelo fato de conter instruçõ es yield para produzir uma sé rie de valores que podem
ser usados em um laço async for.
Normalmente se refere a uma funçã o geradora assíncrona, mas pode se referir a um iterador gerador assín-
crono em alguns contextos. Em casos em que o significado nã o esteja claro, usar o termo completo evita a
ambiguidade.
Uma funçã o geradora assíncrona pode conter expressõ es await e també m as instruçõ es async for e async
with.

iterador gerador assíncrono

Um objeto criado por uma funçã o geradora assíncrona.
Este é um iterador assíncrono que, quando chamado usando o mé todo __anext__(), retorna um objeto
aguardá vel que executará o corpo da funçã o geradora assíncrona até a pró xima expressã o yield.
Cada yield suspende temporariamente o processamento, lembrando o estado de execuçã o do local (incluindo
variá veis locais e instruçõ es try pendentes). Quando o iterador gerador assíncrono é efetivamente retomado
com outro aguardá vel retornado por __anext__(), ele inicia de onde parou. Veja PEP 492 e PEP 525.
iterável assíncrono
Um objeto que pode ser usado em uma instruçã o async for. Deve retornar um iterador assíncrono do seu
mé todo __aiter__(). Introduzido por PEP 492.
iterador assíncrono
Um objeto que implementa os mé todos __aiter__() e __anext__(). __anext__() deve retornar um
objeto aguardável. async for resolve os aguardá veis retornados por um mé todo __anext__() do iterador
assíncrono até que ele levante uma exceçã o StopAsyncIteration. Introduzido pela PEP 492.
atributo
Um valor associado a um objeto que é geralmente referenciado pelo nome separado por um ponto. Por exemplo,
se um objeto o tem um atributo a esse seria referenciado como o.a.
É possível dar a um objeto um atributo cujo nome nã o seja um identificador conforme definido por identifiers,
por exemplo usando setattr(), se o objeto permitir. Tal atributo nã o será acessível usando uma expressã o
pontilhada e, em vez disso, precisaria ser recuperado com getattr().
aguardável
Um objeto que pode ser usado em uma expressã o await. Pode ser uma corrotina ou um objeto com um
mé todo __await__(). Veja també m a PEP 492.

88 Apêndice A. Glossário
 Python Setup and Usage, Release 3.13.0

BDFL
Abreviaçã o da expressã o da língua inglesa “Benevolent Dictator for Life” (em portuguê s, “Ditador Benevolente
Vitalício”), referindo-se a Guido van Rossum, criador do Python.
arquivo binário
Um objeto arquivo capaz de ler e gravar em objetos bytes ou similar. Exemplos de arquivos biná rios sã o arquivos
abertos no modo biná rio ('rb', 'wb' ou 'rb+'), sys.stdin.buffer, sys.stdout.buffer, e instâ ncias
de io.BytesIO e gzip.GzipFile.
Veja també m arquivo texto para um objeto arquivo capaz de ler e gravar em objetos str.
referência emprestada
Na API C do Python, uma referê ncia emprestada é uma referê ncia a um objeto que nã o é dona da referê ncia.
Ela se torna um ponteiro solto se o objeto for destruído. Por exemplo, uma coleta de lixo pode remover a
ú ltima referência forte para o objeto e assim destruí-lo.
Chamar Py_INCREF() na referência emprestada é recomendado para convertê -lo, internamente, em uma
referência forte, exceto quando o objeto nã o pode ser destruído antes do ú ltimo uso da referê ncia emprestada.
A funçã o Py_NewRef() pode ser usada para criar uma nova referência forte.
objeto byte ou similar
Um objeto com suporte ao o bufferobjects e que pode exportar um buffer C contíguo. Isso inclui todos os
objetos bytes, bytearray e array.array, alé m de muitos objetos memoryview comuns. Objetos byte
ou similar podem ser usados para vá rias operaçõ es que funcionam com dados biná rios; isso inclui compactaçã o,
salvamento em um arquivo biná rio e envio por um soquete.
Algumas operaçõ es precisam que os dados biná rios sejam mutá veis. A documentaçã o geralmente se refere
a eles como “objetos byte ou similar para leitura e escrita”. Exemplos de objetos de buffer mutá vel incluem
bytearray e um memoryview de um bytearray. Outras operaçõ es exigem que os dados biná rios sejam
armazenados em objetos imutá veis (“objetos byte ou similar para somente leitura”); exemplos disso incluem
bytes e a memoryview de um objeto bytes.

bytecode
O có digo-fonte Python é compilado para bytecode, a representaçã o interna de um programa em Python no
interpretador CPython. O bytecode també m é mantido em cache em arquivos .pyc e .pyo, de forma que
executar um mesmo arquivo é mais rá pido na segunda vez (a recompilaçã o dos fontes para bytecode nã o é
necessá ria). Esta “linguagem intermediá ria” é adequada para execuçã o em uma máquina virtual, que executa
o có digo de má quina correspondente para cada bytecode. Tenha em mente que nã o se espera que bytecodes
sejam executados entre má quinas virtuais Python diferentes, nem que se mantenham está veis entre versõ es de
Python.
Uma lista de instruçõ es bytecode pode ser encontrada na documentaçã o para o mó dulo dis.
chamável
Um chamá vel é um objeto que pode ser chamado, possivelmente com um conjunto de argumentos (veja ar-
gumento), com a seguinte sintaxe:

chamavel(argumento1, argumento2, argumentoN)

Uma função, e por extensã o um método, é um chamá vel. Uma instâ ncia de uma classe que implementa o
mé todo __call__() també m é um chamá vel.
função de retorno
També m conhecida como callback, é uma funçã o sub-rotina que é passada como um argumento a ser executado
em algum ponto no futuro.
classe
Um modelo para criaçã o de objetos definidos pelo usuá rio. Definiçõ es de classe normalmente conté m defini-
çõ es de mé todos que operam sobre instâ ncias da classe.
variável de classe
Uma variá vel definida em uma classe e destinada a ser modificada apenas no nível da classe (ou seja, nã o em
uma instâ ncia da classe).

89
Python Setup and Usage, Release 3.13.0

variável de clausura
Uma variável livre referenciada de um escopo aninhado que é definida em um escopo externo em vez de ser
resolvida em tempo de execuçã o a partir dos espaços de nomes embutido ou globais. Pode ser explicitamente
definida com a palavra reservada nonlocal para permitir acesso de gravaçã o, ou implicitamente definida se
a variá vel estiver sendo somente lida.
Por exemplo, na funçã o interna no có digo a seguir, tanto x quanto print sã o variáveis livres, mas somente
x é uma variável de clausura:

def externa():
x = 0
def interna():
nonlocal x
x += 1
print(x)
return interna

Devido ao atributo codeobject.co_freevars (que, apesar do nome, inclui apenas os nomes das variá veis
de clausura em vez de listar todas as variá veis livres referenciadas), o termo mais geral variável livre à s vezes
é usado mesmo quando o significado pretendido é se referir especificamente à s variá veis de clausura.
número complexo
Uma extensã o ao familiar sistema de nú meros reais em que todos os nú meros sã o expressos como uma soma
de uma parte real e uma parte imaginá ria. Nú meros imaginá rios sã o mú ltiplos reais da unidade imaginá ria
(a raiz quadrada de -1), normalmente escrita como i em matemá tica ou j em engenharia. O Python tem
suporte nativo para nú meros complexos, que sã o escritos com esta ú ltima notaçã o; a parte imaginá ria escrita
com um sufixo j, p.ex., 3+1j. Para ter acesso aos equivalentes para nú meros complexos do mó dulo math,
utilize cmath. O uso de nú meros complexos é uma funcionalidade matemá tica bastante avançada. Se você
nã o sabe se irá precisar deles, é quase certo que você pode ignorá -los sem problemas.
contexto
Este termo tem diferentes significados dependendo de onde e como ele é usado. Alguns significados comuns:
• O estado ou ambiente temporá rio estabelecido por um gerenciador de contexto por meio de uma instruçã o
with.

• A coleçã o de ligaçõ es de chave-valor associadas a um objeto contextvars.Context específico e

acessadas por meio de objetos ContextVar. Veja també m variável de contexto.
• Um objeto contextvars.Context. Veja també m contexto atual.
protocolo de gerenciamento de contexto
Os mé todos __enter__() e __exit__() chamados pela instruçã o with. Veja PEP 343.
gerenciador de contexto
Um objeto que implementa o protocolo de gerenciamento de contexto e controla o ambiente visto em uma
instruçã o with. Veja PEP 343.
variável de contexto
Uma variá vel cujo valor depende de qual contexto é o contexto atual. Os valores sã o acessados por meio de
objetos contextvars.ContextVar. Variá veis de contexto sã o usadas principalmente para isolar o estado
entre tarefas assíncronas simultâ neas.
contíguo
Um buffer é considerado contíguo exatamente se for contíguo C ou contíguo Fortran. Os buffers de dimensã o
zero sã o contíguos C e Fortran. Em vetores unidimensionais, os itens devem ser dispostos na memó ria pró ximos
um do outro, em ordem crescente de índices, começando do zero. Em vetores multidimensionais contíguos C,
o ú ltimo índice varia mais rapidamente ao visitar itens em ordem de endereço de memó ria. No entanto, nos
vetores contíguos do Fortran, o primeiro índice varia mais rapidamente.
corrotina
Corrotinas sã o uma forma mais generalizada de sub-rotinas. Sub-rotinas tem a entrada iniciada em um ponto,
e a saída em outro ponto. Corrotinas podem entrar, sair, e continuar em muitos pontos diferentes. Elas podem
ser implementadas com a instruçã o async def. Veja també m PEP 492.

90 Apêndice A. Glossário
 Python Setup and Usage, Release 3.13.0

função de corrotina
Uma funçã o que retorna um objeto do tipo corrotina. Uma funçã o de corrotina pode ser definida com a instru-
çã o async def, e pode conter as palavras chaves await, async for, e async with. Isso foi introduzido
pela PEP 492.
CPython
A implementaçã o canô nica da linguagem de programaçã o Python, como disponibilizada pelo python.org.
O termo “CPython” é usado quando necessá rio distinguir esta implementaçã o de outras como Jython ou
IronPython.
contexto atual
O contexto (objeto contextvars.Context) que é usado atualmente pelos objetos ContextVar para acessar
(obter ou definir) os valores de variáveis de contexto. Cada thread tem seu pró prio contexto atual. Frameworks
para executar tarefas assíncronas (veja asyncio) associam cada tarefa a um contexto que se torna o contexto
atual sempre que a tarefa inicia ou retoma a execuçã o.
decorador
Uma funçã o que retorna outra funçã o, geralmente aplicada como uma transformaçã o de funçã o usando a
sintaxe @wrapper. Exemplos comuns para decoradores sã o classmethod() e staticmethod().
A sintaxe do decorador é meramente um açú car sintá tico, as duas definiçõ es de funçõ es a seguir sã o semanti-
camente equivalentes:

def f(arg):
...
f = staticmethod(f)

@staticmethod
def f(arg):
...

O mesmo conceito existe para as classes, mas nã o é comumente utilizado. Veja a documentaçã o de definiçõ es
de funçã o e definiçõ es de classe para obter mais informaçõ es sobre decoradores.
descritor
Qualquer objeto que define os mé todos __get__(), __set__() ou __delete__(). Quando um atributo
de classe é um descritor, seu comportamento de associaçã o especial é acionado no acesso a um atributo.
Normalmente, ao se utilizar a.b para se obter, definir ou excluir, um atributo dispara uma busca no objeto
chamado b no dicioná rio de classe de a, mas se b for um descritor, o respectivo mé todo descritor é chamado.
Compreender descritores é a chave para um profundo entendimento de Python pois eles sã o a base de muitas
funcionalidades incluindo funçõ es, mé todos, propriedades, mé todos de classe, mé todos está ticos e referê ncias
para superclasses.
Para obter mais informaçõ es sobre os mé todos dos descritores, veja: descriptors ou o Guia de Descritores.
dicionário
Um vetor associativo em que chaves arbitrá rias sã o mapeadas para valores. As chaves podem ser quaisquer
objetos que possuam os mé todos __hash__() e __eq__(). Isso é chamado de hash em Perl.
compreensão de dicionário
Uma maneira compacta de processar todos ou parte dos elementos de um iterá vel e retornar um dicioná rio com
os resultados. results = {n: n ** 2 for n in range(10)} gera um dicioná rio contendo a chave n
mapeada para o valor n ** 2. Veja comprehensions.
visão de dicionário
Os objetos retornados por dict.keys(), dict.values() e dict.items() sã o chamados de visõ es de
dicioná rio. Eles fornecem uma visã o dinâ mica das entradas do dicioná rio, o que significa que quando o di-
cioná rio é alterado, a visã o reflete essas alteraçõ es. Para forçar a visã o de dicioná rio a se tornar uma lista
completa use list(dictview). Veja dict-views.
docstring
Abreviatura de “documentation string” (string de documentaçã o). Uma string literal que aparece como pri-
meira expressã o numa classe, funçã o ou mó dulo. Ainda que sejam ignoradas quando a suíte é executada, é

91
Python Setup and Usage, Release 3.13.0

reconhecida pelo compilador que a coloca no atributo __doc__ da classe, funçã o ou mó dulo que a encapsula.
Como ficam disponíveis por meio de introspecçã o, docstrings sã o o lugar canô nico para documentaçã o do
objeto.
tipagem pato
També m conhecida como duck-typing, é um estilo de programaçã o que nã o verifica o tipo do objeto para
determinar se ele possui a interface correta; em vez disso, o mé todo ou atributo é simplesmente chamado
ou utilizado (“Se se parece com um pato e grasna como um pato, entã o deve ser um pato.”) Enfatizando
interfaces ao invé s de tipos específicos, o có digo bem desenvolvido aprimora sua flexibilidade por permitir
substituiçã o polimó rfica. Tipagem pato evita necessidade de testes que usem type() ou isinstance().
(Note, poré m, que a tipagem pato pode ser complementada com o uso de classes base abstratas.) Ao invé s
disso, sã o normalmente empregados testes hasattr() ou programaçã o EAFP.
EAFP
Iniciais da expressã o em inglê s “easier to ask for forgiveness than permission” que significa “é mais fá cil pedir
perdã o que permissã o”. Este estilo de codificaçã o comum no Python presume a existê ncia de chaves ou atribu-
tos vá lidos e captura exceçõ es caso essa premissa se prove falsa. Este estilo limpo e rá pido se caracteriza pela
presença de vá rias instruçõ es try e except. A té cnica diverge do estilo LBYL, comum em outras linguagens
como C, por exemplo.
expressão
Uma parte da sintaxe que pode ser avaliada para algum valor. Em outras palavras, uma expressã o é a acumula-
çã o de elementos de expressã o como literais, nomes, atributos de acesso, operadores ou chamadas de funçõ es,
todos os quais retornam um valor. Em contraste com muitas outras linguagens, nem todas as construçõ es
de linguagem sã o expressõ es. També m existem instruções, as quais nã o podem ser usadas como expressõ es,
como, por exemplo, while. Atribuiçõ es també m sã o instruçõ es, nã o expressõ es.
módulo de extensão
Um mó dulo escrito em C ou C++, usando a API C do Python para interagir tanto com có digo de usuá rio
quanto do nú cleo.
f-string
Literais string prefixadas com 'f' ou 'F' sã o conhecidas como “f-strings” que é uma abreviaçã o de formatted
string literals. Veja també m PEP 498.
objeto arquivo
Um objeto que expõ e uma API orientada a arquivos (com mé todos tais como read() ou write()) para
um recurso subjacente. Dependendo da maneira como foi criado, um objeto arquivo pode mediar o acesso a
um arquivo real no disco ou outro tipo de dispositivo de armazenamento ou de comunicaçã o (por exemplo a
entrada/saída padrã o, buffers em memó ria, soquetes, pipes, etc.). Objetos arquivo també m sã o chamados de
objetos arquivo ou similares ou fluxos.
Atualmente há trê s categorias de objetos arquivo: arquivos binários brutos, arquivos binários em buffer e
arquivos textos. Suas interfaces estã o definidas no mó dulo io. A forma canô nica para criar um objeto arquivo
é usando a funçã o open().
objeto arquivo ou similar
Um sinô nimo do termo objeto arquivo.
tratador de erros e codificação do sistema de arquivos
Tratador de erros e codificaçã o usado pelo Python para decodificar bytes do sistema operacional e codificar
Unicode para o sistema operacional.
A codificaçã o do sistema de arquivos deve garantir a decodificaçã o bem-sucedida de todos os bytes abaixo
de 128. Se a codificaçã o do sistema de arquivos falhar em fornecer essa garantia, as funçõ es da API podem
levantar UnicodeError.
As funçõ es sys.getfilesystemencoding() e sys.getfilesystemencodeerrors() podem ser usa-
das para obter o tratador de erros e codificaçã o do sistema de arquivos.
O tratador de erros e codificação do sistema de arquivos sã o configurados na inicializaçã o do Python pela funçã o
PyConfig_Read(): veja os membros filesystem_encoding e filesystem_errors do PyConfig.

Veja també m codificação da localidade.

92 Apêndice A. Glossário
 Python Setup and Usage, Release 3.13.0

localizador
Um objeto que tenta encontrar o carregador para um mó dulo que está sendo importado.
Existem dois tipos de localizador: localizadores de metacaminho para uso com sys.meta_path, e localiza-
dores de entrada de caminho para uso com sys.path_hooks.
Veja finders-and-loaders e importlib para muito mais detalhes.
divisão pelo piso
Divisã o matemá tica que arredonda para baixo para o inteiro mais pró ximo. O operador de divisã o pelo piso é
//. Por exemplo, a expressã o 11 // 4 retorna o valor 2 ao invé s de 2.75, que seria retornado pela divisã o
de ponto flutuante. Note que (-11) // 4 é -3 porque é -2.75 arredondado para baixo. Consulte a PEP
238.
threads livres
Um modelo de threads onde mú ltiplas threads podem simultaneamente executar bytecode Python no mesmo
interpretador. Isso está em contraste com a trava global do interpretador que permite apenas uma thread por
vez executar bytecode Python. Veja PEP 703.
variável livre
Formalmente, conforme definido no modelo de execuçã o de linguagem, uma variá vel livre é qualquer variá vel
usada em um espaço de nomes que nã o seja uma variá vel local naquele espaço de nomes. Veja variável de
clausura para um exemplo. Pragmaticamente, devido ao nome do atributo codeobject.co_freevars, o
termo també m é usado algumas vezes como sinô nimo de variável de clausura.
função
Uma sé rie de instruçõ es que retorna algum valor para um chamador. També m pode ser passado zero ou mais
argumentos que podem ser usados na execuçã o do corpo. Veja també m parâmetro, método e a seçã o function.
anotação de função
Uma anotação de um parâ metro de funçã o ou valor de retorno.
Anotaçõ es de funçã o sã o comumente usados por dicas de tipo: por exemplo, essa funçã o espera receber dois
argumentos int e també m é esperado que devolva um valor int:

def soma_dois_numeros(a: int, b: int) -> int:

return a + b

A sintaxe de anotaçã o de funçã o é explicada na seçã o function.

Veja anotação de variável e PEP 484, que descrevem esta funcionalidade. Veja també m annotations-howto
para as melhores prá ticas sobre como trabalhar com anotaçõ es.
__future__
A instruçã o future, from __future__ import <feature>, direciona o compilador a compilar o mó dulo
atual usando sintaxe ou semâ ntica que será padrã o em uma versã o futura de Python. O mó dulo __future__
documenta os possíveis valores de feature. Importando esse mó dulo e avaliando suas variá veis, você pode ver
quando um novo recurso foi inicialmente adicionado à linguagem e quando será (ou se já é ) o padrã o:

>>> import __future__

>>> __future__.division
_Feature((2, 2, 0, 'alpha', 2), (3, 0, 0, 'alpha', 0), 8192)

coleta de lixo
També m conhecido como garbage collection, é o processo de liberar a memó ria quando ela nã o é mais utilizada.
Python executa a liberaçã o da memó ria atravé s da contagem de referê ncias e um coletor de lixo cíclico que é
capaz de detectar e interromper referê ncias cíclicas. O coletor de lixo pode ser controlado usando o mó dulo
gc.

gerador
Uma funçã o que retorna um iterador gerador. É parecida com uma funçã o normal, exceto pelo fato de conter
expressõ es yield para produzir uma sé rie de valores que podem ser usados em um laço “for” ou que podem
ser obtidos um de cada vez com a funçã o next().

93
Python Setup and Usage, Release 3.13.0

Normalmente refere-se a uma funçã o geradora, mas pode referir-se a um iterador gerador em alguns contextos.
Em alguns casos onde o significado desejado nã o está claro, usar o termo completo evita ambiguidade.
iterador gerador
Um objeto criado por uma funçã o geradora.
Cada yield suspende temporariamente o processamento, memorizando o estado da execuçã o local (incluindo
variá veis locais e instruçõ es try pendentes). Quando o iterador gerador retorna, ele se recupera do ú ltimo ponto
onde estava (em contrapartida as funçõ es que iniciam uma nova execuçã o a cada vez que sã o invocadas).
expressão geradora
Uma expressão que retorna um iterador. Parece uma expressã o normal, seguido de uma clá usula for definindo
uma variá vel de laço, um intervalo, e uma clá usula if opcional. A expressã o combinada gera valores para uma
funçã o encapsuladora:

>>> sum(i*i for i in range(10)) # soma dos quadrados 0, 1, 4, ... 81

285

função genérica
Uma funçã o composta por vá rias funçõ es implementando a mesma operaçã o para diferentes tipos. Qual im-
plementaçã o deverá ser usada durante a execuçã o é determinada pelo algoritmo de despacho.
Veja també m a entrada despacho único no glossá rio, o decorador functools.singledispatch(), e a PEP
443.
tipo genérico
Um tipo que pode ser parametrizado; tipicamente uma classe contê iner tal como list ou dict. Usado para
dicas de tipo e anotações.
Para mais detalhes, veja tipo apelido gené rico, PEP 483, PEP 484, PEP 585, e o mó dulo typing.
GIL
Veja trava global do interpretador.
trava global do interpretador
O mecanismo utilizado pelo interpretador CPython para garantir que apenas uma thread execute o bytecode
Python por vez. Isto simplifica a implementaçã o do CPython ao fazer com que o modelo de objetos (incluindo
tipos embutidos críticos como o dict) ganhem segurança implícita contra acesso concorrente. Travar todo o
interpretador facilita que o interpretador em si seja multitarefa, à s custas de muito do paralelismo já provido
por má quinas multiprocessador.
No entanto, alguns mó dulos de extensã o, tanto da biblioteca padrã o quanto de terceiros, sã o desenvolvidos de
forma a liberar a GIL ao realizar tarefas computacionalmente muito intensas, como compactaçã o ou cá lculos
de hash. Alé m disso, a GIL é sempre liberado nas operaçõ es de E/S.
A partir de Python 3.13, o GIL pode ser desabilitado usando a configuraçã o de construçã o --disable-gil.
Depois de construir Python com essa opçã o, o có digo deve ser executado com a opçã o -X gil=0 ou a variá vel
de ambiente PYTHON_GIL=0 deve estar definida. Esse recurso provê um desempenho melhor para aplicaçõ es
com mú ltiplas threads e torna mais fá cil o uso eficiente de CPUs com mú ltiplos nú cleos. Para mais detalhes,
veja PEP 703.
pyc baseado em hash
Um arquivo de cache em bytecode que usa hash ao invé s do tempo, no qual o arquivo de có digo-fonte foi
modificado pela ú ltima vez, para determinar a sua validade. Veja pyc-invalidation.
hasheável
Um objeto é hasheável se tem um valor de hash que nunca muda durante seu ciclo de vida (precisa ter um
mé todo __hash__()) e pode ser comparado com outros objetos (precisa ter um mé todo __eq__()). Objetos
hasheá veis que sã o comparados como iguais devem ter o mesmo valor de hash.
A hasheabilidade faz com que um objeto possa ser usado como uma chave de dicioná rio e como um membro
de conjunto, pois estas estruturas de dados utilizam os valores de hash internamente.
A maioria dos objetos embutidos imutá veis do Python sã o hasheá veis; containers mutá veis (tais como listas
ou dicioná rios) nã o sã o; containers imutá veis (tais como tuplas e frozensets) sã o hasheá veis apenas se os seus

94 Apêndice A. Glossário
 Python Setup and Usage, Release 3.13.0

elementos sã o hasheá veis. Objetos que sã o instâ ncias de classes definidas pelo usuá rio sã o hasheá veis por
padrã o. Todos eles comparam de forma desigual (exceto entre si mesmos), e o seu valor hash é derivado a
partir do seu id().
IDLE
Um ambiente de desenvolvimento e aprendizado integrado para Python. idle é um editor bá sico e um ambiente
interpretador que vem junto com a distribuiçã o padrã o do Python.
imortal
Objetos imortais sã o um detalhe da implementaçã o do CPython introduzida na PEP 683.
Se um objeto é imortal, sua contagem de referências nunca é modificada e, portanto, nunca é desalocado en-
quanto o interpretador está em execuçã o. Por exemplo, True e None sã o imortais no CPython.
imutável
Um objeto que possui um valor fixo. Objetos imutá veis incluem nú meros, strings e tuplas. Estes objetos nã o
podem ser alterados. Um novo objeto deve ser criado se um valor diferente tiver de ser armazenado. Objetos
imutá veis tê m um papel importante em lugares onde um valor constante de hash seja necessá rio, como por
exemplo uma chave em um dicioná rio.
caminho de importação
Uma lista de localizaçõ es (ou entradas de caminho) que sã o buscadas pelo localizador baseado no caminho por
mó dulos para importar. Durante a importaçã o, esta lista de localizaçõ es usualmente vem a partir de sys.path,
mas para subpacotes ela també m pode vir do atributo __path__ de pacotes-pai.
importação
O processo pelo qual o có digo Python em um mó dulo é disponibilizado para o có digo Python em outro mó dulo.
importador
Um objeto que localiza e carrega um mó dulo; Tanto um localizador e o objeto carregador.
interativo
Python tem um interpretador interativo, o que significa que você pode digitar instruçõ es e expressõ es no prompt
do interpretador, executá -los imediatamente e ver seus resultados. Apenas execute python sem argumentos
(possivelmente selecionando-o a partir do menu de aplicaçõ es de seu sistema operacional). O interpretador
interativo é uma maneira poderosa de testar novas ideias ou aprender mais sobre mó dulos e pacotes (lembre-se
do comando help(x)). Para saber mais sobre modo interativo, veja tut-interac.
interpretado
Python é uma linguagem interpretada, em oposiçã o à quelas que sã o compiladas, embora esta distinçã o possa
ser nebulosa devido à presença do compilador de bytecode. Isto significa que os arquivos-fontes podem ser
executados diretamente sem necessidade explícita de se criar um arquivo executá vel. Linguagens interpretadas
normalmente tê m um ciclo de desenvolvimento/depuraçã o mais curto que as linguagens compiladas, apesar
de seus programas geralmente serem executados mais lentamente. Veja també m interativo.
desligamento do interpretador
Quando solicitado para desligar, o interpretador Python entra em uma fase especial, onde ele gradualmente
libera todos os recursos alocados, tais como mó dulos e vá rias estruturas internas críticas. Ele també m faz
diversas chamadas para o coletor de lixo. Isto pode disparar a execuçã o de có digo em destrutores definidos
pelo usuá rio ou funçã o de retorno de referê ncia fraca. Có digo executado durante a fase de desligamento pode
encontrar diversas exceçõ es, pois os recursos que ele depende podem nã o funcionar mais (exemplos comuns
sã o os mó dulos de bibliotecas, ou os mecanismos de avisos).
A principal razã o para o interpretador desligar, é que o mó dulo __main__ ou o script sendo executado ter-
minou sua execuçã o.
iterável
Um objeto capaz de retornar seus membros um de cada vez. Exemplos de iterá veis incluem todos os tipos de
sequê ncia (tais como list, str e tuple) e alguns tipos de nã o-sequê ncia, como o dict, objetos arquivos,
alé m dos objetos de quaisquer classes que você definir com um mé todo __iter__() ou __getitem__()
que implementam a semâ ntica de sequência .
Iterá veis podem ser usados em um laço for e em vá rios outros lugares em que uma sequê ncia é necessá ria
(zip(), map(), …). Quando um objeto iterá vel é passado como argumento para a funçã o embutida iter(),
ela retorna um iterador para o objeto. Este iterador é adequado para se varrer todo o conjunto de valores. Ao

95
Python Setup and Usage, Release 3.13.0

usar iterá veis, normalmente nã o é necessá rio chamar iter() ou lidar com os objetos iteradores em si. A
instruçã o for faz isso automaticamente para você , criando uma variá vel temporá ria para armazenar o iterador
durante a execuçã o do laço. Veja també m iterador, sequência, e gerador.
iterador
Um objeto que representa um fluxo de dados. Repetidas chamadas ao mé todo __next__() de um iterador
(ou passando o objeto para a funçã o embutida next()) vã o retornar itens sucessivos do fluxo. Quando nã o
houver mais dados disponíveis uma exceçã o StopIteration será levantada. Neste ponto, o objeto iterador
se esgotou e quaisquer chamadas subsequentes a seu mé todo __next__() vã o apenas levantar a exceçã o
StopIteration novamente. Iteradores precisam ter um mé todo __iter__() que retorne o objeto iterador
em si, de forma que todo iterador també m é iterá vel e pode ser usado na maioria dos lugares em que um iterá vel
é requerido. Uma notá vel exceçã o é có digo que tenta realizar passagens em mú ltiplas iteraçõ es. Um objeto
contê iner (como uma list) produz um novo iterador a cada vez que você passá -lo para a funçã o iter() ou
utilizá -lo em um laço for. Tentar isso com o mesmo iterador apenas iria retornar o mesmo objeto iterador
esgotado já utilizado na iteraçã o anterior, como se fosse um contê iner vazio.
Mais informaçõ es podem ser encontradas em typeiter.
Detalhes da implementação do CPython: O CPython nã o aplica consistentemente o requisito de que um
iterador defina __iter__(). E també m observe que o CPython com threads livres nã o garante a segurança
do thread das operaçõ es do iterador.
função chave
Uma funçã o chave ou funçã o colaçã o é um chamá vel que retorna um valor usado para ordenaçã o ou classifi-
caçã o. Por exemplo, locale.strxfrm() é usada para produzir uma chave de ordenaçã o que leva o locale
em consideraçã o para fins de ordenaçã o.
Uma porçã o de ferramentas no Python aceitam funçõ es chave para controlar como os elementos sã o orde-
nados ou agrupados. Algumas delas incluem min(), max(), sorted(), list.sort(), heapq.merge(),
heapq.nsmallest(), heapq.nlargest() e itertools.groupby().
Há vá rias maneiras de se criar funçõ es chave. Por exemplo, o mé todo str.lower() pode servir como uma
funçã o chave para ordenaçõ es insensíveis à caixa. Alternativamente, uma funçã o chave ad-hoc pode ser cons-
truída a partir de uma expressã o lambda, como lambda r: (r[0], r[2]). Alé m disso, operator.
attrgetter(), operator.itemgetter() e operator.methodcaller() sã o trê s construtores de fun-
çã o chave. Consulte o guia de Ordenaçã o para ver exemplos de como criar e utilizar funçõ es chave.
argumento nomeado
Veja argumento.
lambda
Uma funçã o de linha anô nima consistindo de uma ú nica expressão, que é avaliada quando a funçã o é chamada.
A sintaxe para criar uma funçã o lambda é lambda [parameters]: expression
LBYL
Iniciais da expressã o em inglê s “look before you leap”, que significa algo como “olhe antes de pisar”. Este estilo
de codificaçã o testa as pré -condiçõ es explicitamente antes de fazer chamadas ou buscas. Este estilo contrasta
com a abordagem EAFP e é caracterizada pela presença de muitas instruçõ es if.
Em um ambiente multithread, a abordagem LBYL pode arriscar a introduçã o de uma condiçã o de corrida
entre “o olhar” e “o pisar”. Por exemplo, o có digo if key in mapping: return mapping[key] pode
falhar se outra thread remover key do mapping apó s o teste, mas antes da olhada. Esse problema pode ser
resolvido com travas ou usando a abordagem EAFP.
lista
Uma sequência embutida no Python. Apesar do seu nome, é mais pró ximo de um vetor em outras linguagens
do que uma lista encadeada, como o acesso aos elementos é da ordem O(1).
compreensão de lista
Uma maneira compacta de processar todos ou parte dos elementos de uma sequê ncia e retornar os resultados
em uma lista. result = ['{:#04x}'.format(x) for x in range(256) if x % 2 == 0] gera
uma lista de strings contendo nú meros hexadecimais (0x..) no intervalo de 0 a 255. A clá usula if é opcional.
Se omitida, todos os elementos no range(256) serã o processados.

96 Apêndice A. Glossário
 Python Setup and Usage, Release 3.13.0

carregador
Um objeto que carrega um mó dulo. Deve definir um mé todo chamado load_module(). Um carregador é
normalmente devolvido por um localizador. Veja també m:
• finders-and-loaders
• importlib.abc.Loader
• PEP 302
codificação da localidade
No Unix, é a codificaçã o da localidade do LC_CTYPE, que pode ser definida com locale.
setlocale(locale.LC_CTYPE, new_locale).

No Windows, é a pá gina de có digo ANSI (ex: "cp1252").

No Android e no VxWorks, o Python usa "utf-8" como a codificaçã o da localidade.
locale.getencoding() pode ser usado para obter a codificaçã o da localidade.
Veja també m tratador de erros e codificação do sistema de arquivos.
método mágico
Um sinô nimo informal para um método especial.
mapeamento
Um objeto contê iner que tem suporte a pesquisas de chave arbitrá ria e implementa os mé todos especificados nas
collections.abc.Mapping ou collections.abc.MutableMapping classes base abstratas. Exemplos
incluem dict, collections.defaultdict, collections.OrderedDict e collections.Counter.
localizador de metacaminho
Um localizador retornado por uma busca de sys.meta_path. Localizadores de metacaminho sã o relaciona-
dos a, mas diferentes de, localizadores de entrada de caminho.
Veja importlib.abc.MetaPathFinder para os mé todos que localizadores de metacaminho implementam.
metaclasse
A classe de uma classe. Definiçõ es de classe criam um nome de classe, um dicioná rio de classe e uma lista
de classes base. A metaclasse é responsá vel por receber estes trê s argumentos e criar a classe. A maioria das
linguagens de programaçã o orientadas a objetos provê uma implementaçã o default. O que torna o Python
especial é o fato de ser possível criar metaclasses personalizadas. A maioria dos usuá rios nunca vai preci-
sar deste recurso, mas quando houver necessidade, metaclasses possibilitam soluçõ es poderosas e elegantes.
Metaclasses tê m sido utilizadas para gerar registros de acesso a atributos, para incluir proteçã o contra acesso
concorrente, rastrear a criaçã o de objetos, implementar singletons, dentre muitas outras tarefas.
Mais informaçõ es podem ser encontradas em metaclasses.
método
Uma funçã o que é definida dentro do corpo de uma classe. Se chamada como um atributo de uma instâ ncia
daquela classe, o mé todo receberá a instâ ncia do objeto como seu primeiro argumento (que comumente é
chamado de self). Veja função e escopo aninhado.
ordem de resolução de métodos
Ordem de resoluçã o de mé todos é a ordem em que os membros de uma classe base sã o buscados durante a
pesquisa. Veja python_2.3_mro para detalhes do algoritmo usado pelo interpretador do Python desde a versã o
2.3.
módulo
Um objeto que serve como uma unidade organizacional de có digo Python. Os mó dulos tê m um espaço de
nomes contendo objetos Python arbitrá rios. Os mó dulos sã o carregados pelo Python atravé s do processo de
importação.
Veja també m pacote.
especificação do módulo
Um espaço de nomes que conté m as informaçõ es relacionadas à importaçã o usadas para carregar um mó dulo.
Uma instâ ncia de importlib.machinery.ModuleSpec.

97
Python Setup and Usage, Release 3.13.0

Veja també m module-specs.

MRO
Veja ordem de resolução de métodos.
mutável
Objeto mutá vel é aquele que pode modificar seus valor mas manter seu id(). Veja també m imutável.
tupla nomeada
O termo “tupla nomeada” é aplicado a qualquer tipo ou classe que herda de tupla e cujos elementos indexá veis
també m sã o acessíveis usando atributos nomeados. O tipo ou classe pode ter outras funcionalidades també m.
Diversos tipos embutidos sã o tuplas nomeadas, incluindo os valores retornados por time.localtime() e
os.stat(). Outro exemplo é sys.float_info:

>>> sys.float_info[1] # acesso indexado

1024
>>> sys.float_info.max_exp # acesso a campo nomeado
1024
>>> isinstance(sys.float_info, tuple) # tipo de tupla
True

Algumas tuplas nomeadas sã o tipos embutidos (tal como os exemplos acima). Alternativamente, uma tupla
nomeada pode ser criada a partir de uma definiçã o de classe regular, que herde de tuple e que defina campos
nomeados. Tal classe pode ser escrita a mã o, ou ela pode ser criada herdando typing.NamedTuple ou com
uma funçã o fá brica collections.namedtuple(). As duas ú ltimas té cnicas també m adicionam alguns
mé todos extras, que podem nã o ser encontrados quando foi escrita manualmente, ou em tuplas nomeadas
embutidas.
espaço de nomes
O lugar em que uma variá vel é armazenada. Espaços de nomes sã o implementados como dicioná rios. Exis-
tem os espaços de nomes local, global e nativo, bem como espaços de nomes aninhados em objetos (em
mé todos). Espaços de nomes suportam modularidade ao prevenir conflitos de nomes. Por exemplo, as fun-
çõ es __builtin__.open() e os.open() sã o diferenciadas por seus espaços de nomes. Espaços de nomes
també m auxiliam na legibilidade e na manutenibilidade ao torar mais claro quais mó dulos implementam uma
funçã o. Escrever random.seed() ou itertools.izip(), por exemplo, deixa claro que estas funçõ es sã o
implementadas pelos mó dulos random e itertools respectivamente.
pacote de espaço de nomes
Um pacote da PEP 420 que serve apenas como container para sub pacotes. Pacotes de espaços de nomes
podem nã o ter representaçã o física, e especificamente nã o sã o como um pacote regular porque eles nã o tem
um arquivo __init__.py.
Veja també m módulo.
escopo aninhado
A habilidade de referir-se a uma variá vel em uma definiçã o de fechamento. Por exemplo, uma funçã o definida
dentro de outra pode referenciar variá veis da funçã o externa. Perceba que escopos aninhados por padrã o
funcionam apenas por referê ncia e nã o por atribuiçã o. Variá veis locais podem ler e escrever no escopo mais
interno. De forma similar, variá veis globais podem ler e escrever para o espaço de nomes global. O nonlocal
permite escrita para escopos externos.
classe estilo novo
Antigo nome para o tipo de classes agora usado para todos os objetos de classes. Em versõ es anteriores
do Python, apenas classes estilo podiam usar recursos novos e versá teis do Python, tais como __slots__,
descritores, propriedades, __getattribute__(), mé todos de classe, e mé todos está ticos.
objeto
Qualquer dado que tenha estado (atributos ou valores) e comportamento definidos (mé todos). També m a
ú ltima classe base de qualquer classe estilo novo.
escopo otimizado
Um escopo no qual os nomes das variá veis locais de destino sã o conhecidos de forma confiá vel pelo compi-
lador quando o có digo é compilado, permitindo a otimizaçã o do acesso de leitura e gravaçã o a esses nomes.

98 Apêndice A. Glossário
 Python Setup and Usage, Release 3.13.0

Os espaços de nomes locais para funçõ es, geradores, corrotinas, compreensõ es e expressõ es geradoras sã o
otimizados desta forma. Nota: a maioria das otimizaçõ es de interpretador sã o aplicadas a todos os escopos,
apenas aquelas que dependem de um conjunto conhecido de nomes de variá veis locais e nã o locais sã o restritas
a escopos otimizados.
pacote
Um módulo Python é capaz de conter submó dulos ou recursivamente, subpacotes. Tecnicamente, um pacote
é um mó dulo Python com um atributo __path__.
Veja també m pacote regular e pacote de espaço de nomes.
parâmetro
Uma entidade nomeada na definiçã o de uma função (ou mé todo) que específica um argumento (ou em alguns
casos, argumentos) que a funçã o pode receber. Existem cinco tipos de parâ metros:
• posicional-ou-nomeado: especifica um argumento que pode ser tanto posicional quanto nomeado. Esse
é o tipo padrã o de parâ metro, por exemplo foo e bar a seguir:

def func(foo, bar=None): ...

• somente-posicional: especifica um argumento que pode ser fornecido apenas por posiçã o. Parâ metros
somente-posicionais podem ser definidos incluindo o caractere / na lista de parâ metros da definiçã o da
funçã o apó s eles, por exemplo somentepos1 e somentepos2 a seguir:

def func(somentepos1, somentepos2, /, posicional_ou_nomeado): ...

• somente-nomeado: especifica um argumento que pode ser passado para a funçã o somente por nome.
Parâ metros somente-nomeados podem ser definidos com um simples parâ metro var-posicional ou um *
antes deles na lista de parâ metros na definiçã o da funçã o, por exemplo somente_nom1 and somente_nom2
a seguir:

def func(arg, *, somente_nom1, somente_nom2): ...

• var-posicional: especifica que uma sequê ncia arbitrá ria de argumentos posicionais pode ser fornecida
(em adiçã o a qualquer argumento posicional já aceito por outros parâ metros). Tal parâ metro pode ser
definido colocando um * antes do nome do parâ metro, por exemplo args a seguir:

def func(*args, **kwargs): ...

• var-nomeado: especifica que, arbitrariamente, muitos argumentos nomeados podem ser fornecidos (em
adiçã o a qualquer argumento nomeado já aceito por outros parâ metros). Tal parâ metro pode definido
colocando-se ** antes do nome, por exemplo kwargs no exemplo acima.
Parâ metros podem especificar tanto argumentos opcionais quanto obrigató rios, assim como valores padrã o
para alguns argumentos opcionais.
Veja o termo argumento no glossá rio, a pergunta sobre a diferença entre argumentos e parâ metros, a classe
inspect.Parameter, a seçã o function e a PEP 362.

entrada de caminho
Um local ú nico no caminho de importação que o localizador baseado no caminho consulta para encontrar
mó dulos a serem importados.
localizador de entrada de caminho
Um localizador retornado por um chamá vel em sys.path_hooks (ou seja, um gancho de entrada de caminho)
que sabe como localizar os mó dulos entrada de caminho.
Veja importlib.abc.PathEntryFinder para os mé todos que localizadores de entrada de caminho im-
plementam.
gancho de entrada de caminho
Um chamá vel na lista sys.path_hooks que retorna um localizador de entrada de caminho caso saiba como
localizar mó dulos em uma entrada de caminho específica.

99
Python Setup and Usage, Release 3.13.0

localizador baseado no caminho

Um dos localizadores de metacaminho padrã o que procura por um caminho de importação de mó dulos.
objeto caminho ou similar
Um objeto representando um caminho de sistema de arquivos. Um objeto caminho ou similar é ou um objeto
str ou bytes representando um caminho, ou um objeto implementando o protocolo os.PathLike. Um
objeto que suporta o protocolo os.PathLike pode ser convertido para um arquivo de caminho do sistema
str ou bytes, atravé s da chamada da funçã o os.fspath(); os.fsdecode() e os.fsencode() podem
ser usadas para garantir um str ou bytes como resultado, respectivamente. Introduzido na PEP 519.
PEP
Proposta de melhoria do Python. Uma PEP é um documento de design que fornece informaçã o para a co-
munidade Python, ou descreve uma nova funcionalidade para o Python ou seus predecessores ou ambientes.
PEPs devem prover uma especificaçã o té cnica concisa e um racional para funcionalidades propostas.
PEPs tê m a intençã o de ser os mecanismos primá rios para propor novas funcionalidades significativas, para
coletar opiniõ es da comunidade sobre um problema, e para documentar as decisõ es de design que foram
adicionadas ao Python. O autor da PEP é responsá vel por construir um consenso dentro da comunidade e
documentar opiniõ es dissidentes.
Veja PEP 1.
porção
Um conjunto de arquivos em um ú nico diretó rio (possivelmente armazenado em um arquivo zip) que contri-
buem para um pacote de espaço de nomes, conforme definido em PEP 420.
argumento posicional
Veja argumento.
API provisória
Uma API provisó ria é uma API que foi deliberadamente excluída das bibliotecas padrõ es com compatibilidade
retroativa garantida. Enquanto mudanças maiores para tais interfaces nã o sã o esperadas, contanto que elas
sejam marcadas como provisó rias, mudanças retroativas incompatíveis (até e incluindo a remoçã o da interface)
podem ocorrer se consideradas necessá rias pelos desenvolvedores principais. Tais mudanças nã o serã o feitas
gratuitamente – elas irã o ocorrer apenas se sé rias falhas fundamentais forem descobertas, que foram esquecidas
anteriormente a inclusã o da API.
Mesmo para APIs provisó rias, mudanças retroativas incompatíveis sã o vistas como uma “soluçã o em ú ltimo
caso” - cada tentativa ainda será feita para encontrar uma resoluçã o retroativa compatível para quaisquer pro-
blemas encontrados.
Esse processo permite que a biblioteca padrã o continue a evoluir com o passar do tempo, sem se prender em
erros de design problemá ticos por períodos de tempo prolongados. Veja PEP 411 para mais detalhes.
pacote provisório
Veja API provisória.
Python 3000
Apelido para a linha de lançamento da versã o do Python 3.x (cunhada há muito tempo, quando o lançamento
da versã o 3 era algo em um futuro muito distante.) Esse termo possui a seguinte abreviaçã o: “Py3k”.
Pythônico
Uma ideia ou um pedaço de có digo que segue de perto as formas de escritas mais comuns da linguagem
Python, ao invé s de implementar có digos usando conceitos comuns a outras linguagens. Por exemplo, um
formato comum em Python é fazer um laço sobre todos os elementos de uma iterá vel usando a instruçã o for.
Muitas outras linguagens nã o tê m esse tipo de construçã o, entã o as pessoas que nã o estã o familiarizadas com
o Python usam um contador numé rico:

for i in range(len(comida)):
print(comida[i])

Ao contrá rio do mé todo mais limpo, Pythô nico:

100 Apêndice A. Glossário

 Python Setup and Usage, Release 3.13.0

for parte in comida:

print(parte)

nome qualificado
Um nome pontilhado (quando 2 termos sã o ligados por um ponto) que mostra o “path” do escopo global de um
mó dulo para uma classe, funçã o ou mé todo definido num determinado mó dulo, conforme definido pela PEP
3155. Para funçõ es e classes de nível superior, o nome qualificado é o mesmo que o nome do objeto:

>>> class C:
... class D:
... def metodo(self):
... pass
...
>>> C.__qualname__
'C'
>>> C.D.__qualname__
'C.D'
>>> C.D.metodo.__qualname__
'C.D.metodo'

Quando usado para se referir a mó dulos, o nome totalmente qualificado significa todo o caminho pontilhado
para o mó dulo, incluindo quaisquer pacotes pai, por exemplo: email.mime.text:

>>> import email.mime.text

>>> email.mime.text.__name__
'email.mime.text'

contagem de referências
O nú mero de referê ncias a um objeto. Quando a contagem de referê ncias de um objeto cai para zero, ele é
desalocado. Alguns objetos sã o imortais e tê m contagens de referê ncias que nunca sã o modificadas e, portanto,
os objetos nunca sã o desalocados. A contagem de referê ncias geralmente nã o é visível para o có digo Python,
mas é um elemento-chave da implementaçã o do CPython. Os programadores podem chamar a funçã o sys.
getrefcount() para retornar a contagem de referê ncias para um objeto específico.

pacote regular
Um pacote tradicional, como um diretó rio contendo um arquivo __init__.py.
Veja també m pacote de espaço de nomes.
REPL
Um acrô nimo para “read–eval–print loop”, outro nome para o console interativo do interpretador.
__slots__
Uma declaraçã o dentro de uma classe que economiza memó ria pré -declarando espaço para atributos de ins-
tâ ncias, e eliminando dicioná rios de instâ ncias. Apesar de popular, a té cnica é um tanto quanto complicada
de acertar, e é melhor se for reservada para casos raros, onde existe uma grande quantidade de instâ ncias em
uma aplicaçã o onde a memó ria é crítica.
sequência
Um iterável com suporte para acesso eficiente a seus elementos atravé s de índices inteiros via mé todo es-
pecial __getitem__() e que define o mé todo __len__() que devolve o tamanho da sequê ncia. Alguns
tipos de sequê ncia embutidos sã o: list, str, tuple, e bytes. Note que dict també m tem suporte para
__getitem__() e __len__(), mas é considerado um mapeamento e nã o uma sequê ncia porque a busca
usa uma chave hasheável arbitrá ria em vez de inteiros.
A classe base abstrata collections.abc.Sequence define uma interface mais rica que vai alé m
de apenas __getitem__() e __len__(), adicionando count(), index(), __contains__(), e
__reversed__(). Tipos que implementam essa interface podem ser explicitamente registrados usando
register(). Para mais documentaçã o sobre mé todos de sequê ncias em geral, veja Operaçõ es comuns de
sequê ncias.

101
Python Setup and Usage, Release 3.13.0

compreensão de conjunto
Uma maneira compacta de processar todos ou parte dos elementos em iterá vel e retornar um conjunto com
os resultados. results = {c for c in 'abracadabra' if c not in 'abc'} gera um conjunto de
strings {'r', 'd'}. Veja comprehensions.
despacho único
Uma forma de despacho de função genérica onde a implementaçã o é escolhida com base no tipo de um ú nico
argumento.
fatia
Um objeto geralmente contendo uma parte de uma sequência. Uma fatia é criada usando a notaçã o de subscrito
[] pode conter també m até dois pontos entre nú meros, como em variable_name[1:3:5]. A notaçã o de
suporte (subscrito) utiliza objetos slice internamente.
suavemente descontinuado
Uma API suavemente descontinuada nã o deve ser usada em có digo novo, mas é seguro para có digo já existente
usá -la. A API continua documentada e testada, mas nã o será aprimorada mais.
A descontinuaçã o suave, diferentemente da descontinuaçã o normal, nã o planeja remover a API e nã o emitirá
avisos.
Veja PEP 387: Descontinuaçã o suave.
método especial
Um mé todo que é chamado implicitamente pelo Python para executar uma certa operaçã o em um tipo, como
uma adiçã o por exemplo. Tais mé todos tem nomes iniciando e terminando com dois underscores. Mé todos
especiais estã o documentados em specialnames.
instrução
Uma instruçã o é parte de uma suíte (um “bloco” de có digo). Uma instruçã o é ou uma expressão ou uma de
vá rias construçõ es com uma palavra reservada, tal como if, while ou for.
verificador de tipo estático
Uma ferramenta externa que lê o có digo Python e o analisa, procurando por problemas como tipos incorretos.
Consulte també m dicas de tipo e o mó dulo typing.
referência forte
Na API C do Python, uma referê ncia forte é uma referê ncia a um objeto que pertence ao có digo que conté m a
referê ncia. A referê ncia forte é obtida chamando Py_INCREF() quando a referê ncia é criada e liberada com
Py_DECREF() quando a referê ncia é excluída.

A funçã o Py_NewRef() pode ser usada para criar uma referê ncia forte para um objeto. Normalmente, a
funçã o Py_DECREF() deve ser chamada na referê ncia forte antes de sair do escopo da referê ncia forte, para
evitar o vazamento de uma referê ncia.
Veja també m referência emprestada.
codificador de texto
Uma string em Python é uma sequê ncia de pontos de có digo Unicode (no intervalo U+0000–U+10FFFF). Para
armazenar ou transferir uma string, ela precisa ser serializada como uma sequê ncia de bytes.
A serializaçã o de uma string em uma sequê ncia de bytes é conhecida como “codificaçã o” e a recriaçã o da string
a partir de uma sequê ncia de bytes é conhecida como “decodificaçã o”.
Há uma variedade de diferentes serializaçõ es de texto codecs, que sã o coletivamente chamadas de “codificaçõ es
de texto”.
arquivo texto
Um objeto arquivo apto a ler e escrever objetos str. Geralmente, um arquivo texto, na verdade, acessa um
fluxo de dados de bytes e captura o codificador de texto automaticamente. Exemplos de arquivos texto sã o:
arquivos abertos em modo texto ('r' or 'w'), sys.stdin, sys.stdout, e instâ ncias de io.StringIO.
Veja també m arquivo binário para um objeto arquivo apto a ler e escrever objetos byte ou similar.
aspas triplas
Uma string que está definida com trê s ocorrê ncias de aspas duplas (”) ou apó strofos (‘). Enquanto elas nã o
fornecem nenhuma funcionalidade nã o disponível com strings de aspas simples, elas sã o ú teis para inú meras

102 Apêndice A. Glossário

 Python Setup and Usage, Release 3.13.0

razõ es. Elas permitem que você inclua aspas simples e duplas nã o escapadas dentro de uma string, e elas
podem utilizar mú ltiplas linhas sem o uso de caractere de continuaçã o, fazendo-as especialmente ú teis quando
escrevemos documentaçã o em docstrings.
tipo
O tipo de um objeto Python determina qual classe de objeto ele é ; cada objeto tem um tipo. Um tipo de objeto
é acessível pelo atributo __class__ ou pode ser recuperado com type(obj).
apelido de tipo
Um sinô nimo para um tipo, criado atravé s da atribuiçã o do tipo para um identificador.
Apelidos de tipo sã o ú teis para simplificar dicas de tipo. Por exemplo:

def remove_tons_de_cinza(
cores: list[tuple[int, int, int]]) -> list[tuple[int, int, int]]:
pass

pode tornar-se mais legível desta forma:

Cor = tuple[int, int, int]

def remove_tons_de_cinza(cores: list[Cor]) -> list[Cor]:

pass

Veja typing e PEP 484, a qual descreve esta funcionalidade.

dica de tipo
Uma anotação que especifica o tipo esperado para uma variá vel, um atributo de classe, ou um parâ metro de
funçã o ou um valor de retorno.
Dicas de tipo sã o opcionais e nã o sã o forçadas pelo Python, mas elas sã o ú teis para verificadores de tipo estático.
Eles també m ajudam IDEs a completar e refatorar có digo.
Dicas de tipos de variá veis globais, atributos de classes, e funçõ es, mas nã o de variá veis locais, podem ser
acessadas usando typing.get_type_hints().
Veja typing e PEP 484, a qual descreve esta funcionalidade.
novas linhas universais
Uma maneira de interpretar fluxos de textos, na qual todos estes sã o reconhecidos como caracteres de fim de
linha: a convençã o para fim de linha no Unix '\n', a convençã o no Windows '\r\n', e a antiga convençã o
no Macintosh '\r'. Veja PEP 278 e PEP 3116, bem como bytes.splitlines() para uso adicional.
anotação de variável
Uma anotação de uma variá vel ou um atributo de classe.
Ao fazer uma anotaçã o de uma variá vel ou um atributo de classe, a atribuiçã o é opcional:

class C:
campo: 'anotação'

Anotaçõ es de variá veis sã o normalmente usadas para dicas de tipo: por exemplo, espera-se que esta variá vel
receba valores do tipo int:

contagem: int = 0

A sintaxe de anotaçã o de variá vel é explicada na seçã o annassign.

Veja anotação de função, PEP 484 e PEP 526, que descrevem esta funcionalidade. Veja també m annotations-
-howto para as melhores prá ticas sobre como trabalhar com anotaçõ es.
ambiente virtual
Um ambiente de execuçã o isolado que permite usuá rios Python e aplicaçõ es instalarem e atualizarem pacotes
Python sem interferir no comportamento de outras aplicaçõ es Python em execuçã o no mesmo sistema.
Veja també m venv.

103
Python Setup and Usage, Release 3.13.0

máquina virtual
Um computador definido inteiramente em software. A má quina virtual de Python executa o bytecode emitido
pelo compilador de bytecode.
Zen do Python
Lista de princípios de projeto e filosofias do Python que sã o ú teis para a compreensã o e uso da linguagem. A
lista é exibida quando se digita “import this” no console interativo.

104 Apêndice A. Glossário

 APÊNDICE B

Sobre esses documentos

Esses documentos sã o gerados a partir de reStructuredText pelo Sphinx, um processador de documentos especifica-
mente escrito para documentaçã o Python.
O desenvolvimento da documentaçã o e de suas ferramentas é um esforço totalmente voluntá rio, como Python em
si. Se você quer contribuir, por favor dê uma olhada na pá gina reporting-bugs para informaçõ es sobre como fazer.
Novos voluntá rios sã o sempre bem-vindos!
Agradecimentos especiais para:
• Fred L. Drake, Jr., o criador do primeiro conjunto de ferramentas para documentar Python e escritor de boa
parte do conteú do;
• O projeto Docutils por criar reStructuredText e o pacote Docutils;
• Fredrik Lundh, pelo seu projeto de referê ncia alternativa em Python, do qual Sphinx pegou muitas boas ideias.

B.1 Contribuidores da Documentação Python

Muitas pessoas tem contribuído para a linguagem Python, sua biblioteca padrã o e sua documentaçã o. Veja
Misc/ACKS na distribuiçã o do có digo do Python para ver uma lista parcial de contribuidores.
Tudo isso só foi possível com o esforço e a contribuiçã o da comunidade Python, por isso temos essa maravilhosa
documentaçã o – Obrigado a todos!

105
Python Setup and Usage, Release 3.13.0

106 Apêndice B. Sobre esses documentos

 APÊNDICE C

História e Licença

C.1 História do software

O Python foi criado no início dos anos 1990 por Guido van Rossum na Stichting Mathematisch Centrum (CWI,
veja https://www.cwi.nl/) na Holanda como um sucessor de uma linguagem chamada ABC. Guido continua a ser o
principal autor de Python, embora inclua muitas contribuiçõ es de outros.
Em 1995, Guido continuou seu trabalho em Python na Corporaçã o para Iniciativas Nacionais de Pesquisa (CNRI,
veja https://www.cnri.reston.va.us/) em Reston, Virgínia, onde lançou vá rias versõ es do software.
Em maio de 2000, Guido e a equipe principal de desenvolvimento do Python mudaram-se para o BeOpen.com para
formar a equipe BeOpen PythonLabs. Em outubro do mesmo ano, a equipe da PythonLabs mudou para a Digital
Creations (agora Zope Corporation; veja https://www.zope.org/). Em 2001, formou-se a Python Software Foundation
(PSF, veja https://www.python.org/psf/), uma organizaçã o sem fins lucrativos criada especificamente para possuir
propriedade intelectual relacionada a Python. A Zope Corporation é um membro patrocinador do PSF.
Todas as versõ es do Python sã o de có digo aberto (consulte https://opensource.org/ para a definiçã o de có digo aberto).
Historicamente, a maioria, mas nã o todas, versõ es do Python també m sã o compatíveis com GPL; a tabela abaixo
resume os vá rios lançamentos.

Versão Derivada de Ano Proprietário Compatível com a GPL?

0.9.0 a 1.2 n/a 1991-1995 CWI sim
1.3 a 1.5.2 1.2 1995-1999 CNRI sim
1.6 1.5.2 2000 CNRI nã o
2.0 1.6 2000 BeOpen.com nã o
1.6.1 1.6 2001 CNRI nã o
2.1 2.0+1.6.1 2001 PSF nã o
2.0.1 2.0+1.6.1 2001 PSF sim
2.1.1 2.1+2.0.1 2001 PSF sim
2.1.2 2.1.1 2002 PSF sim
2.1.3 2.1.2 2002 PSF sim
2.2 e acima 2.1.1 2001-agora PSF sim

® Nota

107
Python Setup and Usage, Release 3.13.0

Compatível com a GPL nã o significa que estamos distribuindo Python sob a GPL. Todas as licenças do Python,
ao contrá rio da GPL, permitem distribuir uma versã o modificada sem fazer alteraçõ es em có digo aberto. As
licenças compatíveis com a GPL possibilitam combinar o Python com outro software lançado sob a GPL; os
outros nã o.

Graças aos muitos voluntá rios externos que trabalharam sob a direçã o de Guido para tornar esses lançamentos pos-
síveis.

C.2 Termos e condições para acessar ou usar Python

O software e a documentaçã o do Python sã o licenciados sob o Acordo de Licenciamento PSF.
A partir do Python 3.8.6, exemplos, receitas e outros có digos na documentaçã o sã o licenciados duplamente sob o
Acordo de Licenciamento PSF e a Licença BSD de Zero Cláusula.
Alguns softwares incorporados ao Python estã o sob licenças diferentes. As licenças sã o listadas com o có digo abran-
gido por essa licença. Veja Licenças e Reconhecimentos para Software Incorporado para uma lista incompleta dessas
licenças.

C.2.1 ACORDO DE LICENCIAMENTO DA PSF PARA PYTHON 3.13.0

1. This LICENSE AGREEMENT is between the Python Software Foundation ("PSF"), and
the Individual or Organization ("Licensee") accessing and otherwise using Python
3.13.0 software in source or binary form and its associated documentation.

2. Subject to the terms and conditions of this License Agreement, PSF hereby
grants Licensee a nonexclusive, royalty-free, world-wide license to reproduce,
analyze, test, perform and/or display publicly, prepare derivative works,
distribute, and otherwise use Python 3.13.0 alone or in any derivative
version, provided, however, that PSF's License Agreement and PSF's notice of
copyright, i.e., "Copyright © 2001-2024 Python Software Foundation; All Rights
Reserved" are retained in Python 3.13.0 alone or in any derivative version
prepared by Licensee.

3. In the event Licensee prepares a derivative work that is based on or

incorporates Python 3.13.0 or any part thereof, and wants to make the
derivative work available to others as provided herein, then Licensee hereby
agrees to include in any such work a brief summary of the changes made to Python
3.13.0.

4. PSF is making Python 3.13.0 available to Licensee on an "AS IS" basis.

PSF MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED. BY WAY OF
EXAMPLE, BUT NOT LIMITATION, PSF MAKES NO AND DISCLAIMS ANY REPRESENTATION OR
WARRANTY OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT THE
USE OF PYTHON 3.13.0 WILL NOT INFRINGE ANY THIRD PARTY RIGHTS.

5. PSF SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON 3.13.0
FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS A RESULT OF
MODIFYING, DISTRIBUTING, OR OTHERWISE USING PYTHON 3.13.0, OR ANY DERIVATIVE
THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF.

6. This License Agreement will automatically terminate upon a material breach of

its terms and conditions.

7. Nothing in this License Agreement shall be deemed to create any relationship

of agency, partnership, or joint venture between PSF and Licensee. This License
Agreement does not grant permission to use PSF trademarks or trade name in a

108 Apêndice C. História e Licença

 Python Setup and Usage, Release 3.13.0

trademark sense to endorse or promote products or services of Licensee, or any

third party.

8. By copying, installing or otherwise using Python 3.13.0, Licensee agrees

to be bound by the terms and conditions of this License Agreement.

C.2.2 ACORDO DE LICENCIAMENTO DA BEOPEN.COM PARA PYTHON 2.0

ACORDO DE LICENCIAMENTO DA BEOPEN DE FONTE ABERTA DO PYTHON VERSÃO 1

1. This LICENSE AGREEMENT is between BeOpen.com ("BeOpen"), having an office at

160 Saratoga Avenue, Santa Clara, CA 95051, and the Individual or Organization
("Licensee") accessing and otherwise using this software in source or binary
form and its associated documentation ("the Software").

2. Subject to the terms and conditions of this BeOpen Python License Agreement,
BeOpen hereby grants Licensee a non-exclusive, royalty-free, world-wide license
to reproduce, analyze, test, perform and/or display publicly, prepare derivative
works, distribute, and otherwise use the Software alone or in any derivative
version, provided, however, that the BeOpen Python License is retained in the
Software, alone or in any derivative version prepared by Licensee.

3. BeOpen is making the Software available to Licensee on an "AS IS" basis.

BEOPEN MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED. BY WAY OF
EXAMPLE, BUT NOT LIMITATION, BEOPEN MAKES NO AND DISCLAIMS ANY REPRESENTATION OR
WARRANTY OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT THE
USE OF THE SOFTWARE WILL NOT INFRINGE ANY THIRD PARTY RIGHTS.

4. BEOPEN SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF THE SOFTWARE FOR
ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS A RESULT OF USING,
MODIFYING OR DISTRIBUTING THE SOFTWARE, OR ANY DERIVATIVE THEREOF, EVEN IF
ADVISED OF THE POSSIBILITY THEREOF.

5. This License Agreement will automatically terminate upon a material breach of

its terms and conditions.

6. This License Agreement shall be governed by and interpreted in all respects

by the law of the State of California, excluding conflict of law provisions.
Nothing in this License Agreement shall be deemed to create any relationship of
agency, partnership, or joint venture between BeOpen and Licensee. This License
Agreement does not grant permission to use BeOpen trademarks or trade names in a
trademark sense to endorse or promote products or services of Licensee, or any
third party. As an exception, the "BeOpen Python" logos available at
http://www.pythonlabs.com/logos.html may be used according to the permissions
granted on that web page.

7. By copying, installing or otherwise using the software, Licensee agrees to be

bound by the terms and conditions of this License Agreement.

C.2.3 CONTRATO DE LICENÇA DA CNRI PARA O PYTHON 1.6.1

1. This LICENSE AGREEMENT is between the Corporation for National Research
Initiatives, having an office at 1895 Preston White Drive, Reston, VA 20191
("CNRI"), and the Individual or Organization ("Licensee") accessing and
otherwise using Python 1.6.1 software in source or binary form and its
associated documentation.

(continua na pró xima pá gina)

C.2. Termos e condições para acessar ou usar Python 109

Python Setup and Usage, Release 3.13.0

(continuaçã o da pá gina anterior)

2. Subject to the terms and conditions of this License Agreement, CNRI hereby
grants Licensee a nonexclusive, royalty-free, world-wide license to reproduce,
analyze, test, perform and/or display publicly, prepare derivative works,
distribute, and otherwise use Python 1.6.1 alone or in any derivative version,
provided, however, that CNRI's License Agreement and CNRI's notice of copyright,
i.e., "Copyright © 1995-2001 Corporation for National Research Initiatives; All
Rights Reserved" are retained in Python 1.6.1 alone or in any derivative version
prepared by Licensee. Alternately, in lieu of CNRI's License Agreement,
Licensee may substitute the following text (omitting the quotes): "Python 1.6.1
is made available subject to the terms and conditions in CNRI's License
Agreement. This Agreement together with Python 1.6.1 may be located on the
internet using the following unique, persistent identifier (known as a handle):
1895.22/1013. This Agreement may also be obtained from a proxy server on the
internet using the following URL: http://hdl.handle.net/1895.22/1013."

3. In the event Licensee prepares a derivative work that is based on or

incorporates Python 1.6.1 or any part thereof, and wants to make the derivative
work available to others as provided herein, then Licensee hereby agrees to
include in any such work a brief summary of the changes made to Python 1.6.1.

4. CNRI is making Python 1.6.1 available to Licensee on an "AS IS" basis. CNRI
MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED. BY WAY OF EXAMPLE,
BUT NOT LIMITATION, CNRI MAKES NO AND DISCLAIMS ANY REPRESENTATION OR WARRANTY
OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF
PYTHON 1.6.1 WILL NOT INFRINGE ANY THIRD PARTY RIGHTS.

5. CNRI SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON 1.6.1 FOR
ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS A RESULT OF
MODIFYING, DISTRIBUTING, OR OTHERWISE USING PYTHON 1.6.1, OR ANY DERIVATIVE
THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF.

6. This License Agreement will automatically terminate upon a material breach of

its terms and conditions.

7. This License Agreement shall be governed by the federal intellectual property

law of the United States, including without limitation the federal copyright
law, and, to the extent such U.S. federal law does not apply, by the law of the
Commonwealth of Virginia, excluding Virginia's conflict of law provisions.
Notwithstanding the foregoing, with regard to derivative works based on Python
1.6.1 that incorporate non-separable material that was previously distributed
under the GNU General Public License (GPL), the law of the Commonwealth of
Virginia shall govern this License Agreement only as to issues arising under or
with respect to Paragraphs 4, 5, and 7 of this License Agreement. Nothing in
this License Agreement shall be deemed to create any relationship of agency,
partnership, or joint venture between CNRI and Licensee. This License Agreement
does not grant permission to use CNRI trademarks or trade name in a trademark
sense to endorse or promote products or services of Licensee, or any third
party.

8. By clicking on the "ACCEPT" button where indicated, or by copying, installing

or otherwise using Python 1.6.1, Licensee agrees to be bound by the terms and
conditions of this License Agreement.

110 Apêndice C. História e Licença

 Python Setup and Usage, Release 3.13.0

C.2.4 ACORDO DE LICENÇA DA CWI PARA PYTHON 0.9.0 A 1.2

Copyright © 1991 - 1995, Stichting Mathematisch Centrum Amsterdam, The
Netherlands. All rights reserved.

Permission to use, copy, modify, and distribute this software and its
documentation for any purpose and without fee is hereby granted, provided that
the above copyright notice appear in all copies and that both that copyright
notice and this permission notice appear in supporting documentation, and that
the name of Stichting Mathematisch Centrum or CWI not be used in advertising or
publicity pertaining to distribution of the software without specific, written
prior permission.

STICHTING MATHEMATISCH CENTRUM DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS

SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
EVENT SHALL STICHTING MATHEMATISCH CENTRUM BE LIABLE FOR ANY SPECIAL, INDIRECT
OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS
ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
SOFTWARE.

C.2.5 LICENÇA BSD DE ZERO CLÁUSULA PARA CÓDIGO NA DOCUMENTAÇÃO

DO PYTHON 3.13.0
Permission to use, copy, modify, and/or distribute this software for any
purpose with or without fee is hereby granted.

THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
PERFORMANCE OF THIS SOFTWARE.

C.3 Licenças e Reconhecimentos para Software Incorporado

Esta seçã o é uma lista incompleta, mas crescente, de licenças e reconhecimentos para softwares de terceiros incor-
porados na distribuiçã o do Python.

C.3.1 Mersenne Twister

A extensã o C _random subjacente ao mó dulo random inclui có digo baseado em um download de http://www.math.
sci.hiroshima-u.ac.jp/~m-mat/MT/MT2002/emt19937ar.html. A seguir estã o os comentá rios literais do có digo ori-
ginal:

A C-program for MT19937, with initialization improved 2002/1/26.

Coded by Takuji Nishimura and Makoto Matsumoto.

Before using, initialize the state by using init_genrand(seed)

or init_by_array(init_key, key_length).

Copyright (C) 1997 - 2002, Makoto Matsumoto and Takuji Nishimura,

All rights reserved.

Redistribution and use in source and binary forms, with or without

(continua na pró xima pá gina)

C.3. Licenças e Reconhecimentos para Software Incorporado 111

Python Setup and Usage, Release 3.13.0

(continuaçã o da pá gina anterior)

modification, are permitted provided that the following conditions
are met:

1. Redistributions of source code must retain the above copyright

notice, this list of conditions and the following disclaimer.

2. Redistributions in binary form must reproduce the above copyright

notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.

3. The names of its contributors may not be used to endorse or promote

products derived from this software without specific prior written
permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS

"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Any feedback is very welcome.

http://www.math.sci.hiroshima-u.ac.jp/~m-mat/MT/emt.html
email: m-mat @ math.sci.hiroshima-u.ac.jp (remove space)

C.3.2 Soquetes
O mó dulo socket usa as funçõ es getaddrinfo() e getnameinfo(), que sã o codificadas em arquivos de origem
separados do Projeto WIDE, https://www.wide.ad.jp/.

Copyright (C) 1995, 1996, 1997, and 1998 WIDE Project.

All rights reserved.

Redistribution and use in source and binary forms, with or without

modification, are permitted provided that the following conditions
are met:
1. Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.
3. Neither the name of the project nor the names of its contributors
may be used to endorse or promote products derived from this software
without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE PROJECT AND CONTRIBUTORS ``AS IS'' AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
ARE DISCLAIMED. IN NO EVENT SHALL THE PROJECT OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
(continua na pró xima pá gina)

112 Apêndice C. História e Licença

 Python Setup and Usage, Release 3.13.0

(continuaçã o da pá gina anterior)

DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
SUCH DAMAGE.

C.3.3 Serviços de soquete assíncrono

Os mó dulos test.support.asynchat e test.support.asyncore contê m o seguinte aviso:

Copyright 1996 by Sam Rushing

All Rights Reserved

Permission to use, copy, modify, and distribute this software and

its documentation for any purpose and without fee is hereby
granted, provided that the above copyright notice appear in all
copies and that both that copyright notice and this permission
notice appear in supporting documentation, and that the name of Sam
Rushing not be used in advertising or publicity pertaining to
distribution of the software without specific, written prior
permission.

SAM RUSHING DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,

INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN
NO EVENT SHALL SAM RUSHING BE LIABLE FOR ANY SPECIAL, INDIRECT OR
CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS
OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

C.3.4 Gerenciamento de cookies

O mó dulo http.cookies conté m o seguinte aviso:

Copyright 2000 by Timothy O'Malley <[email protected]>

All Rights Reserved

Permission to use, copy, modify, and distribute this software

and its documentation for any purpose and without fee is hereby
granted, provided that the above copyright notice appear in all
copies and that both that copyright notice and this permission
notice appear in supporting documentation, and that the name of
Timothy O'Malley not be used in advertising or publicity
pertaining to distribution of the software without specific, written
prior permission.

Timothy O'Malley DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS

SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
AND FITNESS, IN NO EVENT SHALL Timothy O'Malley BE LIABLE FOR
ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS
(continua na pró xima pá gina)

C.3. Licenças e Reconhecimentos para Software Incorporado 113

Python Setup and Usage, Release 3.13.0

(continuaçã o da pá gina anterior)

ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
PERFORMANCE OF THIS SOFTWARE.

C.3.5 Rastreamento de execução

O mó dulo trace conté m o seguinte aviso:
portions copyright 2001, Autonomous Zones Industries, Inc., all rights...
err... reserved and offered to the public under the terms of the
Python 2.2 license.
Author: Zooko O'Whielacronx
http://zooko.com/
mailto:[email protected]

Copyright 2000, Mojam Media, Inc., all rights reserved.

Author: Skip Montanaro

Copyright 1999, Bioreason, Inc., all rights reserved.

Author: Andrew Dalke

Copyright 1995-1997, Automatrix, Inc., all rights reserved.

Author: Skip Montanaro

Copyright 1991-1995, Stichting Mathematisch Centrum, all rights reserved.

Permission to use, copy, modify, and distribute this Python software and
its associated documentation for any purpose without fee is hereby
granted, provided that the above copyright notice appears in all copies,
and that both that copyright notice and this permission notice appear in
supporting documentation, and that the name of neither Automatrix,
Bioreason or Mojam Media be used in advertising or publicity pertaining to
distribution of the software without specific, written prior permission.

C.3.6 Funções UUencode e UUdecode

O codec uu conté m o seguinte aviso:
Copyright 1994 by Lance Ellinghouse
Cathedral City, California Republic, United States of America.
All Rights Reserved
Permission to use, copy, modify, and distribute this software and its
documentation for any purpose and without fee is hereby granted,
provided that the above copyright notice appear in all copies and that
both that copyright notice and this permission notice appear in
supporting documentation, and that the name of Lance Ellinghouse
not be used in advertising or publicity pertaining to distribution
of the software without specific, written prior permission.
LANCE ELLINGHOUSE DISCLAIMS ALL WARRANTIES WITH REGARD TO
THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
FITNESS, IN NO EVENT SHALL LANCE ELLINGHOUSE CENTRUM BE LIABLE
FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

(continua na pró xima pá gina)

114 Apêndice C. História e Licença

 Python Setup and Usage, Release 3.13.0

(continuaçã o da pá gina anterior)

Modified by Jack Jansen, CWI, July 1995:
- Use binascii module to do the actual line-by-line conversion
between ascii and binary. This results in a 1000-fold speedup. The C
version is still 5 times faster, though.
- Arguments more compliant with Python standard

C.3.7 Chamadas de procedimento remoto XML

O mó dulo xmlrpc.client conté m o seguinte aviso:
The XML-RPC client interface is

Copyright (c) 1999-2002 by Secret Labs AB

Copyright (c) 1999-2002 by Fredrik Lundh

By obtaining, using, and/or copying this software and/or its

associated documentation, you agree that you have read, understood,
and will comply with the following terms and conditions:

Permission to use, copy, modify, and distribute this software and

its associated documentation for any purpose and without fee is
hereby granted, provided that the above copyright notice appears in
all copies, and that both that copyright notice and this permission
notice appear in supporting documentation, and that the name of
Secret Labs AB or the author not be used in advertising or publicity
pertaining to distribution of the software without specific, written
prior permission.

SECRET LABS AB AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD
TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANT-
ABILITY AND FITNESS. IN NO EVENT SHALL SECRET LABS AB OR THE AUTHOR
BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY
DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS
ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
OF THIS SOFTWARE.

C.3.8 test_epoll
O mó dulo test.test_epoll conté m o seguinte aviso:
Copyright (c) 2001-2006 Twisted Matrix Laboratories.

Permission is hereby granted, free of charge, to any person obtaining

a copy of this software and associated documentation files (the
"Software"), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:

The above copyright notice and this permission notice shall be

included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,

EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
(continua na pró xima pá gina)

C.3. Licenças e Reconhecimentos para Software Incorporado 115

Python Setup and Usage, Release 3.13.0

(continuaçã o da pá gina anterior)

MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

C.3.9 kqueue de seleção

O mó dulo select conté m o seguinte aviso para a interface do kqueue:
Copyright (c) 2000 Doug White, 2006 James Knight, 2007 Christian Heimes
All rights reserved.

Redistribution and use in source and binary forms, with or without

modification, are permitted provided that the following conditions
are met:
1. Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.

THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
SUCH DAMAGE.

C.3.10 SipHash24
O arquivo Python/pyhash.c conté m a implementaçã o de Marek Majkowski do algoritmo SipHash24 de Dan
Bernstein. Conté m a seguinte nota:
<MIT License>
Copyright (c) 2013 Marek Majkowski <[email protected]>

Permission is hereby granted, free of charge, to any person obtaining a copy

of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
</MIT License>

Original location:
https://github.com/majek/csiphash/

(continua na pró xima pá gina)

116 Apêndice C. História e Licença

 Python Setup and Usage, Release 3.13.0

(continuaçã o da pá gina anterior)

Solution inspired by code from:
Samuel Neves (supercop/crypto_auth/siphash24/little)
djb (supercop/crypto_auth/siphash24/little2)
Jean-Philippe Aumasson (https://131002.net/siphash/siphash24.c)

C.3.11 strtod e dtoa

O arquivo Python/dtoa.c, que fornece as funçõ es C dtoa e strtod para conversã o de duplas de C para e de strings,
é derivado do arquivo com o mesmo nome de David M. Gay, atualmente disponível em https://web.archive.org/
web/20220517033456/http://www.netlib.org/fp/dtoa.c. O arquivo original, conforme recuperado em 16 de março
de 2009, conté m os seguintes avisos de direitos autorais e de licenciamento:

/****************************************************************
*
* The author of this software is David M. Gay.
*
* Copyright (c) 1991, 2000, 2001 by Lucent Technologies.
*
* Permission to use, copy, modify, and distribute this software for any
* purpose without fee is hereby granted, provided that this entire notice
* is included in all copies of any software which is or includes a copy
* or modification of this software and in all copies of the supporting
* documentation for such software.
*
* THIS SOFTWARE IS BEING PROVIDED "AS IS", WITHOUT ANY EXPRESS OR IMPLIED
* WARRANTY. IN PARTICULAR, NEITHER THE AUTHOR NOR LUCENT MAKES ANY
* REPRESENTATION OR WARRANTY OF ANY KIND CONCERNING THE MERCHANTABILITY
* OF THIS SOFTWARE OR ITS FITNESS FOR ANY PARTICULAR PURPOSE.
*
***************************************************************/

C.3.12 OpenSSL
Os mó dulos hashlib, posix e ssl usam a biblioteca OpenSSL para desempenho adicional se forem disponibi-
lizados pelo sistema operacional. Alé m disso, os instaladores do Windows e do Mac OS X para Python podem
incluir uma có pia das bibliotecas do OpenSSL, portanto incluímos uma có pia da licença do OpenSSL aqui: Para o
lançamento do OpenSSL 3.0, e lançamentos posteriores derivados deste, se aplica a Apache License v2:
Apache License
Version 2.0, January 2004
https://www.apache.org/licenses/

TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION

1. Definitions.

"License" shall mean the terms and conditions for use, reproduction,
and distribution as defined by Sections 1 through 9 of this document.

"Licensor" shall mean the copyright owner or entity authorized by

the copyright owner that is granting the License.

"Legal Entity" shall mean the union of the acting entity and all
other entities that control, are controlled by, or are under common
control with that entity. For the purposes of this definition,
"control" means (i) the power, direct or indirect, to cause the
(continua na pró xima pá gina)

C.3. Licenças e Reconhecimentos para Software Incorporado 117

Python Setup and Usage, Release 3.13.0

(continuaçã o da pá gina anterior)

direction or management of such entity, whether by contract or
otherwise, or (ii) ownership of fifty percent (50%) or more of the
outstanding shares, or (iii) beneficial ownership of such entity.

"You" (or "Your") shall mean an individual or Legal Entity

exercising permissions granted by this License.

"Source" form shall mean the preferred form for making modifications,
including but not limited to software source code, documentation
source, and configuration files.

"Object" form shall mean any form resulting from mechanical

transformation or translation of a Source form, including but
not limited to compiled object code, generated documentation,
and conversions to other media types.

"Work" shall mean the work of authorship, whether in Source or

Object form, made available under the License, as indicated by a
copyright notice that is included in or attached to the work
(an example is provided in the Appendix below).

"Derivative Works" shall mean any work, whether in Source or Object

form, that is based on (or derived from) the Work and for which the
editorial revisions, annotations, elaborations, or other modifications
represent, as a whole, an original work of authorship. For the purposes
of this License, Derivative Works shall not include works that remain
separable from, or merely link (or bind by name) to the interfaces of,
the Work and Derivative Works thereof.

"Contribution" shall mean any work of authorship, including

the original version of the Work and any modifications or additions
to that Work or Derivative Works thereof, that is intentionally
submitted to Licensor for inclusion in the Work by the copyright owner
or by an individual or Legal Entity authorized to submit on behalf of
the copyright owner. For the purposes of this definition, "submitted"
means any form of electronic, verbal, or written communication sent
to the Licensor or its representatives, including but not limited to
communication on electronic mailing lists, source code control systems,
and issue tracking systems that are managed by, or on behalf of, the
Licensor for the purpose of discussing and improving the Work, but
excluding communication that is conspicuously marked or otherwise
designated in writing by the copyright owner as "Not a Contribution."

"Contributor" shall mean Licensor and any individual or Legal Entity

on behalf of whom a Contribution has been received by Licensor and
subsequently incorporated within the Work.

2. Grant of Copyright License. Subject to the terms and conditions of

this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
copyright license to reproduce, prepare Derivative Works of,
publicly display, publicly perform, sublicense, and distribute the
Work and such Derivative Works in Source or Object form.

3. Grant of Patent License. Subject to the terms and conditions of

this License, each Contributor hereby grants to You a perpetual,
(continua na pró xima pá gina)

118 Apêndice C. História e Licença

 Python Setup and Usage, Release 3.13.0

(continuaçã o da pá gina anterior)

worldwide, non-exclusive, no-charge, royalty-free, irrevocable
(except as stated in this section) patent license to make, have made,
use, offer to sell, sell, import, and otherwise transfer the Work,
where such license applies only to those patent claims licensable
by such Contributor that are necessarily infringed by their
Contribution(s) alone or by combination of their Contribution(s)
with the Work to which such Contribution(s) was submitted. If You
institute patent litigation against any entity (including a
cross-claim or counterclaim in a lawsuit) alleging that the Work
or a Contribution incorporated within the Work constitutes direct
or contributory patent infringement, then any patent licenses
granted to You under this License for that Work shall terminate
as of the date such litigation is filed.

4. Redistribution. You may reproduce and distribute copies of the

Work or Derivative Works thereof in any medium, with or without
modifications, and in Source or Object form, provided that You
meet the following conditions:

(a) You must give any other recipients of the Work or

Derivative Works a copy of this License; and

(b) You must cause any modified files to carry prominent notices
stating that You changed the files; and

(c) You must retain, in the Source form of any Derivative Works
that You distribute, all copyright, patent, trademark, and
attribution notices from the Source form of the Work,
excluding those notices that do not pertain to any part of
the Derivative Works; and

(d) If the Work includes a "NOTICE" text file as part of its

distribution, then any Derivative Works that You distribute must
include a readable copy of the attribution notices contained
within such NOTICE file, excluding those notices that do not
pertain to any part of the Derivative Works, in at least one
of the following places: within a NOTICE text file distributed
as part of the Derivative Works; within the Source form or
documentation, if provided along with the Derivative Works; or,
within a display generated by the Derivative Works, if and
wherever such third-party notices normally appear. The contents
of the NOTICE file are for informational purposes only and
do not modify the License. You may add Your own attribution
notices within Derivative Works that You distribute, alongside
or as an addendum to the NOTICE text from the Work, provided
that such additional attribution notices cannot be construed
as modifying the License.

You may add Your own copyright statement to Your modifications and
may provide additional or different license terms and conditions
for use, reproduction, or distribution of Your modifications, or
for any such Derivative Works as a whole, provided Your use,
reproduction, and distribution of the Work otherwise complies with
the conditions stated in this License.

5. Submission of Contributions. Unless You explicitly state otherwise,

(continua na pró xima pá gina)

C.3. Licenças e Reconhecimentos para Software Incorporado 119

Python Setup and Usage, Release 3.13.0

(continuaçã o da pá gina anterior)

any Contribution intentionally submitted for inclusion in the Work
by You to the Licensor shall be under the terms and conditions of
this License, without any additional terms or conditions.
Notwithstanding the above, nothing herein shall supersede or modify
the terms of any separate license agreement you may have executed
with Licensor regarding such Contributions.

6. Trademarks. This License does not grant permission to use the trade
names, trademarks, service marks, or product names of the Licensor,
except as required for reasonable and customary use in describing the
origin of the Work and reproducing the content of the NOTICE file.

7. Disclaimer of Warranty. Unless required by applicable law or

agreed to in writing, Licensor provides the Work (and each
Contributor provides its Contributions) on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied, including, without limitation, any warranties or conditions
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
PARTICULAR PURPOSE. You are solely responsible for determining the
appropriateness of using or redistributing the Work and assume any
risks associated with Your exercise of permissions under this License.

8. Limitation of Liability. In no event and under no legal theory,

whether in tort (including negligence), contract, or otherwise,
unless required by applicable law (such as deliberate and grossly
negligent acts) or agreed to in writing, shall any Contributor be
liable to You for damages, including any direct, indirect, special,
incidental, or consequential damages of any character arising as a
result of this License or out of the use or inability to use the
Work (including but not limited to damages for loss of goodwill,
work stoppage, computer failure or malfunction, or any and all
other commercial damages or losses), even if such Contributor
has been advised of the possibility of such damages.

9. Accepting Warranty or Additional Liability. While redistributing

the Work or Derivative Works thereof, You may choose to offer,
and charge a fee for, acceptance of support, warranty, indemnity,
or other liability obligations and/or rights consistent with this
License. However, in accepting such obligations, You may act only
on Your own behalf and on Your sole responsibility, not on behalf
of any other Contributor, and only if You agree to indemnify,
defend, and hold each Contributor harmless for any liability
incurred by, or claims asserted against, such Contributor by reason
of your accepting any such warranty or additional liability.

END OF TERMS AND CONDITIONS

C.3.13 expat
A extensã o pyexpat é construída usando uma có pia incluída das fontes de expatriadas, a menos que a compilaçã o
esteja configurada --with-system-expat:

Copyright (c) 1998, 1999, 2000 Thai Open Source Software Center Ltd
and Clark Cooper

Permission is hereby granted, free of charge, to any person obtaining

(continua na pró xima pá gina)

120 Apêndice C. História e Licença

 Python Setup and Usage, Release 3.13.0

(continuaçã o da pá gina anterior)

a copy of this software and associated documentation files (the
"Software"), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:

The above copyright notice and this permission notice shall be included
in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,

EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

C.3.14 libffi
A extensã o C _ctypes subjacente ao mó dulo ctypes é construída usando uma có pia incluída das fontes do libffi,
a menos que a construçã o esteja configurada com --with-system-libffi:
Copyright (c) 1996-2008 Red Hat, Inc and others.

Permission is hereby granted, free of charge, to any person obtaining

a copy of this software and associated documentation files (the
``Software''), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:

The above copyright notice and this permission notice shall be included
in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED ``AS IS'', WITHOUT WARRANTY OF ANY KIND,

EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE SOFTWARE.

C.3.15 zlib
A extensã o zlib é construída usando uma có pia incluída das fontes zlib se a versã o do zlib encontrada no sistema
for muito antiga para ser usada na construçã o:
Copyright (C) 1995-2011 Jean-loup Gailly and Mark Adler

This software is provided 'as-is', without any express or implied

warranty. In no event will the authors be held liable for any damages
arising from the use of this software.

(continua na pró xima pá gina)

C.3. Licenças e Reconhecimentos para Software Incorporado 121

Python Setup and Usage, Release 3.13.0

(continuaçã o da pá gina anterior)

Permission is granted to anyone to use this software for any purpose,
including commercial applications, and to alter it and redistribute it
freely, subject to the following restrictions:

1. The origin of this software must not be misrepresented; you must not
claim that you wrote the original software. If you use this software
in a product, an acknowledgment in the product documentation would be
appreciated but is not required.

2. Altered source versions must be plainly marked as such, and must not be
misrepresented as being the original software.

3. This notice may not be removed or altered from any source distribution.

Jean-loup Gailly Mark Adler

[email protected] [email protected]

C.3.16 cfuhash
A implementaçã o da tabela de hash usada pelo tracemalloc é baseada no projeto cfuhash:

Copyright (c) 2005 Don Owens

All rights reserved.

This code is released under the BSD license:

Redistribution and use in source and binary forms, with or without

modification, are permitted provided that the following conditions
are met:

* Redistributions of source code must retain the above copyright

notice, this list of conditions and the following disclaimer.

* Redistributions in binary form must reproduce the above

copyright notice, this list of conditions and the following
disclaimer in the documentation and/or other materials provided
with the distribution.

* Neither the name of the author nor the names of its

contributors may be used to endorse or promote products derived
from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS

"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
OF THE POSSIBILITY OF SUCH DAMAGE.

122 Apêndice C. História e Licença

 Python Setup and Usage, Release 3.13.0

C.3.17 libmpdec
A extensã o C _decimal subjacente ao mó dulo decimal é construída usando uma có pia incluída da biblioteca
libmpdec, a menos que a construçã o esteja configurada com --with-system-libmpdec:

Copyright (c) 2008-2020 Stefan Krah. All rights reserved.

Redistribution and use in source and binary forms, with or without

modification, are permitted provided that the following conditions
are met:

1. Redistributions of source code must retain the above copyright

notice, this list of conditions and the following disclaimer.

2. Redistributions in binary form must reproduce the above copyright

notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.

THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS "AS IS" AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
SUCH DAMAGE.

C.3.18 Conjunto de testes C14N do W3C

O conjunto de testes C14N 2.0 no pacote test (Lib/test/xmltestdata/c14n-20/) foi recuperado do site do
W3C em https://www.w3.org/TR/xml-c14n2-testcases/ e é distribuído sob a licença BSD de 3 clá usulas:

Copyright (c) 2013 W3C(R) (MIT, ERCIM, Keio, Beihang),

All Rights Reserved.

Redistribution and use in source and binary forms, with or without

modification, are permitted provided that the following conditions
are met:

* Redistributions of works must retain the original copyright notice,

this list of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the original copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.
* Neither the name of the W3C nor the names of its contributors may be
used to endorse or promote products derived from this work without
specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS

"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
(continua na pró xima pá gina)

C.3. Licenças e Reconhecimentos para Software Incorporado 123

Python Setup and Usage, Release 3.13.0

(continuaçã o da pá gina anterior)

DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

C.3.19 mimalloc
Licença MIT:

Copyright (c) 2018-2021 Microsoft Corporation, Daan Leijen

Permission is hereby granted, free of charge, to any person obtaining a copy

of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

C.3.20 asyncio
Partes do mó dulo asyncio sã o incorporadas do uvloop 0.16, que é distribuído sob a licença MIT:

Copyright (c) 2015-2021 MagicStack Inc. http://magic.io

Permission is hereby granted, free of charge, to any person obtaining

a copy of this software and associated documentation files (the
"Software"), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:

The above copyright notice and this permission notice shall be

included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,

EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

124 Apêndice C. História e Licença

 Python Setup and Usage, Release 3.13.0

C.3.21 Global Unbounded Sequences (GUS)

O arquivo Python/qsbr.c é adaptado do esquema de recuperaçã o de memó ria segura “Global Unbounded Se-
quences” do FreeBSD em subr_smr.c. O arquivo é distribuído sob a licença BSD de 2 clá usulas:

Copyright (c) 2019,2020 Jeffrey Roberson <[email protected]>

Redistribution and use in source and binary forms, with or without

modification, are permitted provided that the following conditions
are met:
1. Redistributions of source code must retain the above copyright
notice unmodified, this list of conditions, and the following
disclaimer.
2. Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.

THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

C.3. Licenças e Reconhecimentos para Software Incorporado 125

Python Setup and Usage, Release 3.13.0

126 Apêndice C. História e Licença

 APÊNDICE D

Direitos autorais

Python e essa documentaçã o é :

Copyright © 2001-2024 Python Software Foundation. Todos os direitos reservados.
Copyright © 2000 BeOpen.com. Todos os direitos reservados.
Copyright © 1995-2000 Corporation for National Research Initiatives. Todos os direitos reservados.
Copyright © 1991-1995 Stichting Mathematisch Centrum. Todos os direitos reservados.

Veja: História e Licença para informaçõ es completas de licença e permissõ es.

127
Python Setup and Usage, Release 3.13.0

128 Apêndice D. Direitos autorais

 Índice

Não alfabético C
..., 87 -c
-? opção de linha de comando, 4
opção de linha de comando, 5 caminho de importação, 95
%APPDATA%, 49 carregador, 97
>>>, 87 CC
__future__, 93 opção de linha de comando, 27
__slots__, 101 CFLAGS, 30, 3941
opção de linha de comando, 27
A CFLAGS_NODIST, 3941
aguardável, 88 chamável, 89
ambiente virtual, 103 --check-hash-based-pycs
anotação, 87 opção de linha de comando, 6
anotação de função, 93 classe, 89
anotação de variável, 103 classe base abstrata, 87
apelido de tipo, 103 classe estilo novo, 98
API provisória, 100 codificação da localidade, 97
argumento, 87 codificador de texto, 102
argumento nomeado, 96 coleta de lixo, 93
argumento posicional, 100 compreensão de conjunto, 102
arquivo binário, 89 compreensão de dicionário, 91
arquivo texto, 102 compreensão de lista, 96
aspas triplas, 102 CONFIG_SITE
atributo, 88 opção de linha de comando, 36
contagem de referências, 101
B contexto, 90
-B contexto atual, 91
opção de linha de comando, 6 contíguo, 90
-b contíguo C, 90
opção de linha de comando, 6 contíguo Fortran, 90
BDFL, 89 corrotina, 90
BOLT_APPLY_FLAGS CPP
opção de linha de comando, 31 opção de linha de comando, 27
BOLT_INSTRUMENT_FLAGS CPPFLAGS, 39, 41
opção de linha de comando, 31 opção de linha de comando, 27
--build CPython, 91
opção de linha de comando, 36 CURSES_CFLAGS
bytecode, 89 opção de linha de comando, 27
BZIP2_CFLAGS CURSES_LIBS
opção de linha de comando, 27 opção de linha de comando, 27
BZIP2_LIBS
opção de linha de comando, 27 D
-d

129
Python Setup and Usage, Release 3.13.0

opção de linha de comando, 6 função chave, 96

decorador, 91 função de corrotina, 91
descritor, 91 função de retorno, 89
desligamento do interpretador, 95 função genérica, 94
despacho único, 102
dica de tipo, 103 G
dicionário, 91 gancho de entrada de caminho, 99
--disable-gil GDBM_CFLAGS
opção de linha de comando, 27 opção de linha de comando, 28
--disable-ipv6 GDBM_LIBS
opção de linha de comando, 24 opção de linha de comando, 28
--disable-test-modules gerador, 93
opção de linha de comando, 29 gerador assíncrono, 88
divisão pelo piso, 93 gerenciador de contexto, 90
docstring, 91 gerenciador de contexto assíncrono, 88
GIL, 94
E
-E H
opção de linha de comando, 6 -h
EAFP, 92 opção de linha de comando, 5
--enable-big-digits hasheável, 94
opção de linha de comando, 24 --help
--enable-bolt opção de linha de comando, 5
opção de linha de comando, 30 --help-all
--enable-framework opção de linha de comando, 5
opção de linha de comando, 35, 36 --help-env
--enable-loadable-sqlite-extensions opção de linha de comando, 5
opção de linha de comando, 24 --help-xoptions
--enable-optimizations opção de linha de comando, 5
opção de linha de comando, 30 --host
--enable-profiling opção de linha de comando, 36
opção de linha de comando, 31 HOSTRUNNER
--enable-pystats opção de linha de comando, 36
opção de linha de comando, 25
--enable-shared I
opção de linha de comando, 33 -I
--enable-universalsdk opção de linha de comando, 6
opção de linha de comando, 35 -i
--enable-wasm-dynamic-linking opção de linha de comando, 6
opção de linha de comando, 29 IDLE, 95
--enable-wasm-pthreads imortal, 95
opção de linha de comando, 29 importação, 95
entrada de caminho, 99 importador, 95
escopo aninhado, 98 imutável, 95
escopo otimizado, 98 instrução, 102
espaço de nomes, 98 interativo, 95
especial interpretado, 95
método, 102 iterador, 96
especificação do módulo, 97 iterador assíncrono, 88
--exec-prefix iterador gerador, 94
opção de linha de comando, 29 iterador gerador assíncrono, 88
expressão, 92 iterável, 95
expressão geradora, 94 iterável assíncrono, 88

F J
f-string, 92 -J
fatia, 102 opção de linha de comando, 11
função, 93

130 Índice
 Python Setup and Usage, Release 3.13.0

L mágico, 97
lambda, 96 método especial, 102
LBYL, 96 método mágico, 97
LDFLAGS, 39, 41 módulo, 97
opção de linha de comando, 27 módulo de extensão, 92
LDFLAGS_NODIST, 41 MRO, 98
LIBB2_CFLAGS mutável, 98
opção de linha de comando, 28
LIBB2_LIBS
N
opção de linha de comando, 28 nome qualificado, 101
LIBEDIT_CFLAGS novas linhas universais, 103
opção de linha de comando, 28 número complexo, 90
LIBEDIT_LIBS
opção de linha de comando, 28 O
LIBFFI_CFLAGS -O
opção de linha de comando, 28 opção de linha de comando, 7
LIBFFI_LIBS objeto, 98
opção de linha de comando, 28 objeto arquivo, 92
LIBLZMA_CFLAGS objeto arquivo ou similar, 92
opção de linha de comando, 28 objeto byte ou similar, 89
LIBLZMA_LIBS objeto caminho ou similar, 100
opção de linha de comando, 28 -OO
LIBMPDEC_CFLAGS opção de linha de comando, 7
opção de linha de comando, 28 opção de linha de comando
LIBMPDEC_LIBS -?, 5
opção de linha de comando, 28 -B, 6
LIBREADLINE_CFLAGS -b, 6
opção de linha de comando, 28 BOLT_APPLY_FLAGS, 31
LIBREADLINE_LIBS BOLT_INSTRUMENT_FLAGS, 31
opção de linha de comando, 28 --build, 36
LIBS BZIP2_CFLAGS, 27
opção de linha de comando, 27 BZIP2_LIBS, 27
LIBSQLITE3_CFLAGS -c, 4
opção de linha de comando, 28 CC, 27
LIBSQLITE3_LIBS CFLAGS, 27
opção de linha de comando, 28 --check-hash-based-pycs, 6
LIBUUID_CFLAGS CONFIG_SITE, 36
opção de linha de comando, 28 CPP, 27
LIBUUID_LIBS CPPFLAGS, 27
opção de linha de comando, 28 CURSES_CFLAGS, 27
lista, 96 CURSES_LIBS, 27
localizador, 93 -d, 6
localizador baseado no caminho, 100 --disable-gil, 27
localizador de entrada de caminho, 99 --disable-ipv6, 24
localizador de metacaminho, 97 --disable-test-modules, 29
-E, 6
M --enable-big-digits, 24
-m --enable-bolt, 30
opção de linha de comando, 4 --enable-framework, 35, 36
MACHDEP --enable-loadable-sqlite-extensions,
opção de linha de comando, 27 24
mágico --enable-optimizations, 30
método, 97 --enable-profiling, 31
mapeamento, 97 --enable-pystats, 25
máquina virtual, 104 --enable-shared, 33
metaclasse, 97 --enable-universalsdk, 35
método, 97 --enable-wasm-dynamic-linking, 29
especial, 102 --enable-wasm-pthreads, 29

Índice 131
Python Setup and Usage, Release 3.13.0

--exec-prefix, 29 --with-computed-gotos, 31
GDBM_CFLAGS, 28 --with-dbmliborder, 25
GDBM_LIBS, 28 --with-dtrace, 33
-h, 5 --with-emscripten-target, 29
--help, 5 --with-ensurepip, 29
--help-all, 5 --with-framework-name, 35, 36
--help-env, 5 --with-hash-algorithm, 34
--help-xoptions, 5 --with-libc, 34
--host, 36 --with-libm, 34
HOSTRUNNER, 36 --with-libs, 33
-I, 6 --with-lto, 30
-i, 6 --with-memory-sanitizer, 33
-J, 11 --with-openssl, 34
LDFLAGS, 27 --with-openssl-rpath, 34
LIBB2_CFLAGS, 28 --without-c-locale-coercion, 25
LIBB2_LIBS, 28 --without-decimal-contextvar, 25
LIBEDIT_CFLAGS, 28 --without-doc-strings, 31
LIBEDIT_LIBS, 28 --without-freelists, 25
LIBFFI_CFLAGS, 28 --without-mimalloc, 31
LIBFFI_LIBS, 28 --without-pymalloc, 31
LIBLZMA_CFLAGS, 28 --without-readline, 34
LIBLZMA_LIBS, 28 --without-static-libpython, 33
LIBMPDEC_CFLAGS, 28 --with-pkg-config, 25
LIBMPDEC_LIBS, 28 --with-platlibdir, 25
LIBREADLINE_CFLAGS, 28 --with-pydebug, 32
LIBREADLINE_LIBS, 28 --with-readline, 34
LIBS, 27 --with-ssl-default-suites, 35
LIBSQLITE3_CFLAGS, 28 --with-strict-overflow, 31
LIBSQLITE3_LIBS, 28 --with-suffix, 24
LIBUUID_CFLAGS, 28 --with-system-expat, 33
LIBUUID_LIBS, 28 --with-system-libmpdec, 33
-m, 4 --with-thread-sanitizer, 33
MACHDEP, 27 --with-trace-refs, 32
-O, 7 --with-tzpath, 24
-OO, 7 --with-undefined-behavior-sanitizer,
-P, 7 33
PANEL_CFLAGS, 28 --with-universal-archs, 35
PANEL_LIBS, 29 --with-valgrind, 33
PKG_CONFIG, 27 --with-wheel-pkg-dir, 25
PKG_CONFIG_LIBDIR, 27 -X, 9
PKG_CONFIG_PATH, 27 -x, 9
--prefix, 29 ZLIB_CFLAGS, 29
-q, 7 ZLIB_LIBS, 29
-R, 7 OPT, 33
-S, 8 ordem de resolução de métodos, 97
-s, 7
TCLTK_CFLAGS, 29 P
TCLTK_LIBS, 29 -P
-u, 8 opção de linha de comando, 7
-V, 6 pacote, 99
-v, 8 pacote de espaço de nomes, 98
--version, 6 pacote provisório, 100
-W, 8 pacote regular, 101
--with-address-sanitizer, 33 PANEL_CFLAGS
--with-app-store-compliance, 35 opção de linha de comando, 28
--with-assertions, 32 PANEL_LIBS
--with-build-python, 36 opção de linha de comando, 29
--with-builtin-hashlib-hashes, 34 parâmetro, 99

132 Índice
 Python Setup and Usage, Release 3.13.0

PATH, 11, 20, 44, 46, 53, 54, 56 PYTHON_GIL, 10, 94

PATHEXT, 46 PYTHON_PERF_JIT_SUPPORT, 10
PEP, 100 PYTHON_PRESITE, 10
PKG_CONFIG PYTHONCOERCECLOCALE, 25
opção de linha de comando, 27 PYTHONDEBUG, 6, 32
PKG_CONFIG_LIBDIR PYTHONDEVMODE, 9
opção de linha de comando, 27 PYTHONDONTWRITEBYTECODE, 6
PKG_CONFIG_PATH PYTHONDUMPREFS, 32
opção de linha de comando, 27 PYTHONFAULTHANDLER, 9
porção, 100 PYTHONHASHSEED, 7, 13
--prefix PYTHONHOME, 6, 11, 59, 60
opção de linha de comando, 29 Pythônico, 100
PROFILE_TASK, 30 PYTHONINSPECT, 6
Propostas de Melhorias do Python PYTHONINTMAXSTRDIGITS, 9
PEP 1, 100 PYTHONIOENCODING, 15
PEP 7, 23 PYTHONLEGACYWINDOWSSTDIO, 13
PEP 8, 85 PYTHONMALLOC, 15, 31
PEP 11, 23, 43, 61 PYTHONNODEBUGRANGES, 10
PEP 238, 93 PYTHONNOUSERSITE, 7
PEP 278, 103 PYTHONOPTIMIZE, 7
PEP 302, 97 PYTHONPATH, 6, 11, 53, 59, 60
PEP 338, 4 PYTHONPERFSUPPORT, 10
PEP 343, 90 PYTHONPROFILEIMPORTTIME, 9
PEP 362, 88, 99 PYTHONPYCACHEPREFIX, 9
PEP 370, 8, 13 PYTHONSAFEPATH, 7
PEP 397, 54 PYTHONSTARTUP, 6, 12
PEP 411, 100 PYTHONTRACEMALLOC, 9
PEP 420, 98, 100 PYTHONUNBUFFERED, 8
PEP 443, 94 PYTHONUTF8, 9, 16, 54
PEP 483, 94 PYTHONVERBOSE, 8
PEP 484, 87, 93, 94, 103 PYTHONWARNDEFAULTENCODING, 9
PEP 488, 7 PYTHONWARNINGS, 9
PEP 492, 88, 90, 91
PEP 498, 92 Q
PEP 514, 55 -q
PEP 519, 100 opção de linha de comando, 7
PEP 525, 88
PEP 526, 87, 103 R
PEP 528, 54 -R
PEP 529, 15, 54 opção de linha de comando, 7
PEP 538, 16, 25 referência emprestada, 89
PEP 585, 94 referência forte, 102
PEP 683, 95 REPL, 101
PEP 703, 48, 72, 93, 94
PEP 3116, 103 S
PEP 3155, 101
-S
protocolo de gerenciamento de contexto, 90
opção de linha de comando, 8
PY_PYTHON, 57
-s
pyc baseado em hash, 94
opção de linha de comando, 7
PYLAUNCHER_ALLOW_INSTALL, 58
sequência, 101
PYLAUNCHER_ALWAYS_INSTALL, 58
suavemente descontinuado, 102
PYLAUNCHER_DEBUG, 58
PYLAUNCHER_DRYRUN, 58 T
PYLAUNCHER_NO_SEARCH_PATH, 56
TCLTK_CFLAGS
Python 3000, 100
opção de linha de comando, 29
PYTHON_COLORS, 11
TCLTK_LIBS
PYTHON_CPU_COUNT, 10
opção de linha de comando, 29
PYTHON_FROZEN_MODULES, 10
TEMP, 49

Índice 133
Python Setup and Usage, Release 3.13.0

threads livres, 93 PYLAUNCHER_ALLOW_INSTALL, 58

tipagem pato, 92 PYLAUNCHER_ALWAYS_INSTALL, 58
tipo, 103 PYLAUNCHER_DEBUG, 58
tipo genérico, 94 PYLAUNCHER_DRYRUN, 58
tratador de erros e codificação do PYLAUNCHER_NO_SEARCH_PATH, 56
sistema de arquivos, 92 PYTHON_BASIC_REPL, 17
trava global do interpretador, 94 PYTHON_COLORS, 11, 17
tupla nomeada, 98 PYTHON_CPU_COUNT, 10, 16
PYTHON_FROZEN_MODULES, 10, 16
U PYTHON_GIL, 10, 17, 94
-u PYTHON_HISTORY, 17
opção de linha de comando, 8 PYTHON_PERF_JIT_SUPPORT, 10, 16
PYTHON_PRESITE, 10, 17
V PYTHONASYNCIODEBUG, 14
-V PYTHONBREAKPOINT, 12
opção de linha de comando, 6 PYTHONCASEOK, 12
-v PYTHONCOERCECLOCALE, 15, 25
opção de linha de comando, 8 PYTHONDEBUG, 6, 12, 32
variável de ambiente PYTHONDEVMODE, 9, 16
%APPDATA%, 49 PYTHONDONTWRITEBYTECODE, 6, 12
BASECFLAGS, 40 PYTHONDUMPREFS, 17, 32
BASECPPFLAGS, 39 PYTHONDUMPREFSFILE, 17
BLDSHARED, 41 PYTHONEXECUTABLE, 13
CC, 39 PYTHONFAULTHANDLER, 9, 14
CCSHARED, 40 PYTHONHASHSEED, 7, 12, 13
CFLAGS, 30, 3941 PYTHONHOME, 6, 11, 59, 60
CFLAGS_ALIASING, 40 PYTHONINSPECT, 6, 12
CFLAGS_NODIST, 3941 PYTHONINTMAXSTRDIGITS, 9, 13
CFLAGSFORSHARED, 40 PYTHONIOENCODING, 13, 15
COMPILEALL_OPTS, 40 PYTHONLEGACYWINDOWSFSENCODING, 15
CONFIGURE_CFLAGS, 40 PYTHONLEGACYWINDOWSSTDIO, 13, 15
CONFIGURE_CFLAGS_NODIST, 40 PYTHONMALLOC, 14, 15, 31
CONFIGURE_CPPFLAGS, 39 PYTHONMALLOCSTATS, 14
CONFIGURE_LDFLAGS, 41 PYTHONNODEBUGRANGES, 10, 16
CONFIGURE_LDFLAGS_NODIST, 41 PYTHONNOUSERSITE, 7, 13
CPPFLAGS, 39, 41 PYTHONOPTIMIZE, 7, 12
CXX, 39 PYTHONPATH, 6, 11, 53, 59, 60
EXTRA_CFLAGS, 40 PYTHONPERFSUPPORT, 10, 16
LDFLAGS, 39, 41 PYTHONPLATLIBDIR, 11
LDFLAGS_NODIST, 41 PYTHONPROFILEIMPORTTIME, 9, 14
LDSHARED, 41 PYTHONPYCACHEPREFIX, 9, 12
LIBS, 41 PYTHONSAFEPATH, 7, 11
LINKCC, 41 PYTHONSTARTUP, 6, 11, 12
OPT, 33, 40 PYTHONTRACEMALLOC, 9, 14
PATH, 11, 20, 44, 46, 53, 54, 56 PYTHONUNBUFFERED, 8, 12
PATHEXT, 46 PYTHONUSERBASE, 13
PROFILE_TASK, 30 PYTHONUTF8, 9, 16, 54
PURIFY, 41 PYTHONVERBOSE, 8, 12
PY_BUILTIN_MODULE_CFLAGS, 40 PYTHONWARNDEFAULTENCODING, 9, 16
PY_CFLAGS, 40 PYTHONWARNINGS, 9, 13
PY_CFLAGS_NODIST, 40 TEMP, 49
PY_CORE_CFLAGS, 40 variável de classe, 89
PY_CORE_LDFLAGS, 41 variável de clausura, 90
PY_CPPFLAGS, 39 variável de contexto, 90
PY_LDFLAGS, 41 variável livre, 93
PY_LDFLAGS_NODIST, 41 verificador de tipo estático, 102
PY_PYTHON, 57 --version
PY_STDMODULE_CFLAGS, 40 opção de linha de comando, 6

134 Índice
 Python Setup and Usage, Release 3.13.0

visão de dicionário, 91 opção de linha de comando, 33

--with-pkg-config
W opção de linha de comando, 25
-W --with-platlibdir
opção de linha de comando, 8 opção de linha de comando, 25
--with-address-sanitizer --with-pydebug
opção de linha de comando, 33 opção de linha de comando, 32
--with-app-store-compliance --with-readline
opção de linha de comando, 35 opção de linha de comando, 34
--with-assertions --with-ssl-default-suites
opção de linha de comando, 32 opção de linha de comando, 35
--with-build-python --with-strict-overflow
opção de linha de comando, 36 opção de linha de comando, 31
--with-builtin-hashlib-hashes --with-suffix
opção de linha de comando, 34 opção de linha de comando, 24
--with-computed-gotos --with-system-expat
opção de linha de comando, 31 opção de linha de comando, 33
--with-dbmliborder --with-system-libmpdec
opção de linha de comando, 25 opção de linha de comando, 33
--with-dtrace --with-thread-sanitizer
opção de linha de comando, 33 opção de linha de comando, 33
--with-emscripten-target --with-trace-refs
opção de linha de comando, 29 opção de linha de comando, 32
--with-ensurepip --with-tzpath
opção de linha de comando, 29 opção de linha de comando, 24
--with-framework-name --with-undefined-behavior-sanitizer
opção de linha de comando, 35, 36 opção de linha de comando, 33
--with-hash-algorithm --with-universal-archs
opção de linha de comando, 34 opção de linha de comando, 35
--with-libc --with-valgrind
opção de linha de comando, 34 opção de linha de comando, 33
--with-libm --with-wheel-pkg-dir
opção de linha de comando, 34 opção de linha de comando, 25
--with-libs
opção de linha de comando, 33 X
--with-lto -X
opção de linha de comando, 30 opção de linha de comando, 9
--with-memory-sanitizer -x
opção de linha de comando, 33 opção de linha de comando, 9
--with-openssl
opção de linha de comando, 34 Z
--with-openssl-rpath Zen do Python, 104
opção de linha de comando, 34 ZLIB_CFLAGS
--without-c-locale-coercion opção de linha de comando, 29
opção de linha de comando, 25 ZLIB_LIBS
--without-decimal-contextvar opção de linha de comando, 29
opção de linha de comando, 25
--without-doc-strings
opção de linha de comando, 31
--without-freelists
opção de linha de comando, 25
--without-mimalloc
opção de linha de comando, 31
--without-pymalloc
opção de linha de comando, 31
--without-readline
opção de linha de comando, 34
--without-static-libpython

Índice 135