portugython 0.0.14__tar.gz → 0.2.0__tar.gz

portugython-0.2.0/.gitignore

@@ -0,0 +1,36 @@
+# Secrets
+api-token
+.pypirc
+*.pem
+*.key
+.env*
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+*.egg
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+
+# IDE
+.vscode/
+*.swp
+*.swo
+.DS_Store
+
+# Ruff
+.ruff_cache/

portugython-0.2.0/CHANGELOG.md

@@ -0,0 +1,70 @@
+# Changelog
+
+## 0.2.0 (2026-06-26)
+
+Full stdlib coverage. 36 submodules total, all importable via `from portugython import <modulo>`:
+
+**New in 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
+- `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
+
+Also in 0.2.0:
+- Fix: renamed builtin `identificador` alias to `obter_id` to avoid shadowing the uuid submodule
+- 49 tests covering all modules
+
+
+## 0.1.0 (2026-06-26)
+
+- Add full stdlib submodule set with Portuguese translations:
+  - `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.
+- 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
+
+## 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
+
+## 0.0.14 (2022-11-28)
+
+- Latest release on PyPI.

{portugython-0.0.14 → portugython-0.2.0}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2022 In Gnave
+Copyright (c) 2022 Victor Kolis
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

portugython-0.2.0/PKG-INFO

