Core functionality for CanTango
Status: Dec 1 2011
The core CanTango component is now almost fully spec'ed and functional. Core should not dependencies to any other CanTango components but should stand on its own. All other CanTango components can rely on core for "core" functionality :)
CanTango has been tested to work with Ruby 1.9+ and currently doesn't support Ruby 1.8.7 If you require ruby 1.8.7 support, please help patch it and make a pull request ;)
Install in Ruby environment (or gem set)
gem install cantango-core
Install in Rails application
Insert into Gemfile of your Rails application:
If you want to live on the edge and use the latest master branch, use the
:git option. To designate a specific branch, use the
:branch option. You can also clone this project and reference your local copy (easier to debug/fix) by using the
:path option (see Bundler documentation).
Run bundler in a terminal/console from the folder of your Gemfile (root folder of the app)
CanTango core extensions
The following CanTango components extend core:
To extend core, you should follow the CanTango extension conventions. We will demonstrate these conventions using the -api extension as an example. The extension file structure should look like this:
/cantango /api /api_ext api.rb api_ext.rb_
The main API logic should go in the
cantango/api folder. Extensions to core go into the
cantango/api_ext folder. The extensions should use the same folder structure as core if possible.
Contributing to cantango-core
- Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
- Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
- Fork the project
- Start a feature/bugfix branch
- Commit and push until you are happy with your contribution
- Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
- Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
Copyright (c) 2011 Kristian Mandrup. See LICENSE.txt for further details.