mirror of
https://github.com/eth-p/bat-extras.git
synced 2024-12-12 17:20:40 +01:00
2.2 KiB
2.2 KiB
bat-extras: batdiff
Diff a file against the current git index, or display the diff between two files.
This script supports using delta as an alternative highlighter for diffs.
Usage
batdiff [OPTIONS] FILE
batdiff [OPTIONS] FILE OTHER_FILE
batdiff --staged
Environment
| Variable | Description |
|---|---|
BATDIFF_USE_DELTA=true |
If delta is installed, use delta by default. |
Options
| Short | Long | Description |
|---|---|---|
-C |
--context=[LINES] |
The number of lines to show before and after the differing lines. |
--delta |
Display diffs using delta. |
|
--color |
Force color output. | |
--no-color |
Force disable color output. | |
--paging=["never"/"always"] |
Enable/disable paging. | |
--pager=[PAGER] |
Specify the pager to use. | |
--terminal-width=[COLS] |
Generate output for the specified terminal width. | |
--staged |
Show staged changes. |
Installation
This script is a part of the bat-extras suite of scripts. You can find install instructions here.
Caveats
When using bat as the printer:
- Syntax highlighting in diffs between two files is not supported.
- Syntax highlighting in a single-file diff requires
bat>= 0.15.
When using delta as the printer:
- The
--no-coloroption does not remove all color output.
Issues?
If you find an issue or have a feature suggestion, make a pull request or issue through GitHub! Contributions are always welcome.