s3 0.1.36

A lean, modern, unofficial S3-compatible client for 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

use crate::{Error, Result};

pub(crate) fn validate_object_key(key: &str) -> Result<()> {
    if key.is_empty() {
        return Err(Error::invalid_config("object key must not be empty"));
    }
    if key.bytes().any(|b| b.is_ascii_control()) {
        return Err(Error::invalid_config(
            "object key must not contain ASCII control characters",
        ));
    }
    if key.split('/').any(|segment| matches!(segment, "." | "..")) {
        return Err(Error::invalid_config(
            "object key must not contain '.' or '..' path segments",
        ));
    }
    Ok(())
}

pub(crate) fn validate_version_id(version_id: &str) -> Result<()> {
    if version_id.is_empty() {
        return Err(Error::invalid_config("version_id must not be empty"));
    }
    if version_id.trim() != version_id {
        return Err(Error::invalid_config(
            "version_id must not include leading or trailing whitespace",
        ));
    }
    if version_id.bytes().any(|b| b.is_ascii_control()) {
        return Err(Error::invalid_config(
            "version_id must not contain ASCII control characters",
        ));
    }
    Ok(())
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn validates_object_key() {
        validate_object_key("dir/file.txt").unwrap();
        assert!(validate_object_key("").is_err());
        assert!(validate_object_key("dir/../file.txt").is_err());
        assert!(validate_object_key("dir/./file.txt").is_err());
        assert!(validate_object_key("line\nbreak").is_err());
    }

    #[test]
    fn validates_version_id() {
        validate_version_id("version-1").unwrap();
        assert!(validate_version_id("").is_err());
        assert!(validate_version_id(" version").is_err());
        assert!(validate_version_id("version ").is_err());
        assert!(validate_version_id("line\nbreak").is_err());
    }
}