djblets.webapi.resources.registry¶

Resource registration and lookup.

class ResourcesRegistry¶

Bases: object

Manages a registry of instances of API resources.

This handles dynamically loading API resource instances upon request, and registering those resources with models.

When accessing a resource through this class for the first time, it will be imported from the proper file and cached. Subsequent requests will be returned from the cache.

While an optional class, consumers are encouraged to create a subclass of this that they use for all resource instance references and for registering model to resource mappings.

resource_search_path = None¶

A list of Python module paths to search for module instances.

When looking up a module, the class will attempt to load a “<resource_name>_resource” module from that path, with a “<resource_name>” instance from the module.

__init__()¶

__getattr__(name)¶

Return a resource instance as an attribute.

If the resource hasn’t yet been loaded into cache, it will be imported, fetched from the module, and cached. Subsequent attribute fetches for this resource will be returned from the cache.

Parameters:

name (unicode) – The name of the resource to look up.

Returns:

The resource instance matching the name.

Return type:

djblets.webapi.resources.base.WebAPIResource

register_resources()¶

Register model to resource mappings.

Subclasses must override this to do any registration they may need.

register_resource_for_model(model, resource)¶

Register a resource as the official location for a model.

Parameters:

• model (djagno.db.models.Model) – The model associated with the resource.

• resource (djblets.webapi.resources.base.WebAPIResource or callable) – Either a WebAPIResource, or a function that takes an instance of model and returns a WebAPIResource.

unregister_resource_for_model(model)¶

Remove the official location for a model.

Parameters:

model (django.db.models.Model) – The model associated with the resource to remove.

get_resource_for_object(obj)¶

Return the resource for an object.

Parameters:

obj (object) – The object whose model has a resource associated.

Returns:

The resource associated with the object, or None if not found.

Return type:

djblets.webapi.resources.base.WebAPIResource

get_resource_from_name(name)¶

Return the resource of the specified name.

Parameters:

name (unicode) – The name of the resource.

Returns:

The resource instance, or None if not found.

Return type:

djblets.webapi.resources.base.WebAPIResource

get_resource_from_class(klass)¶

Return the resource with the specified resource class.

Parameters:

klass (type) – The WebAPIResource subclass.

Returns:

The resource instance, or None if not found.

Return type:

djblets.webapi.resources.base.WebAPIResource

unregister_resource(resource)¶

Unregister a resource from the caches.

Parameters:

resource (djblets.webapi.resources.base.WebAPIResource) – The resource instance to unregister.