For the most basic usage pytest_pyramid provides a pyramid_app and pyramid_config fixtures, that can be used to test your pyramid app. Simply pass your pyramid config *.ini file to –pc command line option, and include pytest_app fixture into your test suite to be able to use it for integration tests.


pytest_pyramid provides two fixtures to be used in pytest tests:

  • pyramid_config - fixture providing pyramid’s Configurator instance as
    defined in pyramid config’s file
  • pyramid_app - pyramid application for testing - a

Both of these fixtures depend on Config file passed in command line.

Fixture factories

If you’re developing a module, package meant to extend functionalities of other applications, it’s not necessary to create a full blown application to test functionalities provided in packages. To do this, pytest_pyramid provides you with fixture factories.

There are two factories:

  • pyramid_config() provides you with Configuration object based on either settings, config_file argument or by –pc command line option config file.
  • pyramid_app() creates a TestApp based on Configurator class instance as returned from fixture passed by name to it.