# jcukeforker

Forking cukes and VNC displays.

Jcukeforker is a fork of cukeforker desgined for jruby.

[![Gem Version](https://badge.fury.io/rb/jcukeforker.svg)](http://badge.fury.io/rb/jcukeforker)

### NB!

If you're using cukeforker with selenium-webdriver and Firefox, all versions prior to 2.40 has a bug where custom
Firefox profiles created in a forked process would not get cleaned up. Please make sure you're using selenium-webdriver >= 2.40
to avoid this.

## Usage


```ruby
    # parallelize per feature
    JCukeForker::Runner.run Dir['features/**/*.feature'],
                           :max        => 4,                    # number of workers
                           :out        => "/path/to/reports",   # output path
                           :format     => :html,                # passed to `cucumber --format`,
                           :extra_args => %w[--extra arguments],# passed to cucumber,
                           :vnc        => true                  # manage a pool of VNC displays, assign one per worker.

    # parallelize per scenario, with one JUnit XML file per scenario.
    JCukeForker::Runner.run JCukeForker::Scenarios.tagged(%W[@edition ~@wip])
                           :extra_args => %W[-f JCukeForker::Formatters::JunitScenarioFormatter --out results/junit]
    
    # setup with vncserver and screen recording
    JCukeForker::Runner.run Dir['features/**/*.feature'],
                            :vnc       => %W[-geometry 1280x1024 -depth 24 -dpi 96]
                            :record    => {:ext => 'mp4', :codec => 'mpeg4', :frame_size => '1280x1024', :frame_rate => '5'}
```

Note on Patches/Pull Requests
=============================

* Fork the project.
* Make your feature addition or bug fix.
* Add tests for it. This is important so I don't break it in a
  future version unintentionally.
* Commit, do not mess with rakefile, version, or history.
  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
* Send me a pull request. Bonus points for topic branches.

Copyright
=========

Copyright (c) 2011-2014 Jari Bakken. See LICENSE for details.