Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
TorqueBox Ruby Platform
Ruby Java HTML Other

This branch is 800 commits behind master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
build
docs
examples
gems
integration-tests
licenses
modules
support
.gitignore
README.md
pom.xml

README.md

Requirements

  • Maven 3
  • Configuration of the JBoss Maven repository in settings.xml

Dependencies

TorqueBox depends on polyglot: https://github.com/projectodd/jboss-polyglot

Polyglot is published as a snapshot, so you may need to run mvn with the -U option to check for updates if you run into build issues.

Building

Install the project using the provided settings.xml:

mvn -s support/settings.xml install

If you will be building the project often, you'll want to create/modify your own ~/.m2/settings.xml file.

If you're a regular JBoss developer, see:

Otherwise, see:

Once your repositories are configured, simply type:

mvn install

Running

After successfully building it, you'll probably want to run it. To do so, set TORQUEBOX_HOME, and add $TORQUEBOX_HOME/jruby/bin to your $PATH, like so:

export TORQUEBOX_HOME=$PWD/build/assembly/target/stage/torquebox
export PATH=$TORQUEBOX_HOME/jruby/bin:$PATH

You can then use the torquebox command to control your creation. Run it without parameters to see a list of its supported subcommands.

Testing

All unit tests will be run during the build process, but tests can be run independently with the following command:

mvn -s support/settings.xml test

The integration tests (a.k.a. integs), which are not run as part of the main build, can be run like this:

cd integration-tests
mvn test -s ../support/settings.xml

Or a single integration test can be run like this:

mvn test -s ../support/settings.xml -Dspec=spec/session_handling_spec.rb

If you wish to skip the unit tests during the build process (to speed things up) you can add the -Dmaven.test.skip=true option when running the mvn install command.

Something went wrong with that request. Please try again.