portugython 0.3.0__tar.gz → 0.4.1__tar.gz

portugython-0.4.1/CHANGELOG.md

@@ -0,0 +1,151 @@
+# Changelog
+
+## 0.4.1 (2026-06-26)
+
+Corrige acentuação em toda a documentação (README, CHANGELOG, docstrings).
+Sem alterações na API ou no código.
+
+
+
+Adiciona módulo `transpilador`: transpilador de código-fonte baseado no tokenizador do
+Python que traduz palavras-chave para português, permitindo sintaxe Python completamente
+em português.
+
+Novo módulo `portugython.transpilador`:
+
+- `traduzir(codigo)` - traduz código Python em português para Python padrão
+- `traduzir_para_portugues(codigo)` - tradução inversa
+- `executar_texto(codigo)` - traduz e executa uma string de código em português
+- `executar_arquivo(caminho)` - traduz e executa um arquivo `.ptpy`
+- `mostrar_traducao(codigo)` - imprime o código Python equivalente
+- `MAPA_PALAVRAS_CHAVE` - tabela completa de tradução de palavras-chave
+- `PALAVRAS_RESERVADAS` - frozenset de palavras-chave reservadas em português
+
+Traduções de palavras-chave (34 palavras):
+
+    se       -> if       senaose   -> elif     senao      -> else
+    para     -> for      enquanto  -> while    parar      -> break
+    continuar -> continue passar   -> pass
+    defina   -> def      classe    -> class    retorne    -> return
+    produzca -> yield    anonima   -> lambda
+    importe  -> import   de        -> from     como       -> as
+    tente    -> try      exceto    -> except   finalmente -> finally
+    levante  -> raise    com       -> with
+    nao      -> not      e         -> and      ou         -> or
+    em       -> in       eh        -> is
+    excluir  -> del      afirmar   -> assert
+    global   -> global   naolocal  -> nonlocal
+    assincronico -> async aguardar -> await
+    Verdadeiro -> True   Falso     -> False    Nenhum     -> None
+
+Novo ponto de entrada CLI: `ptpy` executa arquivos `.ptpy` diretamente:
+
+    ptpy meu_programa.ptpy
+    ptpy -c 'para i em intervalo(3): escreva(i)'
+    ptpy --mostrar meu_programa.ptpy   # exibe o Python equivalente
+
+Hook de importação estendido para carregar arquivos `.ptpy` pelo sistema de importação normal.
+
+Exemplo de programa `.ptpy`:
+
+```python
+defina fatorial(n):
+    se n <= 1:
+        retorne 1
+    senao:
+        retorne n * fatorial(n - 1)
+
+para i em intervalo(1, 6):
+    escreva(f"{i}! = {fatorial(i)}")
+```
+
+## 0.3.0 (2026-06-26)
+
+Adiciona hook de importação para que todos os módulos em português funcionem como
+importações de nível superior.
+
+Após `import portugython`, a sintaxe completa em nível de stdlib funciona:
+
+    import aleatorio
+    from matematica import raiz_quadrada, PI
+    from colecoes import Contador, Pilha, Fila
+    from tempo import agora, hoje
+    from expressao import buscar, encontrar_todos
+    from dados import serializar, deserializar     # json
+    from subprocesso import executar
+    from caminho import Caminho
+    # ... todos os 36 módulos
+
+Novos exports:
+- `portugython.instalar()` - instala o gancho (chamado automaticamente)
+- `portugython.desinstalar()` - remove o gancho
+- `portugython.listar_modulos()` - retorna o mapa de nomes
+
+## 0.2.0 (2026-06-26)
+
+Cobertura completa da stdlib. 36 submódulos no total, todos importáveis via
+`from portugython import <modulo>`:
+
+**Novos em 0.2.0:**
+- `caminho` (pathlib): Caminho com existe, eh_arquivo, listar, ler_texto, escrever_texto, etc.
+- `json`: serializar, deserializar, serializar_arquivo, deserializar_arquivo
+- `estatistica` (statistics): media, mediana, moda, desvio_padrao, covariancia, correlacao, quantis
+- `enumeracao` (enum): Enumeracao, EnumeracaoInteira, EnumeracaoBandeira, automatico, unico
+- `classe_dados` (dataclasses): classe_dados, campo, para_dicionario, para_tupla, substituir
+- `contexto` (contextlib): gerenciador, suprimir, fechar_ao_sair, pilha_saida
+- `tipagem` (typing): re-exporta todos os tipos com nomes em português
+- `csv_pt` (csv): ler_csv, escrever_csv, LeitorCSV, EscritorCSV, LeitorDicionario
+- `registro` (logging): obter_registrador, configurar_registro, depurar, informar, avisar, erro
+- `argumentos` (argparse): AnalisadorArgumentos com adicionar_argumento, analisar
+- `subprocesso` (subprocess): executar, executar_shell, saida, chamar
+- `copia` (copy): copiar, copiar_profundo
+- `hash_pt` (hashlib + hmac): md5, sha256, sha512, blake2b, codigo_autenticacao, comparar_seguro
+- `threads` (threading): Thread, Semaforo, Evento, Trava, contagem_threads, thread_atual
+- `abstrato` (abc): ClasseAbstrata, metodo_abstrato, propriedade_abstrata
+- `bisecao` (bisect + heapq): inserir_ordenado, buscar_ordenado, heapificar, empurrar, n_maiores
+- `identificador` (uuid): uuid1, uuid3, uuid4, uuid5
+- `calendario` (calendar): dias_no_mes, eh_ano_bissexto, dia_semana, calendario_mes
+- `configuracao` (configparser): AnalisadorConfig com ler_arquivo, obter, definir, escrever_arquivo
+- `serializacao` (pickle): serializar, deserializar, serializar_arquivo, deserializar_arquivo
+- `codificacao` (base64 + codecs): para_base64, de_base64, para_base32, para_base16
+- `compressao` (gzip + zlib): comprimir_gzip, descomprimir_gzip, comprimir_zlib
+- `formatacao` (textwrap + pprint + string): quebrar, preencher, dedenter, recuar, imprimir_bonito
+- `depuracao` (traceback + warnings + gc): imprimir_excecao, formatar_excecao, coletar_lixo
+- `soquete` (socket): Soquete, criar_conexao, criar_servidor, nome_host, endereco_ip
+- `assincronico` (asyncio): executar, criar_tarefa, dormir, reunir, Evento, Fila
+- `estrutura` (struct): empacotar, desempacotar, calcular_tamanho
+- `rede` (urllib + http): baixar_url, abrir_url, analisar_url, codificar_url, codificar_parametros
+
+Também em 0.2.0:
+- Correção: alias de builtin `identificador` renomeado para `obter_id` para evitar shadowing do submódulo uuid
+- 49 testes cobrindo todos os módulos
+
+## 0.1.0 (2026-06-26)
+
+- Adiciona conjunto completo de submódulos da stdlib com traduções em português:
+  - `aleatorio` (random): escolha, embaralhe, amostra, gauss, normal, etc.
+  - `matematica` (math): raiz_quadrada, seno, cosseno, fatorial, mdc, mmc, etc.
+  - `sistema` (os + sys): diretorio_atual, listar_diretorio, existe, sair, etc.
+  - `tempo` (time + datetime): Data, Hora, DataHora, Duracao, agora, hoje, dormir, etc.
+  - `colecoes` (collections): Contador, Deque, DicionarioOrdenado, Pilha, Fila, etc.
+  - `iteradores` (itertools): encadeie, combine, permute, acumule, agrupe, etc.
+  - `funcional` (functools): reduzido, parcial, cache, compor, negado, etc.
+  - `expressao` (re): compilar, buscar, substituir, encontrar_todos, Padrao, etc.
+- Reescrita do `__init__.py` com nomes em português limpos (remove sufixos `_pt`)
+- Adiciona classe `Conjunto` com métodos em português
+- Expande `Texto`, `Lista`, `Dicionario` com mais métodos
+- Adiciona mais tipos de exceção: ErroArquivo, ErroPermissao, ErroRecursao, ErroPausa
+- Versão mínima do Python elevada para >=3.10
+- 30 testes cobrindo todos os módulos
+
+## 0.0.15 (2026-06-26)
+
+- Adiciona traduções em português dos builtins e funções principais do Python
+- Introduz classes Lista, Dicionario, Texto com métodos em português
+- Adiciona funções auxiliares: se(), para_cada(), filtro()
+- Adiciona classes de exceção em português
+- Expande a suíte de testes
+
+## 0.0.14 (2022-11-28)
+
+- Última versão anterior no PyPI.

