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
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

//! integration tests moved from `examples/006_testing_integration.rs` to comply with "no tests in examples" requirement

#[ cfg( feature = "testing" ) ]
use workspace_tools ::testing :: { create_test_workspace, create_test_workspace_with_structure };

#[ cfg( feature = "testing" ) ]
#[ test ]
fn test_workspace_basic_operations()
{
  let ( _temp_dir, ws ) = create_test_workspace();

  // test workspace resolution
  assert!( ws.root().exists() );
  assert!( ws.root().is_dir() );

  // test path operations
  let config = ws.join( "config.toml" );
  assert!( ws.is_workspace_file( &config ) );

  // test standard directories
  let data_dir = ws.data_dir();
  assert!( data_dir.starts_with( ws.root() ) );
}

#[ cfg( feature = "testing" ) ]
#[ test ]
fn test_workspace_with_structure()
{
  let ( _temp_dir, ws ) = create_test_workspace_with_structure();

  // verify standard directories exist
  assert!( ws.config_dir().exists() );
  assert!( ws.data_dir().exists() );
  assert!( ws.logs_dir().exists() );

  // test file creation
  let config_file = ws.config_dir().join( "test.toml" );
  std ::fs ::write( &config_file, "[test]" ).unwrap();
  assert!( config_file.exists() );
  assert!( ws.is_workspace_file( &config_file ) );
}

#[ cfg( all( feature = "testing", feature = "glob" ) ) ]
#[ test ]
fn test_config_discovery()
{
  let ( _temp_dir, ws ) = create_test_workspace_with_structure();

  // create test config
  let config_path = ws.config_dir().join( "app.toml" );
  std ::fs ::write( &config_path, "[app]" ).unwrap();

  // test discovery
  let found = ws.find_config( "app" ).unwrap();
  assert_eq!( found, config_path );

  // test missing config
  assert!( ws.find_config( "nonexistent" ).is_err() );
}