Internal Development Interface

Package accretive.__

Common constants, imports, and utilities.

Module accretive.__.imports

Common imports used throughout the package.

Module accretive.__.exceptions

Family of exceptions for package internals.

exception accretive.__.exceptions.EntryImmutability(indicator)

Bases: Omnierror, TypeError

Attempt to update or remove immutable dictionary entry.

exception accretive.__.exceptions.Omnierror(*posargs, **nomargs)

Bases: Omniexception, Exception

Base for error exceptions raised internally.

exception accretive.__.exceptions.Omniexception(*posargs, **nomargs)

Bases: Object, BaseException

Base for all exceptions raised internally.

exception accretive.__.exceptions.OperationInvalidity(name)

Bases: Omnierror, RuntimeError, TypeError

Attempt to perform invalid operation.

Module accretive.__.dictionaries

Internal dictionary.

class accretive.__.dictionaries.AccretiveDictionary(*iterables, **entries)

Bases: dict[_H, _V], Object, Generic[_H, _V]

Accretive subclass of dict.

Can be used as an instance dictionary.

Prevents attempts to mutate dictionary via inherited interface.

clear()

Raises exception. Cannot clear immutable entries.

Parameters:

self

Return type:

typing_extensions.Never

copy()

Provides fresh copy of dictionary.

Parameters:

self

Return type:

typing_extensions.Self

pop(key, default=absence.absent)

Raises exception. Cannot pop immutable entry.

Parameters:
  • self

  • key (accretive.__.dictionaries._H)

  • default (accretive.__.dictionaries._V | absence.objects.AbsentSingleton)

Return type:

typing_extensions.Never

popitem()

Raises exception. Cannot pop immutable entry.

Parameters:

self

Return type:

typing_extensions.Never

update(*iterables, **entries)

Adds new entries as a batch.

Parameters:
  • self

  • iterables (collections.abc.Mapping[ accretive.__.dictionaries._H, accretive.__.dictionaries._V ] | collections.abc.Iterable[ tuple[ accretive.__.dictionaries._H, accretive.__.dictionaries._V ] ]) – Zero or more iterables from which to initialize dictionary data. Each iterable must be dictionary or sequence of key-value pairs. Duplicate keys will result in an error.

  • entries (accretive.__.dictionaries._V) – Zero or more keyword arguments from which to initialize dictionary data.

Module accretive.__.nomina

Common names and type aliases.

type accretive.__.nomina.ComparisonResult = bool | builtins.NotImplementedType
type accretive.__.nomina.NominativeArguments = collections.abc.Mapping[str, typing_extensions.Any]
type accretive.__.nomina.PositionalArguments = collections.abc.Sequence[typing_extensions.Any]
type accretive.__.nomina.ClassDecorator = collections.abc.Callable[[type[accretive.__.nomina.U]], type[accretive.__.nomina.U]]
type accretive.__.nomina.ClassDecorators = collections.abc.Sequence[collections.abc.Callable[[type[accretive.__.nomina.U]], type[accretive.__.nomina.U]]]
type accretive.__.nomina.ClassDecoratorFactory = collections.abc.Callable[..., collections.abc.Callable[[type[accretive.__.nomina.U]], type[accretive.__.nomina.U]]]
type accretive.__.nomina.ModuleReclassifier = collections.abc.Callable[[collections.abc.Mapping[str, typing_extensions.Any]], None]
type accretive.__.nomina.DictionaryNominativeArgument = accretive.__.nomina.V
type accretive.__.nomina.DictionaryPositionalArgument = collections.abc.Mapping[accretive.__.nomina.H, accretive.__.nomina.V] | collections.abc.Iterable[tuple[accretive.__.nomina.H, accretive.__.nomina.V]]
type accretive.__.nomina.DictionaryProducer = collections.abc.Callable[[], accretive.__.nomina.V]
type accretive.__.nomina.DictionaryValidator = collections.abc.Callable[[accretive.__.nomina.H, accretive.__.nomina.V], bool]
accretive.__.nomina.calculate_attrname(level, core)
Parameters:
Return type:

str

accretive.__.nomina.is_public_identifier(name)

Is Python identifier public?

Parameters:

name (str)

Return type:

bool