Automated tests¶
Kotti uses pytest, zope.testbrowser and WebTest for automated testing.
Before you can run the tests, you must install Kotti’s ‘testing’ extras. Inside your Kotti checkout directory, do:
bin/python setup.py dev
To then run Kotti’s test suite, do:
bin/py.test
Using Kotti’s test fixtures/funcargs in third party add-ons’ tests¶
To be able to use all of Kotti’s fixtures and funcargs in your own package’s
tests, you only need to “include” them with a line like this in your
conftest.py
file:
pytest_plugins = "kotti"
Available fixtures¶
Fixture dependencies¶
-
kotti.tests.
browser
(*args, **kwargs)[source] returns an instance of zope.testbrowser. The kotti.testing.user pytest marker (or pytest.mark.user) can be used to pre-authenticate the browser with the given login name: @user(‘admin’).
-
kotti.tests.
config
(*args, **kwargs)[source] returns a Pyramid Configurator object initialized with Kotti’s default (test) settings.
-
kotti.tests.
connection
(*args, **kwargs)[source] sets up a SQLAlchemy engine and returns a connection to the database. The connection string used for testing can be specified via the
KOTTI_TEST_DB_STRING
environment variable. Thecustom_settings
fixture is needed to allow users to import their models easily instead of having to override theconnection
.
-
kotti.tests.
content
(*args, **kwargs)[source] sets up some default content using Kotti’s testing populator.
-
kotti.tests.
custom_settings
(*args, **kwargs)[source] This is a dummy fixture meant to be overriden in add on package’s
conftest.py
. It can be used to inject arbitrary settings for third party test suites. The default settings dictionary will be updated with the dictionary returned by this fixture.This is also a good place to import your add on’s
resources
module to have the corresponding tables created duringcreate_all()
inkotti.tests.content()
.Result: settings Return type: dict
-
kotti.tests.
db_session
(*args, **kwargs)[source] returns a db session object and sets up a db transaction savepoint, which will be rolled back after the test.
-
kotti.tests.
dummy_request
(*args, **kwargs)[source] returns a dummy request object after registering it as the currently active request. This is needed when pyramid.threadlocal.get_current_request is used.
-
kotti.tests.
events
(*args, **kwargs)[source] sets up Kotti’s default event handlers.
-
kotti.tests.
filedepot
(*args, **kwargs)[source] Configures a dbsession integrated mock depot store for
depot.manager.DepotManager
-
kotti.tests.
mock_filedepot
(*args, **kwargs)[source] Configures a mock depot store for
depot.manager.DepotManager
This filedepot is not integrated with dbsession. Can be used in simple, standalone unit tests.
-
kotti.tests.
no_filedepots
(*args, **kwargs)[source] A filedepot fixture to empty and then restore DepotManager configuration
-
kotti.tests.
root
(*args, **kwargs)[source] returns Kotti’s ‘root’ node.
-
kotti.tests.
workflow
(*args, **kwargs)[source] loads and activates Kotti’s default workflow rules.
Continuous Integration¶
Kotti itself is tested against Python versions 2.6 and 2.7 as well as SQLite, mySQL and PostgreSQL (in every possible combination of those) on every commit (and pull request) via the excellent GitHub / Travis CI hook.
If you want your add-on packages’ to be tested the same way with additional
testing against multiple versions of Kotti (including the current master), you
can add a .travis.yml
file to your repo that looks similar to this:
https://raw.github.com/Kotti/kotti_media/master/.travis.yml.
The packages under http://kottipackages.xo7.de/ include all Kotti versions released on PyPI (synced every night at 00:15 CET) and a package built from the current master on GitHub (created every 15 minutes).