Skip to main content

An interactive python test runner supports various test frameworks.

Project description

Build Coverage Status Quality Gate Status

PyPi License Download PythonVersion

logo IUTest

"IUTest" stands for "Interactive UnitTest", it is an interactive python unit-test runner that aims to support various unit-test frameworks like nose2, pytest, etc.

It has a pretty yummy Chinese name "Youtiao", which is Chinese fried breadstick typically for breakfast :)


To install IUTest

# For system default python or virtual env
pip install iutest

# For pipenv python
pipenv install iutest

IUTest Command Line Interface

# Get version:
iutest --version

# Run IUTest UI:
# or
iutest --ui

# Run all tests recursively within a directory:
iutest --runner "nose2" --runTests "E:/projects/iutest"

# Run tests by python module paths:
iutest --runner "nose2" --runTests "iutest.tests.test_dummypyunits" --runTests "iutest.tests.iutests"

# Run test but stop at first error / failure:
iutest --runner "nose2" --runTests "iutest" --stopOnError

Run tests in python

import sys
testerPath = 'E:/projects/iutest'  # Change to your path!
if testerPath not in sys.path:

import iutest
# Run all tests under given file system path:
iutest.runTests("nose2", 'path/To/Test/RootDir')

# Run tests by given python module paths:
iutest.runTests("nose2", "iutest.tests.test_dummytests", "iutest.tests.iutests")

Run UI in python

import sys
testerPath = 'E:/projects/iutest'  # Change to your path!
if testerPath not in sys.path:

import iutest

Run IUTest in DCC application, e.g. Maya

It is easy to use pip with Maya, with pip available in mayapy, you just need to do mayapy -m pip install packageName for each package we need: iutest, reimport, nose2 or pytest.

However, pip requires root privilege and it did introduce many potential risks, so to use iutest in Maya without pip:

  • Download IUTest and its dependency libraries: reimport, nose2 or pytest
  • Make these libraries available to Maya by adding their paths to sys.path.
  • Install the code above as a Maya shelf button.
  • Click on the shelf button to run IUTest UI.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for iutest, version 0.1.5
Filename, size File type Python version Upload date Hashes
Filename, size iutest-0.1.5-py3-none-any.whl (951.3 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size iutest-0.1.5.tar.gz (890.6 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page