ggen-core 26.5.19

Core graph-aware code generation engine
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

//! Unified Lockfile Trait System for ggen v4.0
//!
//! This module provides zero-cost abstractions for lockfile operations,
//! unifying the three existing lockfile implementations into a coherent
//! trait-based architecture.
//!
//! ## Architecture
//!
//! The unified lockfile system uses Rust's trait system to encode invariants:
//!
//! ```text
//! ┌─────────────────────────────────────────────────────────────┐
//! │                    Trait Hierarchy                          │
//! ├─────────────────────────────────────────────────────────────┤
//! │  LockEntry          - Individual entry with metadata        │
//! │  Lockfile           - Container for entries                 │
//! │  LockfileFormat     - TOML/JSON serialization              │
//! │  LockfileManager    - CRUD operations                       │
//! │  PqcSignable        - Post-quantum signature support        │
//! │  CachingManager     - Dependency resolution cache           │
//! │  Validatable        - Integrity verification                │
//! └─────────────────────────────────────────────────────────────┘
//! ```
//!
//! ## Key Features
//!
//! - **Type-First Design**: Types encode invariants at compile time
//! - **Zero-Cost Abstractions**: Generics monomorphize to concrete code
//! - **Backward Compatible**: From<T> implementations for existing types
//! - **PQC Support**: ML-DSA-65 (Dilithium3) signature integration
//! - **Cache Coherency**: Shared LRU cache across managers
//!
//! ## Example
//!
//! ```rust,no_run
//! use crate::lockfile_unified::prelude::*;
//!
//! // Use unified manager for any lockfile type
//! let manager = UnifiedLockfileManager::new(Path::new("."));
//! let lockfile = manager.load_or_create()?;
//! ```

pub mod cache;
pub mod entry;
pub mod format;
pub mod traits;
pub mod validation;

pub mod prelude {
    //! Prelude for convenient imports
    pub use super::cache::*;
    pub use super::entry::*;
    pub use super::format::*;
    pub use super::traits::*;
    pub use super::validation::*;
}

// Re-exports for backward compatibility
pub use cache::{CacheStats, CoherentCache};
pub use entry::{ExtendedMetadata, LockSource, PqcSignature, UnifiedLockEntry};
pub use format::{detect_format, FormatType, JsonFormat, TomlFormat};
pub use traits::{LockEntry, Lockfile, LockfileFormat, LockfileManager};
pub use validation::{IntegrityCheck, ValidationResult};