Skip to main content

Python decorator for automatic initialization instance attributes

Project description

Tests Pypy Tests CPython Tests Pypy


Python decorator for automatic initialization instance attributes


import autoinit  # same as `from autoinit import autoinit`

class X:
    def __init__(self, a, b, c, d:int, e=99.99, f='some_default_value'):
	    print("__init__ do some another things")

x = X(42, 100, 500, None)
#  Output: "__init__ do some another things"

# Output: {'a': 42, 'b': 100, 'c': 500, 'd': None, 'e': 99.99, 'f': 'some_default_value'}


$ pip install autoinit


Tested in:

  • CPython: 2.7, 3.5-3.11
  • Pypy: 2.7, 3.5-3.9
  • Jython: 2.7

...but with a high probability will work with other implementations as well.


A lot of elementary assignments inside __init__ are a fairly frequent and rather dull case.

class FiveDimensionRecord:
    def __init__(self, x:int, y:int, z:int, u:int,
                 v:int, dt:typing.Optional[datetime]=None, description:str=''):
        self.x = x
        self.y = y
        self.z = z
        self.u = u
        self.v = v
        self.dt = dt or
        self.description = description

Dataclasses do not make it much more fun, mainly because you still cannot declare attributes in one line

class FiveDimensionRecord:
    x: int
    y: int
    z: int
    u: int
    v: int
    dt: 'typing.Any' = None
    description: str = ''

    def __post_init__(self):
        self.dt = self.dt or

With autoinit it looks much more compact and minimalistic

class FiveDimensionRecord:
    def __init__(self, x:int, y:int, z:int,
                 u:int, v:int, dt=None, description:str=''):
        self.dt = self.dt or


  • @autoinit(exclude='attr') or @autoinit(exclude=['attr1', 'attr2]'): skip specified attributes. Default: []

  • @autoinit(no_warn=True): do not throw warning if decorator applied to non-__init__ method. Default: False.

  • @autoinit(reverse=True): invert the order of actions - first call the wrapped method (which is usually __init__), and then do assignment. Default: False.

The decorator itself can be equally applied to both the __init__ method and the entire class.

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

autoinit-1.1.1.tar.gz (6.3 kB view hashes)

Uploaded Source

Built Distribution

autoinit-1.1.1-py2.py3-none-any.whl (5.5 kB view hashes)

Uploaded Python 2 Python 3

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