The Python standard library¶
This library reference manual describes the standard library distributed with Python. It also describes some of the optional components that are commonly included in Python distributions.
Elsewhere, A Referência da Linguagem Python describes the exact syntax and semantics of the Python language, and Referência da bibliotecas embutidas do Python describes the built-in functions.
Python’s standard library is extensive, offering a wide range of facilities as indicated by the long table of contents listed below. The library contains built-in modules (written in C) that provide access to system functionality such as file I/O that would otherwise be inaccessible to Python programmers, as well as modules written in Python that provide standardized solutions for many problems that occur in everyday programming. Some of these modules are explicitly designed to encourage and enhance the portability of Python programs by abstracting away platform-specifics into platform-neutral APIs.
Os instaladores do Python para a plataforma Windows geralmente incluem toda a biblioteca padrão e muitas vezes também incluem muitos componentes adicionais. Para sistemas operacionais semelhantes a Unix, o Python é normalmente fornecido como uma coleção de pacotes, portanto, pode ser necessário usar as ferramentas de empacotamento fornecidas com o sistema operacional para obter alguns ou todos os componentes opcionais.
Além da biblioteca padrão, há uma coleção ativa de centenas de milhares de componentes (de programas e módulos individuais a pacotes e frameworks de desenvolvimento de aplicativos inteiros), disponíveis no Python Package Index.
- Introdução
- Serviços de Processamento de Texto
string— Operações comuns de stringsstring.templatelib— Suporte para literais de string templatere— Operações com expressões regularesdifflib— Helpers for computing deltastextwrap— Quebra automática e preenchimento de textounicodedata— Banco de dados de Unicodestringprep— Preparação de string para internetreadline— Interface para o GNU readlinerlcompleter— Função de autocomplemento para GNU readline
- Serviços de Dados Binários
- Tipos de Dados
datetime— Tipos básicos de data e horazoneinfo— Suporte a fuso horário da IANAcalendar— Funções gerais relacionadas ao calendáriocollections— Tipos de dados de contêinerescollections.abc— Classes Base Abstratas para Contêineresheapq— Algoritmo de fila heapbisect— Algoritmo de bisseção de vetorarray— Vetores eficientes de valores numéricosweakref— Referências fracastypes— Criação de tipos dinâmicos e nomes para tipos embutidoscopy— Operações de cópia profunda e cópia rasapprint— Impressão bonita de dadosreprlib— Implementação alternativa àrepr()enum— Suporte a enumeraçõesgraphlib— Funcionalidade para operar com estruturas do tipo grafo
- Módulos Matemáticos e Numéricos
- Módulos de Programação Funcional
- Acesso a arquivos e diretórios
pathlib— Caminhos do sistema de arquivos orientados a objetosos.path— Manipulações comuns de nomes de caminhosstat— Interpretando resultados destat()filecmp— Comparações de arquivos e diretóriostempfile— Generate temporary files and directoriesglob— Expansão de padrão de nome de arquivo no estilo Unixfnmatch— Correspondência de padrões de nome de arquivo Unixlinecache— Acesso aleatório a linhas de textoshutil— Operações de arquivo de alto nível
- Persistência de Dados
- Compressão de Dados e Arquivamento
- O pacote
compression compression.zstd— Compactação compatível com o formato Zstandardzlib— Compactação compatível com gzipgzip— Suporte para arquivos gzipbz2— Suporte para compressão bzip2lzma— Compressão usando o algoritmo LZMAzipfile— Trabalha com arquivos ZIPtarfile— Ler e gravar arquivos do tipo tar
- O pacote
- Formatos de Arquivo
- Serviços Criptográficos
- Serviços Genéricos do Sistema Operacional
os— Diversas interfaces de sistema operacionalio— Ferramentas essenciais para trabalhar com fluxostime— Acesso e conversões de tempologging— Recursos de registro de eventos para Pythonlogging.config— Configuração do módulo logginglogging.handlers— Manipuladores de loggingplatform— Acesso aos dados de identificação da plataforma subjacenteerrno— Símbolos padrão do sistema errnoctypes— Uma biblioteca de funções externas para Python
- Bibliotecas de interface de linha de comando
argparse— Analisador sintático para opções de linha de comando, argumentos e subcomandosoptparse— Analisador sintático para opções de linha de comandogetpass— Entrada de senha portátilfileinput— Itera sobre linhas de múltiplos fluxos de entradacurses— Gerenciador de terminal para visualizadores de células de caracteres.curses.textpad— Text input widget for curses programscurses.ascii— Utilitários para caracteres ASCIIcurses.panel— Uma extensão de pilha de painéis para o cursescmd— Suporte para interpretadores de comando orientado a linhas
- Execução Concorrente
threading— Paralelismo baseado em threadsmultiprocessing— Paralelismo baseado em processomultiprocessing.shared_memory— Memória compartilhada para acesso direto entre processos- O pacote
concurrent concurrent.futures— Launching parallel tasksconcurrent.interpreters— Múltiplos interpretadores no mesmo processosubprocess— Gerenciamento de subprocessossched— Agendador de eventosqueue— Uma classe de fila sincronizadacontextvars— Variáveis de contexto_thread— API de segmentação de baixo nível
- Comunicação em Rede e Interprocesso
- Manuseio de Dados na Internet
email— Um e-mail e um pacote MIME manipuláveljson— Codificador e decodificador JSONmailbox— Manipule caixas de entradas em vários formatosmimetypes— Mapeia nomes de arquivos para tipos MIMEbase64— Base16, Base32, Base64, Base85 Data Encodingsbinascii— Converte entre binário e ASCIIquopri— Codifica e decodifica dados MIME imprimidos entre aspas
- Ferramentas de Processamento de Markup Estruturado
html— Suporte HTML (HyperText Markup Language)html.parser— Analisador simples de HTML e XHTMLhtml.entities— Definições de entidades gerais de HTML- Módulos de Processamento de XML
xml.etree.ElementTree— A API XML ElementTreexml.dom— The Document Object Model APIxml.dom.minidom— Minimal DOM implementationxml.dom.pulldom— Suporte para construir árvores parciais de DOMxml.sax— Support for SAX2 parsersxml.sax.handler— Classes base para manipuladores de SAXxml.sax.saxutils— Utilitários de SAXxml.sax.xmlreader— Interface for XML parsersxml.parsers.expat— Fast XML parsing using Expat
- Protocolos de Internet e Suporte
webbrowser— Controlador de navegador web convenientewsgiref— Implementação de referência e utilitários WSGIurllib— Módulos de manipulação de URLurllib.request— Biblioteca extensível para abrir URLsurllib.response— Response classes used by urlliburllib.parse— Analisa URLs para componentesurllib.error— Classes de exceção levantadas por urllib.requesturllib.robotparser— Analisador sintático de robots.txthttp— Módulos HTTPhttp.client— HTTP protocol clientftplib— FTP protocol clientpoplib— Cliente de protocolo POP3imaplib— IMAP4 protocol clientsmtplib— Cliente de protocolo SMTPuuid— Objetos UUID conforme RFC 9562socketserver— Um framework para servidores de redehttp.server— HTTP servershttp.cookies— HTTP state managementhttp.cookiejar— Cookie handling for HTTP clientsxmlrpc— Módulos de servidor e cliente XMLRPCxmlrpc.client— Cliente XML-RPCxmlrpc.server— Servidores XML-RPC básicosipaddress— Biblioteca de manipulação de IPv4/IPv6
- Serviços Multimídia
- Internacionalização
- Interfaces gráficas de usuário com Tk
tkinter— Interface Python para Tcl/Tktkinter.colorchooser— Diálogo de escolha de cortkinter.font— Invólucro de fontes Tkinter- Tkinter dialogs
tkinter.messagebox— Prompts de mensagem do Tkintertkinter.scrolledtext— Widget de texto com scrollbartkinter.dnd— Suporte para arrastar e soltartkinter.ttk— Widgets temáticos do Tk- IDLE — editor e console Python
turtle— Gráficos tartaruga
- Ferramentas de Desenvolvimento
typing— Suporte para dicas de tipopydoc— Gerador de documentação e sistema de ajuda online- Modo de Desenvolvimento do Python
doctest— Teste exemplos interativos de Pythonunittest— Framework de testes unitáriosunittest.mock— mock object libraryunittest.mock— primeiros passostest— Pacote de Testes de Regressão do Pythontest.support— Utilities for the Python test suitetest.support.socket_helper— Utilities for socket teststest.support.script_helper— Utilities for the Python execution teststest.support.bytecode_helper— Support tools for testing correct bytecode generationtest.support.threading_helper— Utilities for threading teststest.support.os_helper— Utilities for os teststest.support.import_helper— Utilities for import teststest.support.warnings_helper— Utilities for warnings tests
- Depuração e perfilamento
- Tabela de eventos de auditoria
bdb— Framework do depuradorfaulthandler— Dump the Python tracebackpdb— O depurador do Python- Os Profilers do Python
timeit— Mede o tempo de execução de pequenos trechos de códigotrace— Rastreia ou acompanha a execução de instruções Pythontracemalloc— Trace memory allocations
- Empacotamento e Distribuição de Software
- Serviços de Tempo de Execução Python
sys— Parâmetros e funções específicas do sistemasys.monitoring— Monitoramento de eventos de execuçãosysconfig— Fornece acesso às informações de configuração do Pythonbuiltins— Objetos embutidos__main__— Ambiente de código principalwarnings— Controle de avisosdataclasses— Data Classescontextlib— Utilitários para contextos da instruçãowithabc— Classes base abstratasatexit— Manipuladores de saídatraceback— Imprime ou recupera um traceback da pilha__future__— Definições de instruções futuregc— Interface para o coletor de lixoinspect— Inspecione objetos vivosannotationlib— Funcionalidade para introspecção de anotaçõessite— Gancho de configuração específico do site
- Interpretadores Python Personalizados
- Importando módulos
zipimport- Importa módulos de arquivos Zippkgutil— Utilitário de extensão de pacotemodulefinder— Procura módulos usados por um scriptrunpy— Localizando e executando módulos Pythonimportlib— A implementação deimportimportlib.resources– Leitura, abertura e acesso a recursos de pacotesimportlib.resources.abc– Classes base abstratas para recursosimportlib.metadata– Acessando metadados do pacote- A inicialização do caminho de pesquisa de módulos
sys.path
- Serviços da Linguagem Python
ast— Árvores de sintaxe abstratasymtable— Acesso a tabela de símbolos do compiladortoken— Constantes usadas com árvores de análises do Pythonkeyword— Testando palavras reservadas do Pythontokenize— Tokenizador para código-fonte Pythontabnanny— Detecção de indentação ambíguapyclbr— Suporte a navegador de módulos do Pythonpy_compile— Compila arquivos fonte do Pythoncompileall— Compilar bibliotecas do Python para bytecodedis— Disassembler de bytecode do Pythonpickletools— Ferramentas para desenvolvedores pickle
- Serviços Específicos do MS Windows
- Serviços específicos do Unix
shlex— Simple lexical analysisposix— As chamadas de sistema mais comuns do POSIXpwd— A senha do banco de dadosgrp— O banco de dados de grupostermios— Controle de tty no estilo POSIXtty— Funções de controle de terminalpty— Utilitários de pseudoterminalfcntl— as chamadas de sistemafcntleioctlresource— Informação de uso de recursossyslog— Rotinas da biblioteca syslog do Unix
- Interface de linha de comando (CLI) de módulos
- Módulos substituídos
- Módulos removidos
- Considerações de Segurança