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
$ gem install consular $ consular init
This will generate a global path directory for your scripts to live in
~/.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 . do |c| c.global_path = '/a/path/i/like/better' end
After that, you'll need to install a 'core' so you can run Consular on your desired platform.
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:
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
.consularc like so:
# .consularc require 'consular/osx'
Or check the README of each individual core.
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 (c) (2011 - when the Singularity occurs) Arthur Chiu. See LICENSE for details.