Metadata-Version: 2.4
Name: mota-jokes
Version: 0.1.2
Summary: Uma biblioteca Python para manter vivas as piadas ruins do Mota.
Author: Amigos do Mota
License-Expression: MIT
Project-URL: Homepage, https://github.com/paladini/mota-jokes
Project-URL: Repository, https://github.com/paladini/mota-jokes
Project-URL: Issues, https://github.com/paladini/mota-jokes/issues
Keywords: jokes,meme,python,php,mota
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: Portuguese
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
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: Programming Language :: Python :: 3.14
Classifier: Topic :: Games/Entertainment
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# mota-jokes

Uma biblioteca Python para honrar uma tradição importante: as piadas ruins do Mota.

O pacote é instalado como `mota-jokes`, mas o import fica como `mota`. A ideia é simples: transformar o folclore interno de um amigo que insiste em manter o meme vivo numa API Python publicável, testável e completamente desnecessária.

Ele tem dois módulos de primeira classe:

- `mota.jokes`: acervo e motor de piadas ruins.
- `mota.php`: utilidades PHP emocionalmente duvidosas.

## Instalação

```bash
python -m pip install mota-jokes
```

Para desenvolvimento local:

```bash
python -m pip install -e .
```

## Exemplos

### A piada canônica

```python
from mota import jokes

print(jokes.tell("direito"))
```

Saída:

```text
Nossa, bicho, já pensou em fazer Direito?
Por quê, tô fazendo errado?
```

### Quando o ambiente entra na piada

```python
from mota import jokes

print(jokes.tell("docker"))
```

Saída:

```text
O Mota colocou a piada ruim no Docker.
Agora ela roda igual em qualquer máquina, infelizmente.
```

### Quando o PHP exige respeito

```python
from mota import php

print(php.composer_install("mota/bom-senso"))
```

Saída:

```text
composer require mota/bom-senso
Pacote instalado. O humor ainda requer configuração manual.
```

### Quando o problema é só um ponto e vírgula

```python
from mota import php

print(php.semicolon("$mota = 'meme'"))
```

Saída:

```text
$mota = 'meme';
```

## Linha de comando

Depois de instalar:

```bash
python -m mota jokes direito
python -m mota jokes docker
python -m mota jokes --search python
python -m mota php framework
python -m mota php composer mota/bom-senso
```

Se o diretório de scripts do Python estiver no `PATH`, o comando `mota` também fica disponível diretamente:

```bash
mota jokes cache
```

## Uso em Python

```python
from mota import jokes, php

print(jokes.random())
print(jokes.explain("regex"))
print(php.echo())
```

## API rápida

```python
jokes.all()
jokes.ids()
jokes.random()
jokes.by_id("prod")
jokes.tell("cache")
jokes.search("python")
jokes.explain("php")
jokes.audit()
jokes.cringe_index()

php.echo()
php.is_php("Python")
php.translate("print('olá')")
php.framework()
php.ini_get("display_errors")
php.semicolon("$mota = 'meme'")
php.composer_install("mota/humor")
```

## Publicação no PyPI

O nome `mota` já existe no PyPI, então este projeto usa `mota-jokes` como nome de distribuição. Isso não afeta o import:

```bash
pip install mota-jokes
```

```python
from mota import jokes, php
```

Para publicar uma nova versão:

```bash
python -m pip install --upgrade build twine
python -m build
python -m twine check dist/*
python -m twine upload dist/*
```

Antes de publicar, lembre-se de incrementar a versão em `pyproject.toml` e `src/mota/__init__.py`, porque o PyPI não permite reenviar a mesma versão.
