workspace_tools: cleaning

Author: Wandalen

module/core/workspace_tools/Cargo.toml

@@ -11,37 +11,39 @@ documentation = "https://docs.rs/workspace_tools"
 repository = "https://github.com/Wandalen/workspace_tools"
 homepage = "https://github.com/Wandalen/workspace_tools"
 description = """
-Universal workspace-relative path resolution for any Rust project. Provides consistent, reliable path management regardless of execution context or working directory.
+Reliable workspace-relative path resolution for Rust projects. Automatically finds your workspace root and provides consistent file path handling regardless of execution context.
 """
-categories = [ "development-tools", "filesystem" ]
-keywords = [ "workspace", "path", "resolution", "build-tools", "cross-platform" ]
+categories = [ "filesystem", "development-tools" ]
+keywords = [ "workspace", "path", "cargo", "filesystem", "build-tools" ]
 
 [lints]
 workspace = true
 
 [package.metadata.docs.rs]
-features = [ "full" ]
+features = [ "serde", "glob", "secrets", "validation" ]
 all-features = false
 
 [features]
-default = [ "full" ]
-full = [ "enabled", "glob", "secret_management", "cargo_integration", "serde_integration", "stress", "integration" ]
-enabled = [ "dep:tempfile" ]
+default = [ "serde" ]
+serde = [ "dep:serde", "dep:serde_json", "dep:serde_yaml" ]
 glob = [ "dep:glob" ]
-secret_management = []
-cargo_integration = [ "dep:cargo_metadata", "dep:toml" ]
-serde_integration = [ "dep:serde", "dep:serde_json", "dep:serde_yaml" ]
-stress = []
-integration = []
+secrets = []
+validation = [ "dep:jsonschema", "dep:schemars" ]
+testing = [ "dep:tempfile" ]
 
 [dependencies]
+# Core dependencies (always available)
+cargo_metadata = { workspace = true }
+toml = { workspace = true, features = [ "preserve_order" ] }
+
+# Optional dependencies
 glob = { workspace = true, optional = true }
 tempfile = { workspace = true, optional = true }
-cargo_metadata = { workspace = true, optional = true }
-toml = { workspace = true, features = [ "preserve_order" ], optional = true }
 serde = { workspace = true, features = [ "derive" ], optional = true }
 serde_json = { workspace = true, optional = true }
 serde_yaml = { workspace = true, optional = true }
+jsonschema = { version = "0.20", optional = true }
+schemars = { version = "0.8", optional = true }
 
 [dev-dependencies]
 # Test utilities - using minimal local dependencies only

module/core/workspace_tools/examples/010_cargo_and_serde_integration.rs

@@ -62,12 +62,11 @@ fn main() -> Result< (), Box< dyn core::error::Error > >
 {
   println!( "🚀 Cargo Integration and Serde Integration Demo\n" );
 
-  // demonstrate cargo integration
-  #[ cfg( feature = "cargo_integration" ) ]
+  // demonstrate cargo integration (always available)
   cargo_integration_demo();
 
   // demonstrate serde integration
-  #[ cfg( feature = "serde_integration" ) ]
+  #[ cfg( feature = "serde" ) ]
   serde_integration_demo()?;
 
   Ok( () )
@@ -290,9 +289,9 @@ fn serde_integration_demo() -> Result< (), Box< dyn core::error::Error > >
   Ok( () )
 }
 
-#[ cfg( not( any( feature = "cargo_integration", feature = "serde_integration" ) ) ) ]
+#[ cfg( not( feature = "serde" ) ) ]
 fn main()
 {
-  println!( "🔧 This example requires cargo_integration and/or serde_integration features." );
-  println!( "   Run with: cargo run --example 010_cargo_and_serde_integration --features full" );
+  println!( "🔧 This example requires serde feature (enabled by default)." );
+  println!( "   Run with: cargo run --example 010_cargo_and_serde_integration --features serde" );
 }

module/core/workspace_tools/readme.md

@@ -131,90 +131,41 @@ your-project/
 
 ---
 
-## 🎭 Advanced Features
+## 🔧 Optional Features
 
-`workspace_tools` is packed with powerful, optional features. Enable them in your `Cargo.toml` as needed.
+Enable additional functionality as needed in your `Cargo.toml`:
 
