pytest-celery 1.2.1


pip install pytest-celery

  Latest version

Released: Jul 30, 2025

Project Links

Meta
Author: Tomer Nosrati
Requires Python: >=3.8,<4.0

Classifiers

Development Status
  • 5 - Production/Stable

Framework
  • Celery

License
  • OSI Approved :: BSD License

Operating System
  • OS Independent

Programming Language
  • Python
  • Python :: 3
  • Python :: 3.8
  • Python :: 3.9
  • Python :: 3.10
  • Python :: 3.11
  • Python :: 3.12
  • Python :: 3.13
  • Python :: 3 :: Only
  • Python :: Implementation :: CPython

Topic
  • Software Development :: Testing

Build status coverage BSD License Semgrep security Supported Python versions. Supported Python implementations. Backers on Open Collective Sponsors on Open Collective Poetry

Version:

v1.2.1

Web:

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

Download:

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

Source:

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

DeepWiki:

Ask http://DeepWiki.com

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

Wheel compatibility matrix

Platform Python 3
any

Files in release

Extras:
Dependencies:
celery
debugpy (<2.0.0,>=1.8.12)
docker (<8.0.0,>=7.1.0)
kombu
psutil (>=7.0.0)
pytest-docker-tools (>=3.1.3)
setuptools (<75.0.0,>=60.0.0)
setuptools and (>=75.8.0)
tenacity (>=9.0.0)