Consular
Consular automates your development workflow setup.
Read the rest of the README and check out the wiki for more info!
Setup && Installation
Install the consular gem and init
:
$ gem install consular
$ consular init
This will generate a global path directory for your scripts to live in
at ~/.config/consular
and also a .consularc
in your home directory.
You can customize your Consular further with .consularc
. Say for
example, that you didn't like the default global path:
# ~/.consularc
Consular.configure do |c|
c.global_path = '/a/path/i/like/better'
end
IMPORTANT
After that, you'll need to install a 'core' so you can run Consular n your desired platform.
Cores
Cores allow Consular to operate on a variety of platforms. They abstract the general behavior that consular needs to run the commands. Each core inherits from (Consular::Core) and defines the needed methods. Some of the cores that are available are:
- OSX - Mac OS X Terminal
- iTerm - Mac OS X iTerm
- Terminator - Terminator
- Gnome - Gnome Terminal
- Gnome - Gnome Terminal Core that doesn't use xdotool
Feel free to contribute more cores so that Consular can support your terminal of choice :)
To integrate core support for your Consular, you can simply require it
in your .consularc
like so:
# .consularc
require 'consular/osx'
Or check the README of each individual core.
Development Setup
To begin development on Consular, run bundler:
$ gem install bundler
$ bundle install
The test suite uses Minitest to run the test run:
$ rake test
or use watchr:
$ watchr spec.watchr
Note on Patches/Pull Requests
- Fork the project.
- Make your feature addition or bug fix.
- Add tests for it. This is important so I don't break it in a future version unintentionally.
- Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
- Send me a pull request. Bonus points for topic branches.
Copyright
Copyright (c) (2011 - when the Singularity occurs) Arthur Chiu. See LICENSE for details.