datafold 0.1.55

A personal database for data sovereignty with AI-powered ingestion
Documentation
//! # Schema System
//!
//! The schema module defines the structure and behavior of data in the DataFold system.
//! Schemas define fields, their types, permissions, and payment requirements.
//!
//! ## Components
//!
//! * `core` - Core schema functionality including loading, validation, and field mapping
//! * `types` - Schema-related data structures and type definitions
//! * `hasher` - Schema hashing and integrity verification with configurable directory paths
//! * `file_operations` - File-based operations for reading and writing schemas
//! * `duplicate_detection` - Duplicate detection and conflict resolution for schemas
//! * `validator` - Schema validation logic
//!
//! ## Architecture
//!
//! Schemas in DataFold define the structure of data and the operations that can be
//! performed on it. Each schema has a name and a set of fields, each with its own
//! type, permissions, and payment requirements.
//!
//! The schema system supports field mapping between schemas, allowing fields from
//! one schema to reference fields in another. This creates a graph-like structure
//! of related data across schemas.
//!
//! Schemas are loaded from JSON definitions, validated, and then used to process
//! queries and mutations against the database.

// Internal modules
pub mod constants;
pub mod core;
pub mod duplicate_detection;
pub mod file_operations;
pub mod hasher;
pub mod molecule_variants;
pub mod persistence;
pub mod schema_types;
pub mod types;

// Public re-exports
pub use core::*;
pub use duplicate_detection::SchemaDuplicateDetector;
pub use file_operations::SchemaFileOperations;
pub use hasher::SchemaHasher;
pub use molecule_variants::MoleculeVariant;
pub use schema_types::{SchemaLoadingReport, SchemaSource, SchemaState, SchemaWithState};
pub use types::*;

/// Public prelude module containing types needed by tests and external code
pub mod prelude {
    pub use super::SchemaCore;
}

/// Convenience helper for creating a lock acquisition error
pub fn schema_lock_error() -> SchemaError {
    SchemaError::InvalidData("Failed to acquire schema lock".to_string())
}