A Biblioteca Padrão do Python
*****************************

Enquanto A Referência da Linguagem Python descreve a sintaxe e a
semântica exatas da linguagem Python, este manual de referência de
bibliotecas descreve a biblioteca padrão que é distribuída com o
Python. Ele também descreve alguns dos componentes opcionais que são
comumente incluídos nas distribuições do Python.

A biblioteca padrão do Python é muito extensa, oferecendo uma ampla
gama de recursos, conforme indicado pelo longo índice listado abaixo.
A biblioteca contém módulos embutidos (escritos em C) que fornecem
acesso à funcionalidade do sistema, como E/S de arquivos que de outra
forma seriam inacessíveis para programadores Python, bem como módulos
escritos em Python que fornecem soluções padronizadas para muitos
problemas que ocorrem em programação cotidiana. Alguns desses módulos
são explicitamente projetados para incentivar e aprimorar a
portabilidade de programas em Python, abstraindo os detalhes da
plataforma em APIs neutras em plataforma.

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

  * Observações sobre disponibilidade

* Funções embutidas

* Constantes embutidas

  * Constantes adicionadas pelo módulo "site"

* Tipos embutidos

  * Teste do valor verdade

  * Operações booleanas --- "and", "or", "not"

  * Comparações

  * Tipos numéricos --- "int", "float", "complex"

  * Tipo booleano - "bool"

  * Tipos iteradores

  * Tipos sequências --- "list", "tuple", "range"

  * Tipo sequência de texto --- "str"

  * Tipos de Sequência Binária --- "bytes", "bytearray", "memoryview"

  * Tipo conjuntos --- "set", "frozenset"

  * Tipo mapeamento --- "dict"

  * Tipos de Gerenciador de Contexto

  * Tipos de anotação de tipo --- *Apelido genérico*, *União*

  * Outros tipos embutidos

  * Atributos Especiais

  * Limitação de comprimento de string na conversão para inteiro

* Exceções embutidas

  * Contexto da exceção

  * Herdando de exceções embutidas

  * Classes base

  * Exceções concretas

  * Avisos

  * Grupos de exceções

  * Hierarquia das exceções

* Serviços de Processamento de Texto

  * "string" --- Operações comuns de strings

  * "re" --- Operações com expressões regulares

  * "difflib" --- Helpers for computing deltas

  * "textwrap" --- Quebra automática e preenchimento de texto

  * "unicodedata" --- Unicode Database

  * "stringprep" --- Internet String Preparation

  * "readline" --- Interface para o GNU readline

  * "rlcompleter" --- Função de autocomplemento para GNU readline

* Serviços de Dados Binários

  * "struct" --- Interpret bytes as packed binary data

  * "codecs" --- Codec registry and base classes

* Tipos de Dados

  * "datetime" --- Tipos básicos de data e hora

  * "zoneinfo" --- IANA time zone support

  * "calendar" --- General calendar-related functions

  * "collections" --- Tipos de dados de contêineres

  * "collections.abc" --- Abstract Base Classes for Containers

  * "heapq" --- Algoritmo de fila heap

  * "bisect" --- Array bisection algorithm

  * "array" --- Efficient arrays of numeric values

  * "weakref" --- Referências fracas

  * "types" --- Criação de tipos dinâmicos e nomes para tipos
    embutidos

  * "copy" --- Shallow and deep copy operations

  * "pprint" --- Impressão bonita de dados

  * "reprlib" --- Alternate "repr()" implementation

  * "enum" --- Support for enumerations

  * "graphlib" --- Funcionalidade para operar com estruturas do tipo
    grafo

* Módulos Matemáticos e Numéricos

  * "numbers" --- Numeric abstract base classes

  * "math" --- Funções matemáticas

  * "cmath" --- Funções matemáticas para números complexos

  * "decimal" --- Aritmética de ponto fixo decimal e ponto flutuante

  * "fractions" --- Rational numbers

  * "random" --- Gera números pseudoaleatórios

  * "statistics" --- Mathematical statistics functions

