bigml 0.0.3

BigML client bindings (WORK IN PROGRESS, unstable Rust)
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

//! Support for sending multipart form data with a file attachment.

use mime;
use std::fs;
use std::io::{self, Read};
use std::path::PathBuf;
use uuid::Uuid;

use errors::*;

/// A `multipart/form-data` body containing exactly one file.  We can
/// generalize this latter if we need to, but maybe upstream will be fixed
/// by then.
pub struct Body {
    boundary: String,
    reader: Box<Read>,
}

impl Body {
    /// Create a new multipart body.
    pub fn new<S, P>(name: S, path: P) -> Result<Body>
        where S: Into<String>, P: Into<PathBuf>
    {
        // Convert our parameters.
        let name = name.into();
        let path = path.into();
        let filename = path.to_string_lossy();

        // Open up our file.
        let file = fs::File::open(&path)
            .chain_err(|| ErrorKind::CouldNotReadFile(path.clone()))?;

        // Create a streaming, multi-part encoder.  Don't even think of
        // reading all the data into memory; there may be 10s of gigabytes
        // for some applications.
        //
        // TODO: Escape filename.
        let boundary = format!("--------------------------{}", Uuid::new_v4());
        let header = format!("--{}\r
Content-Disposition: form-data; name=\"{}\"; filename=\"{}\"\r
Content-Type: application/octet-stream\r
\r
", &boundary, &name, filename);
        let footer = format!("\r
--{}--\r
", &boundary);
        let body = io::Cursor::new(header)
            .chain(file)
            .chain(io::Cursor::new(footer));
        Ok(Body {
            boundary: boundary,
            reader: Box::new(body)
        })
    }

    /// The MIME type for this body, including the `boundary` value.
    pub fn mime_type(&self) -> mime::Mime {
        mime::Mime(mime::TopLevel::Multipart,
                   mime::SubLevel::FormData,
                   vec![(mime::Attr::Boundary,
                         mime::Value::Ext(self.boundary.to_owned()))])
    }
}

impl Read for Body {
    fn read(&mut self, buf: &mut [u8]) -> io::Result<usize> {
        self.reader.read(buf)
    }
}