Testcontainers for Python

[amotl]

About

• Similar to Testcontainers for Java: Add showcase examples for different scenarios #54, we would like to demonstrate CrateDB with testcontainers-python, a »Testcontainers« implementation for Python.
• I've started a corresponding implementation on behalf of the LorryStream project the other day, and already reused it at the CrateDB Retention project. It needs to be reviewed and submitted to the upstream repository as a contribution before further elaborating on it.

[amotl]

The "Testcontainers for Python" implementation for CrateDB is located here.

• lorrystream:tests/testcontainers/cratedb.py
• cratedb-retention:tests/testcontainers/cratedb.py

pytest-based initialization code to use the "Testcontainers for Python" implementation, and provide a pytest fixture to the test cases, can be found within the conftest.py files of the corresponding projects.

• lorrystream:tests/conftest.py
• cratedb-retention:tests/conftest.py

Finally, those test cases demonstrate how to actually use that pytest fixture.

• lorrystream:tests/test_engine.py
• cratedb-retention:tests/test_database.py

[amotl]

Progress

CrateDB's adapter for "Testcontainers for Python" is maturing. Thanks for your support on all things yak shaving, @pilosus and @surister. 💯

References

• Refactor Testcontainers test layer into cratedb-toolkit package daq-tools/lorrystream#47
• Adapt testcontainers to be testing framework agnostic cratedb-toolkit#82
• Testing: Export cratedb_service fixture as pytest11 entrypoint cratedb-toolkit#113
• Testing: Update to cratedb-toolkit 0.0.4, using upstream pytest fixture daq-tools/lorrystream#78
• Testing: Demonstrate Python test layer implementations #280

Backlog

• Demonstrate more features of the existing test layers than just basic examples added by the other patch Testing: Demonstrate Python test layer implementations #280.
• Exercise and improve implementations wrt. [Testing] Demonstrate CrateDB test layers with parameterization #282