Rules for Contributing

  1. All contributions go via pull requests and code review
  2. Most of pylint warnings should be fixed
  3. All new files must contain Apache License header (unit test files may not have it)
  4. All changes must be reflected in Changelog
  5. All changes must be properly documented
  6. All changes must be covered with unit tests, no broken tests in master

Release Process

  • Modify Changelog.md, set version and date
  • Set correct version in bzt/__init__.py, commit
  • Create git tag, make git push, including tag
  • Build source distribution: ./build-sdist.sh
  • Upload to PyPi: python ./setup.py upload
  • rebuild and publish Docker image (how?)
  • site is updated automatically by Jenkins
  • notify all interested parties (Twitter, mailing lists)

Deploying Project Website

If you want to deploy project website locally to debug its content use these instructions (actually it's for Debian/Ubuntu, adopt for your system if needed).

Have Apache web server installed with mod_rewrite support and PHP 5:

  sudo apt-get update
  sudo apt-get install apache2 libapache2-mod-php5 php5
  sudo a2enmod rewrite

Prepare site directory, go here and execute

 php -r "readfile('https://getcomposer.org/installer');" | php
 php composer.phar update --prefer-stable
 ln -s vendor/undera/pwe/.htaccess 
 mkdir snapshots

Under /etc/apache2/sites-enabled create the file taurus.conf with following content (change for appropriate directory names):

<Directory "/home/mydir/taurus/site">
    Options FollowSymlinks
    AllowOverride All
    Require all granted
</Directory>
Listen 8002
<VirtualHost _default_:8002>
        DocumentRoot /home/mydir/taurus/site
</VirtualHost>

Restart Apache webserver

 sudo service apache2 restart

Open http://localhost:8002 in your browser, you should see our website.

Developing Taurus Extensions

Taurus is an extensible project. You can develop additional modules for it (executors, services, reporters) in a completely separate codebase. See bzt/resources/base-config.yml to get a feeling of how Taurus loads all its components.

Additionally, Taurus has a mechanism for automatically detecting configuration files for Taurus plugins. Here's the conditions:

  1. Your plugin has to be a Python package installed with the same Python that you're using to run Taurus.
  2. You plugin has to have a bzt-configs.json file in the project dir (right next to init.py).
  3. In this file should be a JSON list of configuration file names that your project uses to define Taurus modules.

For example, you are developing a Taurus extension with the following structure:

bzt_plugin_hello
├── __init__.py  # package init file, standard for Python
├── hello.py  # your plugin module, contains class HelloService
├── 10-hello.yml  # configuration file, analogous to base-config.yml
├── bzt-configs.json  # configuration index

Contents of bzt-configs.json should be `["10-hello.yml"]`.

Contents of 10-hello.yml:

modules:
  hello:
    class: bzt_plugin_hello.hello.HelloService

Python Egg Snapshots

Download and install it like this:

pip install bzt-150.tar.gz

bzt-1.13.2.108.tar.gz, 939.01 KB, Dec 10, 2018
TaurusInstaller_1.13.2.108_x64.exe, 24.68 MB, Dec 10, 2018
TaurusInstaller_1.13.2.10270_x64.exe, 24.68 MB, Dec 10, 2018
bzt-1.13.2.10270.tar.gz, 939.03 KB, Dec 10, 2018
bzt-1.13.2.10269.tar.gz, 939.13 KB, Dec 10, 2018
TaurusInstaller_1.13.2.10269_x64.exe, 24.68 MB, Dec 10, 2018
bzt-1.13.2.107.tar.gz, 939.11 KB, Dec 10, 2018
TaurusInstaller_1.13.2.107_x64.exe, 24.68 MB, Dec 10, 2018
bzt-1.13.2.102.tar.gz, 938.86 KB, Dec 04, 2018
TaurusInstaller_1.13.2.102_x64.exe, 24.67 MB, Dec 04, 2018
bzt-1.13.2.10264.tar.gz, 938.88 KB, Dec 04, 2018
TaurusInstaller_1.13.2.10264_x64.exe, 24.67 MB, Dec 04, 2018
bzt-1.13.2.10263.tar.gz, 938.74 KB, Dec 03, 2018
TaurusInstaller_1.13.2.10263_x64.exe, 24.67 MB, Dec 03, 2018
bzt-1.13.2.101.tar.gz, 938.7 KB, Dec 03, 2018
TaurusInstaller_1.13.2.101_x64.exe, 24.67 MB, Dec 03, 2018
bzt-1.13.1.10262.tar.gz, 938.71 KB, Dec 03, 2018
TaurusInstaller_1.13.1.10262_x64.exe, 24.67 MB, Dec 03, 2018
bzt-1.13.1.100.tar.gz, 938.68 KB, Dec 03, 2018
TaurusInstaller_1.13.1.100_x64.exe, 24.67 MB, Dec 03, 2018
TaurusInstaller_1.13.1.99_x64.exe, 24.67 MB, Nov 30, 2018
bzt-1.13.1.99.tar.gz, 938.79 KB, Nov 30, 2018
bzt-1.13.1.10261.tar.gz, 938.82 KB, Nov 30, 2018
TaurusInstaller_1.13.1.10261_x64.exe, 24.67 MB, Nov 30, 2018
bzt-1.13.1.98.tar.gz, 938.79 KB, Nov 29, 2018
TaurusInstaller_1.13.1.98_x64.exe, 24.67 MB, Nov 29, 2018
bzt-1.13.1.10260.tar.gz, 938.82 KB, Nov 29, 2018
TaurusInstaller_1.13.1.10260_x64.exe, 24.67 MB, Nov 29, 2018
bzt-1.13.1.97.tar.gz, 938.79 KB, Nov 29, 2018
TaurusInstaller_1.13.1.97_x64.exe, 24.67 MB, Nov 29, 2018
bzt-1.13.1.10259.tar.gz, 938.83 KB, Nov 29, 2018
TaurusInstaller_1.13.1.10259_x64.exe, 24.67 MB, Nov 29, 2018
bzt-1.13.1.96.tar.gz, 938.66 KB, Nov 28, 2018
TaurusInstaller_1.13.1.96_x64.exe, 24.67 MB, Nov 28, 2018
bzt-1.13.1.10258.tar.gz, 938.69 KB, Nov 28, 2018
TaurusInstaller_1.13.1.10258_x64.exe, 24.67 MB, Nov 28, 2018
bzt-1.13.1.95.tar.gz, 938.54 KB, Nov 28, 2018
TaurusInstaller_1.13.1.95_x64.exe, 24.67 MB, Nov 28, 2018
bzt-1.13.1.10257.tar.gz, 938.55 KB, Nov 28, 2018
TaurusInstaller_1.13.1.10257_x64.exe, 24.67 MB, Nov 28, 2018
bzt-1.13.1.94.tar.gz, 938.48 KB, Nov 28, 2018
TaurusInstaller_1.13.1.94_x64.exe, 24.67 MB, Nov 28, 2018
bzt-1.13.1.10256.tar.gz, 938.51 KB, Nov 28, 2018
TaurusInstaller_1.13.1.10256_x64.exe, 24.67 MB, Nov 28, 2018
bzt-1.13.1.93.tar.gz, 938.46 KB, Nov 27, 2018
TaurusInstaller_1.13.1.93_x64.exe, 24.67 MB, Nov 27, 2018
bzt-1.13.1.10255.tar.gz, 938.48 KB, Nov 27, 2018
TaurusInstaller_1.13.1.10255_x64.exe, 24.67 MB, Nov 27, 2018
bzt-1.13.1.10254.tar.gz, 938.47 KB, Nov 26, 2018
TaurusInstaller_1.13.1.10254_x64.exe, 24.67 MB, Nov 26, 2018
bzt-1.13.1.92.tar.gz, 938.45 KB, Nov 26, 2018
TaurusInstaller_1.13.1.92_x64.exe, 24.67 MB, Nov 26, 2018
bzt-1.13.1.91.tar.gz, 938.34 KB, Nov 26, 2018
TaurusInstaller_1.13.1.91_x64.exe, 24.67 MB, Nov 26, 2018
bzt-1.13.1.10253.tar.gz, 938.36 KB, Nov 26, 2018
TaurusInstaller_1.13.1.10253_x64.exe, 24.67 MB, Nov 26, 2018
bzt-1.13.1.90.tar.gz, 938.33 KB, Nov 25, 2018
TaurusInstaller_1.13.1.90_x64.exe, 24.67 MB, Nov 25, 2018
bzt-1.13.1.10252.tar.gz, 938.35 KB, Nov 25, 2018
TaurusInstaller_1.13.1.10252_x64.exe, 24.67 MB, Nov 25, 2018
bzt-1.13.1.89.tar.gz, 938.31 KB, Nov 25, 2018
TaurusInstaller_1.13.1.89_x64.exe, 24.67 MB, Nov 25, 2018
bzt-1.13.1.10251.tar.gz, 938.33 KB, Nov 25, 2018
TaurusInstaller_1.13.1.10251_x64.exe, 24.67 MB, Nov 25, 2018
bzt-1.13.1.88.tar.gz, 938.3 KB, Nov 22, 2018
TaurusInstaller_1.13.1.88_x64.exe, 24.67 MB, Nov 22, 2018
bzt-1.13.1.10250.tar.gz, 938.33 KB, Nov 22, 2018
TaurusInstaller_1.13.1.10250_x64.exe, 24.67 MB, Nov 22, 2018
bzt-1.13.1.87.tar.gz, 937.95 KB, Nov 22, 2018
TaurusInstaller_1.13.1.87_x64.exe, 24.66 MB, Nov 22, 2018
bzt-1.13.1.10249.tar.gz, 937.98 KB, Nov 22, 2018
TaurusInstaller_1.13.1.10249_x64.exe, 24.66 MB, Nov 22, 2018
bzt-1.13.1.86.tar.gz, 937.72 KB, Nov 21, 2018
TaurusInstaller_1.13.1.86_x64.exe, 24.66 MB, Nov 21, 2018
bzt-1.13.1.10248.tar.gz, 937.77 KB, Nov 21, 2018
TaurusInstaller_1.13.1.10248_x64.exe, 24.66 MB, Nov 21, 2018
bzt-1.13.1.85.tar.gz, 937.71 KB, Nov 21, 2018
TaurusInstaller_1.13.1.85_x64.exe, 24.66 MB, Nov 21, 2018
bzt-1.13.1.10247.tar.gz, 937.74 KB, Nov 21, 2018
TaurusInstaller_1.13.1.10247_x64.exe, 24.66 MB, Nov 21, 2018
bzt-1.13.1.10246.tar.gz, 937.65 KB, Nov 20, 2018
TaurusInstaller_1.13.1.10246_x64.exe, 24.66 MB, Nov 20, 2018
bzt-1.13.1.84.tar.gz, 937.62 KB, Nov 20, 2018
TaurusInstaller_1.13.1.84_x64.exe, 24.66 MB, Nov 20, 2018
bzt-1.13.1.83.tar.gz, 937.36 KB, Nov 20, 2018
TaurusInstaller_1.13.1.83_x64.exe, 24.66 MB, Nov 20, 2018
bzt-1.13.1.10245.tar.gz, 937.37 KB, Nov 20, 2018
TaurusInstaller_1.13.1.10245_x64.exe, 24.66 MB, Nov 20, 2018
bzt-1.13.1.82.tar.gz, 937.33 KB, Nov 20, 2018
TaurusInstaller_1.13.1.82_x64.exe, 24.66 MB, Nov 20, 2018
bzt-1.13.1.10244.tar.gz, 937.37 KB, Nov 20, 2018
TaurusInstaller_1.13.1.10244_x64.exe, 24.66 MB, Nov 20, 2018
bzt-1.13.1.81.tar.gz, 937.11 KB, Nov 19, 2018
TaurusInstaller_1.13.1.81_x64.exe, 24.66 MB, Nov 19, 2018
bzt-1.13.1.10243.tar.gz, 937.15 KB, Nov 19, 2018
TaurusInstaller_1.13.1.10243_x64.exe, 24.66 MB, Nov 19, 2018
bzt-1.13.1.76.tar.gz, 936.61 KB, Nov 16, 2018
TaurusInstaller_1.13.1.76_x64.exe, 24.66 MB, Nov 16, 2018
bzt-1.13.1.10238.tar.gz, 936.62 KB, Nov 16, 2018
TaurusInstaller_1.13.1.10238_x64.exe, 24.66 MB, Nov 16, 2018
bzt-1.13.1.10237.tar.gz, 936.62 KB, Nov 15, 2018
TaurusInstaller_1.13.1.10237_x64.exe, 24.66 MB, Nov 15, 2018
bzt-1.13.1.75.tar.gz, 936.59 KB, Nov 15, 2018
TaurusInstaller_1.13.1.75_x64.exe, 24.66 MB, Nov 15, 2018
bzt-1.13.1.74.tar.gz, 936.57 KB, Nov 13, 2018
TaurusInstaller_1.13.1.74_x64.exe, 24.66 MB, Nov 13, 2018
bzt-1.13.1.10236.tar.gz, 936.59 KB, Nov 13, 2018
TaurusInstaller_1.13.1.10236_x64.exe, 24.66 MB, Nov 13, 2018
bzt-1.13.1.10235.tar.gz, 936.51 KB, Nov 12, 2018
TaurusInstaller_1.13.1.10235_x64.exe, 24.66 MB, Nov 12, 2018
bzt-1.13.1.73.tar.gz, 936.47 KB, Nov 12, 2018
TaurusInstaller_1.13.1.73_x64.exe, 24.66 MB, Nov 12, 2018
bzt-1.13.1.10234.tar.gz, 936.63 KB, Nov 12, 2018
TaurusInstaller_1.13.1.10234_x64.exe, 24.66 MB, Nov 12, 2018
bzt-1.13.1.72.tar.gz, 936.6 KB, Nov 12, 2018
TaurusInstaller_1.13.1.72_x64.exe, 24.66 MB, Nov 12, 2018