litcat 0.1.4

A CLI tool for viewing patches with colors
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

# litcat

**litcat** is a simple Rust CLI tool for viewing patch and diff files with  highlighting. It colors added (`+`), removed (`-`), and context lines to make git diffs easier to read in your terminal.


## Features

- Colors added lines in **green**
- Colors removed lines in **red**
- Colors diff headers and hunk markers
- Reads from a file or standard input (pipe)


## Usage

### From a patch file

```sh
litcat xxx.patch
```

### Accepting stdin 

```sh
cat diff.patch | litcat
```

## Example Output

- Lines starting with `+` (but not `+++`) are **green**
- Lines starting with `-` (but not `---`) are **red**
- Diff headers (`+++`, `---`) are **cyan**
- Hunk markers (`@@ ... @@`) are **yellow**
- All other lines are default color


## Installation

### 1. Build from Source

1. Clone the repo:
    ```sh
    git clone https://github.com/shan-shaji/litcat.git
    cd litcat
    ```
2. Build:
    ```sh
    cargo build --release
    ```
3. Copy the build to `~/.cargo/bin`.
4. Run as shown above.

### 2. Install from crates.io

you can install directly using cargo:

```sh
cargo install litcat
```

## Dependencies

- [clap](https://crates.io/crates/clap) for CLI argument parsing
- [colored](https://crates.io/crates/colored) for colored terminal output