* Módulos de Programação Funcional

  * "itertools" --- Functions creating iterators for efficient looping

  * "functools" --- Higher-order functions and operations on callable
    objects

  * "operator" --- Operadores padrões como funções

* Acesso a arquivos e diretórios

  * "pathlib" --- Caminhos do sistema de arquivos orientados a objetos

  * "os.path" --- Manipulações comuns de nomes de caminhos

  * "fileinput" --- Itera sobre linhas de múltiplos fluxos de entrada

  * "stat" --- Interpretando resultados de "stat()"

  * "filecmp" --- File and Directory Comparisons

  * "tempfile" --- Generate temporary files and directories

  * "glob" --- Unix style pathname pattern expansion

  * "fnmatch" --- Correspondência de padrões de nome de arquivo Unix

  * "linecache" --- Acesso aleatório a linhas de texto

  * "shutil" --- High-level file operations

* Persistência de Dados

  * "pickle" --- Serialização de objetos Python

  * "copyreg" --- Registra funções de suporte "pickle"

  * "shelve" --- Python object persistence

  * "marshal" --- Serialização interna de objetos Python

  * "dbm" --- Interfaces to Unix "databases"

  * "sqlite3" --- DB-API 2.0 interface for SQLite databases

* Compressão de Dados e Arquivamento

  * "zlib" --- Compactação compatível com **gzip**

  * "gzip" --- Support for **gzip** files

  * "bz2" --- Suporte para compressão **bzip2**

  * "lzma" --- Compression using the LZMA algorithm

  * "zipfile" --- Trabalha com arquivos ZIP

  * "tarfile" --- Ler e gravar arquivos do tipo tar

* Formatos de Arquivo

  * "csv" --- Leitura e escrita de arquivos CSV

  * "configparser" --- Analisador sintático de arquivo de configuração

  * "tomllib" --- Analisa arquivos TOML

  * "netrc" --- Arquivo de processamento netrc

  * "plistlib" --- Generate and parse Apple ".plist" files

* Serviços Criptográficos

  * "hashlib" --- Secure hashes and message digests

  * "hmac" --- Keyed-Hashing for Message Authentication

  * "secrets" --- Gera números aleatórios seguros para gerenciar
    segredos

* Serviços Genéricos do Sistema Operacional

  * "os" --- Diversas interfaces de sistema operacional

  * "io" --- Core tools for working with streams

  * "time" --- Acesso ao horário e conversões

  * "argparse" --- Analisador sintático para opções de linha de
    comando, argumentos e subcomandos

  * "logging" --- Recurso de utilização do Logging para Python

  * "logging.config" --- Logging configuration

  * "logging.handlers" --- Logging handlers

  * "getpass" --- Entrada de senha portátil

  * "curses" --- Terminal handling for character-cell displays

  * "curses.textpad" --- Text input widget for curses programs

  * "curses.ascii" --- Utilities for ASCII characters

  * "curses.panel" --- A panel stack extension for curses

  * "platform" ---  Access to underlying platform's identifying data

  * "errno" --- Standard errno system symbols

  * "ctypes" --- A foreign function library for Python

* Execução Concorrente

  * "threading" --- Thread-based parallelism

  * "multiprocessing" --- Paralelismo baseado em processo

  * "multiprocessing.shared_memory" --- Shared memory for direct
    access across processes

  * O pacote "concurrent"

  * "concurrent.futures" --- Launching parallel tasks

  * "subprocess" --- Subprocess management

  * "sched" --- Event scheduler

  * "queue" --- A synchronized queue class

  * "contextvars" --- Variáveis de contexto

  * "_thread" --- Low-level threading API

* Comunicação em Rede e Interprocesso

  * "asyncio" --- E/S assíncrona

  * "socket" --- Low-level networking interface

  * "ssl" --- TLS/SSL wrapper for socket objects

  * "select" --- Waiting for I/O completion

  * "selectors" --- High-level I/O multiplexing

  * "signal" --- Define manipuladores para eventos assíncronos

  * "mmap" --- Memory-mapped file support

