Skip to main content

Documentation build status GitHub status

The refcycle package provides support for creating, analysing, and visualising graphs of Python objects and the references between them. It’s intended to aid in debugging reference-related problems, for example:

  • Figuring out why an object is still alive after it should have been deleted.

  • Detecting reference cycles that may be preventing objects from being collected by the regular reference-count-based garbage collection.

  • Finding out why garbage collection is putting objects into gc.garbage.

Features

Prerequisites

  • Requires Python 3.7 or later.

  • The export_image method for exporting a graph in image form requires Graphviz to be installed.

  • Refcycle is CPython only.

Documentation

Up-to-date documentation can be found on “Read the Docs”, at http://refcycle.readthedocs.org/en/latest/index.html.

Installing refcycle

The latest release of refcycle is available from the Python Package Index, at https://pypi.python.org/pypi/refcycle. On most systems, it can be installed in the usual way using pip:

python -m pip install refcycle

The currently-in-development version can be obtained from the project’s GitHub homepage: https://github.com/mdickinson/refcycle.

License

The refcycle package is copyright (c) 2013-2023 Mark Dickinson.

Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Metadata

Release files for refcycle 0.3.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for refcycle 0.3.1
File Size Uploaded
refcycle-0.3.1.tar.gz 121.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for refcycle 0.3.1
File Interpreter ABI Platform
refcycle-0.3.1-py3-none-any.whl Python 3 none any Details

Total release size: 165.7 kB

Release files / refcycle-0.3.1.tar.gz

Download URL refcycle-0.3.1.tar.gz
Size 121.8 kB
Tags Source
SHA-256 checksum
How to use checksums
3c601aade586dcdbbc8b1283385d3f9dba80fe90187efc9f7c85e7c1961efd3d
BLAKE2b-256 checksum
How to use checksums
9df9e5adbb15b4e6e955b0aabeda392d63f6e9637adfecccb57476303fbc6b93
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.12.0

Release files / refcycle-0.3.1-py3-none-any.whl

Download URL refcycle-0.3.1-py3-none-any.whl
Size 44.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1c838c0b66a80ba0fe24efcb7576e24d428f8953b671a30f15f27346336e7116
BLAKE2b-256 checksum
How to use checksums
d782ee9c9727f163eb45688b8116babf5410af8ebd7110b95c24e2de4d8ace8d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.12.0

Release history Release notifications | RSS feed

This release

0.3.1 This release

2 release files

0.3.0

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.2

1 release file

0.1.1

1 release file

0.1.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page