pathmaster 0.3.0

pathmaster is a powerful command-line tool written in Rust for managing your system's PATH environment variable.
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

# Shell Support

pathmaster provides comprehensive support for various shell environments, ensuring consistent PATH management across different shells.

## Supported Shells

### bash
- Primary shell support
- .bashrc management
- PATH export handling
- Environment variable support

### zsh
- Full zsh compatibility
- .zshrc management
- path array support
- Framework compatibility

### fish
- Modern shell support
- config.fish handling
- fish_add_path support
- Universal variable handling

### tcsh/csh
- C shell compatibility
- .tcshrc management
- setenv PATH support
- Shell-specific syntax

### ksh
- Korn shell support
- .kshrc management
- typeset handling
- Shell initialization order

## Configuration Management

### File Detection
- Automatic shell detection
- Proper config file location
- Framework awareness
- Permission handling

### File Modifications
- Safe configuration updates
- Automatic backups
- Syntax preservation
- Error handling

### Shell Integration
- Framework compatibility
- Plugin support
- Custom configuration
- Path management commands

## Shell-Specific Features

### bash/zsh Features
```bash
# PATH modification
export PATH="/new/path:$PATH"

# Array handling
path=(/usr/bin /usr/local/bin) && export PATH
```

### fish Features
```bash
# PATH modification
fish_add_path /new/path

# Universal variables
set -U fish_user_paths /new/path $fish_user_paths
```

### tcsh Features
```bash
# PATH modification
setenv PATH /new/path:$PATH

# Path array
set path = (/usr/bin /usr/local/bin)
```

## Framework Support

### Oh My Zsh
- Compatible with custom plugins
- Preserves theme configurations
- Handles custom PATH modifications
- Framework-specific backup support

### Oh My Fish
- Supports fish_add_path
- Maintains framework structure
- Plugin compatibility
- Custom function preservation

## Best Practices

### Configuration Updates
1. Use shell-appropriate commands
2. Verify configuration changes
3. Test PATH modifications
4. Maintain backups

### Framework Integration
1. Check framework compatibility
2. Use framework-specific methods
3. Test with custom configurations
4. Document special requirements