https://github.com/Xion/gisht

Gists in the shell
https://github.com/Xion/gisht

gists github pastebin runner rust scripting

Last synced: about 2 months ago
JSON representation

Gists in the shell

• Host: GitHub
• URL: https://github.com/Xion/gisht
• Owner: Xion
• License: gpl-2.0
• Created: 2016-08-21T00:37:23.000Z (about 8 years ago)
• Default Branch: master
• Last Pushed: 2023-04-03T19:27:03.000Z (over 1 year ago)
• Last Synced: 2024-06-29T06:01:51.064Z (3 months ago)
• Topics: gists, github, pastebin, runner, rust, scripting
• Language: Rust
• Size: 422 KB
• Stars: 27
• Watchers: 5
• Forks: 0
• Open Issues: 22
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# gisht

Gists in the shell

[![Build Status](https://img.shields.io/travis/Xion/gisht.svg)](https://travis-ci.org/Xion/gisht)

[![License](https://img.shields.io/github/license/Xion/gisht.svg)](https://github.com/Xion/gisht/blob/master/LICENSE)

With *gisht*, you can run scripts published as GitHub (or other) gists with a single command::

    gisht Xion/git-today

Behind the scenes, *gisht* will fetch the gist, cache it locally, and run its code.

Magic!

## Usage

    gisht [OPTIONS] [SUBCOMMAND]

    

    OPTIONS:

        -c, --cached     Operate only on gists available locally

        -f, --fetch      Always fetch the gist from a remote host

        -v, --verbose    Increase logging verbosity

        -q, --quiet      Decrease logging verbosity

        -H, --help       Prints help information

        -V, --version    Prints version information

    

    SUBCOMMANDS:

        run      Run the specified gist [aliases: exec]

        which    Output the path to gist's binary

        print    Print the source code of gist's binary [aliases: cat]

        open     Open the gist's webpage [aliases: show]

        info     Display summary information about the gist [aliases: stat]

        hosts    List supported gist hosts (services) [aliases: services]

        help     Prints this message or the help of the given subcommand(s)

    

    Hint: `gisht run GIST` can be shortened to just `gisht GIST`.

    If you want to pass arguments, put them after `--` (two dashes), like this:

    

    	gisht Octocat/greet -- "Hello world" --cheerful

## Installation

[Binaries are available](https://github.com/Xion/gisht/releases) for Linux and Mac.

If you use **Mac OS X**, `gisht` can be installed with **Homebrew**:

    brew tap Xion/gisht https://github.com/Xion/gisht.git

    brew install gisht

Windows binaries coming soon.

## Development

`gisht` is written in Rust. Besides the [Rust toolchain](http://rustup.sh), build requirements include:

* cmake 2.8.11 or higher (for compiling libgit2)

* OpenSSL 1.1 (for hyper)

  * on Linux, it likely means `libssl1.1`, `libssl-dev`, and/or equivalent package(s) must be installed

  * on OSX, besides the relevant package, it may also require adjusting some environment variables

  * (Windows unknown)

* Some Linux setups may require installing of `libssh-dev` and `pkg-config`.

Additionally, the Python-based [Invoke](http://pyinvoke.org) task runner is used for automation.

It is recommended you install it inside a Python virtualenv. e.g.:

    $ virtualenv ~/venv/gisht && source ~/venv/gisht/bin/activate

    $ pip install -r -requirements-dev.txt

Then you can use:

    $ inv

to build the binary and run tests.