1 unstable release
0.1.0 | Jan 4, 2021 |
---|
#64 in #unix-socket
18KB
371 lines
abra
A tool that makes data sharing between terminal windows easy.
abra can be used for displaying info about the current working directory, for splitting stdout and stderr and much more.
Table of contents
- Installation
- Basic concepts
- Common use cases
- Advantages over named pipes
- Forcing colorized output
- Similar tools
- Etymology
Installation
The recommended way to install abra is by running:
brew install denisidoro/tools/abra
You can also run:
cargo install abra-cli
If these package managers aren't available, you can download a pre-compiled binary here and extract it to your $PATH
.
Basic concepts
- abra is built over Unix sockets
- it can publish and subscribe to channels, manipulating text as necessary
- no terminal multiplexers are necessary
Common use cases
Some abra calls are quite verbose, so the use of aliases is recommended.
File tree sidebar
Since this is a very common use case, abra provides a hook for you.
If you call the following...
eval "$(abra hook bash)" # If you use bash, add this to ~/.bashrc
eval "$(abra hook zsh)" # If you use zsh, add this to ~/.zshrc
Then you can open a new terminal window and call abra rx --channel pwd --cmd 'ls {}'
.
Whenever you cd
into a directory, the sidebar will reflect the changes.
Split stdout and stderr into different windows
Let's say that you want to run some tests but errors should appear in a different window.
You can use anonymous pipes with abra for that purpose:
The commands are:
abra rx --channel test_out # window 1
abra rx --channel test_err # window 2
cargo test > >(abra tx --channel test_out) 2> >(abra tx --channel test_err) # window 3
Filter some output lines
Let's say you want to see the contents of a file in a window but show only the lines that contain "foo" in another window:
abra rx --channel filter --cmd 'echo "{}" | grep foo' # window 1
cat myfile.txt |& tee >(abra tx --channel filter) # window 2
Forcing colorized output
Some CLIs will detect that they are being piped and will hide color information by default.
To circumvent this, each CLI may offer different paramenters: --color=always
and export COLORTERM=truecolor
are some examples.
In some cases, you need to trick an application into thinking its stdout is a terminal, not a pipe. For these cases you can call abra faketty --cmd '<your command>'
.
Advantages over named pipes
In theory, you could run the following to achieve similar results:
mkfifo tmp
tail -f tmp
echo foo > tmp # in another window
That said:
- with abra you don't need to worry about creating/removing named pipes
echo foo > tmp
is blocking in casetmp
isn't open for readingabra tx
will terminate immediately if there's noabra rx
process
- you can have many
abra rx
windows reacting to the sameabra tx
call - abra is cross-platform
- to correctly create temporary named pipes you need to write platform-specific code
Similar tools
Etymology
Dependencies
~4–13MB
~131K SLoC