Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/citizen428/repl
Wrap CLI tools in a REPL
https://github.com/citizen428/repl
cli golang repl tools
Last synced: 2 days ago
JSON representation
Wrap CLI tools in a REPL
- Host: GitHub
- URL: https://github.com/citizen428/repl
- Owner: citizen428
- License: mit
- Created: 2018-10-29T14:02:24.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2022-04-30T07:22:49.000Z (over 2 years ago)
- Last Synced: 2024-06-20T01:56:56.841Z (5 months ago)
- Topics: cli, golang, repl, tools
- Language: Go
- Homepage:
- Size: 11.7 KB
- Stars: 3
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# repl —- Add more read-eval-print-love in your life
`repl` is an interactive program which wraps non-interactive programs. Inspired by [Chris Wanstrath](https://github.com/defunkt)'s original [Ruby version](https://github.com/defunkt/repl). It comes with
line editing capabilities (including history and completions) provided by [liner](https://github.com/peterh/liner).
## Installation
### Homebrew
```sh
$ brew tap citizen428/homebrew-tap
$ brew install repl-go
```
### Release
Head over to the [release page](https://github.com/citizen428/repl/releases) and download the archive for your operating system/architecture.
### Manual
```sh
git clone https://github.com/citizen428/repl.git
cd repl
go build
```
## Examples
Ruby's gem command:
```
$ repl gem
gem>> --version
2.7.6
gem>> list --local
ast (2.4.0)
awesome_print (1.8.0)
bigdecimal (default: 1.3.4)
bundler (1.17.1, 1.16.6)
byebug (10.0.2)
cmath (default: 1.0.0)
[...]
```
Docker:
```
$ repl docker
docker>> version
Client:
Version: 18.06.1-ce
API version: 1.38
Go version: go1.10.3
Git commit: e68fc7a
Built: Tue Aug 21 17:21:31 2018
OS/Arch: darwin/amd64
Experimental: false
[...]
docker>> images
REPOSITORY TAG IMAGE ID CREATED SIZE
citizen428/unsavory latest abe19fd175b0 6 days ago 6.6MB
citizen428/unsavory v0.2.0 abe19fd175b0 6 days ago 6.6MB
golang alpine 95ec94706ff6 3 weeks ago 310MB
```
## Usage
```
$ repl
Usage:
repl cmd [options]
Options:
-compdir string
Directory for completion files (default "/Users//.repl")
-debug
Enable debug output
-histdir string
Directory for history file (default "/Users/")
```
## Completions
Since [liner](https://github.com/peterh/liner) supports completions, `repl` does too. Any file in
the directory specified via the `-compdir` option matching the name of the command you start `repl`
with will be used for completions.
For instance, a file named `~/.repl/redis-cli` containing "get set info" will cause "get", "set", and
"info" to be tab completeable at the `repl redis-cli` prompt.
This is compatible with the original [repl-completion](http://github.com/defunkt/repl-completion)
project, which contains a few common, pre-rolled completion files.
## Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/citizen428/repl.
## TODO
- [ ] Add tests
## License
The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).