Skip to main content

A WeakList class for storing objects using weak references in a list.

Project description

https://pypip.in/v/weakreflist/badge.png

A WeakList class for storing objects using weak references in a list.

Table of Contents

Installation

Install it from pypi:

pip install weakreflist

or from sources:

git clone git@github.com:apieum/weakreflist.git
cd weakreflist
python setup.py install

Usage

Same as a list except that when a weakref-able variable is deleted, it is removed from the list.

Example for CPython:

from weakreflist import WeakList

class A(object):
    """weakrefs don't function directly on object()"""
objectA = A()
my_list = WeakList([objectA])
assert len(my_list) == 1
del objectA
assert len(my_list) == 0 # objectA removed from list
Note:

Pypy (probably jython, cython…) have a different implementation of garbage collector and it is known that weakrefs doesn’t function the same way.

You need to explicitly call gc.collect() which has an impact on performance.

Example for other python implementations

from weakreflist import WeakList
import gc

class A(object):
    """weakrefs don't function directly on object()"""
objectA = A()
my_list = WeakList([objectA])
assert len(my_list) == 1
del objectA

assert len(my_list) == 1 # gc not done
gc.collect() # must be called
assert len(my_list) == 0

Development

Your feedback, code review, improvements or bugs, and help to document is appreciated. You can contact me by mail: apieum [at] gmail [dot] com

Test recommended requirements:

pip install -r dev-requirements.txt

Sometimes –spec-color doesn’t function. Uninstall nosespec and nosecolor then reinstall nosecolor and nosespec separatly in this order (nosecolor first).

Launch tests:

git clone git@github.com:apieum/weakreflist.git
cd weakreflist
nosetests --with-spec --spec-color ./weakreflist
# or with watch
# nosetests --with-spec --spec-color --with-watch ./weakreflist

Contributors

Thanks to BoonsNaibot to have contributed to:
  • extended slicing support

  • __reversed__, count, extend, insert methods.

https://secure.travis-ci.org/apieum/weakreflist.png?branch=master

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

weakreflist-0.4.tar.gz (7.5 kB view details)

Uploaded Source

File details

Details for the file weakreflist-0.4.tar.gz.

File metadata

  • Download URL: weakreflist-0.4.tar.gz
  • Upload date:
  • Size: 7.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for weakreflist-0.4.tar.gz
Algorithm Hash digest
SHA256 28bb41d87b8d4ae9ca9c388ef322c6f4473346d54985863d41ba4f29ba797a09
MD5 fb424b900f67e2ad2584c4af29c24498
BLAKE2b-256 221bd4716e0f52f026c8620a0c973a64907934068c41195cf18a9e123eae3066

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page