PyInq 0.2.1

Basic Examples

Simply run the code as is to try any of these examples for youself

A single module level test:

from pyinq.asserts import *
from pyinq.tags import *

@test
def atest():
        assert_true(True)

Test expecting an error:

from pyinq.asserts import *
from pyinq.tags import *

@test(expected=ValueError)
def tester():
        assert_equal(int("4.0"),4)

Using an instance variable:

from pyinq.asserts import *
from pyinq.tags import *

@testClass
class Class1:
        @before
        def setup():
                this.num = 4

        @test
        def test():
                assert_equal(this.num,4)
                this.num += 1

        @after
        def teardown():
                assert_equal(this.num,5)

unittest basic example:

from pyinq.asserts import *
from pyinq.tags import *
import random

@testClass
class TestSequenceFunctions:
        @before
        def setUp():
                this.seq = range(10)

        @test
        def test_shuffle():
                # make sure the shuffled TestSequenceFunctions.sequence does not lose any elements
                random.shuffle(this.seq)
                this.seq.sort()
                assert_equal(this.seq, range(10))

                # should raise an exception for an immutable TestSequenceFunctions.sequence
                assert_raises(TypeError, random.shuffle, (1,2,3))

        @test
        def test_choice():
                element = random.choice(this.seq)
                assert_true(element in this.seq)

        @test
        def test_sample():
                assert_raises(ValueError, random.sample, this.seq, 20)
                for element in random.sample(this.seq, 5):
                        assert_in(element,this.seq)

Test Discovery

Test discovery is a method for finding tests beginning at a specific root folder. The program will walk down each Python package in the folder structure until it has nowhere else to go. If any files in the package contain PyInq tests, they will be properly detected and executed.

The main way to use it is invocation from the command line, like so:

python -m pyinq discovery <root>

Output is the same as when executing a single file, with the addition of a tag indicating which module a set of tests belongs to.

You may also choose to invoke test discovery via the API. If you do, you will be given a TestSuite object, which is executable. A sample of how to use it appears below:

from pyinq import discover_tests

suite = discover_tests('examples')
if suite:
        suite()