Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sodiumjoe/lobar
A thin shell wrapper for lodash.chain().
https://github.com/sodiumjoe/lobar
cli interactive javascript lodash nodejs shell
Last synced: 2 months ago
JSON representation
A thin shell wrapper for lodash.chain().
- Host: GitHub
- URL: https://github.com/sodiumjoe/lobar
- Owner: sodiumjoe
- Created: 2016-04-13T09:14:23.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2019-01-09T21:48:22.000Z (over 5 years ago)
- Last Synced: 2024-04-24T23:41:07.752Z (5 months ago)
- Topics: cli, interactive, javascript, lodash, nodejs, shell
- Language: JavaScript
- Homepage:
- Size: 744 KB
- Stars: 28
- Watchers: 4
- Forks: 1
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# lobar
A thin shell wrapper for [lodash.chain()](https://lodash.com/).
## install
```shell
> npm install -g lobar
```
## usage
```shell
> lbr -h
Usage: lbr [method arg, ...] [options]
Options:
-d, --data input json [string]
-f, --filename input json file [string]
-v, --verbose verbosity level [count]
-p, --prettyPrint pretty print output [boolean]
-i, --interactive interactive mode [boolean]
-h, --help Show help [boolean]
-V, --version Show version number [boolean]
Examples:
lbr -d '["foo"]' map upperCase ["FOO"]
echo '{"foo": "bar"}' | lbr get foo "bar"
echo '{"foo": "bar"}' | lbr .foo "bar"
```
### pipe
```shell
$ echo '[{"foo":"bar"}, {"foo":"baz"}]' | lbr map foo
> ["bar","baz"]
```
You also have access to lodash methods inside of the method calls:
```shell
$ echo '[{"foo":"bar"}, {"foo": 3}]' | lbr filter 'x => isString(x.foo)'
> [{"foo":"bar"}]
```
### shorthands
A leading `.` on an argument is shorthand for `get`:
```shell
$ echo '{"foo": {"bar": "baz"}}' | lbr .foo.bar
> "baz"
```
is equivalent to:
```shell
$ echo '{"foo": {"bar": "baz"}}' | lbr get foo.bar
> "baz"
```
### interactive mode
```shell
$ curl https://registry.npmjs.com/lobar | lbr -i
```
#### vi keybindings
Interactive mode has basic vi keybindings. It starts in `insert` mode.
##### autocompletion
In insert mode, lobar will try to infer methods or argument from method/arg
position and evaluated JSON at the current cursor position. ``/`` or
``/`` to navigate the completion list.
##### normal mode
Hitting `esc` will drop you into normal mode, where you can move horizontally
with `h`, `l`, `b`, `w`, `e`, `t`, `f`, `T`, `F`, `0`, and `$`. You can also use
`c` and `d` with those movements in addition to `i` and `a` with a character or
one of `{}[]{}'"`. Vertical movement ('j', 'k', ``, ``), will scroll the
json output.
`u` to undo and `` to redo.
`y` will copy your current prompt input to your clipboard.
`` to exit or `enter` to exit and print the currently evaluated json to
`stdout`.
### caveats
If you want to use a string argument for a method that collides with a lodash
method name, you'll have to quote it twice:
```shell
echo '[{"isString": true}]' | lbr filter "'isString'"
[{"isString":true}]
```
This is because `lbr` tries to `eval` the argument with lodash as the context.
```shell
echo '[{"isString": true}]' | lbr filter isString
[]
```
### environment variables
You can set options using environment variables:
```shell
$ LOBAR_PRETTY_PRINT=true lbr -d '{"foo": "bar"}' .foo
> "bar"
```
## why?
I really like [jq](https://stedolan.github.io/jq/), but I have to look up the
syntax all the time. As a javascript developer, I already know lodash, and it's
generally enough for what I want to do at the command line.