fs_tools 0.2.0

Tools to manipulate files.
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
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121

//! Comprehensive test of ALL examples from readme.md

fn main()
{
  println!( "\n=== Testing All readme.md Examples ===" );

  test_tempdir_raii();
  test_glob_pattern_matching();
  test_recursive_glob();
  test_pattern_matching();

  println!( "\n✓ All readme.md examples completed successfully\n" );
}

/// Example 1: `TempDir` with RAII Cleanup (readme.md lines 23-37)
#[ cfg( feature = "enabled" ) ]
fn test_tempdir_raii()
{
  use fs_tools::TempDir;
  use std::path::PathBuf;

  println!( "\n--- Test 1: TempDir with RAII Cleanup ---" );

  let mut temp = TempDir::new();
  temp.base_path = std::env::temp_dir();
  temp.prefix_path = PathBuf::from( "my_app" );
  temp.postfix_path = PathBuf::from( "session_1" );

  // Create directory (enables automatic cleanup)
  let path = temp.create_all().expect( "failed to create" );
  println!( "Created: {}", path.display() );
  assert!( path.is_dir(), "Directory should exist after creation" );

  // Verify the directory exists
  assert!( path.exists(), "Path should exist" );
  println!( "✓ Directory exists and is a directory" );

  // Directory is automatically removed when `temp` goes out of scope
}

#[ cfg( not( feature = "enabled" ) ) ]
fn test_tempdir_raii()
{
  println!( "\n--- Test 1: TempDir with RAII Cleanup ---" );
  println!( "⚠ Skipped (requires 'enabled' feature)" );
}

/// Example 2: Glob Pattern Matching (readme.md lines 41-52)
#[ cfg( feature = "glob" ) ]
fn test_glob_pattern_matching()
{
  use fs_tools::glob::glob;

  println!( "\n--- Test 2: Glob Pattern Matching ---" );

  // Find all Rust files in current directory
  let mut found_count = 0;
  for path in glob( "*.rs" ).expect( "valid pattern" ).flatten()
  {
    println!( "Found: {}", path.display() );
    found_count += 1;
  }

  println!( "✓ Found {found_count} .rs files" );
}

#[ cfg( not( feature = "glob" ) ) ]
fn test_glob_pattern_matching()
{
  println!( "\n--- Test 2: Glob Pattern Matching ---" );
  println!( "⚠ Skipped (requires 'glob' feature)" );
}

/// Example 3: Recursive Glob (readme.md lines 56-67)
#[ cfg( feature = "glob" ) ]
fn test_recursive_glob()
{
  use fs_tools::glob::glob;

  println!( "\n--- Test 3: Recursive Glob ---" );

  // Find all Rust files recursively
  let mut found_count = 0;
  for path in glob( "src/**/*.rs" ).expect( "valid pattern" ).flatten()
  {
    println!( "Found: {}", path.display() );
    found_count += 1;
  }

  println!( "✓ Found {found_count} .rs files recursively" );
}

#[ cfg( not( feature = "glob" ) ) ]
fn test_recursive_glob()
{
  println!( "\n--- Test 3: Recursive Glob ---" );
  println!( "⚠ Skipped (requires 'glob' feature)" );
}

/// Example 4: Pattern Matching (readme.md lines 71-78)
#[ cfg( feature = "glob" ) ]
fn test_pattern_matching()
{
  use fs_tools::glob::Pattern;

  println!( "\n--- Test 4: Pattern Matching ---" );

  let pattern = Pattern::new( "*.rs" ).expect( "valid pattern" );

  assert!( pattern.matches( "lib.rs" ), "Should match lib.rs" );
  assert!( !pattern.matches( "Cargo.toml" ), "Should not match Cargo.toml" );

  println!( "✓ Pattern matching works correctly" );
}

#[ cfg( not( feature = "glob" ) ) ]
fn test_pattern_matching()
{
  println!( "\n--- Test 4: Pattern Matching ---" );
  println!( "⚠ Skipped (requires 'glob' feature)" );
}