Skip to main content

A collection of test helpers to facilitate AAA testing.

Project description

BuildStatus CoverageStatus Downloads License Docs

Test Helpers

The Test Helpers library aims to make Arrange-Act-Assert, class-based tests easier to write. The helpers in this module make patching easier, ease Python 3 compatibility, and gently guide users towards the AAA style of testing. Additional helpers are included for situations likely to be encountered in the web-app world.

Examples

The library is designed to be simple and modular. By using mixins to extend the test cases functionality we can write more expressive tests in fewer lines of code.

Creating Patches:

>>> from test_helpers import mixins, bases
>>> class WhenFooingBar(mixins.PatchMixin, bases.BaseTest):
...
...     patch_prefix = 'module.submodule'
...
...     @classmethod
...     def configure(cls):
...         cls.foo = cls.create_patch('foo', return_value=True)
...
...     @classmethod
...     def execute(cls):
...         function_under_test()
...
...     def should_have_called_foo(cls):
...         self.foo.assert_called_once_with()

Dependent Data Service Helpers

The Test Helpers library includes classes that facilitate initializing and cleaning up dependent data service resources. Provided with connection configuration to existing service instances, each class can generate name-spaced workspaces and tear down any created workspaces at the end of each test run.

Currently included:

  • MongoDB
  • PostgreSQL
  • RabbitMQ

Supported Python Versions

The Test Helpers library is built and tested against python 2.7, 3.3, 3.4, and 3.5. You may need to grab other versions of the interpreter with your preferred package manager (MacPorts, Apt, Yum, etc)

sudo port install python27 python33

Running Tests

To run the all of the tests across the supported versions of Python via tox run the following commands in your terminal:

$ virtualenv env
$ env/bin/pip install -r dev-requirements.txt
$ env/bin/detox

Developing The Test Helpers library

Clone the repo and start hacking:

$ virtualenv env
$ env/bin/pip install -r dev-requirements.txt

Project details


Release history Release notifications

This version
History Node

1.6.0

History Node

1.5.4

History Node

1.5.3

History Node

1.5.1

History Node

1.5.0

History Node

1.0.0

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
test_helpers-1.6.0-py2.py3-none-any.whl (19.6 kB) Copy SHA256 hash SHA256 Wheel py2.py3 Dec 7, 2017

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page