base

Common internal object model

class oslo_versionedobjects.base.ComparableVersionedObject

Mix-in to provide comparison methods

When objects are to be compared with each other (in tests for example), this mixin can be used.

class oslo_versionedobjects.base.ObjectListBase(*args, **kwargs)

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.

class oslo_versionedobjects.base.TimestampedObject

Mixin class for db backed objects with timestamp fields.

Sqlalchemy models that inherit from the oslo_db TimestampMixin will include these fields and the corresponding objects will benefit from this mixin.

class oslo_versionedobjects.base.VersionedObject(context=None, **kwargs)

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.

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)

Object field-by-field hydration.

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 load self.$attrname and cache any data that might be useful for future load operations.

obj_make_compatible(primitive, target_version)

Make an object representation compatible with a target version.

This is responsible for taking the primitive representation of an object and making it suitable for the given target_version. This may mean converting the format of object attributes, removing attributes that have been added since the target version, etc. In general:

  • If a new version of an object adds a field, this routine should remove it for older versions.

  • If a new version changed or restricted the format of a field, this should convert it back to something a client knowing only of the older version will tolerate.

  • If an object that this object depends on is bumped, then this object should also take a version bump. Then, this routine should backlevel the dependent object (by calling its obj_make_compatible()) if the requested version of this object is older than the version where the new dependent object was added.

Parameters:
  • primitive – The result of obj_to_primitive()

  • target_version – The version string requested by the recipient of the object

Raises:

oslo_versionedobjects.exception.UnsupportedObjectError if conversion is not possible for some reason

classmethod obj_name()

Return the object’s name

Return a canonical name for this object which will be used over the wire for remote hydration.

obj_reset_changes(fields=None, recursive=False)

Reset the list of fields that have been changed.

Parameters:
  • fields – List of fields to reset, or “all” if None.

  • recursive – Call obj_reset_changes(recursive=True) on any sub-objects within the list of fields being reset.

This is NOT “revert to previous values”.

Specifying fields on recursive resets will only be honored at the top level. Everything below the top will reset all.

obj_to_primitive(target_version=None, version_manifest=None)

Simple base-case dehydration.

This calls 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.

class oslo_versionedobjects.base.VersionedObjectDictCompat

Mix-in to provide dictionary key access compatibility

If an object needs to support attribute access using dictionary items instead of object attributes, inherit from this class. This should only be used as a temporary measure until all callers are converted to use modern attribute access.

class oslo_versionedobjects.base.VersionedObjectSerializer

A VersionedObject-aware Serializer.

This implements the Oslo Serializer interface and provides the ability to serialize and deserialize VersionedObject entities. Any service that needs to accept or return VersionedObjects as arguments or result values should pass this to its RPCClient and RPCServer objects.

OBJ_BASE_CLASS

alias of VersionedObject

deserialize_entity(context, entity)

Deserialize something from primitive form.

Parameters:
  • ctxt – Request context, in deserialized form

  • entity – Primitive to be deserialized

Returns:

Deserialized form of entity

serialize_entity(context, entity)

Serialize something to primitive form.

Parameters:
  • ctxt – Request context, in deserialized form

  • entity – Entity to be serialized

Returns:

Serialized form of entity

oslo_versionedobjects.base.obj_make_list(context, list_obj, item_cls, db_list, **extra_args)

Construct an object list from a list of primitives.

This calls item_cls._from_db_object() on each item of db_list, and adds the resulting object to list_obj.

Param:context:

Request context

Param:list_obj:

An ObjectListBase object

Param:item_cls:

The VersionedObject class of the objects within the list

Param:db_list:

The list of primitives to convert to objects

Param:extra_args:

Extra arguments to pass to _from_db_object()

Returns:

list_obj

oslo_versionedobjects.base.obj_tree_get_versions(objname, tree=None)

Construct a mapping of dependent object versions.

This method builds a list of dependent object versions given a top- level object with other objects as fields. It walks the tree recursively to determine all the objects (by symbolic name) that could be contained within the top-level object, and the maximum versions of each. The result is a dict like:

{'MyObject': '1.23', ... }
Parameters:
  • objname – The top-level object at which to start

  • tree – Used internally, pass None here.

Returns:

A dictionary of object names and versions

oslo_versionedobjects.base.remotable(fn)

Decorator for remotable object methods.

oslo_versionedobjects.base.remotable_classmethod(fn)

Decorator for remotable classmethods.