Skip to content
This repository has been archived by the owner on Mar 19, 2024. It is now read-only.

browncoat-ninjas/nimoy

Repository files navigation

Nimoy

A testing and specification framework for Python 3, heavily inspired by the amazing Spock Framework.

PyPI version CircleCI

Better Python Testing

Powerful Python DDT (Domain Driven Testing) made easy with Nimoy’s DSL:

from nimoy.specification import Specification

class MySpec(Specification):

    def my_feature_method(self):
        with given:
            a = value_of_a
            b = value_of_b

        with expect:
            (a * b) == expected_value

        with where:
            value_of_a | value_of_b | expected_value
            1          | 10         | 10
            2          | 20         | 40

Installation

Python 3.8 or earlier

pip install nimoy-framework==1.0.2

Python 3.9 or later

pip install nimoy-framework

Why?

The Spock Framework has set a new standard as to what testing frameworks should be like - beautiful, expressive, pragmatic and fun.

While unittest, pytest and nose2 are great, there’s still room for improvement.

The aim of this project is to port Spock to Python while maintaining the original vision as much as possible.

Features

  • Domain Driven Testing

  • Based on unittest, so minimal dependencies are required and specifications are recognized by IDEs and report analyzers.

  • Reduction of boilerplate code.

  • Write detailed specifications with clear distinction.

  • Auto discovery of specifications.

  • Write data-driven specifications.

  • Pretty mock behavior assertion.

  • See fancy detailed assertion failure reports including power assertions.

License

Apache License 2.0

In memory of Leonard Nimoy 1931-2015