Skip to main content

Basic OpenStack client library using asyncio

Project description

AsyncOpenStackClient

image0

Introduction

The AsyncOpenStackClient is a rest wrapper for the OpenStack API. It provides very raw functionality; however, it has a nice abstraction for authentication. For method specification, see the official OpenStack documentation: https://docs.openstack.org/queens/api/.

Installation

Use pip:

pip install AsyncOpenStackClient

Usage

As mentioned above, this is a “raw” library, so you must handle params and/or body and the response.

from asyncopenstackclient import NovaClient, GlanceClient, AuthPassword

# you can either pass credentials explicitly (as shown below)
# or use enviormental variables from OpenStack RC file
# https://docs.openstack.org/mitaka/cli-reference/common/cli_set_environment_variables_using_openstack_rc.html
auth = AuthPassword(
    auth_url='https://keystone:5999/v3'
    username='USER', password='PASS',
    project_name='my-project',
    user_domain_name='default',
    project_domain_name='foo.bar'
)
nova = NovaClient(session=auth)
glance = GlanceClient(session=auth)

# api url for each service will be taken from catalog,
# but you may pass `api_url` param to force custom url eg.
# nova = NovaClient(session=auth, api_url='http://my-local-nova:9876/v2/')

await nova.init_api()
await glance.init_api()


servers = await nova.api.servers.list(params={'name': 'testvm'})
vm = await nova.api.servers.get(id)


body = {
    "server": {
        "name": 'some_name',
        "flavorRef": 'flavor_id',
        "imageRef": 'image_id',
        "security_groups": [{'name': 'group1'}, {'name': 'group2'}]
        "user_data": base64.b64encode(userdata).decode('utf-8')
    }
}
response = await nova.api.servers.create(body=body)
print(response.body)

Available functions

License

Apache License 2.0

Changelog

0.5.1 (2018-04-29)

  • Bugfix: update README with metadata entry and envs notice

0.5.0 (2018-04-25)

  • Feature: partial support for server metadata usage

0.4.1 (2018-04-25)

  • Bugifx: invalid concat auth_url with urljoin

0.4.0 (2018-04-16)

  • Feature: use OS_ variables if present

0.3.0 (2018-04-13)

  • Feature: accept to pass api_url

  • Feature: determine api url if catalog provide incomplete one (eg. without version)

0.2.3 (2018-04-05)

  • Bugfix: do_not_await_sync_method

0.2.2 (2018-04-02)

  • Update simple-rest-client (fixed logging)

0.2.1 (2018-03-28)

  • fix tests, cov report, MANIFEST.in

0.1.1 (2018-03-02)

  • Update MANIFEST.in

0.1.0 (2018-02-15)

  • First approach to build async openstack client library for Python3

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

AsyncOpenStackClient-0.5.1.tar.gz (19.0 kB view details)

Uploaded Source

File details

Details for the file AsyncOpenStackClient-0.5.1.tar.gz.

File metadata

File hashes

Hashes for AsyncOpenStackClient-0.5.1.tar.gz
Algorithm Hash digest
SHA256 d63f84beffa66a6536910b6b718b1018f1877e18f3e1dae12628d3482ff51248
MD5 5a25e33425c078d7892d78646aca891d
BLAKE2b-256 ef0c27019e788c5f131d742d05082d6864111080140c534ea79d88c4bfcdd959

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page