f51162070c
There are several modules that end-users are expected to be using--connection, profile, exceptions, and utils--which could be made slightly more accessible by having them available in the top level `openstack` namespace. This change proposes importing `from openstack import <x>` in openstack.__init__.py so that end-users can do `import openstack` and then work from there. Nothing more than the typical end-user entry points are to be exposed from there, so if you need to get the server resource you still need to do `from openstack.compute.v2 import server`. Additionally, we should continue documenting and using in tests everything in the `from openstack import <x>` format ourselves as this is merely a convenience. Change-Id: I24a7ce3636b18287fcb2246fbdfa9f8b6767f323
OpenStack Python SDK
The python-openstacksdk is a collection of libraries for
building applications to work with OpenStack clouds. The project aims to
provide a consistent and complete set of interactions with OpenStack's
many services, along with complete documentation, examples, and
tools.
This SDK is under active development, and in the interests of providing a high-quality interface, the APIs provided in this release may differ from those provided in future release.
Usage
The following example simply connects to an OpenStack cloud and lists the containers in the Object Store service.:
from openstack import connection
conn = connection.Connection(auth_url="http://openstack:5000/v3",
project_name="big_project",
username="SDK_user",
password="Super5ecretPassw0rd")
for container in conn.object_store.containers():
print(container.name)Documentation
Documentation is available at http://developer.openstack.org/sdks/python/openstacksdk/
License
Apache 2.0