bpwd 0.4.0

A better pwd
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

# bpwd

A better pwd with clipboard support and targeting.

## Installation

### Homebrew (macOS/Linux)

```bash
brew install CodeTease/tap/bwd
```

### Scoop (Windows)

```bash
scoop bucket add codetease https://github.com/CodeTease/scoop-bucket
scoop install bwd
```

### Cargo

```bash
cargo install bpwd
```

### Release

You can also download the binary from the [Release page](https://github.com/CodeTease/bpwd/releases).

For more download methods, see [INSTALLATION.md](INSTALLATION.md).

## Usage

```bash
bwd [target] [-c] [-s] [-j] [-r]
```

- `target`: Optional path to resolve relative to current directory. Use `--` to separate flags from arguments (e.g., `bwd -- -my-dir`).
- `-c`: Copy the result to clipboard.
- `-s`: Shorten path (replace home directory with `$HOME` or `%USERPROFILE%`).
- `-j`: Output path information as JSON.
- `-r`: Print path relative to project root (searches for `.git` or `.bwd-root`).

### Examples

**Standard Output (Absolute Path)**
```bash
$ bwd
/home/codetease/projects/bpwd
```

**Shortened Path (`-s`)**
```bash
$ bwd -s
$HOME/projects/bpwd
```

**JSON Output (`-j`)**
```bash
$ bwd -j
{"path":"/home/codetease/projects/bpwd","short":"$HOME/projects/bpwd","root":"."}
```

**Priority Logic**
1. **JSON (`-j`)**: Always outputs the JSON object.
2. **Short (`-s`)**: If JSON is not requested, outputs the shortened path.
3. **Default**: Outputs the absolute path.