X-Git-Url: https://git.armaanb.net/?a=blobdiff_plain;f=README.md;h=c22b212240fcead9a9aa764773521e46986169d2;hb=be112929a782f5f2cc6605a3f3a2b38db49c1d0d;hp=72a4662cfbbc6c001606f5f2d9f9738468f14955;hpb=53bdc8a2876b57840010d5708b20dca3a46bcef5;p=gen-shell.git diff --git a/README.md b/README.md index 72a4662..c22b212 100644 --- a/README.md +++ b/README.md @@ -1,20 +1,29 @@ # 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. This is a very reduced fork of [taskshell](https://github.com/GothenburgBitFactory/taskshell) +[![builds.sr.ht status](https://builds.sr.ht/~armaan/gen-shell/commits/.build.yml.svg)](https://builds.sr.ht/~armaan/gen-shell/commits/.build.yml?) + +A simple way to turn any command into a shell with arrow key/history support (if compiled with libreadline). Forked from [taskshell](https://github.com/GothenburgBitFactory/taskshell). + +## Usage +See `gen-shell --help` ## 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. +### From a binary +Binaries can be downloaded from [here](https://builds.sr.ht/~armaan/gen-shell/commits/.build.yml). NB: these binaries are compiled against libreadline version 8 -If you would like to avoid this, you can build from source. Doing so requires: - - CMake - - g++ - - libreadline development files +### From source +Dependencies: + - cmake (2.8 or higher) + - make + - g++ (sometimes packaged as gcc-c++ or gcc-g++) + - libreadline development files (7 or 8 is fine, 5 is untested) (optional, but highly recommended) -``` -git clone https://codeberg.org/armaan/gen-shell +```bash +git clone https://git.sr.ht/~armaan/gen-shell cd gen-shell -cmake --build . -sudo cp src/gen-shell /usr/bin/ +cmake . +sudo make install ``` -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, 2020. 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.