Repolode
gruns

gruns/icecream

Una herramienta de depuración para Python en la que ic() reemplaza a print() y muestra los nombres de variables, las expresiones y sus valores con formato legible y resaltado de sintaxis.

Estrellas
10,109
Forks
235
Issues abiertos
77
Último commit
anteayer

¿Qué es?

IceCream es una biblioteca de depuración para Python basada en una función llamada ic(), una alternativa más práctica a print(). Al recibir una variable o expresión, ic() muestra el texto fuente junto al valor calculado, para que puedas ver qué se pasó sin tener que escribir la etiqueta manualmente. Las estructuras de datos se muestran con formato legible y resaltado de sintaxis.

Si se llama sin argumentos, ic() informa el nombre del archivo desde el que se llamó, el número de línea y la función que lo contiene. Esto resulta útil para rastrear qué ramas del código se ejecutan y en qué orden. ic() también devuelve sus argumentos, así que se puede incluir en expresiones existentes sin cambiar su comportamiento; además, ic.disable() e ic.enable() desactivan o activan toda la salida de una vez.

El formato de salida, el prefijo, el destino y la serialización de valores se pueden personalizar mediante configureOutput, que también permite registrar formateadores personalizados para tipos específicos. La biblioteca es compatible con Python 3 y PyPy3, e ic.format() devuelve la salida como una cadena para usarla con el registro de eventos.

Funciones clave

  • 01Muestra tanto la expresión fuente como su valor para variables y expresiones.
  • 02Muestra las estructuras de datos con formato legible y resaltado de sintaxis.
  • 03Sin argumentos, informa el archivo desde el que se llamó, el número de línea y la función que lo contiene.
  • 04Devuelve sus argumentos, por lo que se puede insertar en código existente.
  • 05Se puede desactivar y volver a activar globalmente, e instalar en builtins.
  • 06Se pueden configurar el prefijo de salida, el destino y el formato de los valores.

Casos de uso

  • Inspeccionar rápidamente los valores de variables al depurar un script de Python.
  • Rastrear qué ramas o funciones se ejecutan y en qué orden.
  • Enviar la salida de depuración a un logger mediante ic.format().
  • Dejar llamadas de depuración en el código y silenciarlas en producción con disable().

Inicio rápido

  1. 1

    Instala IceCream con pip

    pip install icecream
  2. 2

    Importa ic y llámalo con una variable o expresión para imprimir su nombre y valor

Temas

Preguntas frecuentes

¿Qué es icecream?
Una herramienta de depuración para Python en la que ic() reemplaza a print() y muestra los nombres de variables, las expresiones y sus valores con formato legible y resaltado de sintaxis. IceCream es una biblioteca de depuración para Python basada en una función llamada ic(), una alternativa más práctica a print(). Al recibir una variable o expresión, ic() muestra el texto fuente junto al valor calculado, para que puedas ver qué se pasó sin tener que escribir la etiqueta manualmente. Las estructuras de datos se muestran con formato legible y resaltado de sintaxis.
¿icecream es gratuito? ¿Qué licencia tiene?
icecream es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿icecream sigue mantenido?
Mantenimiento activo. El último commit de icecream fue el 19 oct 2026.
¿Para qué puedo usar icecream?
Inspeccionar rápidamente los valores de variables al depurar un script de Python. Rastrear qué ramas o funciones se ejecutan y en qué orden. Enviar la salida de depuración a un logger mediante ic.format(). Dejar llamadas de depuración en el código y silenciarlas en producción con disable().
¿Cómo se instala icecream?
Instala IceCream con pip: pip install icecream Importa ic y llámalo con una variable o expresión para imprimir su nombre y valor
¿Dónde consigo icecream?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/gruns/icecream

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

Proyectos relacionados