Vuelve a formatear Python al estilo de Black y mira exactamente cuántas líneas han cambiado.
Esto ejecuta Black, el formateador en el que ya coinciden la mayoría de los proyectos Python, sobre lo que pegues, con la longitud de línea y el manejo de comillas que elijas. Si el archivo no se puede analizar, dice en qué línea, y si ya está formateado también lo dice, en lugar de simular que hizo algo.
Formatear Python no requiere ejecutarlo. El código se analiza en un árbol de sintaxis y se reescribe a partir de ese árbol, enteramente en memoria - nunca se escribe en un archivo, nunca se importa y nunca se ejecuta. Un formateador que ejecutara lo que pegaste sería una shell remota con un cuadro de texto.
Black es una transformación que preserva el AST: el código que sale es el mismo programa que el que entró. Esa propiedad es la razón por la que se puede confiar en un formateador, y por eso ningún modelo de lenguaje interviene en ninguna parte de esta herramienta. Un modelo al que se le pida ordenar código ocasionalmente reescribirá una línea mientras está en ello, y un cambio silencioso a un código que funciona es el único fallo que un formateador no puede permitirse.
La misma pregunta que hace el CI: ¿cambiaría este archivo? El modo de verificación devuelve tu código original intacto e informa si Black lo habría reformateado, y en cuántas líneas. Es la forma rápida de averiguar por qué falla un pipeline en un archivo que no puedes reproducir localmente.
Una coma tras el último elemento indica a Black que mantenga una llamada o colección con un elemento por línea: result = compute(alpha, beta,) vuelve como cuatro líneas, con alpha, y beta, cada uno en su propia línea. Marca Ignorar coma final mágica y la misma entrada queda como result = compute(alpha, beta) siempre que quepa en la longitud de línea. Para proteger un bloque alineado a mano, como una matriz, pon # fmt: off en la línea anterior y # fmt: on debajo, y Black deja todo lo de en medio tal como lo escribiste; # fmt: skip al final de una línea protege solo esa línea. Son comentarios propios de Black, así que siguen funcionando cuando el CI de tu proyecto ejecuta Black.
Se envía al servidor, se formatea en memoria y se devuelve en la misma respuesta. Nada se escribe en disco, se cachea ni se registra, y el registro de uso solo guarda recuentos - tamaño, opciones, cuántas líneas cambiaron - nunca el código.
No. Black cambia la presentación, no el comportamiento, pero hace algo más que mover espacios. Quita paréntesis redundantes (x = (1) pasa a x = 1), pone en minúscula los prefijos y exponentes de los números (0XABCDEF pasa a 0xABCDEF, 1E5 a 1e5), añade una coma final cuando reparte una llamada en varias líneas, reduce las series de líneas en blanco y recorta los espacios dentro de un docstring (""" Doc. """ pasa a """Doc."""). Este último cambio altera el texto de __doc__, lo que solo importa si tu código lee sus propios docstrings.
Porque ya estaba formateado con la longitud de línea que elegiste. La herramienta dice "ya formateado" en lugar de devolver silenciosamente una copia.
No. Ordenar imports es tarea de isort, no de Black, y ambos discrepan con suficiente frecuencia como para que hacerlo aquí te sorprendiera.
Ningún formateador puede - un archivo que no se puede analizar no tiene estructura que reescribir. Obtienes la línea, la columna y el código alrededor para que puedas corregirlo e intentarlo de nuevo.
Black es compatible con PEP 8 con una desviación conocida: su longitud de línea predeterminada es 88 en lugar de 79. Elige 79 en el selector de longitud de línea si necesitas la cifra más estricta.
Hasta 400.000 caracteres por ejecución. El formateo se detiene a los 10 segundos, algo que solo alcanzan archivos muy grandes o muy repetitivos, y cada dirección IP puede hacer 30 formateos cada 10 minutos.
Esta página usa Black, y su versión aparece en la cabecera de la página en pantallas anchas. Black lee la configuración del proyecto de pyproject.toml, en la sección [tool.black], con los nombres largos de las opciones: line-length = 88 para la opción "Longitud de línea" que elegiste, skip-string-normalization = true si marcaste "Mantener mis comillas", skip-magic-trailing-comma = true para "Ignorar coma final mágica" y target-version = ["py311"] para un valor fijo en "Objetivo". Los plugins del editor y el hook de pre-commit leen el mismo archivo. Ejecuta black . para formatear y black --check --diff . en CI: no cambia nada y sale con código 1 cuando un archivo se reformatearía. Fija la misma versión de Black que esta página, porque la primera versión de cada año natural puede cambiar el estilo estable.
Casi siempre, pero no byte a byte. El formateador de Ruff está diseñado como sustituto directo de Black, y su documentación indica que en grandes proyectos ya formateados con Black, como Django y Zulip, más del 99,9 % de las líneas salen idénticas. Difiere más en código que nunca pasó por Black, sobre todo en los comentarios al final de línea, y su documentación enumera sus desviaciones intencionadas. Su longitud de línea por defecto también es 88, configurable con line-length en [tool.ruff]; quote-style = "preserve" en [tool.ruff.format] equivale a "Mantener mis comillas" y skip-magic-trailing-comma = true equivale a "Ignorar coma final mágica". Si tu CI ejecuta ruff format --check, prueba el archivo con Ruff, no con esta página.