portugython 0.4.0__tar.gz → 0.4.1__tar.gz

{portugython-0.4.0 → portugython-0.4.1}/CHANGELOG.md

@@ -1,21 +1,27 @@
 # Changelog
 
-## 0.4.0 (2026-06-26)
+## 0.4.1 (2026-06-26)
 
-Add `transpilador` module: a tokenizer-based source transpiler that
-translates Python keywords to Portuguese, enabling fully Portuguese Python syntax.
+Corrige acentuação em toda a documentação (README, CHANGELOG, docstrings).
+Sem alterações na API ou no código.
 
-New module `portugython.transpilador`:
 
-- `traduzir(codigo)` - translates Portuguese Python source to valid Python
-- `traduzir_para_portugues(codigo)` - inverse translation
-- `executar_texto(codigo)` - translate and execute a Portuguese Python string
-- `executar_arquivo(caminho)` - translate and execute a `.ptpy` file
-- `mostrar_traducao(codigo)` - print the translated Python source
-- `MAPA_PALAVRAS_CHAVE` - full keyword translation table
-- `PALAVRAS_RESERVADAS` - frozenset of reserved Portuguese keywords
 
-Keyword translations (34 keywords):
+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
@@ -32,15 +38,15 @@ Keyword translations (34 keywords):
     assincronico -> async aguardar -> await
     Verdadeiro -> True   Falso     -> False    Nenhum     -> None
 
-New CLI entry point: `ptpy` runs `.ptpy` files directly:
+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   # show the translated Python
+    ptpy --mostrar meu_programa.ptpy   # exibe o Python equivalente
 
-Extended import hook to load `.ptpy` files via the normal import system.
+Hook de importação estendido para carregar arquivos `.ptpy` pelo sistema de importação normal.
 
-Example `.ptpy` program:
+Exemplo de programa `.ptpy`:
 
 ```python
 defina fatorial(n):
@@ -53,11 +59,12 @@ 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.
 
-Add import hook so all Portuguese module names work as top-level imports.
-
-After `import portugython`, the full stdlib-level syntax works:
+Após `import portugython`, a sintaxe completa em nível de stdlib funciona:
 
     import aleatorio
     from matematica import raiz_quadrada, PI
@@ -67,25 +74,26 @@ After `import portugython`, the full stdlib-level syntax works:
     from dados import serializar, deserializar     # json
     from subprocesso import executar
     from caminho import Caminho
-    # ... all 36 modules
+    # ... todos os 36 módulos
 
-New exports:
+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>`:
 
-Full stdlib coverage. 36 submodules total, all importable via `from portugython import <modulo>`:
-
-**New in 0.2.0:**
+**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 Portugues
+- `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
@@ -108,14 +116,13 @@ Full stdlib coverage. 36 submodules total, all importable via `from portugython
 - `estrutura` (struct): empacotar, desempacotar, calcular_tamanho
 - `rede` (urllib + http): baixar_url, abrir_url, analisar_url, codificar_url, codificar_parametros
 
-Also in 0.2.0:
-- Fix: renamed builtin `identificador` alias to `obter_id` to avoid shadowing the uuid submodule
-- 49 tests covering all modules
-
+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)
 
-- Add full stdlib submodule set with Portuguese translations:
+- 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.
@@ -124,21 +131,21 @@ Also in 0.2.0:
   - `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.
-- Rewrite `__init__.py` with clean Portuguese names (remove `_pt` suffixes)
-- Add `Conjunto` class with Portuguese methods
-- Expand `Texto`, `Lista`, `Dicionario` with more methods
-- Add more exception types: ErroArquivo, ErroPermissao, ErroRecursao, ErroPausa
-- Bump minimum Python to >=3.10
-- 30 tests across all modules
+- 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)
 
-- Add Portuguese translations of Python builtins and core functions
-- Introduce Lista, Dicionario, Texto classes with Portuguese methods
-- Add helper functions: se(), para_cada(), filtro()
-- Add Portuguese exception classes
-- Expand test suite
+- 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)
 
-- Latest release on PyPI.
+- Última versão anterior no PyPI.

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: portugython
-Version: 0.4.0
+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
@@ -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,15 +266,15 @@ 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))` |
@@ -284,8 +284,8 @@ if email.encontrar("contato@example.com"):
 ## Transpilador de palavras-chave
 
 Portugython inclui um transpilador completo que traduz a sintaxe do Python
-(palavras-chave) para portugues. Isso permite escrever programas Python
-inteiramente em portugues.
+(palavras-chave) para português. Isso permite escrever programas Python
+inteiramente em português.
 
 ### CLI: ptpy
 
