digitalocean 0.1.1

A pure Rust DigitalOcean API binding.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115

use super::action::Action;
use super::volume::Volume;
use crate::method::{Create, Get, List};
use crate::request::Request;
use crate::request::{VolumeActionRequest, VolumeRequest};
use crate::{ROOT_URL, STATIC_URL_ERROR};
use serde::Serialize;
use std::fmt::Display;

const VOLUMES_SEGMENT: &str = "volumes";
const VOLUME_ACTIONS_SEGMENT: &str = "actions";

impl Volume {
	/// [Digital Ocean Documentation.](https://developers.digitalocean.com/documentation/v2/#attach-a-block-storage-volume-to-a-droplet-by-name)
	pub fn attach<S>(volume_name: S, droplet: usize) -> VolumeActionRequest<Create, Action>
		where S: AsRef<str> + Serialize + Display {
		let mut url = ROOT_URL.clone();
		url.path_segments_mut()
			.expect(STATIC_URL_ERROR)
			.push(VOLUMES_SEGMENT);

		let mut req = Request::new(url);
		req.set_body(json!({
			"type": "attach",
			"volume_name": volume_name,
			"droplet_id": droplet,
		}));
		req
	}

	/// [Digital Ocean Documentation.](https://developers.digitalocean.com/documentation/v2/#remove-a-block-storage-volume-from-a-droplet-by-name)
	pub fn detach<S>(volume_name: S, droplet: usize) -> VolumeActionRequest<Create, Action>
		where S: AsRef<str> + Serialize + Display {
		let mut url = ROOT_URL.clone();
		url.path_segments_mut()
			.expect(STATIC_URL_ERROR)
			.push(VOLUMES_SEGMENT);

		let mut req = Request::new(url);
		req.set_body(json!({
			"type": "detach",
			"volume_name": volume_name,
			"droplet_id": droplet,
		}));
		req
	}
}

impl VolumeRequest<Get, Volume> {
	/// [Digital Ocean Documentation.](https://developers.digitalocean.com/documentation/v2/#attach-a-block-storage-volume-to-a-droplet)
	pub fn attach(mut self, droplet: usize) -> VolumeActionRequest<Create, Action> {
		self.url_mut()
			.path_segments_mut()
			.expect(STATIC_URL_ERROR)
			.push(VOLUME_ACTIONS_SEGMENT);

		self.set_body(json!({
			"type": "attach",
			"droplet_id": droplet,
		}));

		self.transmute()
	}

	/// [Digital Ocean Documentation.](https://developers.digitalocean.com/documentation/v2/#remove-a-block-storage-volume-from-a-droplet)
	pub fn detach(mut self, droplet: usize) -> VolumeActionRequest<Create, Action> {
		self.url_mut()
			.path_segments_mut()
			.expect(STATIC_URL_ERROR)
			.push(VOLUME_ACTIONS_SEGMENT);

		self.set_body(json!({
			"type": "detach",
			"droplet_id": droplet,
		}));

		self.transmute()
	}

	/// [Digital Ocean Documentation.](https://developers.digitalocean.com/documentation/v2/#resize-a-volume)
	pub fn resize(mut self, size: usize) -> VolumeActionRequest<Create, Action> {
		self.url_mut()
			.path_segments_mut()
			.expect(STATIC_URL_ERROR)
			.push(VOLUME_ACTIONS_SEGMENT);

		self.set_body(json!({
			"type": "resize",
			"size_gigabytes": size,
		}));

		self.transmute()
	}

	/// [Digital Ocean Documentation.](https://developers.digitalocean.com/documentation/v2/#list-all-actions-for-a-volume)
	pub fn actions(mut self) -> VolumeActionRequest<List, Vec<Action>> {
		self.url_mut()
			.path_segments_mut()
			.expect(STATIC_URL_ERROR)
			.push(VOLUME_ACTIONS_SEGMENT);

		self.transmute()
	}

	/// [Digital Ocean Documentation.](https://developers.digitalocean.com/documentation/v2/#retrieve-an-existing-volume-action)
	pub fn action(mut self, id: usize) -> VolumeActionRequest<Get, Action> {
		self.url_mut()
			.path_segments_mut()
			.expect(STATIC_URL_ERROR)
			.push(VOLUME_ACTIONS_SEGMENT)
			.push(&id.to_string());

		self.transmute()
	}
}