X-Git-Url: https://git.armaanb.net/?p=gen-shell.git;a=blobdiff_plain;f=README.md;h=5b0e8356c34e5000384987693a1cd20d433bc4f2;hp=ead6bf44bdc06f7e3a6b9c23697455d85725c73c;hb=HEAD;hpb=6b00badf490a075f6520e0f856aaa68ae52e67d8 diff --git a/README.md b/README.md index ead6bf4..5b0e835 100644 --- a/README.md +++ b/README.md @@ -1,20 +1,20 @@ # gen-shell -![Jenkins](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fbuild.bhojwani.org%2Fjob%2Fgen-shell%2F) -A work in progress generic shell forked form [taskshell](https://github.com/GothenburgBitFactory/taskshell) +A simple way to turn any command into a REPL with arrow key/history support. -## Installation -Binaries can be downloaded [from here](https://build.bhojwani.org/job/gen-shell/lastSuccessfulBuild/artifact/build/src/gen-shell). Note that these binaries are compiled against libreadline7, so if your system only has libreadline8, you should symlink 8 to 7 with `sudo ln -s /usr/lib/x86_64-linux-gnu/libreadline.so.8.0 /usr/lib/x86_64-linux-gnu/libreadline.so.7`. This isn't a great solution, but it gets the job done. +## Usage +See `gen-shell --help` -If you would like to avoid this, you can build from source. Doing so requires: - - CMake - - g++ - - libreadline development files +## Installation +Dependencies: + - POSIX make + - a c++ compiler and standard library + - libreadline development files (7 or 8 is fine, 5 is untested) +```bash +make +make install ``` -git clone https://codeberg.org/armaan/gen-shell -cd gen-shell -cmake --build . -sudo cp src/gen-shell /usr/bin/ -``` -Or if you don't have root access, you can subsitute the last line with -`cp src/gen-shell ~/.local/bin` +## License +Following suit from taskshell, gen-shell is MIT licensed by Armaan Bhojwani, 2021. Gen-shell is forked from taskshell, which was developed by [these people](https://github.com/GothenburgBitFactory/taskshell/blob/master/AUTHORS). + +Gen-shell uses the [Sarge library](https://github.com/MayaPosch/Sarge) for parsing command-line arguments. Sarge was written by Maya Posch and is BSD 3-Clause licensed.