community.mysql/CONTRIBUTING.md

Contributing

Refer to the Ansible Contributing guidelines to learn how to contribute to this collection.

Refer to the review checklist when triaging issues or reviewing PRs.

Testing locally

You can use GitHub to run ansible-test either on the community repo or your fork. But sometimes you want to quickly test a single version or a single target. To do that, you can use the Makefile present at the root of this repository.

Actually, the makefile only support Podman. I don't have tested with docker yet.

The Makefile accept the following options:

• db_engin_version: The name of the container to use. Either MYSQL or MariaDB. Use ':' as a separator. Do not use short version, like mysql:8 for instance. Our tests expect a full version to filter tests based on released version. For instance: when: db_version is version ('8.0.22', '>').
• connector: The name of the python package of the connector along with its version number. Use '==' as a separator.
• python: The python version to use in the controller.
• target : If omitted, all test targets will run. But you can limit the tests to a single target to speed up your tests.

Exemples:

# Run all tests
make db_engine_version="mysql:5.7.40" connector="pymysql==0.7.10" python="3.8"

# A single target
make db_engine_version="mysql:5.7.40" connector="pymysql==0.7.10" python="3.8" target="test_mysql_db"