orcli (💎+🤖)

Bash script to control OpenRefine via its HTTP API.

Features

works with latest OpenRefine version (currently 3.6)
run batch processes (import, transform, export)
- orcli takes care of starting and stopping OpenRefine with temporary workspaces
- allows execution of arbitrary bash scripts
- interactive mode for playing around and debugging
- your existing OpenRefine data will not be touched
import CSV, ~~TSV, line-based TXT, fixed-width TXT, JSON or XML~~ (and specify input options)
- supports stdin, multiple files and URLs
transform data by providing an undo/redo JSON file
- orcli calls specific endpoints for each operation to provide improved error handling and logging
- supports stdin, multiple files and URLs
export to TSV, ~~CSV, HTML, XLS, XLSX, ODS~~
~~templating export to additional formats like JSON or XML~~

wget https://github.com/opencultureconsulting/orcli/raw/main/orcli
chmod +x orcli

Optional:

Create a symlink in your $PATH (e.g. to ~/.local/bin)
```
ln -s "${PWD}/orcli" ~/.local/bin/
```

Install Bash tab completion

permanently

mkdir -p ~/.bashrc.d
orcli completions > ~/.bashrc.d/orcli

./orcli run --interactive

orcli import csv "https://git.io/fj5hF" --projectName "duplicates"

orcli info "duplicates"

Remove duplicates (coming soon)
Export data from OpenRefine project to tab-separated-values (TSV) file duplicates.tsv

orcli export tsv "duplicates" --output "duplicates.tsv"

Write out your session history to file example.sh (and delete the last line to remove the history command)

history -a "example.sh"
sed -i '$ d' example.sh

exit

./orcli run example.sh

rm duplicates.tsv
rm example.sh

Use integrated help screens for available options and examples for each command.
```
orcli --help
```
If your OpenRefine is running on a server, then use the environment variable OPENREFINE_URL.
```
OPENREFINE_URL="http://localhost:3333" orcli list
```

orcli uses bashly for generating the one-file script from files in the src directory

gem install bashly

bashly generate --upgrade