pytest-celery 1.2.0

Pytest plugin for Celery

Version:

v1.2.0

Web:

https://pytest-celery.readthedocs.io/en/latest/

Download:

https://pypi.org/project/pytest-celery/

Source:

https://github.com/celery/pytest-celery/

Official pytest plugin for Celery

Welcome to pytest-celery, the official pytest plugin for Celery.

The pytest-celery plugin introduces significant enhancements with the introduction of version >= 1.0.0, shifting towards a Docker-based approach for smoke and production-like testing. While the celery.contrib.pytest API continues to support detailed integration and unit testing, the new Docker-based methodology is tailored for testing in environments that closely mirror production settings.

Adopting version >= 1.0.0 enriches your testing suite with these new capabilities without affecting your existing tests, allowing for a smooth upgrade path. The documentation here will navigate you through utilizing the Docker-based approach. For information on the celery.contrib.pytest API for integration and unit testing, please refer to the official documentation.

The pytest-celery plugin is Open Source and licensed under the BSD License.

Donations

This project relies on your generous donations.

If you are using pytest-celery to test a commercial product, please consider becoming our backer or our sponsor to ensure pytest-celery’s future.

Getting Started

• If you’re new to pytest-celery you can get started by following the Getting Started tutorial.

• You can also check out the FAQ.

Contents

• Copyright

• Getting Started

  • Introduction to pytest-celery

  • First Steps with pytest-celery

  • Next Steps

  • Vendors

  • Help

• User Guide

  • Advanced Installation Guide

  • Test Setup Matrix

  • How to prepare the Celery application

  • How to inject your own utility functions

  • How to add tasks

  • Built-in Tasks

  • How to connect signal handlers

  • Standalone Celery Bug Report

  • Examples

  • Useful Resources

• Plugin Development Guide

  • Local Development Environment

  • Tox Environments

  • Sphinx Documentation

  • How to release a new version

• API Documentation

• Contributing

• FAQ

• Change history

• Glossary