Repolode
Enviar
gruns

gruns/icecream

Um auxiliar de depuração para Python em que ic() substitui print() e exibe nomes de variáveis, expressões e seus valores em uma saída formatada e com realce de sintaxe.

Ver no GitHub
Estrelas
10,109
Forks
235
Issues abertas
77
Último commit
anteontem

O que é?

IceCream é uma biblioteca de depuração para Python baseada em uma função chamada ic(), uma alternativa mais prática a print(). Quando recebe uma variável ou expressão, ic() exibe o texto do código-fonte junto com o valor calculado, para que você veja o que foi passado sem precisar escrever o rótulo manualmente. Estruturas de dados são formatadas de forma legível e a saída recebe realce de sintaxe.

Quando chamada sem argumentos, ic() informa o nome do arquivo, o número da linha e a função chamadora, o que é útil para rastrear quais ramificações do código são executadas e em que ordem. ic() também retorna seus argumentos, então pode ser usada em expressões existentes sem alterar o comportamento; ic.disable() e ic.enable() ativam ou desativam toda a saída de uma só vez.

É possível personalizar o formato da saída, o prefixo, o destino e a serialização dos valores por meio de configureOutput, inclusive registrando formatadores personalizados para tipos específicos. A biblioteca oferece suporte a Python 3 e PyPy3, e ic.format() retorna a saída como uma string para uso com logging.

Recursos principais

  • 01Exibe a expressão do código-fonte e seu valor para variáveis e expressões.
  • 02Formata estruturas de dados de forma legível e com realce de sintaxe.
  • 03Sem argumentos, informa o arquivo, o número da linha e a função chamadora.
  • 04Retorna seus argumentos, permitindo inseri-la em código existente.
  • 05Pode ser desativada e reativada globalmente, além de instalada em builtins.
  • 06O prefixo, o destino e a formatação dos valores da saída são configuráveis.

Casos de uso

  • Inspecionar rapidamente os valores de variáveis ao depurar um script Python.
  • Rastrear quais ramificações ou funções são executadas e em que ordem.
  • Direcionar a saída de depuração para um logger usando ic.format().
  • Manter chamadas de depuração no código e silenciá-las em produção com disable().

Início rápido

  1. 1

    Instale o IceCream com pip

    pip install icecream
  2. 2

    Importe ic e chame-o com uma variável ou expressão para imprimir o nome e o valor dela

Tópicos

#python#debugging#print-debugging#logging#developer-tools#debug#debugging-tool#inspects#library#print

Perguntas frequentes

O que é icecream?
Um auxiliar de depuração para Python em que ic() substitui print() e exibe nomes de variáveis, expressões e seus valores em uma saída formatada e com realce de sintaxe. IceCream é uma biblioteca de depuração para Python baseada em uma função chamada ic(), uma alternativa mais prática a print(). Quando recebe uma variável ou expressão, ic() exibe o texto do código-fonte junto com o valor calculado, para que você veja o que foi passado sem precisar escrever o rótulo manualmente. Estruturas de dados são formatadas de forma legível e a saída recebe realce de sintaxe.
icecream é gratuito? Qual é a licença?
icecream é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
icecream ainda é mantido?
Manutenção ativa. O último commit de icecream foi em 19 de out. de 2026.
Para que posso usar icecream?
Inspecionar rapidamente os valores de variáveis ao depurar um script Python. Rastrear quais ramificações ou funções são executadas e em que ordem. Direcionar a saída de depuração para um logger usando ic.format(). Manter chamadas de depuração no código e silenciá-las em produção com disable().
Como instalar icecream?
Instale o IceCream com pip: pip install icecream Importe ic e chame-o com uma variável ou expressão para imprimir o nome e o valor dela
Onde consigo icecream?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/gruns/icecream

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados