steve9001 / torquebox Goto Github PK

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

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.

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:

• http://community.jboss.org/wiki/MavenGettingStarted-Developers

Otherwise, see:

• http://community.jboss.org/wiki/MavenGettingStarted-Users

Once your repositories are configured, simply type:

mvn install

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.

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.