Paraduct

Paraduct (parallel + parameterize + product) is matrix test runner

• ruby 2.0+
• rsync

Add this line to your application's Gemfile:

gem 'paraduct'

And then execute:

$ bundle

Or install it yourself as:

$ gem install paraduct

$ paraduct --help
Commands:
  paraduct generate        # generate .paraduct.yml
  paraduct help [COMMAND]  # Describe available commands or one specific command
  paraduct test            # run matrix test

$ paraduct generate
      create  .paraduct.yml
      create  .paraduct_rsync_exclude.txt

$ vi .paraduct.yml
$ vi .paraduct_rsync_exclude.txt

$ paraduct test

script: |-
  echo "[START] NAME1=${NAME1}, NAME2=${NAME2}"
after_script: |-
  echo "[END] NAME1=${NAME1}, NAME2=${NAME2}"
work_dir: tmp/paraduct_workspace
variables:
  NAME1:
    - value1a
    - value1b
  NAME2:
    - value2a
    - value2b
max_threads: 4
rsync_option:
  exclude_from: .paraduct_rsync_exclude.txt
exclude:
  - NAME1: value1a
    NAME2: value2b

script to run

script to run after both script successful and script failure

diretory to run

• own job is run under work_dir/$PARADUCT_JOB_NAME
• if work_dir is empty, own job is run under current directory.
  • rsync is disabled

Parameters to be combined

• $PARADUCT_JOB_NAME is generated with variables

maximum concurrent execution number of jobs

support only exclude-from

exclude pattern from product variables

1. Fork it ( https://github.com/sue445/paraduct/fork )
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new Pull Request