Skip to content
This repository

Update README.md

latest commit bb1233c183
Arthur Chiu authored
Octocat-spinner-32 bin clean up old terminitor stuff
Octocat-spinner-32 lib version bump 1.0.2
Octocat-spinner-32 spec add create command for CLI closes #1
Octocat-spinner-32 .gitignore add Gemfile.lock to ignore
Octocat-spinner-32 Gemfile initial commit
Octocat-spinner-32 LICENSE add MIT LICENSE
Octocat-spinner-32 README.md Update README.md
Octocat-spinner-32 Rakefile clean up old terminitor stuff
Octocat-spinner-32 Termfile clean up Termfile
Octocat-spinner-32 consular.gemspec more clean up
Octocat-spinner-32 spec.watchr add watchr
README.md

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.

Something went wrong with that request. Please try again.