Skip to main content

Enforces usage of '__slots__' for python classes.

Project description

https://github.com/brunonicko/slotted/workflows/MyPy/badge.svg https://github.com/brunonicko/slotted/workflows/Lint/badge.svg https://github.com/brunonicko/slotted/workflows/Tests/badge.svg https://readthedocs.org/projects/slotted/badge/?version=stable https://img.shields.io/github/license/brunonicko/slotted?color=light-green https://static.pepy.tech/personalized-badge/slotted?period=total&units=international_system&left_color=grey&right_color=brightgreen&left_text=Downloads https://img.shields.io/pypi/pyversions/slotted?color=light-green&style=flat

Overview

Enforces usage of __slots__ for Python classes.

Motivation

Besides the performance benefits, using __slots__ also prevents the client code from setting attributes that were not initially defined for instances of classes, which usually happens by mistake especially in environments where static type checking is not being performed.

So forcing it upon a class and its subclasses might be a desirable thing to do for classes that are part of an API, for example.

Examples

When defining a Slotted class with no __slots__ declaration, it assumes it has empty slots, which is equivalent to declaring __slots__ = ().

>>> from slotted import Slotted

>>> class Foo(Slotted):
...     pass  # implicit declaration of __slots__ = ()
...
>>> foo = Foo()
>>> foo.bar = 1
Traceback (most recent call last):
AttributeError: 'Foo' object has no attribute 'bar'

Slotted classes can be mixed with regular classes as long as they and all of their bases implement __slots__.

>>> from slotted import Slotted

>>> class Bar(object):
...     __slots__ = ("bar",)
>>> class Foo(Bar, Slotted):
...     __slots__ = ("foo",)
...
>>> foo = Foo()

If any non-Slotted class anywhere in the chain does not implement __slots__, a TypeError exception is raised.

>>> from slotted import Slotted

>>> class Bar(object):
...     pass
>>> class Foo(Bar, Slotted):
...     __slots__ = ("foo",)
...
Traceback (most recent call last):
TypeError: base 'Bar' is not slotted

Slotted behavior can also be achieved by using the SlottedMeta metaclass.

>>> from six import with_metaclass
>>> from slotted import SlottedMeta

>>> class Foo(with_metaclass(SlottedMeta, object)):
...     pass  # implicit declaration of __slots__ = ()
...
>>> foo = Foo()
>>> foo.bar = 1
Traceback (most recent call last):
AttributeError: 'Foo' object has no attribute 'bar'

abc

slotted also provides generic versions of the collection.abc classes.

>>> from typing import TypeVar
>>> from slotted import SlottedMapping, SlottedSequence, SlottedSet
>>> KT = TypeVar("KT")
>>> VT = TypeVar("VT")
>>> class MyMapping(SlottedMapping[KT, VT]):
...     pass # implicit declaration of __slots__ = ()
...
>>> class MySequence(SlottedSequence[VT]):
...     pass # implicit declaration of __slots__ = ()
...
>>> class MySet(SlottedSet[VT]):
...     pass # implicit declaration of __slots__ = ()
...

For Python 2.7, slotted adds a SlottedCollection class, even though the original Collection is not available.

>>> from typing import TypeVar
>>> from slotted import SlottedCollection
>>> T = TypeVar("T")
>>> class MyCollection(SlottedCollection[T]):
...     pass # implicit declaration of __slots__ = ()
...

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

slotted-5.1.0.tar.gz (14.3 kB view details)

Uploaded Source

Built Distribution

slotted-5.1.0-py2.py3-none-any.whl (7.5 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file slotted-5.1.0.tar.gz.

File metadata

  • Download URL: slotted-5.1.0.tar.gz
  • Upload date:
  • Size: 14.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.2

File hashes

Hashes for slotted-5.1.0.tar.gz
Algorithm Hash digest
SHA256 817fddb559808f7e17a9b6fa6a86667a9477736797fd7bbe0040e995275aaec6
MD5 3e6a9ee41f8f3b8890c8b56a99307491
BLAKE2b-256 4f4d113f0478c1394e10fda371a375dccf83257370320c0b15d11908ef39bdb7

See more details on using hashes here.

File details

Details for the file slotted-5.1.0-py2.py3-none-any.whl.

File metadata

  • Download URL: slotted-5.1.0-py2.py3-none-any.whl
  • Upload date:
  • Size: 7.5 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.2

File hashes

Hashes for slotted-5.1.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 aa242d048c1d766a1f05e4d432f9c45847718f0e016134556935337757e70b37
MD5 53ccd2cb028e8e4daf336a4238e864cd
BLAKE2b-256 77301fc27f2c85f2e0d7505312507547a539834ac1c24c02480f3e1b97c34be5

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