quilt-rs 0.40.0

Rust library for versioning data packages: content-addressed manifests, local domains, and S3 remotes.
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

use chrono::Utc;
use tempfile::TempDir;
use test_log::test;

use super::*;

use crate::io::storage::Storage;
use crate::local_domain::LocalDomain;

#[test(tokio::test)]
async fn current_revision_reads_only_the_selected_installed_manifest() -> Res {
    let temp_dir = TempDir::new()?;
    let domain = LocalDomain::new(temp_dir.path());
    domain.set_home(temp_dir.path()).await?;

    let namespace: Namespace = ("demo", "sales").into();
    let before = Utc::now();
    let package = domain
        .create_package(namespace.clone(), None, Some("initial import".to_string()))
        .await?;
    let snapshot = package.lineage().await?;
    let expected_hash = snapshot
        .current_hash()
        .expect("a created package has a current revision")
        .to_string();

    // A current-revision read must not enumerate and parse history. Keeping a
    // corrupt sibling here makes that contract observable in the test.
    package
        .storage
        .write_byte_stream(
            package
                .paths
                .installed_manifest(&namespace, "damaged-old-revision"),
            b"not a manifest".to_vec().into(),
        )
        .await?;

    // Change the stored lineage after the caller's snapshot. The revision read
    // must stay on that snapshot rather than selecting again halfway through.
    package
        .lineage
        .edit(&package.storage, |lineage| {
            *lineage = crate::lineage::PackageLineage::default();
        })
        .await?;

    let revision = package
        .current_revision(&snapshot)
        .await?
        .expect("a created package has a current revision");
    let after = Utc::now();

    assert_eq!(revision.hash, expected_hash);
    assert_eq!(revision.message.as_deref(), Some("initial import"));
    assert!(revision.obtained >= before);
    assert!(revision.obtained <= after);

    Ok(())
}

#[test(tokio::test)]
async fn current_revision_prefers_a_pending_commit_over_the_remote_hash() -> Res {
    let temp_dir = TempDir::new()?;
    let domain = LocalDomain::new(temp_dir.path());
    domain.set_home(temp_dir.path()).await?;

    let namespace: Namespace = ("demo", "pending").into();
    let package = domain
        .create_package(namespace.clone(), None, Some("local work".to_string()))
        .await?;
    let pending_hash = package
        .lineage()
        .await?
        .commit
        .expect("a locally created package has a pending commit")
        .hash;
    let remote_hash = "published-revision".to_string();

    package
        .lineage
        .edit(&package.storage, |lineage| {
            lineage.remote_uri = Some(ManifestUri {
                origin: None,
                bucket: "published-bucket".to_string(),
                namespace: namespace.clone(),
                hash: remote_hash.clone(),
            });
        })
        .await?;

    let snapshot = package.lineage().await?;
    let revision = package
        .current_revision(&snapshot)
        .await?
        .expect("the pending commit is the current revision");

    assert_ne!(pending_hash, remote_hash);
    assert_eq!(revision.hash, pending_hash);
    assert_eq!(revision.message.as_deref(), Some("local work"));

    Ok(())
}