Repolode
Enviar
peterjc

peterjc/flake8-black

Plugin de flake8 que ejecuta black en modo de comprobación e informa las diferencias de formato como infracciones BLK de flake8.

Ver en GitHub
Estrellas
167
Forks
11
Issues abiertos
3
Último commit
hace 3 días

¿Qué es?

flake8-black es un plugin de flake8 que ejecuta black en modo de comprobación como parte del análisis de flake8. Los archivos que black reformatearía se notifican como infracciones BLK100, de modo que las comprobaciones de estilo de black pueden ejecutarse con el mismo comando de flake8 que se usa para otras reglas de lint.

El plugin resulta útil en hooks de pre-commit de git y en integración continua, donde una sola ejecución de flake8 puede abarcar tanto el formato de black como otras comprobaciones. Lee ajustes de black como target_version, skip_string_normalization y line_length desde pyproject.toml, y acepta la opción --black-config para usar un archivo de configuración compartido. También informa de errores internos con códigos BLK9xx, por ejemplo, cuando no se pueden leer archivos o el TOML no es válido.

El README señala que el plugin no respeta los ajustes include y exclude de black, por lo que los archivos excluidos de black también deben excluirse en flake8. Se recomienda fijar una versión específica de black, ya que las actualizaciones de black pueden introducir nuevas infracciones BLK100.

Funciones clave

  • 01Informa los archivos que black reformatearía como infracciones BLK100 de flake8.
  • 02Lee ajustes de black, como line_length y target_version, desde pyproject.toml.
  • 03Acepta la opción --black-config para indicar un archivo de configuración compartido.
  • 04Informa de problemas internos, como archivos que no se pueden leer o TOML no válido, con códigos BLK9xx.
  • 05Se puede instalar desde PyPI o conda-forge.

Casos de uso

  • Ejecutar comprobaciones de estilo de black junto con otras reglas de flake8 en CI.
  • Aplicar un formato coherente mediante un hook de pre-commit de git.
  • Compartir una configuración de black entre varios proyectos de Python.

Inicio rápido

  1. 1

    Instala el complemento desde PyPI con pip

    pip install flake8-black
  2. 2

    Ejecuta flake8 en un archivo Python para ver los códigos BLK

    flake8 example.py

Antes de usarlo

  • No respeta la configuración include y exclude de black, por lo que esos archivos deben excluirse por separado en flake8.
  • Como se indica en el README, las versiones a partir de la 0.3.7 no funcionan con black 25.9.0. La versión v0.4.0, que corregirá este problema, está pendiente.

En colecciones

Linters y formateadores de código

Temas

#python#flake8#linting#code-style#black#formatter

Preguntas frecuentes

¿Qué es flake8-black?
Plugin de flake8 que ejecuta black en modo de comprobación e informa las diferencias de formato como infracciones BLK de flake8. flake8-black es un plugin de flake8 que ejecuta black en modo de comprobación como parte del análisis de flake8. Los archivos que black reformatearía se notifican como infracciones BLK100, de modo que las comprobaciones de estilo de black pueden ejecutarse con el mismo comando de flake8 que se usa para otras reglas de lint.
¿flake8-black es gratuito? ¿Qué licencia tiene?
flake8-black es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿flake8-black sigue mantenido?
Mantenimiento activo. El último commit de flake8-black fue el 3 nov 2026.
¿Para qué puedo usar flake8-black?
Ejecutar comprobaciones de estilo de black junto con otras reglas de flake8 en CI. Aplicar un formato coherente mediante un hook de pre-commit de git. Compartir una configuración de black entre varios proyectos de Python.
¿Cómo se instala flake8-black?
Instala el complemento desde PyPI con pip: pip install flake8-black Ejecuta flake8 en un archivo Python para ver los códigos BLK: flake8 example.py
¿Dónde consigo flake8-black?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/peterjc/flake8-black

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados