Metadata-Version: 2.4
Name: pitao
Version: 0.2.4
Summary: Python com palavras reservadas em Português
Project-URL: Homepage, https://github.com/ivancrneto/pitao
Project-URL: Repository, https://github.com/ivancrneto/pitao
Author: Ivan Neto
License: MIT
Keywords: brasil,education,portuguese,preprocessor,python
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: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Education
Classifier: Topic :: Software Development :: Pre-processors
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# Pitão 🐍

<p align="center">
  <img src="https://raw.githubusercontent.com/ivancrneto/pitao/main/pitao.jpg" alt="Pitão Logo" width="200"/>
</p>

**Python com palavras reservadas em Português!**

Pitão é um preprocessador Python que permite escrever código usando palavras reservadas em Português. Inspirado no [Bython](https://github.com/mathialo/bython).

---

## Instalação

```bash
pip install pitao
```

Ou para instalar localmente com `uv`:

```bash
git clone https://github.com/ivancrneto/pitao.git
cd pitao
uv sync
```

---

## Galeria

![Sintaxe Básica](https://raw.githubusercontent.com/ivancrneto/pitao/main/vscode-pitao/assets/pitao1.png)
![Controle de Fluxo](https://raw.githubusercontent.com/ivancrneto/pitao/main/vscode-pitao/assets/pitao2.png)

---

## Exemplo de Código

Pitão suporta arquivos com extensão `.pt` ou `.pit`:

```python
# ola_mundo.pt (ou ola_mundo.pit)
def ola_mundo():
    imprimir("Olá, Mundo!")

se __nome__ == "__principal__":
    ola_mundo()
```

Execute com:

```bash
pitao ola_mundo.pt
# ou
pitao ola_mundo.pit
```

---

## Palavras Reservadas

| Português    | Python     |
| ------------ | ---------- |
| `Falso`      | `False`    |
| `Verdadeiro` | `True`     |
| `Nulo`       | `None`     |
| `e`          | `and`      |
| `ou`         | `or`       |
| `nao`        | `not`      |
| `se`         | `if`       |
| `senaose`    | `elif`     |
| `senao`      | `else`     |
| `para`       | `for`      |
| `enquanto`   | `while`    |
| `quebre`     | `break`    |
| `continue`   | `continue` |
| `def`        | `def`      |
| `classe`     | `class`    |
| `retorne`    | `return`   |
| `produza`    | `yield`    |
| `tente`      | `try`      |
| `exceto`     | `except`   |
| `finalmente` | `finally`  |
| `levante`    | `raise`    |
| `assincrono` | `async`    |
| `aguarde`    | `await`    |
| `importe`    | `import`   |
| `de`         | `from`     |
| `como`       | `as`       |
| `em`         | `in`       |
| `eh`         | `is`       |
| `com`        | `with`     |
| `afirme`     | `assert`   |
| `del`        | `del`      |
| `global`     | `global`   |
| `naolocal`   | `nonlocal` |
| `lambda`     | `lambda`   |
| `passe`      | `pass`     |

---

## Funções Built-in

Pitão também suporta a tradução de algumas funções built-in do Python:

| Português      | Python        |
| -------------- | ------------- |
| `imprimir()`   | `print()`     |
| `entrada()`    | `input()`     |
| `abrir()`      | `open()`      |
| `inteiro()`    | `int()`       |
| `flutuante()`  | `float()`     |
| `texto()`      | `str()`       |
| `booleano()`   | `bool()`      |
| `lista()`      | `list()`      |
| `dicionario()` | `dict()`      |
| `conjunto()`   | `set()`       |
| `tupla()`      | `tuple()`     |
| `tamanho()`    | `len()`       |
| `intervalo()`  | `range()`     |
| `enumerar()`   | `enumerate()` |
| `juntar()`     | `zip()`       |
| `ordenar()`    | `sorted()`    |
| `inverter()`   | `reversed()`  |
| `somar()`      | `sum()`       |
| `maior_de()`   | `max()`       |
| `menor_de()`   | `min()`       |

---

## Comandos

### `pitao` - Executar arquivos Pitão

```bash
pitao arquivo.pt [args...]     # Executa o arquivo
pitao -c arquivo.pt            # Compila para .py sem executar
pitao -k arquivo.pt            # Executa e mantém o .py gerado
pitao -v arquivo.pt            # Modo verbose
```

### `pt2py` - Traduzir Pitão para Python

```bash
pt2py arquivo.pt               # Cria arquivo.py
pt2py -o saida.py arquivo.pt   # Especifica nome de saída
```

### `py2pt` - Traduzir Python para Pitão

```bash
py2pt arquivo.py               # Cria arquivo.pt
py2pt -o saida.pt arquivo.py   # Especifica nome de saída
```

---

## Licença

MIT
