PLR2004 na prática: por que evitar números mágicos em expressões booleanas em Python

Evitar números mágicos em expressões booleanas é uma recomendação explícita de linters Python modernos (como Pylint e Ruff, via regra PLR2004), pois esses valores dificultam a leitura e a manutenção do código. Entender essa regra e o contexto em que ela surgiu ajuda a justificar a prática ao time e a padronizar o estilo da base de código. PLR2004: de onde vem essa regra? A sigla PLR2004 é o identificador da regra magic-value-comparison em ferramentas de lint para Python, como o linter Ruff, que reutiliza a numeração herdada do Pylint. A regra é derivada diretamente da mensagem de refatoração R2004 – magic-value-comparison do Pylint, mantido pelo projeto PyCQA, que incentiva o uso de constantes nomeadas em vez de valores mágicos em comparações. ...

29 de dezembro de 2025 · 4 min · 780 words · Riverfount

Scripts Python Autocontidos: Como Rodar Qualquer `.py` com Dependências Embutidas no UV

Você já precisou compartilhar um script Python com colegas e teve que explicar: “Instala o Python 3.12, cria um venv, instala requests e rich, depois roda”? Com o gerenciador UV, isso acabou. Agora é possível escrever um único arquivo .py que já traz suas dependências dentro dele, como requests<3 e rich, e rodar tudo com apenas uv run script.py. Neste guia, você vai aprender como usar o bloco # /// script do UV para transformar scripts comuns em artefatos autocontidos, reprodutíveis e portáteis — perfeitos para automações, ferramentas internas e protótipos. ...

28 de novembro de 2025 · 4 min · 815 words · Riverfount

Descubra o UV: Gerenciador de Projetos Python para Iniciantes

O UV é um gerenciador de pacotes e projetos Python extremamente rápido, escrito em Rust, que substitui ferramentas como pip, venv e pipenv por comandos simples e automação de ambientes virtuais. Ele conecta gerenciamento de versões do Python, instalação de dependências e execução de scripts em um único comando, proporcionando agilidade no desenvolvimento.​ Instalação Rápida Para começar, instale o UV facilmente via terminal: Linux/macOS: curl -LsSf https://astral.sh/uv/install.sh | sh Windows PowerShell: irm https://astral.sh/uv/install.ps1 | iex Confirme a instalação com uv --version para garantir que está pronto para uso. ...

27 de novembro de 2025 · 2 min · 369 words · Riverfount