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.
Source Distribution
File details
Details for the file dop-1.6.b6.tar.gz
.
File metadata
- Download URL: dop-1.6.b6.tar.gz
- Upload date:
- Size: 10.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | dbd3a8eb3d2849064a1e9117881528bdee28fd5c766d9d228c5c837e51b06c37 |
|
MD5 | 79f3117b4e08609b85f61fdfb54b01b1 |
|
BLAKE2b-256 | 99ae762eec0ef3c98a9766822ccf62e2a7d9f06ea1889a199aa303b8c28a7150 |