-<details>
-<summary><strong>🔧 Seamless Serde Integration (`serde_integration`)</strong></summary>
-
-Eliminate boilerplate for loading `.toml`, `.json`, and `.yaml` files.
-
-**Enable:** `cargo add serde` and add `workspace_tools = { workspace = true, features = ["serde_integration"] }` to `Cargo.toml`.
+**Serde Integration** (`serde`) - *enabled by default*
+Load `.toml`, `.json`, and `.yaml` files directly into structs.
 
 ```rust
-use serde::Deserialize;
-use workspace_tools::workspace;
-
 #[ derive( Deserialize ) ]
-struct AppConfig
-{
-  name : String,
-  port : u16,
-}
-
-let ws = workspace()?;
-
-// Automatically finds and parses `config/app.{toml,yaml,json}`.
-let config : AppConfig = ws.load_config( "app" )?;
-println!( "Running '{}' on port {}", config.name, config.port );
+struct AppConfig { name: String, port: u16 }
 
-// Load and merge multiple layers (e.g., base + production).
-let final_config : AppConfig = ws.load_config_layered( &[ "base", "production" ] )?;
-
-// Partially update a configuration file on disk.
-let updates = serde_json::json!( { "port": 9090 } );
-let updated_config : AppConfig = ws.update_config( "app", updates )?;
+let config: AppConfig = workspace()?.load_config( "app" )?;
 ```
 
-</details>
-
-<details>
-<summary><strong>🔍 Powerful Resource Discovery (`glob`)</strong></summary>
-
-Find files anywhere in your workspace using glob patterns.
-
-**Enable:** Add `workspace_tools = { workspace = true, features = ["glob"] }` to `Cargo.toml`.
+**Resource Discovery** (`glob`)
+Find files with glob patterns like `src/**/*.rs`.
 
 ```rust
-use workspace_tools::workspace;
-
-let ws = workspace()?;
-
-// Find all Rust source files recursively.
-let rust_files = ws.find_resources( "src/**/*.rs" )?;
-
-// Intelligently find a config file, trying multiple extensions.
-let db_config = ws.find_config( "database" )?; // Finds config/database.toml, .yaml, etc.
+let rust_files = workspace()?.find_resources( "src/**/*.rs" )?;
 ```
 
-</details>
-
-<details>
-<summary><strong>🔒 Secure Secret Management (`secret_management`)</strong></summary>
-
-Load secrets from files in a dedicated, git-ignored `.secret/` directory, with fallbacks to environment variables.
-
-**Enable:** Add `workspace_tools = { workspace = true, features = ["secret_management"] }` to `Cargo.toml`.
-
-```
-// .gitignore
-.*
-// .secret/-secrets.sh
-API_KEY="your-super-secret-key"
-```
+**Secret Management** (`secrets`)
+Load secrets from `.secret/` directory with environment fallbacks.
 
 ```rust
-use workspace_tools::workspace;
+let api_key = workspace()?.load_secret_key( "API_KEY", "-secrets.sh" )?;
+```
 
-let ws = workspace()?;
+**Config Validation** (`validation`)
+Schema-based validation for configuration files.
 
-// Loads API_KEY from .secret/-secrets.sh, or falls back to the environment.
-let api_key = ws.load_secret_key( "API_KEY", "-secrets.sh" )?;
+```rust
+let config: AppConfig = workspace()?.load_config_with_validation( "app" )?;
 ```
 
-</details>
-
 ---
 
 ## 🛠️ Built for the Real World
@@ -286,15 +237,6 @@ graph TD
 
 ---
 
-## 🚧 Vision & Roadmap
-
-`workspace_tools` is actively developed. Our vision is to make workspace management a solved problem in Rust. Upcoming features include:
-
-*   **Project Scaffolding**: A powerful `cargo workspace-tools init` command to create new projects from templates.
-*   **Configuration Validation**: Schema-based validation to catch config errors before they cause panics.
-*   **Async & Hot-Reloading**: Full `tokio` integration for non-blocking file operations and live configuration reloads.
-*   **Official CLI Tool**: A `cargo workspace-tools` command for managing your workspace from the terminal.
-*   **IDE Integration**: Rich support for VS Code and RustRover to bring workspace-awareness directly into your editor.
 
 ## 🤝 Contributing