yicaifeitian / gauge-python

Python language runner for Gauge

Gauge-Python

This project adds Python language plugin for gauge.

Getting started

Pre-requisite

• Gauge
• Python
• Pip

Installation

gauge install python

Create a gauge-python project

gauge init python

Run tests

gauge run specs

Useful links

• User Docs
• Setup Guide
• Examples

Alternate Installation options

Install specific version

gauge install python -v 0.2.3
[pip / pip3] install getgauge

Offline installation

• Download the plugin from Releases

gauge install python --file gauge-python-0.2.3.zip
[pip / pip3] install getgauge

Nightly installation

To install python nightly, download the latest nightly from here.

Once you have the downloaded nightly gauge-python-$VERSION.nightly-yyyy-mm-dd.zip, install using:

gauge install python -f gauge-python-$VERSION.nightly.yyyy-mm-dd.zip
[pip / pip3] install --pre getgauge==$VERSION.dev.yyyymmdd

Build from Source

Pre-Requisites

• Golang

Installing package dependencies

pip install -r requirements.txt

Tests

python build.py --test

Tests Coverage

python build.py --test
coverage report -m

Installing

python build.py --install

Creating distributable

python build.py --dist

This will create a .zip file in bin directory and a .tar.gz file in dist directory. The zip file can be uploaded to Github release and the .tar.gz file can be uploaded to PyPi

Uploading to PyPI

twine upload dist/FILE_NAME

Creating Nightly distributable

NIGHTLY=true python build.py --dist

This will create the .zip nightly file and a .dev.DATE.tar.gz(PyPi pre release package) file.

License

The Gauge-Python is an open-sourced software licensed under the MIT license_.

Copyright

Copyright 2018 ThoughtWorks, Inc.