Skip to main content

A development tool to measure, monitor and analyze the memory behavior of Python objects.

Project description

README for pympler

Pympler is a development tool to measure, monitor and analyze the memory behavior of Python objects in a running Python application.

By pympling a Python application, detailed insight in the size and the lifetime of Python objects can be obtained. Undesirable or unexpected runtime behavior like memory bloat and other "pymples" can easily be identified.

Pympler integrates three previously separate projects into a single, comprehensive profiling tool. Asizeof provides basic size information for one or several Python objects, muppy is used for on-line monitoring of a Python application and the class tracker provides off-line analysis of the lifetime of selected Python objects. A web profiling frontend exposes process statistics, garbage visualisation and class tracker statistics.

Pympler is written entirely in Python, with no dependencies to external libraries. It has been tested with Python 3.6, 3.7, 3.8, 3.9, 3.10 on Linux, Windows and MacOS X.

Installation from PyPI

To install the latest version of Pympler from the Python package index run:

pip install Pympler

Installation from source

Before installing Pympler, try it with your Python version:

python setup.py try

If any errors are reported, check whether your Python version is supported. Pympler is written entirely in Python, with no dependencies other than standard Python modules and libraries. Pympler works with Python 3.6, 3.7, 3.8, 3.9 and 3.10.

For a system-wide installation from source run:

pip install .

Test the installed Pympler package:

python setup.py test

Usage

The usage of pympler is described in the documentation. It is available either in this distribution at doc/index.html or you can read it online.

Contributing

You can post wishes, bug reports or patches at our issue tracker or write an email to pympler-dev@googlegroups.com.

Latest Version License Coverage Status

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Pympler-1.0.1.tar.gz (677.0 kB view hashes)

Uploaded source

Built Distribution

Pympler-1.0.1-py3-none-any.whl (164.8 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page