@@ -322,7 +322,7 @@ executar_texto("para i em intervalo(3):\n    escreva(i)")
 executar_arquivo("meu_programa.ptpy")
 ```
 
-### Programa completo em portugues (.ptpy)
+### Programa completo em português (.ptpy)
 
 ```python
 # fatorial.ptpy
@@ -358,7 +358,7 @@ finalmente:
 
 ### Tabela de palavras-chave
 
-| Portugues | Python | | Portugues | Python |
+| Português | Python | | Português | Python |
 |-----------|--------|-|-----------|--------|
 | `se` | `if` | | `senao` | `else` |
 | `senaose` | `elif` | | `para` | `for` |
@@ -379,17 +379,17 @@ finalmente:
 | `Verdadeiro` | `True` | | `Falso` | `False` |
 | `Nenhum` | `None` | | | |
 
-> **Nota**: Palavras como `e`, `ou`, `de`, `com` e `em` sao palavras-chave
-> reservadas no contexto de arquivos `.ptpy`. Evite usa-las como nomes de
-> variaveis nesses arquivos, assim como nao se usa `if` ou `for` como
-> variaveis em Python normal.
+> **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.4.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,15 +239,15 @@ 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))` |
@@ -257,8 +257,8 @@ if email.encontrar("contato@example.com"):
 ## Transpilador de palavras-chave
 
 Portugython inclui um transpilador completo que traduz a sintaxe do Python
-(palavras-chave) para portugues. Isso permite escrever programas Python
-inteiramente em portugues.
+(palavras-chave) para português. Isso permite escrever programas Python
+inteiramente em português.
 
 ### CLI: ptpy
 
@@ -295,7 +295,7 @@ executar_texto("para i em intervalo(3):\n    escreva(i)")
 executar_arquivo("meu_programa.ptpy")
 ```
 