* Manuseio de Dados na Internet

  * "email" --- Um e-mail e um pacote MIME manipulável

  * "json" --- Codificador e decodificador JSON

  * "mailbox" --- Manipulate mailboxes in various formats

  * "mimetypes" --- Map filenames to MIME types

  * "base64" --- Base16, Base32, Base64, Base85 Data Encodings

  * "binascii" --- Convert between binary and ASCII

  * "quopri" --- Codifica e decodifica dados MIME imprimidos entre
    aspas

* Ferramentas de Processamento de Markup Estruturado

  * "html" --- Suporte HTML (HyperText Markup Language)

  * "html.parser" --- Simple HTML and XHTML parser

  * "html.entities" --- Definições de entidades gerais de HTML

  * Módulos de Processamento de XML

  * "xml.etree.ElementTree" --- A API XML ElementTree

  * "xml.dom" --- The Document Object Model API

  * "xml.dom.minidom" --- Minimal DOM implementation

  * "xml.dom.pulldom" --- Support for building partial DOM trees

  * "xml.sax" --- Support for SAX2 parsers

  * "xml.sax.handler" --- Base classes for SAX handlers

  * "xml.sax.saxutils" --- SAX Utilities

  * "xml.sax.xmlreader" --- Interface for XML parsers

  * "xml.parsers.expat" --- Fast XML parsing using Expat

* Protocolos de Internet e Suporte

  * "webbrowser" --- Convenient web-browser controller

  * "wsgiref" --- WSGI Utilities and Reference Implementation

  * "urllib" --- Módulos de manipulação de URL

  * "urllib.request" --- Extensible library for opening URLs

  * "urllib.response" --- Response classes used by urllib

  * "urllib.parse" --- Analisa URLs para componentes

  * "urllib.error" --- Classes de exceção levantadas por
    urllib.request

  * "urllib.robotparser" ---  Parser for robots.txt

  * "http" --- HTTP modules

  * "http.client" --- HTTP protocol client

  * "ftplib" --- FTP protocol client

  * "poplib" --- POP3 protocol client

  * "imaplib" --- IMAP4 protocol client

  * "smtplib" --- SMTP protocol client

  * "uuid" --- UUID objects according to **RFC 4122**

  * "socketserver" --- A framework for network servers

  * "http.server" --- HTTP servers

  * "http.cookies" --- HTTP state management

  * "http.cookiejar" --- Cookie handling for HTTP clients

  * "xmlrpc" --- Módulos de servidor e cliente XMLRPC

  * "xmlrpc.client" --- XML-RPC client access

  * "xmlrpc.server" --- Servidores XML-RPC básicos

  * "ipaddress" --- Biblioteca de manipulação de IPv4/IPv6

* Serviços Multimídia

  * "wave" --- Read and write WAV files

  * "colorsys" --- Conversões entre sistemas de cores

* Internacionalização

  * "gettext" --- Serviços de internacionalização multilíngues

  * "locale" --- Serviços de internacionalização

* Frameworks de programa

  * "turtle" --- Gráficos Tartaruga

  * "cmd" --- Support for line-oriented command interpreters

  * "shlex" --- Simple lexical analysis

* Interfaces Gráficas de Usuário com Tk

  * "tkinter" --- Interface Python para Tcl/Tk

  * "tkinter.colorchooser" --- Diálogo de escolha de cor

  * "tkinter.font" --- Tkinter font wrapper

  * Diálogos Tkinter

  * "tkinter.messagebox" --- Prompts de mensagem do Tkinter

  * "tkinter.scrolledtext" --- Widget de texto de rolado

  * "tkinter.dnd" --- Suporte para arrastar e soltar

  * "tkinter.ttk" --- Tk themed widgets

  * IDLE

