cerniera 0.3.0

A ZIP archive encoder that never copies your data
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

//! `ZipEntry` constructor validation: the trailing-slash convention is
//! enforced at construction, so a path that validates can no longer
//! panic the writer.

use std::io;

use bytes::Bytes;
use cerniera::{FileTimes, InvalidZipPath, ZipEntry};
use futures_util::stream;

/// A concrete content-stream type. Directory entries carry no content,
/// so constructing one standalone needs the stream's `S` spelled out;
/// in a mixed entry stream it is inferred from the file entries.
type Content = stream::Iter<std::iter::Empty<Result<Bytes, io::Error>>>;

fn empty_content() -> Content {
    stream::iter(std::iter::empty::<Result<Bytes, io::Error>>())
}

#[test]
fn file_constructor_rejects_trailing_slash() {
    let path = "dir/".try_into().unwrap();
    assert!(matches!(
        ZipEntry::file(path, FileTimes::default(), empty_content()),
        Err(InvalidZipPath::FileWithTrailingSlash(p)) if p == "dir/"
    ));
}

#[test]
fn directory_constructor_requires_trailing_slash() {
    let path = "dir".try_into().unwrap();
    assert!(matches!(
        ZipEntry::<Content>::directory(path, FileTimes::default()),
        Err(InvalidZipPath::DirectoryWithoutSlash(p)) if p == "dir"
    ));
}

#[test]
fn constructors_accept_matching_paths() {
    assert!(
        ZipEntry::file(
            "images/photo.jpg".try_into().unwrap(),
            FileTimes::default(),
            empty_content(),
        )
        .is_ok()
    );
    assert!(
        ZipEntry::<Content>::directory("subdir/".try_into().unwrap(), FileTimes::default()).is_ok()
    );
}