attr_ module¶

Utilities for working with class/instance attributes.

deep_getattr function¶

deep_getattr(
    obj,
    attr_chain,
    getattr_func=<function default_getattr_func>,
    call_last_attr=True
)

Retrieve attribute consecutively.

The attribute chain attr_chain can be:

• string -> get variable/property or method without arguments
• tuple of string -> call method without arguments
• tuple of string and tuple -> call method and pass positional arguments (unpacked)
• tuple of string, tuple, and dict -> call method and pass positional and keyword arguments (unpacked)
• iterable of any of the above

Use getattr_func to overwrite the default behavior of accessing an attribute (see default_getattr_func()).

default_getattr_func function¶

default_getattr_func(
    obj,
    attr,
    args=None,
    kwargs=None,
    call_attr=True
)

Default getattr_func.

get_dict_attr function¶

get_dict_attr(
    obj,
    attr
)

Get attribute without invoking the attribute lookup machinery.

AttrResolver class¶

AttrResolver()

Class that implements resolution of self and its attributes.

Resolution is getattr that works for self, properties, and methods. It also utilizes built-in caching.

Subclasses

• Wrapping

deep_getattr method¶

AttrResolver.deep_getattr(
    *args,
    **kwargs
)

See deep_getattr().

post_resolve_attr method¶

AttrResolver.post_resolve_attr(
    attr,
    out,
    final_kwargs=None
)

Post-process an object after resolution.

Should return an object.

pre_resolve_attr method¶

AttrResolver.pre_resolve_attr(
    attr,
    final_kwargs=None
)

Pre-process an attribute before resolution.

Should return an attribute.

resolve_attr method¶

AttrResolver.resolve_attr(
    attr,
    args=None,
    cond_kwargs=None,
    kwargs=None,
    custom_arg_names=None,
    cache_dct=None,
    use_caching=True,
    passed_kwargs_out=None
)

Resolve an attribute using keyword arguments and built-in caching.

• If attr is a property, returns its value.
• If attr is a method, passes *args, **kwargs, and **cond_kwargs with keys found in the signature.
• If attr is a property and there is a get_{arg} method, calls the get_{arg} method.

Won't cache if use_caching is False or any passed argument is in custom_arg_names.

Use passed_kwargs_out to get keyword arguments that were passed.

resolve_self method¶

AttrResolver.resolve_self(
    cond_kwargs=None,
    custom_arg_names=None,
    impacts_caching=True,
    silence_warnings=False
)

Resolve self.

self_aliases property¶

Names to associate with this object.