pytest-stoq

A plugin to pytest stoq.

This plugin automatically set up the stoq test environment. It also provide a range of fixtures to ease the testing of stoq-related projects.

Installation

You can install "pytest-stoq" via pip from PyPI:

$ pip install pytest-stoq

Command-line options

• --plugin-cls: the plugin class path to be installed. Useful for testing stoq plugin projects.
• --quick: setup stoq using the quick strategy.
• --skip-env-setup: pytest-stoq won't setup the database, install plugins etc. (in case you already have the test env ready).
• --stoq-plugins: a comma-separated list of stoq plugin names to be installed. Useful for testing stoq applications that uses plugins (such as stoq desktop and stoq server).

Config file options

• PLUGIN_CLASS: same as --plugin-cls
• STOQ_PLUGINS: same as --stoq-plugins

Fixtures

The plugin provides the following fixtures:

• store: an instance of storm's (ORM) store used to access the database. It suffers rollback after each test case and cannot be committed, closed or rollbacked manually
• example_creator: instance creates (inserts) database objects with example/test data
• sysparam: a sysparam instance that clear its cache automatically after each use
• current_station
• current_user
• current_branch
• current_till
• mock_new_store: replace stoqlib.api.new_store() with the store fixture

Local Development

(optional) Setup your virtualenv using python 3.5+

Install test requirements:

$ pip install -Ur requirements-test.txt

Setup pre-commit:

$ pre-commit install

Run tests using pytest:

$ make test

License

Distributed under the terms of the GNU GPL v3.0 license, "pytest-stoq" is free and open source software