pakx-core 0.1.9

pakx core — manifest, lockfile, resolver, installer logic
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

//! Filesystem helpers for `agents.yml`.

use std::path::Path;

use crate::atomic_write::atomic_write;
use crate::errors::ManifestError;

use super::parse::parse_manifest;
use super::schema::Manifest;
use super::write::write_manifest;

/// Read + parse `agents.yml` from disk. Errors carry the path for
/// diagnostic output.
pub fn read_from(path: &Path) -> Result<Manifest, ManifestError> {
    let source = std::fs::read_to_string(path).map_err(|source| ManifestError::Io {
        source,
        path: Some(path.to_path_buf()),
    })?;
    parse_manifest(&source, Some(path))
}

/// Write a manifest to disk via [`write_manifest`] + `atomic_write`.
///
/// The temp-then-rename flow keeps a crash mid-write from corrupting
/// the on-disk `agents.yml` — either the prior contents stay intact or
/// the new body is fully there, never partially.
pub fn write_to(path: &Path, manifest: &Manifest) -> Result<(), ManifestError> {
    let body = write_manifest(manifest);
    atomic_write(path, body.as_bytes()).map_err(|source| ManifestError::Io {
        source,
        path: Some(path.to_path_buf()),
    })
}