Refcycle: Visualisation and Analysis of Python Object References¶
Release v0.3.1.
The refcycle package provides tools for analysing and visualising references
between Python objects, and for finding reference cycles and strongly connected
components of the object graph. It provides an
ObjectGraph type for representing a collection
of Python objects and references between them. For visualisation, it relies on
Graphviz.
If you have Graphviz installed, and the dot executable is in
your path, then the following code:
>>> import refcycle
>>> a = [["hello", "world"], 37]
>>> graph = refcycle.objects_reachable_from(a)
>>> graph
<refcycle.object_graph.ObjectGraph object of size 5 at 0x10191e2d0>
>>> graph.export_image('example.svg')
will produce this image:
Features¶
Computation of strongly connected components.
Snapshots of all currently tracked objects.
Representation of garbage as a graph.
Annotation of references and objects.
Export and import from JSON for offline analysis.
Use of Graphviz (if installed) for conversion to images.
Installing refcycle¶
The latest release of refcycle can be installed from PyPI in the usual way:
$ python -m pip install refcycle
The refcycle package requires Python version 3.7 or later.