/usr/share/doc/jruby/README.test.md is in jruby 1.7.22-1ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 | # Writing Tests
1. There are actually *4* core test suites:
a) `org.jruby.test.MainTestSuite`, a suite of pure-java tests;
b) `org.jruby.test.TestUnitTestSuite`, which runs a suite of files named
one-per-line in `test/jruby_index` (and other `test/*_index` files).
Note: some are commented out.
c) `Rubyspecs`, a recent point-in-time copy of [RubySpec](http://rubyspec.org)
project. The specs
are written in `rspec `format and aim to test conformance of JRuby
against the Ruby specification.
d) MRI's own tests, synced periodically. The tests are run with
`rake test:mri19` and known failing tests are marked as such in
excludes files under `test/externals/ruby1.9/excludes`.
2. If you'd like to contribute new tests, we'd prefer you write them via the
`rubyspecs` project. If the tests are very specific to JRuby (like Java
Integration) we prefer writing `rspec`s under our `specs` directory.
3. We're also interested in running tests for other ruby software suites; if
you want to grab your favorite ruby software and run its own tests under JRuby
and report to the mailing list at `dev@jruby.codehaus.org`, that would be great.
4. Please file any and all patches in [Github issues](https://github.com/jruby/jruby/issues)
# Running Tests
Using ant, type
ant test
The three test suites should be run in order.
To run rubyspecs, type
ant spec
A slightly shorter run we run frequently is:
ant spec-short
The rubyspecs will be fetched over the net, and then executed.
To run an individual test:
1. run `ant install-dev-gems` which will install `bin/rspec` for use.
2. run `ant compile-test` to compile the java fixtures (you don't need to wait for the tests to finish) then test as normal with `bin/rspec spec/path-to-spec`
|