{portugython-0.3.0 → portugython-0.4.1}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: portugython
-Version: 0.3.0
-Summary: A Portuguese translation of the Python functions/modules/packages
+Version: 0.4.1
+Summary: A Portuguese translation of Python: functions, modules and syntax
 Project-URL: Homepage, https://github.com/spacemany2k38/portugython
 Project-URL: Bug Tracker, https://github.com/spacemany2k38/portugython/issues
 Author: Victor Kolis
@@ -31,22 +31,22 @@ Description-Content-Type: text/markdown
 [![Python versions](https://img.shields.io/pypi/pyversions/portugython.svg)](https://pypi.org/project/portugython/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-Escreva Python em Portugues. Portugython traduz funcoes, tipos e modulos da biblioteca padrao do Python para nomes em portugues.
+Escreva Python em Português. Portugython traduz funções, tipos e módulos da biblioteca padrão do Python para nomes em português.
 
-## Instalacao
+## Instalação
 
 ```bash
 pip install portugython
 ```
 
-## Uso basico
+## Uso básico
 
 ```python
 from portugython import *
 
-escreva("Ola, Mundo!")
-nome = leia("Qual e seu nome? ")
-escreva("Ola,", nome)
+escreva("Olá, Mundo!")
+nome = leia("Qual é seu nome? ")
+escreva("Olá,", nome)
 
 numeros = Lista([1, 2, 3, 4, 5])
 numeros.adicione(6)
@@ -60,9 +60,9 @@ resultado = se(tamanho(pares) > 0, "tem pares", "sem pares")
 escreva(resultado)
 ```
 
-## Modulos da biblioteca padrao
+## Módulos da biblioteca padrão
 
-Cada modulo da stdlib tem uma versao em portugues que pode ser importada separadamente.
+Cada módulo da stdlib tem uma versão em português que pode ser importada separadamente.
 
 ### aleatorio (random)
 
@@ -159,7 +159,7 @@ print(p.x, p.y)
 ```python
 from portugython import iteradores
 
-# Combinatoria
+# Combinatória
 for combo in iteradores.combine([1, 2, 3, 4], 2):
     print(combo)
 
@@ -167,7 +167,7 @@ for combo in iteradores.combine([1, 2, 3, 4], 2):
 for par in iteradores.produto("AB", "12"):
     print(par)
 
-# Acumulacao
+# Acumulação
 totais = list(iteradores.acumule([1, 2, 3, 4, 5]))
 
 # Encadeamento
@@ -179,21 +179,21 @@ unido = list(iteradores.encadeie([1, 2], [3, 4], [5]))
 ```python
 from portugython import funcional
 
-# Reducao
+# Redução
 total = funcional.reduzido(lambda a, b: a + b, range(1, 11))
 
-# Funcao parcial
+# Função parcial
 multiplicar_por_3 = funcional.parcial(lambda a, b: a * b, 3)
 print(multiplicar_por_3(7))
 
-# Memoizacao
+# Memoização
 @funcional.cache
 def fibonacci(n):
     if n < 2:
         return n
     return fibonacci(n - 1) + fibonacci(n - 2)
 
-# Composicao
+# Composição
 dobrar = lambda x: x * 2
 somar_um = lambda x: x + 1
 dobrar_e_somar = funcional.compor(somar_um, dobrar)
@@ -213,26 +213,26 @@ if m:
 # Todos os resultados
 numeros = expressao.encontrar_todos(r"\d+", "1 mais 2 igual 3")
 
-# Substituicao
+# Substituição
 limpo = expressao.substituir(r"\s+", " ", "texto  com   espacos")
 
-# Padrao reutilizavel
+# Padrão reutilizável
 email = expressao.Padrao(r"[\w.+-]+@[\w-]+\.[a-z]{2,}")
 if email.encontrar("contato@example.com"):
-    print("Email valido")
+    print("E-mail válido")
 ```
 
-## Referencia de builtins
+## Referência de builtins
 
-### Entrada / Saida
-| Portugues | Python |
+### Entrada / Saída
+| Português | Python |
 |-----------|--------|
 | `escreva` | `print` |
 | `leia` | `input` |
 | `abra` | `open` |
 
 ### Tipos
-| Portugues | Python |
+| Português | Python |
 |-----------|--------|
 | `inteiro` | `int` |
 | `texto` | `str` |
@@ -245,14 +245,14 @@ if email.encontrar("contato@example.com"):
 | `intervalo` | `range` |
 
 ### Constantes
-| Portugues | Python |
+| Português | Python |
 |-----------|--------|
 | `Verdadeiro` | `True` |
 | `Falso` | `False` |
 | `Nenhum` | `None` |
 
-### Funcoes de sequencia
-| Portugues | Python |
+### Funções de sequência
+| Português | Python |
 |-----------|--------|
 | `tamanho` | `len` |
 | `soma` | `sum` |
@@ -266,27 +266,130 @@ if email.encontrar("contato@example.com"):
 | `mapeado` | `map` |
 | `filtrado` | `filter` |
 
-### Operadores logicos
-| Portugues | Python |
+### Operadores lógicos
+| Português | Python |
 |-----------|--------|
 | `nao(x)` | `not x` |
 | `e(a, b)` | `a and b` |
 | `ou(a, b)` | `a or b` |
 
-### Funcoes utilitarias
-| Portugues | Python |
+### Funções utilitárias
+| Português | Python |
 |-----------|--------|
 | `se(c, a, b)` | `a if c else b` |
 | `para_cada(f, it)` | `list(map(f, it))` |
 | `filtro(f, it)` | `list(filter(f, it))` |
 | `reduzido(f, it)` | `functools.reduce(f, it)` |
 
+## Transpilador de palavras-chave
+
+Portugython inclui um transpilador completo que traduz a sintaxe do Python
+(palavras-chave) para português. Isso permite escrever programas Python
+inteiramente em português.
+
+### CLI: ptpy
+
+```bash
+ptpy meu_programa.ptpy               # executa um arquivo .ptpy
+ptpy -c 'para i em intervalo(3): escreva(i)'   # executa inline
+ptpy --mostrar meu_programa.ptpy     # imprime o Python equivalente
+```
+
+### API Python
+
+```python
+from portugython import traduzir, executar_texto, executar_arquivo
+
+# Traduzir uma string
+codigo_pt = """
+defina fatorial(n):
+    se n <= 1:
+        retorne 1
+    senao:
+        retorne n * fatorial(n - 1)
+"""
+print(traduzir(codigo_pt))
+# def fatorial(n):
+#     if n <= 1:
+#         return 1
+#     else:
+#         return n * fatorial(n - 1)
+
+# Executar diretamente
+executar_texto("para i em intervalo(3):\n    escreva(i)")
+
+# Executar um arquivo .ptpy
+executar_arquivo("meu_programa.ptpy")
+```
+
+### Programa completo em português (.ptpy)
+
+```python
+# fatorial.ptpy
+importe portugython
+
+defina fatorial(n):
+    se n <= 1:
+        retorne 1
+    senao:
+        retorne n * fatorial(n - 1)
+
+defina verificar_primo(n):
+    se n < 2:
+        retorne Falso
+    para i em intervalo(2, n):
+        se n % i == 0:
+            retorne Falso
+    retorne Verdadeiro
+
+primos = [x para x em intervalo(2, 20) se verificar_primo(x)]
+escreva("Primos:", primos)
+
+para n em intervalo(1, 8):
+    escreva(f"{n}! = {fatorial(n)}")
+
+tente:
+    resultado = 10 / 0
+exceto ZeroDivisionError como err:
+    escreva("Erro capturado:", err)
+finalmente:
+    escreva("Pronto!")
+```
+
+### Tabela de palavras-chave
+
+| Português | Python | | Português | Python |
+|-----------|--------|-|-----------|--------|
+| `se` | `if` | | `senao` | `else` |
+| `senaose` | `elif` | | `para` | `for` |
+| `enquanto` | `while` | | `parar` | `break` |
+| `continuar` | `continue` | | `passar` | `pass` |
+| `defina` | `def` | | `classe` | `class` |
+| `retorne` | `return` | | `produzca` | `yield` |
+| `anonima` | `lambda` | | `importe` | `import` |
+| `de` | `from` | | `como` | `as` |
+| `tente` | `try` | | `exceto` | `except` |
+| `finalmente` | `finally` | | `levante` | `raise` |
+| `com` | `with` | | `nao` | `not` |
+| `e` | `and` | | `ou` | `or` |
+| `em` | `in` | | `eh` | `is` |
+| `excluir` | `del` | | `afirmar` | `assert` |
+| `global` | `global` | | `naolocal` | `nonlocal` |
+| `assincronico` | `async` | | `aguardar` | `await` |
+| `Verdadeiro` | `True` | | `Falso` | `False` |
+| `Nenhum` | `None` | | | |
+
+> **Nota**: Palavras como `e`, `ou`, `de`, `com` e `em` são palavras-chave
+> reservadas no contexto de arquivos `.ptpy`. Evite usá-las como nomes de
+> variáveis nesses arquivos, assim como não se usa `if` ou `for` como
+> variáveis em Python normal.
+
 ## Contribuir
 
-1. Crie um fork deste repositorio
+1. Crie um fork deste repositório
 2. Crie uma branch nova a partir de main
 3. Envie um pull request
 
-## Licenca
+## Licença
 
 MIT

{portugython-0.3.0 → portugython-0.4.1}/README.md

@@ -4,22 +4,22 @@
 [![Python versions](https://img.shields.io/pypi/pyversions/portugython.svg)](https://pypi.org/project/portugython/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-Escreva Python em Portugues. Portugython traduz funcoes, tipos e modulos da biblioteca padrao do Python para nomes em portugues.
+Escreva Python em Português. Portugython traduz funções, tipos e módulos da biblioteca padrão do Python para nomes em português.
 
-## Instalacao
+## Instalação
 
 ```bash
 pip install portugython
 ```
 
-## Uso basico
+## Uso básico
 
 ```python
 from portugython import *
 
-escreva("Ola, Mundo!")
-nome = leia("Qual e seu nome? ")
-escreva("Ola,", nome)
+escreva("Olá, Mundo!")
+nome = leia("Qual é seu nome? ")
+escreva("Olá,", nome)
 
 numeros = Lista([1, 2, 3, 4, 5])
 numeros.adicione(6)
@@ -33,9 +33,9 @@ resultado = se(tamanho(pares) > 0, "tem pares", "sem pares")
 escreva(resultado)
 ```
 
-## Modulos da biblioteca padrao
+## Módulos da biblioteca padrão
 
-Cada modulo da stdlib tem uma versao em portugues que pode ser importada separadamente.
+Cada módulo da stdlib tem uma versão em português que pode ser importada separadamente.
 
 ### aleatorio (random)
 
@@ -132,7 +132,7 @@ print(p.x, p.y)
 ```python
 from portugython import iteradores
 
-# Combinatoria
+# Combinatória
 for combo in iteradores.combine([1, 2, 3, 4], 2):
     print(combo)
 
@@ -140,7 +140,7 @@ for combo in iteradores.combine([1, 2, 3, 4], 2):
 for par in iteradores.produto("AB", "12"):
     print(par)
 
-# Acumulacao
+# Acumulação
 totais = list(iteradores.acumule([1, 2, 3, 4, 5]))
 
 # Encadeamento
@@ -152,21 +152,21 @@ unido = list(iteradores.encadeie([1, 2], [3, 4], [5]))
 ```python
 from portugython import funcional
 
-# Reducao
+# Redução
 total = funcional.reduzido(lambda a, b: a + b, range(1, 11))
 
-# Funcao parcial
+# Função parcial
 multiplicar_por_3 = funcional.parcial(lambda a, b: a * b, 3)
 print(multiplicar_por_3(7))
 
-# Memoizacao
+# Memoização
 @funcional.cache
 def fibonacci(n):
     if n < 2:
         return n
     return fibonacci(n - 1) + fibonacci(n - 2)
 
-# Composicao
+# Composição
 dobrar = lambda x: x * 2
 somar_um = lambda x: x + 1
 dobrar_e_somar = funcional.compor(somar_um, dobrar)
@@ -186,26 +186,26 @@ if m:
 # Todos os resultados
 numeros = expressao.encontrar_todos(r"\d+", "1 mais 2 igual 3")
 
-# Substituicao
+# Substituição
 limpo = expressao.substituir(r"\s+", " ", "texto  com   espacos")
 
-# Padrao reutilizavel
+# Padrão reutilizável
 email = expressao.Padrao(r"[\w.+-]+@[\w-]+\.[a-z]{2,}")
 if email.encontrar("contato@example.com"):
-    print("Email valido")
+    print("E-mail válido")
 ```
 
-## Referencia de builtins
+## Referência de builtins
 
-### Entrada / Saida
-| Portugues | Python |
+### Entrada / Saída
+| Português | Python |
 |-----------|--------|
 | `escreva` | `print` |
 | `leia` | `input` |
 | `abra` | `open` |
 
 ### Tipos
-| Portugues | Python |
+| Português | Python |
 |-----------|--------|
 | `inteiro` | `int` |
 | `texto` | `str` |
@@ -218,14 +218,14 @@ if email.encontrar("contato@example.com"):
 | `intervalo` | `range` |
 
 ### Constantes
-| Portugues | Python |
+| Português | Python |
 |-----------|--------|
 | `Verdadeiro` | `True` |
 | `Falso` | `False` |
 | `Nenhum` | `None` |
 
-### Funcoes de sequencia
-| Portugues | Python |
+### Funções de sequência
+| Português | Python |
 |-----------|--------|
 | `tamanho` | `len` |
 | `soma` | `sum` |
@@ -239,27 +239,130 @@ if email.encontrar("contato@example.com"):
 | `mapeado` | `map` |
 | `filtrado` | `filter` |
 
-### Operadores logicos
-| Portugues | Python |
+### Operadores lógicos
+| Português | Python |
 |-----------|--------|
 | `nao(x)` | `not x` |
 | `e(a, b)` | `a and b` |
 | `ou(a, b)` | `a or b` |
 
-### Funcoes utilitarias
-| Portugues | Python |
+### Funções utilitárias
+| Português | Python |
 |-----------|--------|
 | `se(c, a, b)` | `a if c else b` |
 | `para_cada(f, it)` | `list(map(f, it))` |
 | `filtro(f, it)` | `list(filter(f, it))` |
 | `reduzido(f, it)` | `functools.reduce(f, it)` |
 
+## Transpilador de palavras-chave
+
+Portugython inclui um transpilador completo que traduz a sintaxe do Python
+(palavras-chave) para português. Isso permite escrever programas Python
+inteiramente em português.
+
+### CLI: ptpy
+
+```bash
+ptpy meu_programa.ptpy               # executa um arquivo .ptpy
+ptpy -c 'para i em intervalo(3): escreva(i)'   # executa inline
+ptpy --mostrar meu_programa.ptpy     # imprime o Python equivalente
+```
+
+### API Python
+
+```python
+from portugython import traduzir, executar_texto, executar_arquivo
+
+# Traduzir uma string
+codigo_pt = """
+defina fatorial(n):
+    se n <= 1:
+        retorne 1
+    senao:
+        retorne n * fatorial(n - 1)
+"""
+print(traduzir(codigo_pt))
+# def fatorial(n):
+#     if n <= 1:
+#         return 1
+#     else:
+#         return n * fatorial(n - 1)
+
+# Executar diretamente
+executar_texto("para i em intervalo(3):\n    escreva(i)")
+
+# Executar um arquivo .ptpy
+executar_arquivo("meu_programa.ptpy")
+```
+
+### Programa completo em português (.ptpy)
+
+```python
+# fatorial.ptpy
+importe portugython
+
+defina fatorial(n):
+    se n <= 1:
+        retorne 1
+    senao:
+        retorne n * fatorial(n - 1)
+
+defina verificar_primo(n):
+    se n < 2:
+        retorne Falso
+    para i em intervalo(2, n):
+        se n % i == 0:
+            retorne Falso
+    retorne Verdadeiro
+
+primos = [x para x em intervalo(2, 20) se verificar_primo(x)]
+escreva("Primos:", primos)
+
+para n em intervalo(1, 8):
+    escreva(f"{n}! = {fatorial(n)}")
+
+tente:
+    resultado = 10 / 0
+exceto ZeroDivisionError como err:
+    escreva("Erro capturado:", err)
+finalmente:
+    escreva("Pronto!")
+```
+
+### Tabela de palavras-chave
+
+| Português | Python | | Português | Python |
+|-----------|--------|-|-----------|--------|
+| `se` | `if` | | `senao` | `else` |
+| `senaose` | `elif` | | `para` | `for` |
+| `enquanto` | `while` | | `parar` | `break` |
+| `continuar` | `continue` | | `passar` | `pass` |
+| `defina` | `def` | | `classe` | `class` |
+| `retorne` | `return` | | `produzca` | `yield` |
+| `anonima` | `lambda` | | `importe` | `import` |
+| `de` | `from` | | `como` | `as` |
+| `tente` | `try` | | `exceto` | `except` |
+| `finalmente` | `finally` | | `levante` | `raise` |
+| `com` | `with` | | `nao` | `not` |
+| `e` | `and` | | `ou` | `or` |
+| `em` | `in` | | `eh` | `is` |
+| `excluir` | `del` | | `afirmar` | `assert` |
+| `global` | `global` | | `naolocal` | `nonlocal` |
+| `assincronico` | `async` | | `aguardar` | `await` |
+| `Verdadeiro` | `True` | | `Falso` | `False` |
+| `Nenhum` | `None` | | | |
+
+> **Nota**: Palavras como `e`, `ou`, `de`, `com` e `em` são palavras-chave
+> reservadas no contexto de arquivos `.ptpy`. Evite usá-las como nomes de
+> variáveis nesses arquivos, assim como não se usa `if` ou `for` como
+> variáveis em Python normal.
+
 ## Contribuir
 
-1. Crie um fork deste repositorio
+1. Crie um fork deste repositório
 2. Crie uma branch nova a partir de main
 3. Envie um pull request
 
-## Licenca
+## Licença
 
 MIT