Skip to content

Latest commit

 

History

History
61 lines (39 loc) · 1.77 KB

README.md

File metadata and controls

61 lines (39 loc) · 1.77 KB

GST

gst is like gs. The t is for Tonchis.

TL;DR

gst is a gemset manager inspired by gs. The difference is that it stays in the same shell and just modifies gem env variables. To be compatible with gs, it uses a .gs directory and sets the GS_NAME variable.

USAGE

Since gst is a script and runs in a child environment of your shell, the latter will not take the env changes unless you source them.

$ gst init
$ source gst in
$ source gst out

Protip: in bash, . is the same as source.

You can also run commands in the gemset using gst in without sourcing. This will execute them in the proper gem context but will not affect the current shell.

$ gst in gem env home

COMMANDS

init    Creates the .gs directory
in      Modifies GEM_HOME, GEM_PATH and PATH to use the .gs directory and sets the GS_NAME variable.
out     Restores the previous GEM_HOME, GEM_PATH and PATH. Also unsets GS_NAME.

INSTALLATION

With Homebrew

brew tap tonchis/goodies && brew install gst

And for the standalone version, here's a oneliner.

$ wget https://raw.githubusercontent.com/tonchis/gst/master/bin/gst && chmod +x gst && sudo mv gst /usr/local/bin

WHY?

As I was using gs I noticed it wouldn't play well with chruby.

The issue was the collision between the way gs works, by modifying the gem env variables and firing up a new shell with them, and the fact that chruby also sets those variables when using the autoload script or the chruby command.

The last one being in my .zshrc script, it was stepping over gs's work.

Thus I decided to write my own gemset manager that doesn't run a new shell, but uses the current one.