Repolode
PyCQA

PyCQA/pycodestyle

Un analizador de Python en un solo archivo que comprueba el código según las convenciones de estilo de PEP 8 y solo usa la biblioteca estándar.

Estrellas
5,165
Forks
762
Issues abiertos
105
Último commit
anteayer

¿Qué es?

pycodestyle comprueba el código fuente de Python según algunas de las convenciones de estilo definidas en PEP 8, la guía oficial de estilo de Python. Informa de infracciones como varias importaciones en una sola línea, un número incorrecto de líneas en blanco entre funciones, espacios en blanco de más y líneas demasiado largas. Cada infracción incluye un código, como E401 o E302, y su ubicación en el archivo.

El proyecto se distribuye como un único archivo Python que solo necesita la biblioteca estándar, por lo que se puede incorporar directamente a un proyecto. La salida puede adaptarse para que los editores permitan saltar a cada error, y la herramienta puede mostrar la línea de código correspondiente junto con el texto pertinente de PEP 8. El modo de estadísticas resume la frecuencia de cada error en una base de código.

La herramienta se basa en una arquitectura de plugins que permite añadir comprobaciones nuevas. Antes se llamaba pep8, pero cambió de nombre para evitar confusiones con el propio documento PEP 8.

Funciones clave

  • 01Comprueba el código según numerosas reglas de estilo de PEP 8 e informa de cada infracción con un código de error estable.
  • 02Se distribuye en un único archivo que solo depende de la biblioteca estándar de Python.
  • 03Indica el archivo, la línea y la columna de cada error para que los editores puedan saltar a él.
  • 04Puede mostrar la línea de código y las indicaciones pertinentes de PEP 8 para cada infracción.
  • 05Ofrece un modo de estadísticas que cuenta los errores en una base de código.
  • 06Admite plugins para añadir comprobaciones personalizadas.

Casos de uso

  • Aplicar un formato PEP 8 coherente en la integración continua de un proyecto Python.
  • Recibir comentarios de estilo en línea desde un editor mientras se escribe código Python.
  • Auditar una base de código heredada de gran tamaño para averiguar qué infracciones de estilo son más frecuentes.
  • Ejecutar una comprobación de estilo ligera sin instalar dependencias más pesadas.

Inicio rápido

  1. 1

    Instala pycodestyle con pip

    pip install pycodestyle
  2. 2

    Ejecútalo en un archivo Python para comprobar el estilo

    pycodestyle --first optparse.py

Antes de usarlo

  • La licencia no está claramente indicada en los metadatos (NOASSERTION), así que consulta el repositorio antes de reutilizarlo.

En colecciones

Temas

Preguntas frecuentes

¿Qué es pycodestyle?
Un analizador de Python en un solo archivo que comprueba el código según las convenciones de estilo de PEP 8 y solo usa la biblioteca estándar. pycodestyle comprueba el código fuente de Python según algunas de las convenciones de estilo definidas en PEP 8, la guía oficial de estilo de Python. Informa de infracciones como varias importaciones en una sola línea, un número incorrecto de líneas en blanco entre funciones, espacios en blanco de más y líneas demasiado largas. Cada infracción incluye un código, como E401 o E302, y su ubicación en el archivo.
¿pycodestyle es gratuito? ¿Qué licencia tiene?
pycodestyle es open source bajo la licencia Other. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿pycodestyle sigue mantenido?
Mantenimiento activo. El último commit de pycodestyle fue el 4 nov 2026.
¿Para qué puedo usar pycodestyle?
Aplicar un formato PEP 8 coherente en la integración continua de un proyecto Python. Recibir comentarios de estilo en línea desde un editor mientras se escribe código Python. Auditar una base de código heredada de gran tamaño para averiguar qué infracciones de estilo son más frecuentes. Ejecutar una comprobación de estilo ligera sin instalar dependencias más pesadas.
¿Cómo se instala pycodestyle?
Instala pycodestyle con pip: pip install pycodestyle Ejecútalo en un archivo Python para comprobar el estilo: pycodestyle --first optparse.py
¿Dónde consigo pycodestyle?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/PyCQA/pycodestyle

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

Proyectos relacionados