Python Documentation
Concise, example-driven Python reference. Read the concept, see the code, then practice it in a Coddy journey.
Start a guided Python journeyPrimeiros passos
- O que é Python?Uma introdução em linguagem simples ao Python — o que é, para que serve e por que tanta gente o escolhe como primeira linguagem de programação.
- Instalar PythonUm guia passo a passo para instalar o Python em qualquer sistema operacional, conferir a versão e saber quando você não precisa instalar nada.
- Executar código PythonTrês formas de executar código Python — o shell interativo, um arquivo .py salvo via terminal e por um editor — com dicas de quando usar cada uma.
- Sintaxe PythonO conjunto mínimo de regras de sintaxe com que o Python se importa — indentação, quebras de linha, dois pontos e sensibilidade a maiúsculas — explicadas sem jargão.
- ComentáriosComo escrever comentários em Python — linha única com #, blocos de múltiplas linhas e docstrings para documentar funções e módulos.
Variáveis e dados
- VariáveisComo as variáveis funcionam em Python — atribuição, regras de nomeação, reatribuição e o modelo mental que te mantém fora de encrenca.
- Tipos de dadosUm passeio pelos tipos de dados embutidos do Python — números, strings, booleanos, None, listas, tuplas, sets, dicionários — com exemplos e quando usar cada um.
- StringsTrabalhando com texto em Python — criando strings, usando f-strings, fatiando e os métodos do dia a dia como split, join, replace e strip.
- f-StringsUm guia prático para f-strings em Python — embutindo variáveis e expressões, formatando números e datas, e quando recorrer aos estilos antigos.
- Números e booleanosComo o Python lida com inteiros, números de ponto flutuante e booleanos — aritmética, conversão e os casos de borda que derrubam as pessoas.
- Input e PrintComo as funções print() e input() do Python funcionam — além de separadores, caracteres de fim e como converter entrada do usuário em números.
Fluxo de controle
- OperadoresUm passeio completo pelos operadores do Python — aritméticos, de comparação, lógicos, de atribuição, de pertinência e de identidade — com exemplos de cada.
- if / elif / elseComo as instruções if, elif e else do Python funcionam — incluindo valores truthy, condições aninhadas e a expressão if ternária.
- Laço forComo o laço for do Python funciona — iterando sobre listas, strings, ranges, dicionários e qualquer outra coisa iterável, além de break, continue e else.
- Laço whileQuando escolher um laço while em vez de for, como evitar loops infinitos e os padrões que aparecem mais em código real.
- range()Como range() funciona em Python — start, stop, step, ranges negativos e por que ele é preguiçoso em vez de materializar uma lista.
Coleções
- ListasUm passeio prático pelas listas em Python — a coleção mais comum — cobrindo criação, indexação, fatiamento, append, sort e os padrões que você mais vai usar.
- TuplasQuando usar uma tupla em vez de uma lista — imutabilidade, desempacotamento, named tuples e os cenários para os quais as tuplas foram feitas.
- SetsQuando usar um set em Python — unicidade, checagens in rápidas e as operações estilo matemática (união, interseção, diferença) que tornam sets poderosos.
- DicionáriosDicionários são a estrutura de lookup chave-valor do Python — o tipo de dado que você vai usar constantemente depois do básico.
- List ComprehensionList comprehensions permitem construir uma nova lista numa linha legível — mapeando, filtrando ou os dois — substituindo o padrão laço-e-append.
Funções e estrutura
- FunçõesComo definir e usar funções em Python — parâmetros, valores de retorno, argumentos default, argumentos por palavra-chave e hábitos de nomeação que mantêm o código legível.
- *args e **kwargsO que *args e **kwargs significam, quando usar e como encaminhar argumentos de forma limpa entre funções.
- LambdaO que é lambda, para que serve e os poucos lugares onde de fato se justifica — mais quando usar uma função nomeada.
- DecoradoresO que decoradores Python de fato são, como escrever os seus e os padrões (argumentos, empilhamento, wraps) que fazem valer usar.
- Type HintsO que são type hints em Python, quando ajudam e a sintaxe para anotar variáveis, assinaturas de função, containers e valores opcionais.
- Módulos e ImportsComo o sistema de módulos do Python funciona — escrever seus próprios módulos, importar deles e usar pip para instalar pacotes de terceiros.
- pip e PacotesComo instalar, atualizar e remover pacotes Python com pip — incluindo PyPI, arquivos de requirements e evitar a armadilha da instalação global.
- Ambientes VirtuaisO que é um ambiente virtual, por que todo projeto Python real precisa de um e como criar e gerenciar com o módulo embutido venv.
- Guard __main__O que `if __name__ == '__main__'` de fato faz, por que todo script Python sério cresce para esse padrão e como estruturar um arquivo que serve como script e módulo.
Classes e objetos
Iteração avançada
- GeradoresComo geradores produzem valores de forma preguiçosa em Python — a palavra-chave `yield`, expressões geradoras e quando ganham de uma lista simples.
- Context ManagersO que a instrução `with` de fato faz — limpeza automática para arquivos, locks, conexões de banco e qualquer outra coisa que precisa de fechamento confiável.
Trabalhando com dados reais
- Manipulação de arquivosComo ler e escrever arquivos em Python — a instrução with, texto vs binário e a API moderna baseada em caminhos, mais segura.
- JSONComo ler e escrever JSON em Python — loads, dumps, ler de arquivos, pretty print e lidar com casos de borda que aparecem com dados reais.
- Arquivos CSVComo ler e escrever arquivos CSV em Python — o módulo csv, DictReader e DictWriter, cabeçalhos, aspas e quando recorrer ao pandas.
- Requisições HTTPComo fazer requisições HTTP em Python com a biblioteca requests — GET, POST, parâmetros de query, headers, corpos JSON e tratamento de erros.
- datetimeUm passeio prático pelo módulo datetime do Python — parsear, formatar, fazer matemática com datas e lidar com fusos horários sem se perder.
- RegexUma introdução prática ao módulo re do Python — busca, match, grupos de captura, substituição e os padrões que você mais vai usar.
Erros e depuração
- ExceçõesComo tratar erros em Python — try/except/finally, capturar exceções específicas, lançar as suas e quando deixar um erro propagar.
- Erros e DebuggingUm passeio pelos erros Python que você vai encontrar com mais frequência — KeyError, ValueError, ModuleNotFoundError, EOFError — e os hábitos de debug que os corrigem rápido.
