Repolode
Enviar
codespell-project

codespell-project/codespell

Herramienta de línea de comandos que detecta y corrige errores ortográficos comunes en código fuente y archivos de texto mediante un diccionario seleccionado.

Ver en GitHub
Estrellas
2,432
Forks
535
Issues abiertos
265
Último commit
ayer

¿Qué es?

codespell comprueba los archivos con una lista seleccionada de errores ortográficos comunes, en lugar de validar las palabras con un diccionario completo. Así reduce los falsos positivos cuando el código usa términos poco habituales y, a la vez, detecta errores como escribir «adn» en lugar de «and». Está diseñado principalmente para código fuente e ignora las secuencias de escape con barra invertida, pero funciona con cualquier archivo de texto.

De forma predeterminada, se ejecuta en modo de solo lectura y muestra los errores ortográficos. Con la opción -w escribe las correcciones sugeridas, y el modo interactivo permite revisar cada cambio. Se pueden excluir palabras mediante un archivo de exclusiones, listas en la línea de comandos o comentarios en línea; además, la configuración puede guardarse en setup.cfg, .codespellrc o pyproject.toml.

El proyecto incluye varios diccionarios derivados de una lista de errores ortográficos comunes de Wikipedia, y los usuarios pueden proporcionar los suyos. Se instala con pip, requiere Python 3.9 o posterior e incluye un hook de pre-commit.

Funciones clave

  • 01Comprueba los archivos con una lista seleccionada de errores ortográficos comunes, en lugar de usar un diccionario completo.
  • 02Puede aplicar las correcciones sugeridas de forma automática o interactiva con -w y -i.
  • 03Evita falsos positivos mediante listas de palabras, opciones de línea de comandos o comentarios en línea.
  • 04Lee la configuración de setup.cfg, .codespellrc o pyproject.toml.
  • 05Funciona como hook de pre-commit y puede hacer que las ejecuciones de CI fallen cuando se escriben correcciones.

Casos de uso

  • Detectar errores tipográficos en comentarios, identificadores y documentación del código fuente durante el desarrollo.
  • Ejecutar comprobaciones ortográficas en un pipeline de CI o en un hook de pre-commit.
  • Corregir errores tipográficos en una base de código extensa mediante correcciones interactivas.

Inicio rápido

  1. 1

    Instala codespell desde PyPI con pip

    pip install codespell
  2. 2

    Ejecuta codespell en el directorio actual

    codespell

Antes de usarlo

  • Está licenciado bajo GPL-2.0, una licencia copyleft que puede restringir la forma de distribuir código derivado.
  • Solo detecta errores ortográficos comunes incluidos en su diccionario, por lo que no encontrará erratas poco habituales.

Temas

#spell-checking#linting#command-line#developer-tools#python#code-quality#pre-commit

Preguntas frecuentes

¿Qué es codespell?
Herramienta de línea de comandos que detecta y corrige errores ortográficos comunes en código fuente y archivos de texto mediante un diccionario seleccionado. codespell comprueba los archivos con una lista seleccionada de errores ortográficos comunes, en lugar de validar las palabras con un diccionario completo. Así reduce los falsos positivos cuando el código usa términos poco habituales y, a la vez, detecta errores como escribir «adn» en lugar de «and». Está diseñado principalmente para código fuente e ignora las secuencias de escape con barra invertida, pero funciona con cualquier archivo de texto.
¿codespell es gratuito? ¿Qué licencia tiene?
codespell es open source bajo la licencia GPL-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿codespell sigue mantenido?
Mantenimiento activo. El último commit de codespell fue el 6 nov 2026.
¿Para qué puedo usar codespell?
Detectar errores tipográficos en comentarios, identificadores y documentación del código fuente durante el desarrollo. Ejecutar comprobaciones ortográficas en un pipeline de CI o en un hook de pre-commit. Corregir errores tipográficos en una base de código extensa mediante correcciones interactivas.
¿Cómo se instala codespell?
Instala codespell desde PyPI con pip: pip install codespell Ejecuta codespell en el directorio actual: codespell
¿Dónde consigo codespell?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/codespell-project/codespell

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

Proyectos relacionados