@@ -0,0 +1,292 @@
+Metadata-Version: 2.4
+Name: portugython
+Version: 0.2.0
+Summary: A Portuguese translation of the Python functions/modules/packages
+Project-URL: Homepage, https://github.com/spacemany2k38/portugython
+Project-URL: Bug Tracker, https://github.com/spacemany2k38/portugython/issues
+Author: Victor Kolis
+Maintainer: Victor Kolis
+License: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Education
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: Portuguese (Brazilian)
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Provides-Extra: dev
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Portugython
+
+[![PyPI version](https://img.shields.io/pypi/v/portugython.svg)](https://pypi.org/project/portugython/)
+[![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.
+
+## Instalacao
+
+```bash
+pip install portugython
+```
+
+## Uso basico
+
+```python
+from portugython import *
+
+escreva("Ola, Mundo!")
+nome = leia("Qual e seu nome? ")
+escreva("Ola,", nome)
+
+numeros = Lista([1, 2, 3, 4, 5])
+numeros.adicione(6)
+numeros.classifique(reverso=Verdadeiro)
+escreva(numeros)
+
+pares = filtro(lambda x: x % 2 == 0, numeros)
+escreva("Pares:", pares)
+
+resultado = se(tamanho(pares) > 0, "tem pares", "sem pares")
+escreva(resultado)
+```
+
+## Modulos da biblioteca padrao
+
+Cada modulo da stdlib tem uma versao em portugues que pode ser importada separadamente.
+
+### aleatorio (random)
+
+```python
+from portugython import aleatorio
+
+aleatorio.semente(42)
+n = aleatorio.inteiro_aleatorio(1, 100)
+item = aleatorio.escolha(["pedra", "papel", "tesoura"])
+lista = [1, 2, 3, 4, 5]
+aleatorio.embaralhe(lista)
+amostra = aleatorio.amostra(range(50), k=5)
+```
+
+### matematica (math)
+
+```python
+from portugython import matematica
+
+print(matematica.PI)
+print(matematica.raiz_quadrada(16))
+print(matematica.fatorial(10))
+print(matematica.seno(matematica.PI / 2))
+print(matematica.mdc(48, 18))
+print(matematica.combinacoes(10, 3))
+```
+
+### sistema (os + sys)
+
+```python
+from portugython import sistema
+
+pasta = sistema.diretorio_atual()
+arquivos = sistema.listar_diretorio(".")
+sistema.criar_diretorios("nova/pasta", existe_ok=Verdadeiro)
+sistema.renomear("antigo.txt", "novo.txt")
+
+print(sistema.versao)
+print(sistema.plataforma)
+db = sistema.variavel_ambiente("DATABASE_URL", "sqlite:///app.db")
+```
+
+### tempo (time + datetime)
+
+```python
+from portugython import tempo
+
+agora = tempo.agora()
+print(agora.formatar("%d/%m/%Y %H:%M"))
+
+hoje = tempo.hoje()
+print(hoje.ano, hoje.mes, hoje.dia)
+
+dur = tempo.Duracao.de(dias=7, horas=2)
+print(dur.total_segundos)
+
+tempo.dormir(0.1)
+```
+
+### colecoes (collections)
+
+```python
+from portugython import colecoes
+
+# Contagem
+votos = colecoes.Contador(["sim", "nao", "sim", "sim", "nao"])
+print(votos.mais_comuns(1))
+
+# Fila dupla
+d = colecoes.Deque([1, 2, 3])
+d.adicione_esquerda(0)
+d.adicione_direita(4)
+
+# Pilha
+pilha = colecoes.Pilha()
+pilha.empurre("a")
+pilha.empurre("b")
+print(pilha.retire())
+
+# Fila
+fila = colecoes.Fila()
+fila.enfileire("primeiro")
+fila.enfileire("segundo")
+print(fila.desenfileire())
+
+# Tupla com campos nomeados
+Ponto = colecoes.tupla_com_nome("Ponto", ["x", "y"])
+p = Ponto(3, 4)
+print(p.x, p.y)
+```
+
+### iteradores (itertools)
+
+```python
+from portugython import iteradores
+
+# Combinatoria
+for combo in iteradores.combine([1, 2, 3, 4], 2):
+    print(combo)
+
+# Produto cartesiano
+for par in iteradores.produto("AB", "12"):
+    print(par)
+
+# Acumulacao
+totais = list(iteradores.acumule([1, 2, 3, 4, 5]))
+
+# Encadeamento
+unido = list(iteradores.encadeie([1, 2], [3, 4], [5]))
+```
+
+### funcional (functools)
+
+```python
+from portugython import funcional
+
+# Reducao
+total = funcional.reduzido(lambda a, b: a + b, range(1, 11))
+
+# Funcao parcial
+multiplicar_por_3 = funcional.parcial(lambda a, b: a * b, 3)
+print(multiplicar_por_3(7))
+
+# Memoizacao
+@funcional.cache
+def fibonacci(n):
+    if n < 2:
+        return n
+    return fibonacci(n - 1) + fibonacci(n - 2)
+
+# Composicao
+dobrar = lambda x: x * 2
+somar_um = lambda x: x + 1
+dobrar_e_somar = funcional.compor(somar_um, dobrar)
+print(dobrar_e_somar(5))
+```
+
+### expressao (re)
+
+```python
+from portugython import expressao
+
+# Busca simples
+m = expressao.buscar(r"\d+", "pagina 42")
+if m:
+    print(m.group())
+
+# Todos os resultados
+numeros = expressao.encontrar_todos(r"\d+", "1 mais 2 igual 3")
+
+# Substituicao
+limpo = expressao.substituir(r"\s+", " ", "texto  com   espacos")
+
+# Padrao reutilizavel
+email = expressao.Padrao(r"[\w.+-]+@[\w-]+\.[a-z]{2,}")
+if email.encontrar("contato@example.com"):
+    print("Email valido")
+```
+
+## Referencia de builtins
+
+### Entrada / Saida
+| Portugues | Python |
+|-----------|--------|
+| `escreva` | `print` |
+| `leia` | `input` |
+| `abra` | `open` |
+
+### Tipos
+| Portugues | Python |
+|-----------|--------|
+| `inteiro` | `int` |
+| `texto` | `str` |
+| `decimal` | `float` |
+| `logico` | `bool` |
+| `lista` | `list` |
+| `dicionario` | `dict` |
+| `conjunto` | `set` |
+| `tupla` | `tuple` |
+| `intervalo` | `range` |
+
+### Constantes
+| Portugues | Python |
+|-----------|--------|
+| `Verdadeiro` | `True` |
+| `Falso` | `False` |
+| `Nenhum` | `None` |
+
+### Funcoes de sequencia
+| Portugues | Python |
+|-----------|--------|
+| `tamanho` | `len` |
+| `soma` | `sum` |
+| `maximo` | `max` |
+| `minimo` | `min` |
+| `absoluto` | `abs` |
+| `classificado` | `sorted` |
+| `reverso` | `reversed` |
+| `enumerado` | `enumerate` |
+| `comprimido` | `zip` |
+| `mapeado` | `map` |
+| `filtrado` | `filter` |
+
+### Operadores logicos
+| Portugues | Python |
+|-----------|--------|
+| `nao(x)` | `not x` |
+| `e(a, b)` | `a and b` |
+| `ou(a, b)` | `a or b` |
+
+### Funcoes utilitarias
+| Portugues | 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)` |
+
+## Contribuir
+
+1. Crie um fork deste repositorio
+2. Crie uma branch nova a partir de main
+3. Envie um pull request
+
+## Licenca
+
+MIT

portugython-0.2.0/README.md

@@ -0,0 +1,265 @@
+# Portugython
+
+[![PyPI version](https://img.shields.io/pypi/v/portugython.svg)](https://pypi.org/project/portugython/)
+[![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.
+
+## Instalacao
+
+```bash
+pip install portugython
+```
+
+## Uso basico
+
+```python
+from portugython import *
+
+escreva("Ola, Mundo!")
+nome = leia("Qual e seu nome? ")
+escreva("Ola,", nome)
+
+numeros = Lista([1, 2, 3, 4, 5])
+numeros.adicione(6)
+numeros.classifique(reverso=Verdadeiro)
+escreva(numeros)
+
+pares = filtro(lambda x: x % 2 == 0, numeros)
+escreva("Pares:", pares)
+
+resultado = se(tamanho(pares) > 0, "tem pares", "sem pares")
+escreva(resultado)
+```
+
+## Modulos da biblioteca padrao
+
+Cada modulo da stdlib tem uma versao em portugues que pode ser importada separadamente.
+
+### aleatorio (random)
+
+```python
+from portugython import aleatorio
+
+aleatorio.semente(42)
+n = aleatorio.inteiro_aleatorio(1, 100)
+item = aleatorio.escolha(["pedra", "papel", "tesoura"])
+lista = [1, 2, 3, 4, 5]
+aleatorio.embaralhe(lista)
+amostra = aleatorio.amostra(range(50), k=5)
+```
+
+### matematica (math)
+
+```python
+from portugython import matematica
+
+print(matematica.PI)
+print(matematica.raiz_quadrada(16))
+print(matematica.fatorial(10))
+print(matematica.seno(matematica.PI / 2))
+print(matematica.mdc(48, 18))
+print(matematica.combinacoes(10, 3))
+```
+
+### sistema (os + sys)
+
+```python
+from portugython import sistema
+
+pasta = sistema.diretorio_atual()
+arquivos = sistema.listar_diretorio(".")
+sistema.criar_diretorios("nova/pasta", existe_ok=Verdadeiro)
+sistema.renomear("antigo.txt", "novo.txt")
+
+print(sistema.versao)
+print(sistema.plataforma)
+db = sistema.variavel_ambiente("DATABASE_URL", "sqlite:///app.db")
+```
+
+### tempo (time + datetime)
+
+```python
+from portugython import tempo
+
+agora = tempo.agora()
+print(agora.formatar("%d/%m/%Y %H:%M"))
+
+hoje = tempo.hoje()
+print(hoje.ano, hoje.mes, hoje.dia)
+
+dur = tempo.Duracao.de(dias=7, horas=2)
+print(dur.total_segundos)
+
+tempo.dormir(0.1)
+```
+
+### colecoes (collections)
+
+```python
+from portugython import colecoes
+
+# Contagem
+votos = colecoes.Contador(["sim", "nao", "sim", "sim", "nao"])
+print(votos.mais_comuns(1))
+
+# Fila dupla
+d = colecoes.Deque([1, 2, 3])
+d.adicione_esquerda(0)
+d.adicione_direita(4)
+
+# Pilha
+pilha = colecoes.Pilha()
+pilha.empurre("a")
+pilha.empurre("b")
+print(pilha.retire())
+
+# Fila
+fila = colecoes.Fila()
+fila.enfileire("primeiro")
+fila.enfileire("segundo")
+print(fila.desenfileire())
+
+# Tupla com campos nomeados
+Ponto = colecoes.tupla_com_nome("Ponto", ["x", "y"])
+p = Ponto(3, 4)
+print(p.x, p.y)
+```
+
+### iteradores (itertools)
+
+```python
+from portugython import iteradores
+
+# Combinatoria
+for combo in iteradores.combine([1, 2, 3, 4], 2):
+    print(combo)
+
+# Produto cartesiano
+for par in iteradores.produto("AB", "12"):
+    print(par)
+
+# Acumulacao
+totais = list(iteradores.acumule([1, 2, 3, 4, 5]))
+
+# Encadeamento
+unido = list(iteradores.encadeie([1, 2], [3, 4], [5]))
+```
+
+### funcional (functools)
+
+```python
+from portugython import funcional
+
+# Reducao
+total = funcional.reduzido(lambda a, b: a + b, range(1, 11))
+
+# Funcao parcial
+multiplicar_por_3 = funcional.parcial(lambda a, b: a * b, 3)
+print(multiplicar_por_3(7))
+
+# Memoizacao
+@funcional.cache
+def fibonacci(n):
+    if n < 2:
+        return n
+    return fibonacci(n - 1) + fibonacci(n - 2)
+
+# Composicao
+dobrar = lambda x: x * 2
+somar_um = lambda x: x + 1
+dobrar_e_somar = funcional.compor(somar_um, dobrar)
+print(dobrar_e_somar(5))
+```
+
+### expressao (re)
+
+```python
+from portugython import expressao
+
+# Busca simples
+m = expressao.buscar(r"\d+", "pagina 42")
+if m:
+    print(m.group())
+
+# Todos os resultados
+numeros = expressao.encontrar_todos(r"\d+", "1 mais 2 igual 3")
+
+# Substituicao
+limpo = expressao.substituir(r"\s+", " ", "texto  com   espacos")
+
+# Padrao reutilizavel
+email = expressao.Padrao(r"[\w.+-]+@[\w-]+\.[a-z]{2,}")
+if email.encontrar("contato@example.com"):
+    print("Email valido")
+```
+
+## Referencia de builtins
+
+### Entrada / Saida
+| Portugues | Python |
+|-----------|--------|
+| `escreva` | `print` |
+| `leia` | `input` |
+| `abra` | `open` |
+
+### Tipos
+| Portugues | Python |
+|-----------|--------|
+| `inteiro` | `int` |
+| `texto` | `str` |
+| `decimal` | `float` |
+| `logico` | `bool` |
+| `lista` | `list` |
+| `dicionario` | `dict` |
+| `conjunto` | `set` |
+| `tupla` | `tuple` |
+| `intervalo` | `range` |
+
+### Constantes
+| Portugues | Python |
+|-----------|--------|
+| `Verdadeiro` | `True` |
+| `Falso` | `False` |
+| `Nenhum` | `None` |
+
+### Funcoes de sequencia
+| Portugues | Python |
+|-----------|--------|
+| `tamanho` | `len` |
+| `soma` | `sum` |
+| `maximo` | `max` |
+| `minimo` | `min` |
+| `absoluto` | `abs` |
+| `classificado` | `sorted` |
+| `reverso` | `reversed` |
+| `enumerado` | `enumerate` |
+| `comprimido` | `zip` |
+| `mapeado` | `map` |
+| `filtrado` | `filter` |
+
+### Operadores logicos
+| Portugues | Python |
+|-----------|--------|
+| `nao(x)` | `not x` |
+| `e(a, b)` | `a and b` |
+| `ou(a, b)` | `a or b` |
+
+### Funcoes utilitarias
+| Portugues | 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)` |
+
+## Contribuir
+
+1. Crie um fork deste repositorio
+2. Crie uma branch nova a partir de main
+3. Envie um pull request
+
+## Licenca
+
+MIT