Python wrapper for Digital Ocean API V2.

Installation

pip install dosa

Usage

import dosa API_KEY = 'Your API Key' dosa.set_debug() # enables debug logs client = dosa.Client(api_key=API_KEY) # Droplets client.droplets.list() status, result = client.droplets.create(name='terminator', region='nyc2',\ size='512mb', image='ubuntu-14-04-x32', ssh_keys=[12345]) new_droplet_id = result['id'] # Droplet new_droplet = client.Droplet(new_droplet_id) print(new_droplet.info()) ## shortcuts new_droplet.status() new_droplet.ip_addresses() client.droplets.delete(new_droplet_id) # SSH Keys pub_key = open('~/.ssh/id_rsa.pub').read() client.keys.create(name='RSA key', public_key=pub_key) client.keys.list() # Images client.images.list() client.images.all() client.images.search('ubuntu', 'sgp1', show_op=True) # Domains client.domains.list() client.domains.all() client.domains.create(name='example.com', ip_address='1.2.3.4') client.domains.delete(id='example.com') ### Get specific domain domain = client.Domain(domain='example.com') domain.info() # Domain Records dr = client.DomainRecords(domain='example.com') dr.list() dr.create(type='A', name='example.com', data='162.10.66.0') ### Get specific domain record for a domain record = dr.Record(record_id='7976006') record.info() record.update(name='new.example.com') # Extras # $ ls keys/ # rsa_pub1.id rsa_pub2.key rsa_pub3.key keys_dir = 'keys' client.sync_ssh_keys(keys_dir)

Notes

Image search:

>>> client.images.search('ubuntu', region='sgp1', show_op=True)

Above code snippets searches for images containing ubuntu in description or slug. Since region is specified (sgp1), only images in sgp1 region would be considered. If no region is specified all regions are included.

Credits

Created while working on Scroll.in's project.