Las f-strings y el minilenguaje de especificación de formato: los detalles que muerden

Qué es

Una f-string evalúa cada expresión dentro de las llaves en tiempo de ejecución y le da formato mediante el mismo mecanismo que str.format: una conversión opcional (!r, !s, !a) seguida de una especificación de formato tras dos puntos, [[fill]align][sign][z][#][0][width][grouping][.precision][type]. El especificador de depuración = (f"{x=}", Python 3.8) imprime el texto de la expresión y su repr, preservando cualquier espacio en blanco alrededor del signo. Desde la versión 3.12 (PEP 701), la parte de la expresión puede reutilizar la comilla envolvente, contener barras invertidas y comentarios, y extenderse por varias líneas. Una especificación puede a su vez contener campos de reemplazo, de modo que f"{name:>{width}}" toma el ancho de una variable.

Por qué importa

El formateo es el punto donde los números se convierten en texto en los registros, los informes y los archivos. Un error en la especificación produce una salida plausible pero incorrecta, y el mismo código fuente puede ser un error de sintaxis en un intérprete más antiguo.

Cómo aplicarlo

• Dar formato explícito a los flotantes: .3f para decimales fijos, .3g para cifras significativas. La documentación indica que sin un tipo, un flotante se muestra como con g, salvo que la salida de punto fijo siempre conserva al menos un dígito después del punto y la precisión toma por defecto lo que representa el valor con fidelidad.
• Agrupar los miles con , o _ (f"{n:,}"); usar n solo con una configuración regional (locale) establecida deliberadamente, ya que la documentación señala que la configuración regional predeterminada no es la del sistema.
• Rellenar números con ceros con f"{n:05d}"; la documentación indica que un 0 inicial habilita el relleno con ceros consciente del signo para los tipos numéricos y que, desde la versión 3.10, ya no afecta a la alineación de cadenas.
• Mostrar proporciones con .1%, que multiplica por 100 y añade el signo de porcentaje.
• Usar !r para valores que puedan estar vacíos o contener espacios en blanco (f"got {value!r}"), de modo que las comillas queden visibles.
• Escribir las llaves literales como {{ y }}.
• En las llamadas de registro (logging), pasar los argumentos de forma perezosa (log.debug("x=%s", x)); un argumento de f-string se evalúa incluso cuando el nivel está desactivado.

Trampas

f"{s:.10}" trunca una cadena a diez caracteres: para las cadenas, la precisión es el tamaño máximo del campo, algo fácil de escribir por accidente cuando en realidad se quería un ancho. El redondeo no elimina el signo de un negativo pequeño: f"{-0.0001:.2f}" da -0.00; la opción z (3.11) fuerza el cero negativo a cero positivo después de redondear. El formateo no repara la coma flotante binaria: f"{2.675:.2f}" imprime 2.67 porque el valor almacenado queda justo por debajo de 2.675 (véase el artículo sobre coma flotante); un Decimal da formato a partir de sus dígitos exactos bajo el modo de redondeo del contexto decimal. f"{x = }" conserva los espacios en la salida. Las comillas anidadas del mismo tipo y las barras invertidas dentro de las llaves son errores en la versión 3.11 y anteriores, por lo que una biblioteca que admita esas versiones debe evitarlas.