wexample-runner 9.4.0__tar.gz → 9.5.0__tar.gz

{wexample_runner-9.4.0 → wexample_runner-9.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: wexample-runner
-Version: 9.4.0
+Version: 9.5.0
 Summary: Executes commands across local, SSH, and Docker environments through a unified runner interface with lifecycle management (build, start, stop, destroy)
 Author-Email: weeger <contact@wexample.com>
 License: MIT
@@ -10,7 +10,7 @@ Classifier: Operating System :: OS Independent
 Project-URL: homepage, https://github.com/wexample/python-runner
 Requires-Python: >=3.10
 Requires-Dist: paramiko>=3.0.0
-Requires-Dist: wexample-helpers>=20.0.0
+Requires-Dist: wexample-helpers>=20.2.0
 Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-cov; extra == "dev"
@@ -18,7 +18,7 @@ Description-Content-Type: text/markdown
 
 # runner
 
-Version: 9.4.0
+Version: 9.5.0
 
 `wexample-runner` gives Python ≥ 3.10 code a single `execute(cmd)` call that runs shell commands on the local machine via subprocess, on a remote server over SSH (paramiko), or inside a Docker container — without the caller branching on the target environment. Every runner follows the same `build / start / stop / destroy` lifecycle and returns a `RunnerResult` dataclass carrying `stdout`, `stderr`, and `exit_code`. It targets developers who automate operations across mixed execution environments and want one interface that works regardless of where the command lands.
 
@@ -238,7 +238,7 @@ Visit the [Wexample Suite documentation](https://docs.wexample.com) for the comp
 ## Dependencies
 
 - paramiko: >=3.0.0
-- wexample-helpers: >=20.0.0
+- wexample-helpers: >=20.2.0
 
 ## Versioning & Compatibility Policy
 

{wexample_runner-9.4.0 → wexample_runner-9.5.0}/README.md

@@ -1,6 +1,6 @@
 # runner
 
-Version: 9.4.0
+Version: 9.5.0
 
 `wexample-runner` gives Python ≥ 3.10 code a single `execute(cmd)` call that runs shell commands on the local machine via subprocess, on a remote server over SSH (paramiko), or inside a Docker container — without the caller branching on the target environment. Every runner follows the same `build / start / stop / destroy` lifecycle and returns a `RunnerResult` dataclass carrying `stdout`, `stderr`, and `exit_code`. It targets developers who automate operations across mixed execution environments and want one interface that works regardless of where the command lands.
 
@@ -220,7 +220,7 @@ Visit the [Wexample Suite documentation](https://docs.wexample.com) for the comp
 ## Dependencies
 
 - paramiko: >=3.0.0
-- wexample-helpers: >=20.0.0
+- wexample-helpers: >=20.2.0
 
 ## Versioning & Compatibility Policy
 

{wexample_runner-9.4.0 → wexample_runner-9.5.0}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "pdm.backend"
 
 [project]
 name = "wexample-runner"
-version = "9.4.0"
+version = "9.5.0"
 description = "Executes commands across local, SSH, and Docker environments through a unified runner interface with lifecycle management (build, start, stop, destroy)"
 authors = [
     { name = "weeger", email = "contact@wexample.com" },
@@ -19,7 +19,7 @@ classifiers = [
 ]
 dependencies = [
     "paramiko>=3.0.0",
-    "wexample-helpers>=20.0.0",
+    "wexample-helpers>=20.2.0",
 ]
 
 [project.readme]

{wexample_runner-9.4.0 → wexample_runner-9.5.0}/src/wexample_runner/runner/docker_runner.py

@@ -74,6 +74,19 @@ class DockerRunner(AbstractDockerRunner):
         if docker_image_exists(self.image_name):
             docker_remove_image(self.image_name)
 
+    def dispose(self) -> None:
+        """Remove the container, keeping the image to start from next time.
+
+        Forced rather than stopped first: the container idles on `tail -f`, which
+        ignores the stop signal and would hold every exit for docker's 10s grace.
+        Never raises — it runs as the process exits.
+        """
+        from wexample_helpers.helper.shell import shell_run
+
+        shell_run(
+            cmd=["docker", "rm", "-f", self.container_name], capture=True, check=False
+        )
+
     def start(self) -> None:
         import os
 
@@ -88,6 +101,8 @@ class DockerRunner(AbstractDockerRunner):
             if not docker_container_is_running(self.container_name):
                 docker_start_container(self.container_name)
         else:
+            import atexit
+
             user = f"{os.getuid()}:{os.getgid()}"
             docker_run_container(
                 self.container_name,
@@ -95,6 +110,9 @@ class DockerRunner(AbstractDockerRunner):
                 volumes=self.volumes,
                 user=user,
             )
+            # A container this process created is removed when it exits, and
+            # only that one: another process may still be using one it found.
+            atexit.register(self.dispose)
 
     def stop(self) -> None:
         from wexample_helpers.helper.docker import (