Hiptest Publisher

Build Status Gem Version Code Climate Test Coverage Dependency Status

Installing

You need to have Ruby installed on your machine. You can then install it using gem:

gem install hiptest-publisher

Note: for Windows user, take a look, at this (short) documentation.

Exporting a project

Go to one of your Hiptest projects and select the Settings tab. This tab is available only for projects you own. From there, copy the secret token and run this command line:

hiptest-publisher --token=<YOUR TOKEN>

This will create a Ruby tests suite. For the moment, we support the following languages and frameworks:

  • Ruby (rspec / minitest)
  • Cucumber Ruby
  • Python (unittest)
  • Java (JUnit / TestNg)
  • Robot Framework
  • Selenium IDE
  • Javascript (qUnit / Jasmine)

You can specify the output language and framework in the command line, for example:

hiptest-publisher --token=<YOUR TOKEN> --language=ruby --framework=minitest

When publishing, you'll notice a file called actionwords_signature.yaml. Store this file in your code repository, it will be used to handle updates of the action word.

Exporting a test run

You can generate the test suite from a test run of your project by specifying option --test-run-id=<xxx> when calling hiptest-publisher. You can find the test run id in the address bar of your browser. If your browser address is http://hiptest.net/app#/projects/1234/testRuns/6941, then your test run id is 6941. You can generate your tests from your test with this command line:

hiptest-publisher --token=<YOUR TOKEN> --test-run-id=6941

Available options

For more information on the available options, use the following command:

hiptest-publisher --help

You could obtain for example:

Exports tests from Hiptest for automation.

Specific options:
    -t, --token=TOKEN                Secret token (available in your project settings)
    -l, --language=LANG              Target language (default: ruby)
    -f, --framework=FRAMEWORK        Test framework to use
    -o, --output-directory=PATH      Output directory (default: .)
    -c, --config-file=PATH           Configuration file
        --overriden-templates=PATH   Folder for overriden templates
        --test-run-id=ID             Export data from a test run
        --scenario-ids=IDS           Filter scenarios by ids
        --scenario-tags=TAGS         Filter scenarios by tags
        --only=CATEGORIES            Restrict export to given file categories (--only=list to list them)
        --tests-only                 (deprecated) alias for --only=tests (default: false)
        --actionwords-only           (deprecated) alias for --only=actionwords (default: false)
        --actionwords-signature      Export actionwords signature (default: false)
        --show-actionwords-diff      Show actionwords diff since last update (summary) (default: false)
        --show-actionwords-deleted   Output signature of deleted action words (default: false)
        --show-actionwords-created   Output code for new action words (default: false)
        --show-actionwords-renamed   Output signatures of renamed action words (default: false)
        --show-actionwords-signature-changed
                                     Output signatures of action words for which signature changed (default: false)
        --with-folders               Use folders hierarchy to export files in respective directories, to be used with --split-scenarios (default: false)
        --split-scenarios            Export each scenario in a single file (default: false)
        --leafless-export            Use only last level action word (default: false)
    -s, --site=SITE                  Site to fetch from (default: https://hiptest.net)
    -p, --push=FILE.TAP              Push a results file to the server
        --push-format=tap            Format of the test results (tap, junit, robot) (default: tap)
    -v, --verbose                    Run verbosely (default: false)
    -H, --languages-help             Show languages and framework options
    -F, --filters-help               Show help about scenario filtering
    -h, --help                       Show this message

Configuration

You have the possibility to store some configuration in a file named 'config'. Copy the file config.sample provided here and update the values with the values you use.

If you have multiple projects, you can have multiple config files and select one using the --config-file option:

# Use the default config file
hiptest-publisher
# Use the one to export as minitest
hiptest-publisher --config-file=config_minitest

For example, for java you can use this config file content:

token = '<YOUR TOKEN>'
language = 'java'
output_directory = '<YOUR OUTPUT DIRECTORY>'
package = 'com.youcompany'

Note that options from command line arguments override options from config file.

Posting results to Hiptest

You can use the options --push to push the results back to Hiptest. For this, you first need to generate the test code from a Test run by specifying option --test-run-id=<xxx> during code generation (or add it to the configuration file). The tests must then generate a test report that is supported by Hiptest. Currently three types of test results are handled:

  • tap (Test Anything Protocol)
  • jUnit XML style
  • Robot framework XML output

You can specify the type of export when pushing by using the option "--push-format=[tap|junit|robot]" or specifying it in the config file.

Development

While developing, you can install the gem locally by issuing

rake install

You can also run the command directly with bundle exec ruby -I lib bin/hiptest-publisher. It is handy to define an alias so you can test your code easily:

# this alias will only work when run from the root of the project
alias hiptest-publisher='bundle exec ruby -I lib bin/hiptest-publisher'

Adding support for other languages and framework

See the CONTRIBUTING help page for more information.