Skip to content

Commit 4c0ba18

Browse files
docs: more detailed explanation on how to use reusable containers
1 parent 3a31883 commit 4c0ba18

File tree

1 file changed

+3
-3
lines changed

1 file changed

+3
-3
lines changed

index.rst

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -123,13 +123,13 @@ Reusable Containers (Experimental)
123123

124124
.. warning::
125125
Reusable Containers is still an experimental feature and the behavior can change.
126-
Those containers won't stop after all tests are finished.
126+
Those containers won't stop after the Python process finished.
127127

128-
Containers can be reused across consecutive test runs. To reuse a container, the container has to be started manually by calling the `start()` method. Do not call the `stop()` method directly or indirectly via a `with` statement (context manager). To reuse a container, the container configuration must be the same.
128+
The Reusable feature keeps the containers running and next executions with the same container configuration will reuse it. To use it, start the container manually by calling `start()` method, do not call `stop()` method directly or indirectly via a `with` statement (context manager), and enable it manually through an opt-in mechanism per environment. To reuse a container, the container configuration must be the same.
129129

130130
Containers that are set up for reuse will not be automatically removed. Thus, if they are not needed anymore, those containers must be removed manually.
131131

132-
Containers should not be reused in a CI environment.
132+
Please note, that containers should not be reused in a CI environment.
133133

134134
How to use?
135135
^^^^^^^^^^^

0 commit comments

Comments
 (0)