Jettywrapper Version Build Status

This gem is designed to make it easier to integrate a jetty servlet container into a rails project.
Jettywrapper provides rake tasks for starting and stopping jetty, as well as the method Jettywrapper.wrap that will start the server before the block and stop the server after the block, which is useful for automated testing.

By default, Jettywrapper is designed to work with Rails projects that use the Hydra gem, and downloads an instance of a hydra-jetty project zipfile. However, it can be configured to download any Jetty-based project on Github.

Jettywrapper supports

  • ruby 2.0.0
  • ruby 1.9.3
  • ruby 1.8.7
  • ree 1.8.7
  • jruby 1.6.6+

Configuring Jettywrapper

Jettywrapper starts the process with a list of options that you can specify in config/jetty.yml, otherwise a default is used. You can provide a per-environment configuration, or you can have a default configuration which will be used when a per-environment configuration is not specified. Such a configuration might look like:

default:
  jetty_port: 8983
  java_opts:
    - "-XX:MaxPermSize=128m"
    - "-Xmx256m"

You can also configure a specific version of hydra-jetty. This is placed in your codebase, usually in a rake task 

Jettywrapper.hydra_jetty_version = "v1.2.3"

Alternatively, you can use a completely different Jetty-based repository, Hydra-related or not

Jettywrapper.url = "https://github.com/myorg/my-jetty/archive/master.zip"

The name of the zip file can either be a branch name, such as master or develop, or the tag name of a released version. Basically, any url that Github provides as a *.zip file will work.

Example rake task

require 'jettywrapper'
Jettywrapper.url = "https://github.com/myorg/my-jetty/archive/testing-feature-branch.zip"
desc "Hudson build"
task :hudson do
  jetty_params = Jettywrapper.load_config.merge({:jetty_home => File.expand_path(File.dirname(__FILE__) + '/../jetty')})
  error = Jettywrapper.wrap(jetty_params) do  
    Rake::Task["spec"].invoke
  end
  raise "test failures: #{error}" if error
end

Testing the gem

If you haven't already, clone the git repository

git clone git@github.com:projecthydra/jettywrapper.git
cd jettywrapper

Install the gems

bundle install

Run the tests

rake