
Security News
New CVE Forecasting Tool Predicts 47,000 Disclosures in 2025
CVEForecast.org uses machine learning to project a record-breaking surge in vulnerability disclosures in 2025.
This package is an exceedingly simple wrapper around the builtin
namedtuple
from the collections
package.
It allows you to instantiate via a tuple
or via kwargs
. It
simplifies the case where you know ahead of time what the values of an
Immutable
should be and you just need to instantiate it once.
pip install immutable
namedtuple
The ``namedtuple`` is a Python ``builtin`` that allows you to
instantiate an object as follows:
.. code:: python
from collections import namedtuple
TupleFactory = namedtuple('ATuple', ['using', 'these', 'attrs'])
ATuple = TupleFactory('first', these='second', attrs='third')
ATuple # ATuple(using='first', these='second', attrs='third')
# dot-access attributes
ATuple.using # 'first'
Atuple.these # 'second'
ATuple.attrs # 'third'
# index-access attributes
ATuple[0] # 'first'
ATuple[1] # 'second'
ATuple[2] # 'third'
ATuple[-1] # 'third'
# the class name is as specified in creating the original factory
ATuple.__class__.__name__ # 'ATuple'
``ImmutableFactory``
Replicate namedtuple
functionality
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
The ImmutableFactory is just a thin wrapper that allows you to do this in one step:
.. code:: python
from immutable import ImmutableFactory
attributes = (('using', 'first'), ('these', 'second'), ('attrs', 'third'))
# don't worry about the extra kwargs for now :)
ATuple = ImmutableFactory.create(attributes, keys=False, values=False, items=False)
ATuple # Immutable(using='first', these='second', attrs='third')
# dot-access attributes
ATuple.using # 'first'
Atuple.these # 'second'
ATuple.attrs # 'third'
# index-access attributes
ATuple[0] # 'first'
ATuple[1] # 'second'
ATuple[2] # 'third'
ATuple[-1] # 'third'
# the class name is *always* `Immutable` now
ATuple.__class__.__name__ # 'Immutable'
Some extra bells and whistles (don't get too excited) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Most of the time, we don't care about the order. This allows us to instantiate in a much cleaner style:
.. code:: python
from immutable import ImmutableFactory
ATuple = ImmutableFactory.create(using='first', these='second', attrs='third',
keys=False, values=False, items=False)
# note that there's no predictable order here
ATuple # Immutable(these='second', using='first', attrs='third')
# dot-access attributes
ATuple.using # 'first'
Atuple.these # 'second'
ATuple.attrs # 'third'
# doesn't really make sense to index-access attributes now, so don't.
# the class name is *always* `Immutable` now
ATuple.__class__.__name__ # 'Immutable'
Additionally, it's helpful to have dict-like keys
, values
, and
items
. These
Notes
Note if you use a *mutable* as a value for an attribute of an
``Immutable`` object, you'll be able to change it. If this wasn't the
case, the ``ImmutableFactory`` would need to mutate your input data--not
nice.
.. code:: python
from immutable import ImmutableFactory
ATuple = ImmutableFactory.create(mutable=['a', 'list'])
ATuple.mutable # ['a', 'list']
ATuple.mutable.append('can change!')
ATuple.mutable # ['a', 'list', 'can change!']
FAQs
Simple immutable object factory
We found that immutable demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
CVEForecast.org uses machine learning to project a record-breaking surge in vulnerability disclosures in 2025.
Security News
Browserslist-rs now uses static data to reduce binary size by over 1MB, improving memory use and performance for Rust-based frontend tools.
Research
Security News
Eight new malicious Firefox extensions impersonate games, steal OAuth tokens, hijack sessions, and exploit browser permissions to spy on users.