Skip to main content

Attributes without boilerplate.

Project description

CI status Coverage

attrs is an MIT-licensed Python package with class decorators that ease the chores of implementing the most common attribute-related object protocols:

>>> import attr
>>> @attr.s
... class C(object):
...     x = attr.ib(default=42)
...     y = attr.ib(default=attr.Factory(list))
>>> i = C(x=1, y=2)
>>> i
C(x=1, y=2)
>>> i == C(1, 2)
True
>>> i != C(2, 1)
True
>>> attr.asdict(i)
{'y': 2, 'x': 1}
>>> C()
C(x=42, y=[])
>>> C2 = attr.make_class("C2", ["a", "b"])
>>> C2("foo", "bar")
C2(a='foo', b='bar')

(If you don’t like the playful attr.s and attr.ib, you can also use their no-nonsense aliases attr.attributes and attr.attr).

You just specify the attributes to work with and attrs gives you:

  • a nice human-readable __repr__,

  • a complete set of comparison methods,

  • an initializer,

  • and much more

without writing dull boilerplate code again and again.

This gives you the power to use actual classes with actual types in your code instead of confusing tuples or confusingly behaving namedtuples.

So put down that type-less data structures and welcome some class into your life!

attrs’s documentation lives at Read the Docs, the code on GitHub. It’s rigorously tested on Python 2.6, 2.7, 3.3+, and PyPy.

Changelog

Versions are year-based with a strict backwards compatibility policy. The third digit is only for regressions.

15.2.0 (2015-12-08)

Changes:

  • Add a convert argument to attr.ib, which allows specifying a function to run on arguments. This allows for simple type conversions, e.g. with attr.ib(convert=int). [26]

  • Speed up object creation when attribute validators are used. [28]

15.1.0 (2015-08-20)

Changes:

  • Add attr.validators.optional that wraps other validators allowing attributes to be None. [16]

  • Fix multi-level inheritance. [24]

  • Fix __repr__ to work for non-redecorated subclasses. [20]

15.0.0 (2015-04-15)

Changes:

Initial release.

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

attrs-15.2.0.tar.gz (36.8 kB view details)

Uploaded Source

Built Distribution

attrs-15.2.0-py2.py3-none-any.whl (14.1 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file attrs-15.2.0.tar.gz.

File metadata

  • Download URL: attrs-15.2.0.tar.gz
  • Upload date:
  • Size: 36.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for attrs-15.2.0.tar.gz
Algorithm Hash digest
SHA256 9f895d2ecefa0be054e29375769f1d0ee88e93ce820088cf5c49390529bf7ee7
MD5 b3c460eb6482f6e557c0e4025475c007
BLAKE2b-256 8b76c57eefda827b981135ccacd4328fceaa3693f79d9da1e5d78fbe59ebd0c4

See more details on using hashes here.

File details

Details for the file attrs-15.2.0-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for attrs-15.2.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 8f5396e0ecf3e4945b81f1e2dd798b8c8f238c16ea8d8a9672d01a0358de9b0d
MD5 9c0855df4ea158b74574deeb379283f2
BLAKE2b-256 b4ac9685a9e9e0857b7229a47573fd7ec6a1b930b07d05cb93d25ad109e55013

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