libvctrl_handler 3.0.0

Fundamental contracts for building a version control system – no implementations, only traits and types
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

//! This module defines the core data structures that represent the version control
//! let author = UserID::new("Alice".into(), "alice@example.com".into()).unwrap();
use crate::constants::MAX_NAME_LENGTH;
use crate::errors::VctrlError;

pub mod blob;
pub mod commit;
pub mod hash;
pub mod tag;
pub mod tree;
pub mod user_id;

pub use blob::Blob;
pub use commit::{Commit, CommitMeta};
pub use hash::Hash;
pub use tag::Tag;
pub use tree::{Tree, TreeEntry};
pub use user_id::UserID;

fn validate_name(name: &str) -> Result<(), VctrlError> {
    if name.is_empty() {
        return Err(VctrlError::InvalidName("name is empty".into()));
    }
    if name.len() > MAX_NAME_LENGTH {
        return Err(VctrlError::InvalidName(format!(
            "name exceeds maximum length {MAX_NAME_LENGTH}: '{name}'"
        )));
    }
    Ok(())
}