🇧🇷 Português · 🇺🇸 English
Um toolkit de produtividade para desenvolvedores Python, com utilitários para logging elegante, manipulação de JSON, validação, decorators inteligentes e automação de tarefas.
PyBrige é um toolkit moderno criado para eliminar código repetitivo em projetos Python, oferecendo funções reutilizáveis para logging, configuração, análise de tempo e manipulação de dados.
Com pybrige, você ganha velocidade, clareza e organização no desenvolvimento — sem perder o controle.
pip install pybrigefrom pybrige import setup_logging, timer, retry, load_env, EnvSpec, VarSpec
setup_logging(colors=True)
config = load_env(EnvSpec(vars=[
VarSpec("API_URL", help="URL da API"),
VarSpec("RETRIES", type="int", default=3)
]))
@retry(tries=config["RETRIES"], delay=1)
@timer(template="[PERF] '{func_name}' executou em {elapsed:.2f}s")
def buscar_dados():
import requests
resp = requests.get(config["API_URL"])
resp.raise_for_status()
return resp.json()
dados = buscar_dados()
print(dados)| Categoria | Recursos |
|---|---|
| ⚙️ Configuração | load_env, EnvSpec, VarSpec |
| 🧠 Logging | setup_logging com cores e formatação avançada |
| ⏱️ Decorators | @retry, @timer |
| 🧩 JSON Utils | read_json, write_json, append_json_line, pretty_print_json |
| 🧵 Texto & Strings | slugify, camel_to_snake, extract_emails, extract_urls, validate_bi |
| 🎨 Extras Visuais | ascii_banner_hacker, matrix_rain_preview |
from pybrige import validate_bi
print(validate_bi("123456789012A")) # ✅ True
print(validate_bi("123456-789012-B")) # ✅ True
print(validate_bi("invalido")) # ❌ False- Suporte a YAML (
io_utils) - Novas transformações de texto (kebab-case, title case)
- CLI interativo (
pybrige build,pybrige upload)
Quer contribuir? ❤️
Siga estes passos simples:
# 1. Fork o repositório
# 2. Crie sua branch
git checkout -b minha-feature
# 3. Commit e push
git commit -m "Nova feature"
git push origin minha-featureDepois, abra um Pull Request 🚀
Distribuído sob a licença MIT.
Consulte o arquivo LICENSE para mais detalhes.
- 📦 PyPI: pypi.org/project/pybrige
- 💻 GitHub: github.com/juliobrige/pybrige
- 📘 Documentação: juliobrige.github.io/pybrige
A developer productivity toolkit for Python, featuring elegant logging, retry decorators, JSON utilities, environment handling, and automation helpers.
PyBrige is a lightweight productivity toolkit designed to simplify repetitive tasks in Python projects — from environment management to data handling and logging.
You get cleaner code, faster setup, and powerful tools ready to use.
pip install pybrigefrom pybrige import setup_logging, retry, timer
setup_logging(colors=True)
@retry(tries=3, delay=1)
@timer()
def fetch_data():
print("Fetching data...")
return {"ok": True}
fetch_data()| Category | Features |
|---|---|
| ⚙️ Config | Environment validation (load_env, EnvSpec, VarSpec) |
| 🧠 Logging | Simple colorized logging (setup_logging) |
| ⏱️ Decorators | @retry, @timer |
| 🧩 JSON Utils | read_json, write_json, append_json_line |
| 🔠 Text Utils | slugify, camel_to_snake, extract_emails, extract_urls |
| 💻 CLI (coming soon) | pybrige build, pybrige upload, pybrige version |
We welcome contributions!
Fork, create your branch, commit, push, and open a PR 🚀
Distributed under the MIT License.
See LICENSE for details.
- PyPI → pypi.org/project/pybrige
- GitHub → github.com/juliobrige/pybrige
- Docs → juliobrige.github.io/pybrige
💡 Inspired by the clean documentation style of FastAPI — modern, organized, and developer-friendly.