Crate digitalocean [] [src]

A crate for interacting with the Digital Ocean API.

While browsing this documentation please feel encouraged to reference the DigitalOcean docs.

A Basic Example

use digitalocean::prelude::*;
use std::env;

let api_key = env::var("API_KEY")
    .expect("API_KEY not set.");
let client = DigitalOcean::new(api_key)
    .unwrap();

Droplet::list()
.execute(&client);

Usage Fundamentals

All values (Domain, SshKey, etc) can be found in the api module.

Calling an action will return a Request<_,_> type. For example Droplet::create() will create a Request<Create, Droplet>. These types may then have specific futher functions to futher build up the request or transform it into some other request.

use digitalocean::DigitalOcean;
use digitalocean::api::Domain;

// Gets details of a specific domain.
let req = Domain::get("foo.com");

// Get the records for that domain instead (futher build the request)
let req = req.records();
// Get the records of a domain without having a prior request.
let req = Domain::get("foo.com").records();

// Create a new record for a domain
let req = Domain::get("foo.com").records().create("CNAME", "test", "127.0.0.1");

In order to realize any action .execute() must be called with a DigitalOcean client. It is also possible to call do_client.execute(some_request).

In order to use the entire API it is recommended to reference the various Request types.

Design

The crate is founded on a few design considerations:

Debugging

This crate uses the log crate. You can see digitalocean logs by passing an environment variable such as:

RUST_LOG=digitalocean=debug cargo run

Development Status

This crate is in a prototype state.

Not all endpoints have been fully end-to-end tested on the production DigitalOcean API. It's very likely that some endpoints will have parsing errors due to unexpected values returned from the API.

If something does not work please file a bug!

Feedback, patches, and new features are encouraged. Please just open an issue or PR!

Modules

api

API specific documentation.

method

Marker types for requests.

prelude

Wildcard glob this module to have access to all commonly used items.

request

Abstract types representing requests and how they are executed.

Structs

DigitalOcean

A DigitalOcean Client that holds an API key.

Error

The Error type.

Enums

ErrorKind

The kind of an error.