mota-jokes 0.1.2

Uma biblioteca Python para manter vivas as piadas ruins do Mota.

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

python -m pip install mota-jokes

Para desenvolvimento local:

python -m pip install -e .

Exemplos

A piada canônica

from mota import jokes

print(jokes.tell("direito"))

Saída:

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

Quando o ambiente entra na piada

from mota import jokes

print(jokes.tell("docker"))

Saída:

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

Quando o PHP exige respeito

from mota import php

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

Saída:

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

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

from mota import php

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

Saída:

$mota = 'meme';

Linha de comando

Depois de instalar:

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:

mota jokes cache

Uso em Python

from mota import jokes, php

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

API rápida

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:

pip install mota-jokes

from mota import jokes, php

Para publicar uma nova versão:

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.