black

Black es un formateador de código Python mantenido por la Python Software Foundation. Su objetivo es terminar los debates sobre el formato manual aplicando un único estilo consistente: los usuarios ceden el control sobre detalles de formato a cambio de velocidad, determinismo y libertad de quejas por parte de los verificadores de estilo. Características principales descritas en el README: - Reformatea archivos completos in situ, ignorando el formato previo (con excepciones prácticas documentadas). - Opciones de configuración deliberadamente limitadas; se enfatizan valores predeterminados sensatos, con configuración del proyecto legible desde pyproject.toml (por ejemplo, patrones de inclusión/exclusión). - Busca producir los difs más pequeños posibles, lo que según el proyecto acelera la revisión del código. - Incluye una verificación de seguridad de que el código reformateado aún produce un AST válido efectivamente equivalente al original; una bandera --fast omite esta verificación. - Afirmar cumplimiento de PEP 8 y una política de estabilidad que rige los cambios de estilo. Instalación y uso: - Instalar mediante pip install black; requiere Python 3.10 o posterior. - El formateo de Jupyter Notebook está disponible a través del extra black[jupyter]. - Se ofrecen ejecutables standalone construidos con PyInstaller en las versiones de GitHub para usuarios sin instalación de Python. - Ejecutar como black {archivo_o_directorio_fuente} o python -m black {archivo_o_directorio_fuente}. Ecosistema y adopción: El README enumera muchos proyectos de código abierto que utilizan Black, incluyendo pytest, tox, Pyramid, Django, Django Channels, Hypothesis, attrs, SQLAlchemy, Poetry, aplicaciones de PyPA, pandas, Pillow, Twisted, LocalStack, Home Assistant, Zulip y Kedro. También nombra organizaciones como Dropbox, Lyft, Mozilla, Quora, Duolingo y Tesla como usuarios. Se citan testimonios de desarrolladores como Mike Bayer, Hynek Schlawack, Kenneth Reitz y Carl Meyer. El proyecto tiene licencia MIT, proporciona documentación en ReadTheDocs, mantiene un registro de cambios y lista de autores en archivos separados, e invita a contribuir a través de su documentación de contribución y chat en Discord. También hace referencia al Código de Conducta de la Comunidad Python.