pytest-docker-fixtures 1.4.2
pytest docker fixtures
License: BSD
Keywords: pytest, fixtures, docker

Introduction
============

Provide various service pytest fixtures.


Install
-------

`pip install pytest-docker-fixtures`

Usages
------

In your conftest.py, add the following: ::

    pytest_plugins = ['pytest_docker_fixtures']

And to use the fixtures: ::

    def test_foobar(redis):
        pass


Available fixtures
------------------

PRs welcome!

- cockroach (require to be installed with `pip install pytest-docker-fixtures[pg]`)
- es (elasticsearch)
- etcd
- kafka (require to be installed with `pip install pytest-docker-fixtures[kafka]`)
- memcached (require to be installed with `pip install pytest-docker-fixtures[memcached]`)
- minio
- mysql (require to be installed with `pip install pytest-docker-fixtures[mysql]`)
- pg (require to be installed with `pip install pytest-docker-fixtures[pg]`)
- rabbitmq (require to be installed with `pip install pytest-docker-fixtures[rabbitmq]`)
- redis
- stripe (stripemock)
- emqx
- influxdb

Configuring custom images
-------------------------

You can also configure custom images to use::

    from pytest_docker_fixtures import images
    images.configure(
        'elasticsearch',
        'docker.elastic.co/elasticsearch/elasticsearch-platinum', '6.2.4',
        env={},
        options={}
    )

1.4.2 (2025-12-01)
------------------

- Fix localhost resulution on macos by forcing resolving hostname to ip. [sunbit]


1.4.1 (2025-11-18)
------------------

- Fix access to deprecated default network in NetworkSettings [jotare]


1.4.0 (2025-06-25)
------------------

- Added Valkey support [sunbit]


1.3.20 (2025-05-14)
-------------------

- Fix typo package dependency name: `pymemcached` to `pymemcache`


1.3.19 (2024-04-03)
-------------------

- Adding emqx fixture [nilbacardit26]
- Adding influxdb fixture [nilbacardit26]

1.3.18 (2023-11-17)
-------------------

- Remove container object after stopping it [sunbit]

1.3.17 (2023-05-02)
-------------------

- Set docker api version to auto
  [vangheem]


1.3.16 (2023-03-24)
-------------------

- Use compatibile version of redis with arm support
  [vangheem]

1.3.15 (2022-11-17)
-------------------

- Set Redis image version to 6.2.6 for amd64 arch [albertnadal]


1.3.14 (2022-07-06)
-------------------

- Add stripe/stripemock image [jotare]


1.3.13 (2021-11-23)
-------------------

- Support for Apple Silicon images [bloodbare]


1.3.12 (2021-08-30)
-------------------

- Add support for remote docker daemons [sunbit]


1.3.11 (2020-09-30)
-------------------

- fix release

1.3.10 (2020-09-30)
-------------------

- Add memcached docker image [lferran]


1.3.9 (2020-07-10)
------------------

- Fix passing options to image configuration
  [gitcarbs]


1.3.8 (2020-07-02)
------------------

- Stop hardcoding db, user, and password in Postgresql.check()
  [marshalium]


1.3.7 (2020-05-04)
------------------

- Change psycopg2 dependency to psycopg2-binary


1.3.6 (2020-02-14)
------------------

- Update to working postgres image after upstream 9.6 change


1.3.5 (2019-10-01)
------------------

- minio: use random port (breaking change!)
  [masipcat]


1.3.4 (2019-09-04)
------------------

- Be able to override with env variables
  [vangheem]


1.3.3 (2019-08-14)
------------------

- Add support for MySQL
  [masipcat]


1.3.2 (2019-07-19)
------------------

- Fix: custom max_wait_s option should not be passed to docker images [lferran]

1.3.1 (2019-07-19)
------------------

- Allow configuring time to wait for image to be setup [lferran]


1.3.0 (2019-04-05)
------------------

- Be able to configure more of image
  [vangheem]

- Make sure ImportError is bubbled
  [vangheem]


1.2.10 (2019-02-28)
-------------------

- minio: configure a custom version of the image doesn't work
  [masipcat]
- minio: check() fails because Minio responds with status 403
  [masipcat]


1.2.9 (2019-01-09)
------------------

- Fix Minio returning port = None
  [masipcat]


1.2.8 (2019-01-03)
------------------

- Add support for Minio
  [masipcat]


1.2.7 (2018-11-19)
------------------

- ensure Kafka is available
  [ableeb]


1.2.6 (2018-11-15)
------------------

- Fix use of optional dependency
  [vangheem]


1.2.5 (2018-11-13)
------------------

- Add support for Kafka
  [ableeb]

1.2.4 (unreleased)
------------------

- Add support for RabbitMQ
  [davidonna]


1.2.3 (2018-06-10)
------------------

- bump


1.2.2 (2018-05-06)
------------------

- Fix es when using 6
  [vangheem]


1.2.1 (2018-05-05)
------------------

- Fix Elasticsearch image
  [vangheem]


1.2.0 (2018-05-05)
------------------

- Be able to configure custom docker images
  [vangheem]

1.1.0 (2018-04-03)
------------------

- Add Elasticsearch fixture
  [vangheem]


1.0.1 (2018-03-12)
------------------

- release


1.0.0 (2018-03-12)
------------------

- initial release