-### Programa completo em portugues (.ptpy)
+### Programa completo em português (.ptpy)
 
 ```python
 # fatorial.ptpy
@@ -331,7 +331,7 @@ finalmente:
 
 ### Tabela de palavras-chave
 
-| Portugues | Python | | Portugues | Python |
+| Português | Python | | Português | Python |
 |-----------|--------|-|-----------|--------|
 | `se` | `if` | | `senao` | `else` |
 | `senaose` | `elif` | | `para` | `for` |
@@ -352,17 +352,17 @@ finalmente:
 | `Verdadeiro` | `True` | | `Falso` | `False` |
 | `Nenhum` | `None` | | | |
 
-> **Nota**: Palavras como `e`, `ou`, `de`, `com` e `em` sao palavras-chave
-> reservadas no contexto de arquivos `.ptpy`. Evite usa-las como nomes de
-> variaveis nesses arquivos, assim como nao se usa `if` ou `for` como
-> variaveis em Python normal.
+> **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.4.0 → portugython-0.4.1}/portugython/__init__.py

@@ -1,4 +1,4 @@
-"""portugython - uma traducao em Portugues das funcoes/modulos/pacotes do Python."""
+"""portugython - uma tradução em Português das funções/módulos/pacotes do Python."""
 
 from __future__ import annotations
 
@@ -19,9 +19,9 @@ from portugython.transpilador import (
     traduzir_para_portugues,
 )
 
-__version__ = "0.4.0"
+__version__ = "0.4.1"
 
-# Instala o gancho de importacao automaticamente
+# Instala o gancho de importação automaticamente
 instalar()
 
 # ---------------------------------------------------------------------------
@@ -118,7 +118,7 @@ Falso = False
 
 
 def nao(valor: object) -> bool:
-    """Inversao logica em Portugues."""
+    """Inversão lógica em Português."""
     return not valor
 
 

{portugython-0.4.0 → portugython-0.4.1}/portugython/_importador.py

@@ -1,12 +1,12 @@
-"""_importador - gancho de importacao que permite importar modulos em Portugues.
+"""_importador - gancho de importação que permite importar módulos em Português.
 
-Quando ativado, permite usar nomes de modulos em Portugues diretamente:
+Quando ativado, permite usar nomes de módulos em Português diretamente:
 
     import aleatorio
     from matematica import raiz_quadrada
     from colecoes import Contador
 
-Tambem permite importar arquivos .ptpy (Python em Portugues):
+Também permite importar arquivos .ptpy (Python em Português):
 
     import meu_modulo   # carrega meu_modulo.ptpy se existir
 """
@@ -22,7 +22,7 @@ from importlib.machinery import ModuleSpec, SourceFileLoader
 from pathlib import Path
 from typing import Sequence
 
-# Mapeamento de nome em Portugues -> caminho completo do modulo portugython
+# Mapeamento de nome em Português -> caminho completo do módulo portugython
 MAPA_MODULOS: dict[str, str] = {
     # Matematica e ciencia
     "aleatorio": "portugython.aleatorio",
@@ -45,7 +45,7 @@ MAPA_MODULOS: dict[str, str] = {
     # Texto e expressoes
     "expressao": "portugython.expressao",
     "formatacao": "portugython.formatacao",
-    # Serialization e codificacao
+    # Serialização e codificação
     "serializacao": "portugython.serializacao",
     "codificacao": "portugython.codificacao",
     "compressao": "portugython.compressao",
@@ -73,7 +73,7 @@ MAPA_MODULOS: dict[str, str] = {
 
 
 class _CarregadorAlias(importlib.abc.Loader):
-    """Carrega um modulo portugython sob um nome em Portugues."""
+    """Carrega um módulo portugython sob um nome em Português."""
 
     def __init__(self, modulo_real: str) -> None:
         self._modulo_real = modulo_real
@@ -87,7 +87,7 @@ class _CarregadorAlias(importlib.abc.Loader):
 
 
 class ImportadorPortugues(importlib.abc.MetaPathFinder):
-    """Intercepta imports de nomes em Portugues e redireciona para portugython.*."""
+    """Intercepta imports de nomes em Português e redireciona para portugython.*."""
 
     def find_spec(
         self,
@@ -95,7 +95,7 @@ class ImportadorPortugues(importlib.abc.MetaPathFinder):
         path: Sequence[str] | None,
         target=None,  # noqa: ANN001
     ) -> ModuleSpec | None:
-        """Retorna um ModuleSpec para o modulo em Portugues, se mapeado.
+        """Retorna um ModuleSpec para o módulo em Português, se mapeado.
 
         Args:
             fullname: Nome completo do modulo sendo importado.
@@ -115,10 +115,10 @@ _gancho = ImportadorPortugues()
 
 
 def listar_modulos() -> dict[str, str]:
-    """Retorna o mapeamento de nomes em Portugues para modulos portugython.
+    """Retorna o mapeamento de nomes em Português para módulos portugython.
 
     Returns:
-        Dicionario com nome_portugues -> caminho_modulo.
+        Dicionário com nome_portugues -> caminho_modulo.
     """
     return dict(MAPA_MODULOS)
 
@@ -141,7 +141,7 @@ class _CarregadorPtpy(SourceFileLoader):
 
 
 class ImportadorPtpy(importlib.abc.MetaPathFinder):
-    """Importa arquivos .ptpy (Python em Portugues) de qualquer diretorio
+    """Importa arquivos .ptpy (Python em Português) de qualquer diretório
     no sys.path."""
 
     def find_spec(
@@ -174,11 +174,11 @@ _gancho_ptpy = ImportadorPtpy()
 
 
 def instalar() -> None:
-    """Instala o importador de modulos em Portugues no sys.meta_path.
+    """Instala o importador de módulos em Português no sys.meta_path.
 
-    Apos chamar esta funcao:
-    - Modulos portugython sao importaveis pelo nome em Portugues
-    - Arquivos .ptpy sao importaveis via import normal
+    Após chamar esta função:
+    - Módulos portugython são importáveis pelo nome em Português
+    - Arquivos .ptpy são importáveis via import normal
 
     Example:
         import aleatorio
@@ -193,7 +193,7 @@ def instalar() -> None:
 
 
 def desinstalar() -> None:
-    """Remove o importador de modulos em Portugues do sys.meta_path."""
+    """Remove o importador de módulos em Português do sys.meta_path."""
     sys.meta_path[:] = [
         f for f in sys.meta_path
         if not isinstance(f, (ImportadorPortugues, ImportadorPtpy))

{portugython-0.4.0 → portugython-0.4.1}/portugython/transpilador.py

@@ -1,6 +1,6 @@
-"""transpilador - converte codigo Python escrito em Portugues para Python padrao.
+"""transpilador - converte código Python escrito em Português para Python padrão.
 
-Uso como modulo:
+Uso como módulo:
 
     from portugython.transpilador import traduzir, executar_texto, executar_arquivo
     codigo_py = traduzir("se x > 0:\\n    escreva(x)")
@@ -20,7 +20,7 @@ import tokenize
 from pathlib import Path
 
 # ---------------------------------------------------------------------------
-# Mapa de palavras-chave: Portugues -> Python
+# Mapa de palavras-chave: Português -> Python
 # ---------------------------------------------------------------------------
 
 MAPA_PALAVRAS_CHAVE: dict[str, str] = {
@@ -50,7 +50,7 @@ MAPA_PALAVRAS_CHAVE: dict[str, str] = {
     "levante": "raise",
     # Gerenciadores de contexto
     "com": "with",
-    # Operadores logicos (como funcoes: e/ou/nao ja existem em __init__.py,
+    # Operadores lógicos (como funções: e/ou/nao já existem em __init__.py,
     # mas aqui traduzimos os tokens da sintaxe)
     "nao": "not",
     "e": "and",
@@ -73,7 +73,7 @@ MAPA_PALAVRAS_CHAVE: dict[str, str] = {
     "Nenhum": "None",
 }
 
-# Mapa inverso (Python -> Portugues) para referencia
+# Mapa inverso (Python -> Português) para referência
 MAPA_INVERSO: dict[str, str] = {v: k for k, v in MAPA_PALAVRAS_CHAVE.items()}
 
 # Palavras reservadas em portugues (nao podem ser nomes de variaveis)
@@ -85,17 +85,17 @@ PALAVRAS_RESERVADAS: frozenset[str] = frozenset(MAPA_PALAVRAS_CHAVE.keys())
 
 
 def traduzir(codigo: str) -> str:
-    """Traduz codigo Python em Portugues para Python padrao.
+    """Traduz código Python em Português para Python padrão.
 
     Usa o tokenizador do Python para substituir apenas tokens NAME que
-    correspondem a palavras-chave em Portugues. Strings, comentarios e
-    identificadores compostos (ex: minha_se_variavel) sao intocados.
+    correspondem a palavras-chave em Português. Strings, comentários e
+    identificadores compostos (ex: minha_se_variavel) são intocados.
 
     Args:
-        codigo: Codigo fonte em Portugues.
+        codigo: Código fonte em Português.
 
     Returns:
-        Codigo fonte Python valido.
+        Código fonte Python válido.
 
     Example:
         >>> traduzir("se x > 0:\\n    retorne x")
@@ -119,15 +119,15 @@ def traduzir(codigo: str) -> str:
 
 
 def traduzir_para_portugues(codigo: str) -> str:
-    """Traduz codigo Python padrao para Python em Portugues.
+    """Traduz código Python padrão para Python em Português.
 
-    Operacao inversa de traduzir().
+    Operação inversa de traduzir().
 
     Args:
-        codigo: Codigo fonte Python padrao.
+        codigo: Código fonte Python padrão.
 
     Returns:
-        Codigo fonte em Portugues.
+        Código fonte em Português.
     """
     tokens_novos: list[tuple] = []
     try:
@@ -154,13 +154,13 @@ def executar_texto(
     globais: dict | None = None,
     locais: dict | None = None,
 ) -> None:
-    """Traduz e executa uma string de codigo em Portugues.
+    """Traduz e executa uma string de código em Português.
 
-    O ambiente de execucao inclui automaticamente todos os nomes definidos
+    O ambiente de execução inclui automaticamente todos os nomes definidos
     em portugython (escreva, intervalo, Verdadeiro, etc.).
 
     Args:
-        codigo: Codigo em Portugues a executar.
+        codigo: Código em Português a executar.
         globais: Namespace global adicional. Mesclado com portugython.
         locais: Namespace local. None usa o global.
 
@@ -182,9 +182,9 @@ def executar_texto(
 
 
 def executar_arquivo(caminho: str | Path) -> None:
-    """Traduz e executa um arquivo .ptpy ou .py em Portugues.
+    """Traduz e executa um arquivo .ptpy ou .py em Português.
 
-    O ambiente de execucao inclui automaticamente todos os nomes definidos
+    O ambiente de execução inclui automaticamente todos os nomes definidos
     em portugython.
 
     Args:
@@ -210,12 +210,12 @@ def executar_arquivo(caminho: str | Path) -> None:
 
 
 def mostrar_traducao(codigo: str) -> None:
-    """Imprime o codigo traduzido para Python padrao.
+    """Imprime o código traduzido para Python padrão.
 
-    Util para depuracao e aprendizado.
+    Útil para depuração e aprendizado.
 
     Args:
-        codigo: Codigo em Portugues.
+        codigo: Código em Português.
     """
     print(traduzir(codigo))
 

{portugython-0.4.0 → portugython-0.4.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "portugython"
-version = "0.4.0"
+version = "0.4.1"
 description = "A Portuguese translation of Python: functions, modules and syntax"
 readme = "README.md"
 license = {text = "MIT"}

{portugython-0.4.0 → portugython-0.4.1}/tests/test_portugython.py

@@ -33,7 +33,7 @@ from portugython import (
 
 def test_version():
     """Testa a versao do pacote."""
-    assert __version__ == "0.4.0"
+    assert __version__ == "0.4.1"
 
 
 def test_type_functions():