office-convert-client 0.6.0

Client library for interacting with office-convert-server
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

pub mod client;
pub mod load;

use std::sync::Arc;

use bytes::Bytes;
pub use client::{ClientOptions, CreateError, OfficeConvertClient, RequestError};
pub use load::OfficeConvertLoadBalancer;

/// Office converter
#[derive(Clone)]
pub enum OfficeConverter {
    /// Recommended: Load balanced client that can handle blocking of the server
    LoadBalanced(Arc<OfficeConvertLoadBalancer>),
    /// Office client without any additional logic for handling a server
    /// being unavailable.
    Client(OfficeConvertClient),
}

impl OfficeConverter {
    /// Create a new converter from a client
    pub fn from_client(client: OfficeConvertClient) -> Self {
        Self::Client(client)
    }

    /// Create a new converter from a load balancer
    pub fn from_load_balancer(client: OfficeConvertLoadBalancer) -> Self {
        Self::LoadBalanced(Arc::new(client))
    }

    /// Converts the provided office file format bytes into a
    /// PDF returning the PDF file bytes
    ///
    /// ## Arguments
    /// * `file` - The file bytes to convert
    pub async fn convert(&self, file: Bytes) -> Result<Bytes, RequestError> {
        match self {
            OfficeConverter::LoadBalanced(inner) => inner.convert(file).await,
            OfficeConverter::Client(inner) => inner.convert(file).await,
        }
    }
}