things3_core/
lib.rs

1//! Things Core - Core library for Things 3 database access and data models
2//!
3//! This library provides high-performance access to the Things 3 database,
4//! with comprehensive data models and efficient querying capabilities.
5//!
6//! # Features
7//!
8//! - **Async Database Access**: Built on SQLx for type-safe, async database operations
9//! - **Comprehensive Data Models**: Full support for Tasks, Projects, Areas, and Tags
10//! - **Bulk Operations**: Efficient batch operations with transactional guarantees
11//! - **Caching Layer**: High-performance caching with configurable TTL
12//! - **Export Support**: Multiple export formats (JSON, CSV, OPML, Markdown)
13//! - **Observability**: Built-in metrics, logging, and health checks
14//! - **Performance Monitoring**: Query performance tracking and optimization suggestions
15//!
16//! # Quick Start
17//!
18//! ```no_run
19//! use things3_core::{ThingsDatabase, ThingsError};
20//! use std::path::Path;
21//!
22//! # async fn example() -> Result<(), ThingsError> {
23//! // Connect to Things 3 database
24//! let db = ThingsDatabase::new(Path::new("/path/to/things.db")).await?;
25//!
26//! // Get inbox tasks
27//! let tasks = db.get_inbox(None).await?;
28//! println!("Found {} tasks in inbox", tasks.len());
29//!
30//! // Search for tasks
31//! let results = db.search_tasks("meeting").await?;
32//! println!("Found {} matching tasks", results.len());
33//! # Ok(())
34//! # }
35//! ```
36//!
37//! # Examples
38//!
39//! See the [examples directory](https://github.com/GarthDB/rust-things3/tree/main/examples)
40//! for more comprehensive usage examples.
41//!
42//! # Crate Features
43//!
44//! - `default`: Minimal feature set (core functionality only)
45//! - `export-csv`: Enable CSV export support
46//! - `export-opml`: Enable OPML export support
47//! - `observability`: Enable metrics, tracing, and health checks
48//! - `full`: Enable all optional features
49//! - `test-utils`: Enable test utilities (for testing only)
50
51pub mod backup;
52pub mod cache;
53pub mod cache_invalidation_middleware;
54pub mod config;
55pub mod config_hot_reload;
56pub mod config_loader;
57pub mod database;
58pub mod disk_cache;
59pub mod error;
60
61#[cfg(feature = "advanced-queries")]
62pub mod filter_expr;
63
64#[cfg(any(feature = "export-csv", feature = "export-opml"))]
65pub mod export;
66
67pub mod mcp_cache_middleware;
68pub mod mcp_config;
69pub mod models;
70
71#[cfg(feature = "observability")]
72pub mod observability;
73
74pub mod performance;
75pub mod query;
76pub mod query_cache;
77pub mod query_performance;
78
79#[cfg(feature = "advanced-queries")]
80pub mod saved_queries;
81
82#[cfg(any(test, feature = "test-utils"))]
83pub mod test_utils;
84
85pub use backup::{BackupManager, BackupMetadata, BackupStats};
86pub use cache::{CacheConfig, CacheStats, ThingsCache};
87pub use cache_invalidation_middleware::{
88    CacheInvalidationHandler, CacheInvalidationMiddleware, InvalidationConfig, InvalidationEvent,
89    InvalidationEventType, InvalidationRule, InvalidationStats, InvalidationStrategy,
90};
91pub use config::ThingsConfig;
92pub use config_hot_reload::{
93    ConfigChangeHandler, ConfigHotReloader, ConfigHotReloaderWithHandler,
94    DefaultConfigChangeHandler,
95};
96pub use config_loader::{load_config, load_config_from_env, load_config_with_paths, ConfigLoader};
97pub use database::{
98    get_default_database_path, ComprehensiveHealthStatus, DatabasePoolConfig, DatabaseStats,
99    PoolHealthStatus, PoolMetrics, SqliteOptimizations, ThingsDatabase,
100};
101pub use disk_cache::{DiskCache, DiskCacheConfig, DiskCacheStats};
102pub use error::{Result, ThingsError};
103
104#[cfg(any(feature = "export-csv", feature = "export-opml"))]
105pub use export::{DataExporter, ExportConfig, ExportData, ExportFormat};
106
107pub use mcp_cache_middleware::{MCPCacheConfig, MCPCacheEntry, MCPCacheMiddleware, MCPCacheStats};
108pub use mcp_config::McpServerConfig;
109pub use models::*;
110// Explicitly re-export DeleteChildHandling for clarity
111pub use models::DeleteChildHandling;
112
113#[cfg(feature = "observability")]
114pub use observability::{
115    CheckResult, HealthStatus, ObservabilityConfig, ObservabilityError, ObservabilityManager,
116    ThingsMetrics,
117};
118
119pub use performance::{
120    CacheMetrics, ComprehensivePerformanceSummary, OperationMetrics, PerformanceMonitor,
121    PerformanceStats, PerformanceSummary, QueryMetrics,
122};
123pub use query_cache::{QueryCache, QueryCacheConfig, QueryCacheStats};
124
125#[cfg(feature = "advanced-queries")]
126pub use filter_expr::{FilterExpr, FilterPredicate};
127pub use query_performance::{
128    ImplementationEffort, OptimizationPriority, OptimizationType, QueryContext,
129    QueryOptimizationSuggestion, QueryPerformanceMetrics, QueryPerformanceStats,
130    QueryPerformanceSummary, QueryPerformanceTracker,
131};
132#[cfg(feature = "advanced-queries")]
133pub use saved_queries::{SavedQuery, SavedQueryStore};
134
135/// Re-export commonly used types
136pub use chrono::{DateTime, NaiveDate, Utc};
137pub use serde::{Deserialize, Serialize};
138pub use uuid::Uuid;
things3_core/lib.rs

things3_core/
lib.rs
