Bash scripts that integrate bat with various command line tools.
Go to file
2020-10-04 00:58:28 -07:00
.circleci ci: Build manuals 2020-05-15 21:13:15 -07:00
.test-framework@7787a2d04f test: Update test framework 2020-05-06 18:52:53 -07:00
doc Update prettybat caveats for header display fix (#39) 2020-10-02 19:50:48 -07:00
lib lib: Add DEFAULT color to printc 2020-10-04 00:40:05 -07:00
src batgrep: Add simple parsing of RIPGREP_CONFIG_PATH. 2020-10-02 20:09:00 -07:00
test lib: Add option parsing for short flags followed by number 2020-07-06 18:03:30 -07:00
.gitignore build: Add experimental support for generating manpages 2020-05-15 21:05:46 -07:00
.gitmodules Format with vs-shell-format 2020-04-01 02:55:41 +02:00
banner.txt developer: Add copyright/info banner to compressed scripts 2020-04-16 23:41:06 -07:00
build.sh build.sh: Add option to prevent full executable paths from inlining 2020-10-04 00:56:01 -07:00
CONTRIBUTING.md docs: Add CONTRIBUTING.md 2020-04-27 01:45:14 -07:00
LICENSE.md Added license. 2019-06-19 14:41:20 -07:00
mdroff.sh build: Add experimental support for generating manpages 2020-05-15 21:05:46 -07:00
README.md build: Add experimental support for generating manpages 2020-05-15 21:05:46 -07:00
release.sh release.sh: Stop packages from inlining alternate executable names 2020-10-04 00:57:57 -07:00
test.sh test: Fix argument values given to test.sh not being passed to Best 2020-04-27 18:51:36 -07:00
version.txt Bump version to 2020.10.04 2020-10-04 00:58:28 -07:00

bat-extras

Bash scripts that integrate bat with various command line tools.

 

Scripts

batgrep

Quickly search through and highlight files using ripgrep. Requirements: ripgrep

batman

Read system manual pages (man) using bat as the manual page formatter.

batwatch

Watch for changes in one or more files, and print them with bat. Requirements: entr (optional)

batdiff

Diff a file against the current git index, or display the diff between two files. Requirements: bat, delta (optional)

prettybat

Pretty-print source code and highlight it with bat. Requirements: (see doc/prettybat.md)

 

Installation via Package Manager

Homebrew: brew install eth-p/software/bat-extras

 

Installation (CircleCI)

The scripts in this repository are designed to run as-is, provided that they aren't moved around. This means that you're free to just symlink src/[script].sh to your local bin folder.

If you would rather have faster, self-contained scripts that you can place and run anywhere, you can use the build.sh script to create (and optionally install) them.

 

Building:

./build.sh [OPTIONS...]

This will combine and preprocess each script under the src directory, and create corresponding self-contained scripts in the bin folder. Any library scripts that are sourced using source "${LIB}/[NAME].sh" will be embedded automatically.

 

Minification:

There are three different options for minification:

Option Description
--minify=none Nothing will be minified.
--minify=lib Embedded library scripts will be minified. [default]
--minify=all Everything will be minified.

This uses shfmt to perform minification.

 

Installation:

You can also specify --install and --prefix=PATH to have the build script automatically install the scripts for all users on the system. You may need to run the build script as root.

If you only want to install a single script, you can run the build process and copy the script directly out of the newly-created bin folder.

Manuals: (EXPERIMENTAL)

You can specify --manuals to have the build script generate a man page for each of the markdown documentation files. This is an experimental feature that uses a non-compliant Markdown "parser" written in Bash, and there is no guarantee as for the quality of the generated manual pages.

Alternate Executable:

Depending on the distribution, bat may have been renamed to avoid package conflicts. If you wish to use these scripts on a distribution where this is the case, there is an --alternate-executable=NAME option which will build the scripts to use an alternate executable name.

Verification:

The build script will attempt to verify the correctness of the "bin" scripts by comparing their output with their source counterparts. It is recommended to let it do this, but you can disable verification with the --no-verify option.

 

Contributing

If you would like to contribute to bat-extras, please feel free to open an issue on GitHub, or make a pull request. If you do the latter, please keep our contributing guidelines in mind.