Citrulu
Citrulu has now closed down. For more details see https://www.citrulu.com/.
The source code can be found at https://github.com/dxw/citrulu
Citrulu exposes an api for creating, editing and compiling test files. This gem provides a wrapper around that api which allows you to work with TestFile objects locally.
The gem has not yet been widely used. It's probably very unlikely to cause anything bad to happen in your app, but please use at your own risk and raise an issue if you find any bugs.
Installation
gem install citrulu
Or in your gemfile:
gem "citrulu"
Setup
You need an account on Citrulu to use the gem: Sign up at http://www.citrulu.com, and once you're signed in you can create an API key on the Account Settings page.
Configure your API key by adding it to an initializer:
#config/initializers/citrulu_auth.rb
CITRULU_API_KEY = "abcdefgh"
Usage
You can interact with TestFile instances in mostly the same way that you'd interact with a Rails model:
List test files
TestFile.all
Create a new test file
test_file = TestFile.new( name: "My first test file",
test_file_text: "On http://www.google.com",
run_tests: "true" )
test_file.save
# test files must have be successfully compiled before they will be run:
test_file.compile
Find a specific test file by and update it:
test_file = TestFile.find(23)
test_file.update(run_tests: false)
test_file.save
Delete a test file:
test_file = TestFile.find(23)
test_file.destroy
Contributing to the Citrulu gem
- 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.
Authors
Duncan Stuart (duncan@dxw.com)
Copyright
Copyright (c) 2012 The Dextrous Web Ltd. See LICENSE.txt for further details.