* Ferramentas de Desenvolvimento

  * "typing" --- Suporte para dicas de tipo

  * "pydoc" --- Gerador de documentação e sistema de ajuda online

  * Modo de Desenvolvimento do Python

  * "doctest" --- Test interactive Python examples

  * "unittest" --- Unit testing framework

  * "unittest.mock" --- mock object library

  * "unittest.mock" --- getting started

  * "test" --- Regression tests package for Python

  * "test.support" --- Utilitários para o conjunto de teste do Python

  * "test.support.socket_helper" --- Utilities for socket tests

  * "test.support.script_helper" --- Utilities for the Python
    execution tests

  * "test.support.bytecode_helper" --- Ferramentas de suporte para
    testar a geração correta de bytecode

  * "test.support.threading_helper" --- Utilities for threading tests

  * "test.support.os_helper" --- Utilities for os tests

  * "test.support.import_helper" --- Utilities for import tests

  * "test.support.warnings_helper" --- Utilities for warnings tests

* Depuração e perfilamento

  * Tabela de eventos de auditoria

  * "bdb" --- Debugger framework

  * "faulthandler" --- Dump the Python traceback

  * "pdb" --- O Depurador do Python

  * The Python Profilers

  * "timeit" --- Measure execution time of small code snippets

  * "trace" --- Rastreia ou acompanha a execução de instruções Python

  * "tracemalloc" --- Trace memory allocations

* Empacotamento e Distribuição de Software

  * "ensurepip" --- Inicialização do instalador do "pip"

  * "venv" --- Criação de ambientes virtuais

  * "zipapp" --- Manage executable Python zip archives

* Serviços de Tempo de Execução Python

  * "sys" --- System-specific parameters and functions

  * "sys.monitoring" --- Monitoramento de eventos de execução

  * "sysconfig" --- Fornece acesso às informações de configuração do
    Python

  * "builtins" --- Objetos embutidos

  * "__main__" --- Ambiente de código principal

  * "warnings" --- Warning control

  * "dataclasses" --- Data Classes

  * "contextlib" --- Utilities for "with"-statement contexts

  * "abc" --- Abstract Base Classes

  * "atexit" --- Manipuladores de saída

  * "traceback" --- Print or retrieve a stack traceback

  * "__future__" --- Definições de instruções future

  * "gc" --- Interface para o coletor de lixo

  * "inspect" --- Inspect live objects

  * "site" --- Site-specific configuration hook

* Interpretadores Python Personalizados

  * "code" --- Classes bases do interpretador

  * "codeop" --- Compila código Python

* Importando módulos

  * "zipimport" --- Import modules from Zip archives

  * "pkgutil" --- Package extension utility

  * "modulefinder" --- Procura módulos usados por um script

  * "runpy" --- Locating and executing Python modules

  * "importlib" --- A implementação de "import"

  * "importlib.resources" -- Leitura, abertura e acesso a recursos de
    pacotes

  * "importlib.resources.abc" -- Classes base abstratas para recursos

  * "importlib.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 Abstrata

  * "symtable" --- Access to the compiler's symbol tables

  * "token" --- Constantes usadas com árvores de análises do Python

  * "keyword" --- Testando palavras reservadas do Python

  * "tokenize" --- Tokenizer for Python source

  * "tabnanny" --- Detecção de indentação ambígua

  * "pyclbr" --- Python module browser support

  * "py_compile" --- Compila arquivos fonte do Python

  * "compileall" --- Compilar bibliotecas do Python para bytecode

  * "dis" --- Disassembler de bytecode do Python

  * "pickletools" --- Ferramentas para desenvolvedores pickle

* Serviços Específicos do MS Windows

  * "msvcrt" --- Useful routines from the MS VC++ runtime

  * "winreg" --- Windows registry access

  * "winsound" --- Sound-playing interface for Windows

* Serviços Específicos Unix

  * "posix" --- As chamadas de sistema mais comuns do POSIX

  * "pwd" --- A senha do banco de dados

  * "grp" --- The group database

  * "termios" --- Controle de tty no estilo POSIX

  * "tty" --- Funções de controle de terminal

  * "pty" --- Utilitários de pseudoterminal

  * "fcntl" --- The "fcntl" and "ioctl" system calls

  * "resource" --- Resource usage information

  * "syslog" --- Unix syslog library routines

* Interface de linha de comando (CLI) de módulos

* Módulos Substituídos

  * "getopt" --- C-style parser for command line options

  * "optparse" --- Parser for command line options

* Considerações de segurança
