Kontr Test Development Kit

Kontr Test Development Kit was designed to write custom test scenarios for multiple programming languages. Configuration is done by python script with predefined structure.

Getting stated

KTDK is a library, to use it, you have to install it, or add it to your's Pipenv or requirements.txt file.

Prerequisites

Python 3.6 or later
(Optional) pipenv

Install the released version

You can install ktdk using the pip:

$ pip install ktdk

Or you can add it as a development dependency using the pipenv

$ pipenv install ktdk

Install the development version

You can either use the Pipenv command.

pipenv install git+https://gitlab.fi.muni.cz/grp-kontr2/ktdk.git

or the pip command:

pip install git+https://gitlab.fi.muni.cz/grp-kontr2/ktdk.git

Available Env variables

KTDK_WORKSPACE - Workspace dir
KTDK_TEST_FILES - Test files dir
KTDK_SUBMISSION - Student's submission dir
KTDK_RESULTS - Results directory submission dir
KTDK_ENTRY_POINT - Entry point - main script (default: instructions.py)
KTDK_TEST_TIMEOUT - Test timeout
KTDK_WEBHOOK_URL - Webhook url
KTDK_WEBHOOK_TOKEN - Webhook token
KTDK_TEST_TIMEOUT - Test timeout
KTDK_SUITE_TIMEOUT - Suite timeout
KTDK_SUITE_ID - Suite ID

Run the cli tool

Ktdk also provides a simple cli tool, to run your tests

# Show the help
$ ktdk --help

# List all the static tests
$ ktdk tests list

# Run your tests using the ktdk
$ ktdk execute --help

# Example:
$ ktdk execute --submission="<SUBMISSION_DIR>" --test-files="<TEST_FILES_DIR>" --devel

Examples

TBD - python examples of the KTDK tests

Development

Take a look at the contribution guide

Release files for ktdk 0.4.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ktdk 0.4.2
File	Size	Uploaded
ktdk-0.4.2.tar.gz	1.9 MB	Apr 25, 2019	Details

Built distribution (wheel)

Table of built distributions (wheels) for ktdk 0.4.2
File	Interpreter	ABI	Platform	Reset
ktdk-0.4.2-py3-none-any.whl 101.9 kB Apr 25, 2019	Python 3	none	any	Details

Total release size: 2.0 MB

Release files / ktdk-0.4.2.tar.gz

Download URL	ktdk-0.4.2.tar.gz
Size	1.9 MB
Tags	Source
SHA-256 checksum How to use checksums	`36a8b512866b01bfd6510b73694b086b165eeed77de54a3d8a054cea5a775391`
BLAKE2b-256 checksum How to use checksums	`9c0f430bee643945455c6b0af3add834ef195c19fbd9b1d72581d3346d14a070`
Upload date	Apr 25, 2019
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/1.12.1 pkginfo/1.4.2 requests/2.21.0 setuptools/41.0.1 requests-toolbelt/0.8.0 tqdm/4.26.0 CPython/3.7.3`

Release files / ktdk-0.4.2-py3-none-any.whl

Download URL	ktdk-0.4.2-py3-none-any.whl
Size	101.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`917ca55926518dee438f4dbb27fa5c99a4ebf2d6e6c3eb20b6074a90a3e66e09`
BLAKE2b-256 checksum How to use checksums	`0973522d8dd449243ec7d1e4685bc7c344c9ae532d2274a8fbe3ac044031eb22`
Upload date	Apr 25, 2019
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/1.12.1 pkginfo/1.4.2 requests/2.21.0 setuptools/41.0.1 requests-toolbelt/0.8.0 tqdm/4.26.0 CPython/3.7.3`