From 0c1c881045d31a5bd10bb0ec0cc00212fe1cc957 Mon Sep 17 00:00:00 2001
From: Vincent Emonet <vincent.emonet@gmail.com>
Date: Thu, 3 Oct 2024 09:02:33 +0200
Subject: [PATCH] docs(core): Add an example for configuring a custom
 DockerContainer with exposed port and environment variable

---
 core/README.rst | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/core/README.rst b/core/README.rst
index 8cc9a278..57ace692 100644
--- a/core/README.rst
+++ b/core/README.rst
@@ -30,3 +30,18 @@ Using `DockerContainer` and `DockerImage` to create a container:
 
 The `DockerImage` class is used to build the image from the specified path and tag.
 The `DockerContainer` class is then used to create a container from the image.
+
+
+Creating a container with an exposed port and a custom environment variable:
+
+.. doctest::
+
+    >>> from testcontainers.core.container import DockerContainer
+    >>> from testcontainers.core.waiting_utils import wait_for_logs
+
+    >>> container = DockerContainer("stain/jena-fuseki:latest")
+    >>> container.with_exposed_ports(3030)
+    >>> container.with_env("ADMIN_PASSWORD", "password")
+    >>> container.start()
+    >>> delay = wait_for_logs(container, "Fuseki is available")
+    >>> container_url = f"http://{container.get_container_host_ip()}:{container.get_exposed_port(3030)}"