workspace_tools 0.12.0

Reliable workspace-relative path resolution for Rust projects. Automatically finds your workspace root and provides consistent file path handling regardless of execution context. Features memory-safe secret management, configuration loading with validation, and resource discovery.
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

//! # 000 - Hello Workspace
//!
//! the most basic introduction to `workspace_tools`
//! this example shows the fundamental concept of workspace resolution

use workspace_tools :: { workspace, WorkspaceError };

fn main() -> Result< (), WorkspaceError >
{
  // workspace_tools works by reading the WORKSPACE_PATH environment variable
  // if it's not set, we'll set it to current directory for this demo
  if std ::env ::var( "WORKSPACE_PATH" ).is_err()
  {
  let current_dir = std ::env ::current_dir().unwrap();
  std ::env ::set_var( "WORKSPACE_PATH", &current_dir );
  println!( "📍 set WORKSPACE_PATH to: {}", current_dir.display() );
 }

  // the fundamental operation: get a workspace instance
  println!( "🔍 resolving workspace..." );
  let ws = workspace()?;
  
  // every workspace has a root directory
  println!( "✅ workspace root: {}", ws.root().display() );
  
  // that's it! you now have reliable, workspace-relative path resolution
  // no more brittle "../../../config/file.toml" paths
  
  println!( "\n🎉 workspace resolution successful!" );
  println!( "next: run example 001 to learn about standard directories" );
  
  Ok( () )
}