A Python client for the Digital Ocean API
Project description
DOP is a MIT licensed Python wrapper for Digital Ocean’s API.
Features
Full support for all methods listed here
Installation
To install dop, simply:
$ pip install dop
Example
It is pretty easy to use:
from dop.client import Client client = Client('client_id', 'api_key') # Print regions. regions = client.regions() for region in regions: print(region.to_json()) # Print sizes. sizes = client.sizes() for size in sizes: print(size.to_json()) # Print public global images. images = client.images() for image in images: print(image.to_json()) # Print your private images. images = client.images(filter='my_images') for image in images: print(image.to_json()) # Create a droplet conf = { 'name': 'test', 'size': {'size_slug': '512MB'}, 'image': {'image_slug': 'ubuntu-13-04-x64'}, 'region': {'region_slug': 'nyc1'}, } droplet = client.create_droplet(**conf)
To create a droplet, you can use the data fetched from regions, sizes and images methods to fill the dictionary properly.
How to initialise with client_id and api_key stored in creds file
Easy:
from dop.client import Client client = Client.fromCredsFile('/home/user/.do.creds')
Contribute
Pull requests and improvements are welcome.
- Version 1.6.b5
Fix some wrong variable names thanks to wummel (http://github.com/wummel)
- Version 1.6.b4
Fixed droplet creation bug
Improved docs
- Version 1.6.b3
Fixed http methods for droplets
Change edit_domain_record method name
Ability to install with easy_install without error (thanks to Adam PAPAI)
- Version 1.6.b1
Updated code to support full api
Improved comments for methods
Some refactor
- Version 0.1.6
Python 3 compatibility thanks to Sambodson (https://github.com/samdobson)
- Version 0.1.5
Updated API
- Version 0.1.4
Added virtio parameter to create_droplet method
Minor fixes in all_ssh_keys method
Readme region example now uses to_json() method
- Version 0.1.3
Added ssh_keys support to Droplet object (thanks to Derek: http://github.com/covertgeek)
- Version 0.1.2
Added ip_address to Droplet object (thanks to Derek: http://github.com/covertgeek)
- Version 0.1.1
Added support for requests 1.x (thanks to Luke: http://github.com/clone1018)
- Version 0.1.0
Initial release
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.