pyutils/line_profiler

O que é?

Recursos principais

• 01Exibe o número de execuções, o tempo e a porcentagem de cada linha de uma função decorada.
• 02Permite ativar o profiling com o decorator @profile e a variável de ambiente LINE_PROFILE.
• 03Inclui o utilitário de linha de comando kernprof.
• 04Pode ser instalado pelo PyPI com pip e oferece wheels para plataformas comuns.
• 05Integração opcional com IPython via extra ipython.

Casos de uso

• Descobrir quais linhas dentro de uma função Python lenta consomem a maior parte do tempo de execução.
• Fazer profiling de scripts de processamento de dados ou numéricos antes de otimizá-los.
• Verificar o efeito de uma alteração no código em linhas específicas de uma função crítica.

Início rápido

1. 1

   Instale line_profiler com pip

   pip install line_profiler
2. 2

   Importe profile e decore a função que deseja perfilar

3. 3

   Defina LINE_PROFILE=1 e execute o script normalmente

Antes de usar

• !Requer Python 3.10 ou posterior; versões mais antigas do Python precisam de releases mais antigas.
• !A instalação a partir do código-fonte pode exigir um compilador C, e checkouts do git também precisam do Cython.

Tópicos

Perguntas frequentes

O que é line_profiler?

Profiler linha a linha para Python que mostra quanto tempo cada linha do código-fonte de uma função decorada leva para executar. line_profiler mede o tempo de execução linha a linha dentro de funções Python. Ele é útil quando o profiling no nível de função já apontou uma função lenta e você precisa descobrir quais linhas específicas consomem esse tempo. As funções são marcadas com o decorator @profile e, quando o script termina, ele exibe um resumo por linha com o número de execuções, o tempo e a porcentagem do tempo total.

line_profiler é gratuito? Qual é a licença?

line_profiler é open source sob a licença Other. Confira os termos da licença antes de usá-lo em produtos comerciais.

line_profiler ainda é mantido?

Manutenção ativa. O último commit de line_profiler foi em 18 de out. de 2026.

Para que posso usar line_profiler?

Descobrir quais linhas dentro de uma função Python lenta consomem a maior parte do tempo de execução. Fazer profiling de scripts de processamento de dados ou numéricos antes de otimizá-los. Verificar o efeito de uma alteração no código em linhas específicas de uma função crítica.

Como instalar line_profiler?

Instale line_profiler com pip: pip install line_profiler Importe profile e decore a função que deseja perfilar Defina LINE_PROFILE=1 e execute o script normalmente

Onde consigo line_profiler?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/pyutils/line_profiler