feat(network): Add create method to Network class (#627)

core/testcontainers/core/network.py

@@ -32,10 +32,13 @@ def connect(self, container_id: str, network_aliases: Optional[list] = None):
     def remove(self) -> None:
         self._network.remove()
 
-    def __enter__(self) -> "Network":
+    def create(self) -> "Network":
         self._network = self._docker.client.networks.create(self.name, **self._docker_network_kw)
         self.id = self._network.id
         return self
 
+    def __enter__(self) -> "Network":
+        return self.create()
+
     def __exit__(self, exc_type, exc_val, exc_tb) -> None:
         self.remove()

core/tests/test_network.py

@@ -1,7 +1,11 @@
+from http import HTTPStatus
 from testcontainers.core.container import DockerContainer
 from testcontainers.core.docker_client import DockerClient
 from testcontainers.core.network import Network
 
+import docker.errors
+import pytest
+
 NGINX_ALPINE_SLIM_IMAGE = "nginx:1.25.4-alpine-slim"
 
 
@@ -14,6 +18,31 @@ def test_network_gets_created_and_cleaned_up():
     assert not docker.client.networks.list(network.name)
 
 
+def test_network_create_wo_cm():
+    network = Network()
+    network.create()
+    docker = DockerClient()
+    networks_list = docker.client.networks.list(network.name)
+    assert networks_list[0].name == network.name
+    assert networks_list[0].id == network.id
+
+    network.remove()
+    assert not docker.client.networks.list(network.name)
+
+
+def test_network_create_errors():
+    network = Network()
+    network.create()
+
+    # calling create the second time should raise an error
+    with pytest.raises(docker.errors.APIError) as excinfo:
+        network.create()
+
+    assert excinfo.value.response.status_code == HTTPStatus.CONFLICT
+    excinfo.match(f"network with name {network.name} already exists")
+    network.remove()
+
+
 def test_containers_can_communicate_over_network():
     with Network() as network:
         with (