octoprint 0.1.3

(WIP) A client library for the Octoprint REST API
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

use std::rc::Rc;

use error_stack::{IntoReport, Result};
use reqwest::Url;
use reqwest::{Client, IntoUrl};
use serde::{Deserialize, Serialize};

mod builder;
pub mod error;
/// File operations and data model
pub mod file;
mod helpers;
/// Job operations and data model
pub mod job;
/// Printer operations and data model
pub mod printer;
/// Octoprint API operations and data model
pub mod server;

pub use builder::OctoClientBuilder;

pub struct OctoClient {
    client: Client,
    base_url: Url,
    auth_credentials: Rc<AuthenticationMethod>,
}

#[derive(Debug, Serialize, Deserialize)]
pub enum AuthenticationMethod {
    Bearer(String),
    Basic { username: String, password: String },
}

impl OctoClient {
    #[allow(clippy::new_ret_no_self)]
    pub fn new<U: IntoUrl>(url: U) -> Result<OctoClientBuilder, reqwest::Error> {
        OctoClientBuilder::new(url)
    }

    fn append_path_to_base_url(&self, path: &str) -> Result<Url, url::ParseError> {
        self.base_url.join(path).into_report()
    }
}