The best way to install gas is with RubyGems:
$ [sudo] gem install gas
You can install from source:
$ cd gas/ $ bundle $ rake install
- add NICKNAME NAME EMAIL - adds a new user to gas
- delete NICKNAME - deletes a user from gas
- import NICKNAME - imports the user from .gitconfig into NICKNAME
- list - lists all users
- plugins - lists all installed plugins
- show - shows the current user
- use NICKNAME - sets the user with NICKNAME as the current user
The default task is to list authors
$ gas $ gas list
This lists the authors that are set up in the ~/.gas/gas.users file.
You can import your current user by giving it a nickname
$ gas import current_user
To add an author use, add
$ gas add walle "Fredrik Wallgren" firstname.lastname@example.org
And the main usage, use
$ gas use walle
To delete it again use, delete
$ gas delete walle
View the help using
$ gas -h
Gas is built to be extendable, it uses the same way git does. Any executable in your PATH named gas-yourplugin is useable with gas. This means you can write extensions for gas in any language you want, the only thing you need to do is make it accessable by putting it in PATH.
To extend already existing commands make an executable with the name gas-yourplugin-existingcommand eg. gas-stats-use to do something when the original use command is executed. This makes it possible to extend plugins too eg. gas-myplugin-stats will extend the stats command, if installed.
An example plugin exists at https://github.com/walle/gas_stats it's written in ruby, and distributed with rubygems. But this is not a requirement. It extends gas both with adding functionality to built-in commands(counting statistics) and adding own functionality(gas-stats).
Shows usage statistics for gas. Serves as a reference implementation of a plugin.
Installation: $ gem install gas_stats
Author: Fredrik Wallgren
Adds ssh support for gas.
Work in progress right now.
Installation: $ gem install gas_ssh