The ironic.objects.base Module

Ironic common internal object model

class ironic.objects.base.IronicObject(context, **kwargs)

Bases: object

Base class and object factory.

This forms the base of all objects that can be remoted or instantiated via RPC. Simply defining a class that inherits from this base class will make it remotely instantiatable. Objects should implement the necessary “get” classmethod routines as well as “save” object methods as appropriate.

as_dict()

get(key, value=<class ironic.objects.base.NotSpecifiedSentinel at 0x7f3738c1a9a8>)

For backwards-compatibility with dict-based objects.

NOTE(danms): May be removed in the future.

items()

iteritems()

For backwards-compatibility with dict-based objects.

NOTE(danms): May be removed in the future.

obj_attr_is_set(attrname)

Test object to see if attrname is present.

Returns True if the named attribute has a value set, or False if not. Raises AttributeError if attrname is not a valid attribute for this object.

classmethod obj_class_from_name(objname, objver)

Returns a class from the registry based on a name and version.

obj_clone()

Create a copy.

classmethod obj_from_primitive(primitive, context=None)

Simple base-case hydration.

This calls self._attr_from_primitive() for each item in fields.

obj_get_changes()

Returns a dict of changed fields and their new values.

obj_load_attr(attrname)

Load an additional attribute from the real object.

This should use self._conductor, and cache any data that might be useful for future load operations.

classmethod obj_name()

Get canonical object name.

This object name will be used over the wire for remote hydration.

obj_reset_changes(fields=None)

Reset the list of fields that have been changed.

Note that this is NOT “revert to previous values”

obj_to_primitive()

Simple base-case dehydration.

This calls self._attr_to_primitive() for each item in fields.

obj_what_changed()

Returns a set of fields that have been modified.

save(context)

Save the changed fields back to the store.

This is optional for subclasses, but is presented here in the base class for consistency among those that do.

update(updates)

For backwards-compatibility with dict-base objects.

NOTE(danms): May be removed in the future.

class ironic.objects.base.IronicObjectMetaclass(names, bases, dict_)

Bases: type

Metaclass that allows tracking of object classes.

class ironic.objects.base.IronicObjectSerializer

Bases: oslo_messaging.serializer.NoOpSerializer

A IronicObject-aware Serializer.

This implements the Oslo Serializer interface and provides the ability to serialize and deserialize IronicObject entities. Any service that needs to accept or return IronicObjects as arguments or result values should pass this to its RpcProxy and RpcDispatcher objects.

deserialize_entity(context, entity)

serialize_entity(context, entity)

class ironic.objects.base.NotSpecifiedSentinel

class ironic.objects.base.ObjectListBase

Bases: object

Mixin class for lists of objects.

This mixin class can be added as a base class for an object that is implementing a list of objects. It adds a single field of ‘objects’, which is the list store, and behaves like a list itself. It supports serialization of the list of objects automatically.

count(value)

List count of value occurrences.

index(value)

List index of value.

obj_make_compatible(primitive, target_version)

obj_what_changed()