https://github.com/deptno/hosejs

:male_detective: Alternative jq, for javascripter
https://github.com/deptno/hosejs

better-jq javascript-cli javascript-tools jq jq-alternative json json-pipeline json-transformation

Last synced: 2 months ago
JSON representation

:male_detective: Alternative jq, for javascripter

• Host: GitHub
• URL: https://github.com/deptno/hosejs
• Owner: deptno
• License: mit
• Created: 2018-05-20T10:07:54.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2018-05-28T17:08:29.000Z (almost 7 years ago)
• Last Synced: 2025-03-14T22:04:23.630Z (2 months ago)
• Topics: better-jq, javascript-cli, javascript-tools, jq, jq-alternative, json, json-pipeline, json-transformation
• Language: TypeScript
• Homepage:
• Size: 469 KB
• Stars: 11
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# HoseJS [![CircleCI](https://circleci.com/gh/deptno/hosejs.svg?style=svg)](https://circleci.com/gh/deptno/hosejs)

[![npm](https://img.shields.io/npm/dt/hosejs.svg?style=for-the-badge)](https://www.npmjs.com/package/hosejs)

> :tada: Data handling with ramda.js (version 1.3 or higher)

![hosejs](https://github.com/deptno/hosejs/raw/master/asset/hosejs.gif)

> 100% code coverage.

You can transform JSON(or NOT) data with just **JavaScript** in terminal.

`jq`? javascript is clearly better option for people already use javascript.

## Feature

### Data handling with ramda.js (version 1.3 or higher)

You can use [ramda.js](https://ramdajs.com>)

eg. `http https://swapi.co/api/people/1/ | j -r "props(['name', 'height'])"`  

eg. `http https://swapi.co/api/people/1/ | j -ramda "props(['name', 'height'])"`  

eg. `http https://swapi.co/api/people/1/ | j "props(['name', 'height'])(_)"`

## Options

- `--file` option provide you to apply pre-defined script first

- `--tab` if result is Object, print JSON format with specified tab size (default: 2)

## Install

```

npm -g install hosejs

```

## Command

`j` or `js`

## Usage

`_` is everything you need to know

```bash

$ cat some.json | j '_.map(x => x.timestamp)'

$ cat some.json | j '_.map(x => x.timestamp)' --tab 4

$ cat some.json | j '_.map(x => x.timestamp)' --file pre.js --tab 2

$ cat some.json | j '_.map(x => x.timestamp)' > some.json

$ cat some.json | j '[_].map(x => x.some_property + '👍')[0]'

$ cat some.json | j '_.map(x => new Date(x.timestamp).toISOString())'

$ cat some.json | j --file preload.js '_.map(x => x.timestamp)'

$ http https://swapi.co/api/people/ | j 'Object.keys(_)'

$ http https://swapi.co/api/people/ | j '_.count'

$ http https://swapi.co/api/people/ | j '_.results.map(x => x.name)'

$ echo 'not json string \n !!' | j '_.split("\n")'

$ http https://swapi.co/api/people/1/ | j -r "props(['name', 'height'])"  

$ http https://swapi.co/api/people/1/ | j -ramda "props(['name', 'height'])"  

$ http https://swapi.co/api/people/1/ | j "props(['name', 'height'])(_)"

```

### Inject script file

#### IIFE

```js

// cw-oneline.js

(() => {

  const time = time => new Date(time).toISOString().slice(0, -5).replace('T', ' ')

  return _.map(x => `${time(x.timestamp)} ${x.message}`)

})()

```

```bash

cat downloaded-cw-log.json | j -f cw-oneline.js > deptno.latest.json

```

> Hmm ... Is it easy to look upside down?

add `_.reverse()`

```bash

cat downloaded-cw-log.json | j -f cw-oneline.js '_.reverse()' > deptno.latest.json

```

## Related

- [cwlog](https://github.com/deptno/cwlog) 🐾 cli AWS Cloudwatch Logs Downloader

- [post](https://medium.com/@deptno/hosejs-jq-그냥-javascript-합시다-64bda90967d8)

## License

MIT