How do I profile a Python script?

Better Stack Team
Updated on February 17, 2023

By default, Python contains a profiler called cProfile. It not only gives the total running time, but also times each function separately, and tells you how many times each function was called, making it easy to determine where you should make optimizations.

You can call it from within your code:

 
import cProfile

cProfile.run('foo()')

Even more usefully, you can invoke the cProfile when running a script:

 
python -m cProfile myscript.py

With the output similar to this:

 
1007 function calls in 0.061 CPU seconds

Ordered by: standard name
ncalls  tottime  percall  cumtime  percall filename:lineno(function)
    1    0.000    0.000    0.061    0.061 <string>:1(<module>)
 1000    0.051    0.000    0.051    0.000 euler048.py:2(<lambda>)
    1    0.005    0.005    0.061    0.061 euler048.py:2(<module>)
    1    0.000    0.000    0.061    0.061 {execfile}
    1    0.002    0.002    0.053    0.053 {map}
    1    0.000    0.000    0.000    0.000 {method 'disable' of '_lsprof.Profiler objects}
    1    0.000    0.000    0.000    0.000 {range}
    1    0.003    0.003    0.003    0.003 {sum}

To learn more about cProfile, you can visit the official documentation.

Got an article suggestion? Let us know
Explore more
Python
How do I check if a list is empty in Python?
Questions
Getting the class name of an instance in Python?
Questions
What Does the “yield” Keyword Do in Python?
Questions
What is the meaning of single and double underscore before an object name in Python?
Questions
Licensed under CC-BY-NC-SA

This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.