Repolode
Enviar
google

google/yapf

Formateador de código Python que adapta los archivos fuente a un estilo configurable con el algoritmo de diseño de clang-format.

Alternativa open source a:Black

Ver en GitHub
Estrellas
13,987
Forks
915
Issues abiertos
433
Último commit
hace 7 días

¿Qué es?

YAPF formatea código fuente Python calculando la mejor disposición que se ajusta al estilo elegido, para que los desarrolladores dediquen menos tiempo a corregir manualmente la indentación, los espacios y los saltos de línea. Se basa en el algoritmo de reformateo de clang-format y puede ejecutarse desde la línea de comandos o usarse como biblioteca mediante las funciones FormatCode y FormatFile.

El estilo se controla con bases predefinidas, como pep8, google, yapf y facebook, que se pueden personalizar con ajustes de clave/valor en un archivo .style.yapf, setup.cfg o pyproject.toml, o desde la línea de comandos. Hay muchas opciones individuales para configurar aspectos como el límite de columnas, la posición de los corchetes, la división de operadores y el espaciado de comentarios.

YAPF puede reformatear solo los rangos de líneas seleccionados, excluir archivos mediante patrones de línea de comandos o un archivo .yapfignore, mostrar diferencias y ejecutarse en paralelo con varios archivos. El modo --diff devuelve un código de salida distinto de cero cuando se necesitan cambios, por lo que sirve como comprobación en CI.

Funciones clave

  • 01Reformatea archivos Python con un estilo predefinido o personalizado, como pep8 o google.
  • 02Se puede personalizar con decenas de opciones de estilo en archivos de configuración o desde la línea de comandos.
  • 03Puede formatear solo los rangos de líneas especificados de un archivo.
  • 04Admite patrones de exclusión desde la línea de comandos o mediante .yapfignore / pyproject.toml.
  • 05Incluye un modo de diferencias que devuelve un código distinto de cero cuando se necesitan cambios de formato, adecuado para comprobaciones de CI.
  • 06Se puede usar como herramienta de línea de comandos o como biblioteca de Python.

Casos de uso

  • Aplicar un estilo de código uniforme en un equipo o repositorio de Python.
  • Añadir una comprobación de formato a una canalización de CI mediante el modo de diferencias.
  • Formatear solo las líneas modificadas por un parche o una edición mediante la integración con un editor.
  • Automatizar la limpieza del estilo en scripts que generan o transforman código Python.

Inicio rápido

  1. 1

    Instala YAPF desde PyPI

    pip install yapf
  2. 2

    Ejecuta yapf en tus archivos Python con opciones como --diff o --in-place

Antes de usarlo

  • El README describe YAPF como una versión beta, y es posible que las versiones cambien con frecuencia.
  • Algunas características recientes de Python, como la sintaxis de parámetros de tipo de PEP 695 y la formalización de f-strings de PEP 701, aún no son compatibles.

En colecciones

Linters y formateadores de código

Temas

#python#code-formatter#linter#code-style#developer-tools#clang-format#formatter#google

Preguntas frecuentes

¿Qué es yapf?
Formateador de código Python que adapta los archivos fuente a un estilo configurable con el algoritmo de diseño de clang-format. YAPF formatea código fuente Python calculando la mejor disposición que se ajusta al estilo elegido, para que los desarrolladores dediquen menos tiempo a corregir manualmente la indentación, los espacios y los saltos de línea. Se basa en el algoritmo de reformateo de clang-format y puede ejecutarse desde la línea de comandos o usarse como biblioteca mediante las funciones FormatCode y FormatFile.
¿yapf es gratuito? ¿Qué licencia tiene?
yapf es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿yapf sigue mantenido?
Mantenimiento activo. El último commit de yapf fue el 30 oct 2026.
¿Para qué puedo usar yapf?
Aplicar un estilo de código uniforme en un equipo o repositorio de Python. Añadir una comprobación de formato a una canalización de CI mediante el modo de diferencias. Formatear solo las líneas modificadas por un parche o una edición mediante la integración con un editor. Automatizar la limpieza del estilo en scripts que generan o transforman código Python.
¿Cómo se instala yapf?
Instala YAPF desde PyPI: pip install yapf Ejecuta yapf en tus archivos Python con opciones como --diff o --in-place
¿Dónde consigo yapf?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/google/yapf

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

Proyectos relacionados