claude_core 1.0.0

Shared Claude Code primitives: path topology and process utilities
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
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159

//! `ClaudePaths` unit tests
//!
//! ## Purpose
//!
//! Verify that `ClaudePaths` constructs all canonical `~/.claude/` paths
//! correctly from the `HOME` environment variable and returns `None` when
//! `HOME` is absent.
//!
//! ## Coverage
//!
//! - `ClaudePaths::new()` returns `None` when `HOME` is unset
//! - `ClaudePaths::new()` succeeds when `HOME` is set
//! - All path accessors return paths with the correct structure
//! - Paths are relative to the provided `HOME`, not the real user home
//!
//! ## Test Matrix
//!
//! | Test | Scenario |
//! |------|----------|
//! | `paths_new_returns_some_with_home` | HOME set → Some |
//! | `paths_base_ends_with_dot_claude` | base path suffix |
//! | `paths_credentials_file_correct` | .credentials.json path |
//! | `paths_accounts_dir_correct` | accounts/ path |
//! | `paths_projects_dir_correct` | projects/ path |
//! | `paths_stats_file_correct` | stats-cache.json path |
//! | `paths_settings_file_correct` | settings.json path |
//! | `paths_session_env_dir_correct` | session-env/ path |
//! | `paths_sessions_dir_correct` | sessions/ path |
//! | `paths_rooted_at_provided_home` | custom HOME → rooted there |
//!
//! ## Note on None path
//!
//! `ClaudePaths::new()` returns `None` when `HOME` is unset. This path
//! cannot be tested here because `std::env::remove_var` requires `unsafe`
//! which is denied workspace-wide. The None path is covered by code review.

use claude_core::ClaudePaths;

#[test]
fn paths_new_returns_some_with_home()
{
  std::env::set_var( "HOME", "/tmp/test_home" );
  assert!( ClaudePaths::new().is_some(), "expected Some when HOME is set" );
}

#[test]
fn paths_base_ends_with_dot_claude()
{
  std::env::set_var( "HOME", "/tmp/test_home" );
  let p = ClaudePaths::new().expect( "HOME is set" );
  assert!(
    p.base().ends_with( ".claude" ),
    "base must be $HOME/.claude, got: {}",
    p.base().display()
  );
}

#[test]
fn paths_credentials_file_correct()
{
  std::env::set_var( "HOME", "/tmp/test_home" );
  let p = ClaudePaths::new().expect( "HOME is set" );
  let f = p.credentials_file();
  assert!(
    f.ends_with( ".claude/.credentials.json" ),
    "expected .claude/.credentials.json, got: {}",
    f.display()
  );
}

#[test]
fn paths_accounts_dir_correct()
{
  std::env::set_var( "HOME", "/tmp/test_home" );
  let p = ClaudePaths::new().expect( "HOME is set" );
  let d = p.accounts_dir();
  assert!(
    d.ends_with( ".claude/accounts" ),
    "expected .claude/accounts, got: {}",
    d.display()
  );
}

#[test]
fn paths_projects_dir_correct()
{
  std::env::set_var( "HOME", "/tmp/test_home" );
  let p = ClaudePaths::new().expect( "HOME is set" );
  let d = p.projects_dir();
  assert!(
    d.ends_with( ".claude/projects" ),
    "expected .claude/projects, got: {}",
    d.display()
  );
}

#[test]
fn paths_stats_file_correct()
{
  std::env::set_var( "HOME", "/tmp/test_home" );
  let p = ClaudePaths::new().expect( "HOME is set" );
  let f = p.stats_file();
  assert!(
    f.ends_with( ".claude/stats-cache.json" ),
    "expected .claude/stats-cache.json, got: {}",
    f.display()
  );
}

#[test]
fn paths_settings_file_correct()
{
  std::env::set_var( "HOME", "/tmp/test_home" );
  let p = ClaudePaths::new().expect( "HOME is set" );
  let f = p.settings_file();
  assert!(
    f.ends_with( ".claude/settings.json" ),
    "expected .claude/settings.json, got: {}",
    f.display()
  );
}

#[test]
fn paths_session_env_dir_correct()
{
  std::env::set_var( "HOME", "/tmp/test_home" );
  let p = ClaudePaths::new().expect( "HOME is set" );
  let d = p.session_env_dir();
  assert!(
    d.ends_with( ".claude/session-env" ),
    "expected .claude/session-env, got: {}",
    d.display()
  );
}

#[test]
fn paths_sessions_dir_correct()
{
  std::env::set_var( "HOME", "/tmp/test_home" );
  let p = ClaudePaths::new().expect( "HOME is set" );
  let d = p.sessions_dir();
  assert!(
    d.ends_with( ".claude/sessions" ),
    "expected .claude/sessions, got: {}",
    d.display()
  );
}

#[test]
fn paths_rooted_at_provided_home()
{
  std::env::set_var( "HOME", "/custom/home" );
  let p = ClaudePaths::new().expect( "HOME is set" );
  let base = p.base().to_str().expect( "valid UTF-8 path" );
  assert!(
    base.starts_with( "/custom/home" ),
    "paths must be rooted at the provided HOME, got: {base}"
  );
}