ic-host-fs 0.26.1

Local host filesystem reads, durable publication and file locking
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
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107

use super::*;
use ic_host_artifacts::artifact::ArtifactError;
use std::fs;

#[test]
fn verified_copy_preserves_prior_bytes_on_digest_limit_and_source_refusal() {
    let fixture = crate::test_support::Fixture::new();
    let source = fixture.root.join("source");
    let output = fixture.root.join("output");
    fs::write(&source, b"complete").unwrap();
    fs::write(&output, b"prior").unwrap();
    let options = WriteOptions {
        mode: super::super::PublicationMode::Replace,
        permissions: 0o600,
    };
    assert!(matches!(
        copy_verified(
            &source,
            &output,
            Sha256Digest::compute(b"wrong"),
            8,
            options
        ),
        Err(NamedWriteError::Producer {
            source: CopyError::Input(ArtifactError::DigestMismatch { .. }),
            cleanup_error: None
        })
    ));
    assert_eq!(fs::read(&output).unwrap(), b"prior");
    assert!(
        copy_verified(
            &source,
            &output,
            Sha256Digest::compute(b"complete"),
            7,
            options
        )
        .is_err()
    );
    assert_eq!(fs::read(&output).unwrap(), b"prior");
    assert!(
        copy_verified(
            &fixture.root,
            &output,
            Sha256Digest::compute(b""),
            8,
            options
        )
        .is_err()
    );
    assert_eq!(fs::read(&output).unwrap(), b"prior");
    let identity = copy_verified(
        &source,
        &output,
        Sha256Digest::compute(b"complete"),
        8,
        options,
    )
    .unwrap();
    assert_eq!(identity.bytes, 8);
    assert_eq!(fs::read(&output).unwrap(), b"complete");
    let create = WriteOptions {
        mode: super::super::PublicationMode::CreateNew,
        ..options
    };
    assert!(matches!(
        copy_verified(&source, &output, identity.sha256, 8, create),
        Err(NamedWriteError::BeforePublication { .. })
    ));
    fs::write(&source, b"").unwrap();
    assert_eq!(
        copy_verified(&source, &output, Sha256Digest::compute(b""), 0, options)
            .unwrap()
            .bytes,
        0
    );
    assert_eq!(fs::read(&output).unwrap(), [] as [u8; 0]);
    assert_eq!(fs::read_dir(&fixture.root).unwrap().count(), 2);
}

#[cfg(unix)]
#[test]
fn verified_copy_refuses_fifo_without_a_writer_and_follows_selected_symlinks() {
    use std::os::unix::fs::symlink;
    let fixture = crate::test_support::Fixture::new();
    let source = fixture.root.join("source");
    let alias = fixture.root.join("alias");
    let fifo = fixture.root.join("fifo");
    let output = fixture.root.join("output");
    fs::write(&source, b"bytes").unwrap();
    symlink(&source, &alias).unwrap();
    crate::test_support::create_fifo(&fifo, None).unwrap();
    let options = WriteOptions {
        mode: super::super::PublicationMode::Replace,
        permissions: 0o600,
    };
    assert!(matches!(
        copy_verified(&fifo, &output, Sha256Digest::compute(b"bytes"), 5, options),
        Err(NamedWriteError::Producer {
            source: CopyError::Input(ArtifactError::NotRegularFile),
            ..
        })
    ));
    assert!(!output.exists());
    copy_verified(&alias, &output, Sha256Digest::compute(b"bytes"), 5, options).unwrap();
    assert_eq!(fs::read(&output).unwrap(), b"bytes");
}