shade/doc/source/usage.rst
David Shrewsbury ab8a196907 Clarify Munch object usage in documentation
We have pretty much settled on sticking with Munch objects for the
1.x series of shade releases. Change the documentation to note this.

Change-Id: I8b2838c3a5a40b0c74e31081bfb1ed4b0d39280f
2016-02-12 03:44:05 +00:00

902 B

Usage

To use shade in a project:

import shade

Note

API methods that return a description of an OpenStack resource (e.g., server instance, image, volume, etc.) do so using a dictionary of values (e.g., server['id'], image['name']). This is the standard, and recommended, way to access these resource values.

For backward compatibility, resource values can be accessed using object attribute access (e.g., server.id, image.name). Shade uses the Munch library to provide this behavior. This is NOT the recommended way to access resource values. We keep this behavior for developer convenience in the 1.x series of shade releases. This will likely not be the case in future, major releases of shade.

shade.OpenStackCloud

shade.OperatorCloud