s3-path 0.1.1

Describe paths inside an S3 bucket like working with std's Path and PathBuf.
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

use crate::error::InvalidS3PathComponent;

/// Validates that a path component contains only allowed characters:
/// alphanumeric characters, hyphens, underscores, and periods.
pub(crate) fn validate_component(component: &str) -> Result<(), InvalidS3PathComponent> {
    if component.is_empty() {
        return Err(InvalidS3PathComponent {
            component: component.to_string(),
            reason: "Empty component is not allowed".to_string(),
        });
    }

    for c in component.chars() {
        if !c.is_ascii_alphanumeric() && c != '-' && c != '_' && c != '.' {
            return Err(InvalidS3PathComponent {
                component: component.to_string(),
                reason: format!("Character '{}' is not allowed", c),
            });
        }
    }

    if component == "." || component == ".." {
        return Err(InvalidS3PathComponent {
            component: component.to_string(),
            reason: "Potentially path traversing components are forbidden.".to_string(),
        });
    }

    Ok(())
}