The cf-python-client repo contains a Python client library for Cloud Foundry.
$ pip install cloudfoundry-clientTo build the library run :
$ python setup.py installTo run the client, enter the following command :
$ cloudfoundry-clientThis will explains you how the client works. At first execution, it will ask you information about the platform you want to reach (url, login and so on). Please note that your credentials won't be saved on your disk: only tokens will be kept for further use.
You may build the client and use it in your code
from cloudfoundry_client.client import CloudFoundryClient
target_endpoint = 'https://somewhere.org'
for organization in client.organizations:
print organization['metadata']['guid']Entities returned by client calls (organzation, space, app..) are navigable ie you can call the method associated with the xxx_url entity attribute (note that if the attribute's name ends with a list, it will be interpreted as a list of object. Other wise you will get a single entity).
for organization in client.organizations:
for space in organization.spaces(): # perform a GET on spaces_url attribute
organization_reloaded = space.organization() # perform a GET on organization_url attribute- Application object provides more methods such as
- instances
- stats
- start
- stop
So far the implemented managers that are available are:
service_plansservice_instancesservice_bindingsservice_brokersappsbuildpacksorganizationsspacesservicesroutes
Note that even if, while navigating, you reach an entity manager that does not exist, the get will be performed and you will get the expected entities. For example, event entity manager is not yet implemented but you can do
for app in client.apps:
for event in app.events():
handle_event_object()All managers provide the following methods:
list(**kwargs): return an iterator on entities, according to the given filtered parametersget_one(**kwargs): return the first matching entity according to the given parameters. Returns`Noneif none returnedget: perform a GET on the entity. If the entity cannot be find it will raise an exception due to http NOT FOUND response status__iter__: iteration on the manager itself. Alias for a no-filter list__getitem__: alias for thegetoperation_create: the create operation. Since it is a generic operation (only takes a dict object), this operation is protected_update: the update operation. Since it is a generic operation (only takes a the resource id and a dict object), this operation is protected_remove: the delete operation. This operation is maintained protected.
Please submit issue/pull request.