robotframework-testcontainers
Robot Framework keywords for testcontainers.
Installation
- using
pip:
pip install robotframework-testcontainers
- using
uv:
uv add robotframework-testcontainers
- using
poetry:
poetry add robotframework-testcontainers
Usage
Starting a container can be done with a single keyword:
*** Settings ***
Library TestcontainersLibrary
*** Test Cases ***
Basic Usage Example
Create Docker Container image=hello-world
TestcontainersLibrary keeps track of all created containers.
It will take care of stopping all created containers at the end of the test,
by making use of the end_test/end_suite listener methods.
If you require more control, you can also manually start and stop the container. Additionally, you can use different wait strategies to wait for the container to be ready:
*** Settings ***
Library TestcontainersLibrary
*** Test Cases ***
Advanced Usage with more control
${container}= Create Docker Container image=traefik/whoami start=False ports=[80]
Start Container ${container}
Wait For Http Endpoint ${container} port=80 path=/api
Stop Container ${container}
You can also use any of the community maintained containers.
Be aware that you have to make sure to install the required dependencies
yourself.
For example: starting a CockroachDB container requires installing testcontainers[cockroachdb].
Use the Create Community Container keyword and specify which class to import from which module.
Any additional arguments can be passed in as keyword arguments.
*** Settings ***
Library TestcontainersLibrary
*** Test Cases ***
Starting an CockroachDb Container
${password}= Evaluate str(uuid.uuid4())
${container}= Create Community Container
... module=testcontainers.cockroachdb
... container_class=CockroachDBContainer
... username=demoUser
... password=${password}
Log ${container.get_connection_url()}
You can read the acceptance tests in test/acceptance/ for more concrete usage examples.
License
This project is licensed under the MIT License.
Third-Party Licenses
This library depends on the
testcontainers-python
package, which is licensed under the
Apache License 2.0.
No parts of testcontainers-python are copied or modified in this project.
It is used only as a dependency.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file robotframework_testcontainers-0.2.1.tar.gz.
File metadata
- Download URL: robotframework_testcontainers-0.2.1.tar.gz
- Upload date:
- Size: 4.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8bf6ba333b343e63ca076effcd3d8c855f81b733570932eb922e087203565a76
|
|
| MD5 |
78983e235c9b1581fd78b643f60d8128
|
|
| BLAKE2b-256 |
4834eede6adbbd6a2d703e4777819e4b6842c0fc463474beb4483225d6383d48
|
Provenance
The following attestation bundles were made for robotframework_testcontainers-0.2.1.tar.gz:
Publisher:
publish.yml on DudeNr33/robotframework-testcontainers
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
robotframework_testcontainers-0.2.1.tar.gz -
Subject digest:
8bf6ba333b343e63ca076effcd3d8c855f81b733570932eb922e087203565a76 - Sigstore transparency entry: 2260881197
- Sigstore integration time:
-
Permalink:
DudeNr33/robotframework-testcontainers@ba02b6cdaab699e856713f92a43624023a6ec62f -
Branch / Tag:
refs/tags/v0.2.1 - Owner: https://github.com/DudeNr33
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@ba02b6cdaab699e856713f92a43624023a6ec62f -
Trigger Event:
push
-
Statement type:
File details
Details for the file robotframework_testcontainers-0.2.1-py3-none-any.whl.
File metadata
- Download URL: robotframework_testcontainers-0.2.1-py3-none-any.whl
- Upload date:
- Size: 5.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
36f03010e1433109334e28257cd59fd7d5eba8aa9f1ea7650016cf963cf04d82
|
|
| MD5 |
9294e23d22983e9987cb0a1b45be2895
|
|
| BLAKE2b-256 |
32b1c48ff8cb7183f96a237bf8e8a7face324a57f696aee69c94f766a9a42d53
|
Provenance
The following attestation bundles were made for robotframework_testcontainers-0.2.1-py3-none-any.whl:
Publisher:
publish.yml on DudeNr33/robotframework-testcontainers
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
robotframework_testcontainers-0.2.1-py3-none-any.whl -
Subject digest:
36f03010e1433109334e28257cd59fd7d5eba8aa9f1ea7650016cf963cf04d82 - Sigstore transparency entry: 2260881246
- Sigstore integration time:
-
Permalink:
DudeNr33/robotframework-testcontainers@ba02b6cdaab699e856713f92a43624023a6ec62f -
Branch / Tag:
refs/tags/v0.2.1 - Owner: https://github.com/DudeNr33
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@ba02b6cdaab699e856713f92a43624023a6ec62f -
Trigger Event:
push
-
Statement type:
