Bash scripts that integrate bat with various command line tools.
Go to file
2020-02-19 21:16:52 -08:00
.circleci Update CI to only test consistency if regular tests pass 2020-02-19 21:02:58 -08:00
.test-framework@83fd97724d Update 'best' to latest master 2020-02-19 21:01:59 -08:00
doc batman: Add support for MANPAGER environment variable 2020-02-15 15:10:18 -08:00
lib Fix pager_name to print name of unknown pagers 2020-01-17 20:50:26 -08:00
src batman: Add support for MANPAGER environment variable 2020-02-15 15:10:18 -08:00
test Add executable shim for tput to ensure consistent size 2020-02-19 21:10:56 -08:00
.gitignore Fix invalid markdown in README and add IDEA files to gitignore 2020-02-15 15:04:30 -08:00
.gitmodules Update to use 'best' for testing 2020-02-19 20:49:20 -08:00
build.sh Update to use 'best' for testing 2020-02-19 20:49:20 -08:00
LICENSE.md Added license. 2019-06-19 14:41:20 -07:00
README.md Fix invalid markdown in README and add IDEA files to gitignore 2020-02-15 15:04:30 -08:00
test.sh Use fake HOME for tests 2020-02-19 21:16:52 -08:00

bat-extras

Bash scripts that integrate bat with various command line tools.

 

Scripts

 

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 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.

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.