docker-composer 5.1.3__tar.gz → 5.2.0__tar.gz

{docker_composer-5.1.3 → docker_composer-5.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: docker-composer
-Version: 5.1.3
+Version: 5.2.0
 Summary: Use docker-compose (V2) from within Python
 Project-URL: Homepage, https://github.com/schollm/docker-composer
 Project-URL: Repository, https://github.com/schollm/docker-composer
@@ -16,9 +16,6 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Topic :: Software Development :: Build Tools
 Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
 Requires-Python: <4.0,>=3.9
-Provides-Extra: generate
-Requires-Dist: black>=25.1.0; extra == 'generate'
-Requires-Dist: isort>=6.0.1; extra == 'generate'
 Description-Content-Type: text/markdown
 
 # Docker Composer
@@ -71,16 +68,13 @@ print(process.stdout.encode("UTF-8"))
 
 ### Development Setup
 
-The `generate` extra is maintainer tooling for code generation/formatting and is not required for normal package usage.
+When developing, the `_utils` module is available for generating the docker_composer
+module from the `docker compose`CLI help output.
+This is not required for normal package usage.
 
 ```bash
-uv sync --group dev --extra generate
-```
-
-If you only need the generation tooling, you can install just the extra:
-
-```bash
-uv sync --extra generate
+uv sync --group dev
+uv run poe generate
 ```
 
 ### Coding Standards

{docker_composer-5.1.3 → docker_composer-5.2.0}/README.md

@@ -48,16 +48,13 @@ print(process.stdout.encode("UTF-8"))
 
 ### Development Setup
 
-The `generate` extra is maintainer tooling for code generation/formatting and is not required for normal package usage.
+When developing, the `_utils` module is available for generating the docker_composer
+module from the `docker compose`CLI help output.
+This is not required for normal package usage.
 
 ```bash
-uv sync --group dev --extra generate
-```
-
-If you only need the generation tooling, you can install just the extra:
-
-```bash
-uv sync --extra generate
+uv sync --group dev
+uv run poe generate
 ```
 
 ### Coding Standards

{docker_composer-5.1.3 → docker_composer-5.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "docker-composer"
-version = "5.1.3"
+version = "5.2.0"
 description = "Use docker-compose (V2) from within Python"
 authors = [{ name = "Micha", email = "schollm-git@gmx.com" }]
 requires-python = ">=3.9,<4.0"
@@ -18,20 +18,15 @@ classifiers = [
 ]
 dependencies = []
 
-[project.optional-dependencies]
-generate = [
-    "black>=25.1.0",
-    "isort>=6.0.1",
-]
-
 [project.urls]
 Homepage = "https://github.com/schollm/docker-composer"
 Repository = "https://github.com/schollm/docker-composer"
 
 [dependency-groups]
 dev = [
-    "black",
-    "isort",
+    "black>=25.1.0",
+    "isort>=6.0.1",
+    "poethepoet>=0.30.0",
     "pytest>=6.1.2",
     "pytest-cov>=6.1.1",
     "ruff>=0.11.10",
@@ -57,8 +52,20 @@ addopts = """
   --cov=src/docker_composer
   --cov-report=xml:.out/coverage.xml
   --cov-report=html:.out/coverage-html
-  --cov-report term-missing
+  --cov-report term-missing:skip-covered
   --cov-branch
   --doctest-modules
 """
 
+[tool.poe.tasks]
+ruff-check = { cmd = "uv run ruff check" }
+ruff-format-check = { cmd = "uv run ruff format --check" }
+pytest =  { cmd = "uv run pytest" }
+format = { cmd = "uv run ruff format" }
+build = { cmd = "uv build" }
+publish-dist = { cmd = "uv publish" }
+generate-code = { cmd = "uv run python -m docker_composer._utils.generate_class" }
+sync-version = { cmd = "uv run python -m docker_composer._utils.sync_version" }
+publish = { sequence = ["build", "publish-dist"] }
+test = { sequence = ["ruff-check", "ruff-format-check", "pytest $POE_EXTRA_ARGS"] }
+generate = { sequence = ["generate-code", "sync-version"] }

{docker_composer-5.1.3 → docker_composer-5.2.0}/src/docker_composer/_utils/argument.py

@@ -1,3 +1,6 @@
+"""Helper modules to parse docker compoose --help arguments"""
+
+from __future__ import annotations
 from typing import Iterable, Iterator
 
 import logging
@@ -137,16 +140,15 @@ def _from_line_has_sep(line) -> "Argument":
     min_arg_chars = 2  #  Simple argument with single dash (e.g. -x)
     min_full_chars = 4  # Named argument with double-dash (e.g. --xy)
     desc_idx = line[min_arg_chars:].index("  ")
+    # Help output can wrap differently depending on terminal width.
+    # Normalize all whitespace so wrapped descriptions are stable.
     desc = line[desc_idx + min_full_chars :].strip()
     args = iter(line[: desc_idx + min_full_chars].split())
     arg, default, has_more = "", "", True
     while has_more:
         arg, default, has_more = _parse_arg(next(args))
     type_from_default = _get_type_name_from_default(default)
-    try:
-        type_desc = next(args)
-    except StopIteration:
-        type_desc = type_from_default
+    type_desc = next(args, type_from_default)
 
     type_ = _get_type(type_from_default if default else type_desc)
     return Argument(arg, type_desc, type_, desc, default=default)

{docker_composer-5.1.3 → docker_composer-5.2.0}/src/docker_composer/_utils/generate_class.py

@@ -15,6 +15,9 @@ import logging
 
 logger = logging.getLogger(__name__)
 
+# must be larger than 50 (otherwise it's ignored by docker compose)
+_DEFAULT_HELP_COLUMNS = 120
+
 
 @lru_cache()
 def project_root():
@@ -35,18 +38,20 @@ def _version() -> str:
 @lru_cache()
 def get_help_message(subcommand: str = "") -> str:
     """Obtain the help message for subcommand from docker-compose."""
-    args = [arg for arg in ["docker", "compose", subcommand, "--help"] if arg]
+    cmd = " ".join(arg for arg in ["docker", "compose", subcommand, "--help"] if arg)
+    full_cmd = f"stty cols {_DEFAULT_HELP_COLUMNS}; {cmd}"
     try:
-        process = subprocess.run(args, capture_output=True, text=True)
+        process = subprocess.run(
+            ["script", "-q", "-c", full_cmd, "/dev/null"],
+            capture_output=True,
+            text=True,
+        )
     except Exception:
-        logger.error("FAILED to run %s.", args)
+        logger.error("FAILED to run %s.", full_cmd)
         raise
     if process.returncode:
-        logger.error(
-            "docker-compose %s --help exited with %s:", subcommand, process.returncode
-        )
+        logger.error("%s exited with %s:", cmd, process.returncode)
         raise RuntimeError(process.stderr)
-
     return process.stdout
 
 
@@ -147,10 +152,10 @@ def {cmd}(self, {args}) -> {class_name}:
         )
 
 
-def generate_class(cmd: str, level: int = 0) -> str:
+def generate_class(cmd: str) -> str:
     class_name = f"DockerCompose{(cmd or 'Root').capitalize()}"
     docker_lines = get_help_message(cmd)
-    nl = level + 4
+    nl = 4
     sections, arguments = parse_help(docker_lines)
     _add_custom_arguments(cmd, arguments)
     cmd_fns = ""
@@ -167,8 +172,8 @@ def generate_class(cmd: str, level: int = 0) -> str:
     if options:
         options = options + ","
     new_line = "\n"  # Python 3.9 does not support backslashes in format-strings.
-    res = indent(
-        f'''
+
+    res = f'''
 # DO NOT EDIT: Autogenerated by {"/".join(Path(__file__).parts[-3:])}
 # for {_version()}
 
@@ -187,9 +192,7 @@ class {class_name}(DockerBaseRunner):
     _cmd: str = _dc.field(default="{cmd or ""}", repr=False, init=False)
     _options: list[str] = _dc.field(default_factory=lambda: [{options}], repr=False, init=False)
 {indent(cmd_fns, level=nl)}
-''',
-        level=level,
-    )
+        '''
     try:
         res = isort.code(
             res, config=isort.Config(settings_path=project_root().as_posix())

docker_composer-5.2.0/src/docker_composer/_utils/sync_version.py

@@ -0,0 +1,21 @@
+from __future__ import annotations
+
+import subprocess
+
+
+def docker_compose_version_short() -> str:
+    return subprocess.check_output(
+        ["docker", "compose", "version", "--short"],
+        text=True,
+    ).strip()
+
+
+def main() -> None:
+    version = docker_compose_version_short()
+    if not version:
+        raise RuntimeError("docker compose version --short returned an empty version")
+    subprocess.check_call(["uv", "version", version])
+
+
+if __name__ == "__main__":
+    main()  # pragma: no cover

{docker_composer-5.1.3 → docker_composer-5.2.0}/src/docker_composer/runner/cmd/attach.py

@@ -1,5 +1,5 @@
 # DO NOT EDIT: Autogenerated by docker_composer/_utils/generate_class.py
-# for Docker Compose version v5.1.3
+# for Docker Compose version v5.2.0
 
 import dataclasses as _dc
 from typing import Optional

{docker_composer-5.1.3 → docker_composer-5.2.0}/src/docker_composer/runner/cmd/build.py

@@ -1,5 +1,5 @@
 # DO NOT EDIT: Autogenerated by docker_composer/_utils/generate_class.py
-# for Docker Compose version v5.1.3
+# for Docker Compose version v5.2.0
 
 import dataclasses as _dc
 from typing import Optional
@@ -39,7 +39,8 @@ class DockerComposeBuild(DockerBaseRunner):
     sbom: Optional[str] = None
     """Add a SBOM attestation"""
     ssh: Optional[str] = None
-    """Set SSH authentications used when building service images. (use 'default' for using your default SSH Agent)"""
+    """Set SSH authentications used when building service images. (use 'default' for
+       using your default SSH Agent)"""
     with_dependencies: Optional[bool] = None
     """Also build dependencies (transitively)"""
     _cmd: str = _dc.field(default="build", repr=False, init=False)

{docker_composer-5.1.3 → docker_composer-5.2.0}/src/docker_composer/runner/cmd/commit.py

@@ -1,5 +1,5 @@
 # DO NOT EDIT: Autogenerated by docker_composer/_utils/generate_class.py
-# for Docker Compose version v5.1.3
+# for Docker Compose version v5.2.0
 
 import dataclasses as _dc
 from typing import Optional

{docker_composer-5.1.3 → docker_composer-5.2.0}/src/docker_composer/runner/cmd/config.py

@@ -1,5 +1,5 @@
 # DO NOT EDIT: Autogenerated by docker_composer/_utils/generate_class.py
-# for Docker Compose version v5.1.3
+# for Docker Compose version v5.2.0
 
 import dataclasses as _dc
 from typing import Optional

{docker_composer-5.1.3 → docker_composer-5.2.0}/src/docker_composer/runner/cmd/cp.py

@@ -1,5 +1,5 @@
 # DO NOT EDIT: Autogenerated by docker_composer/_utils/generate_class.py
-# for Docker Compose version v5.1.3
+# for Docker Compose version v5.2.0
 
 import dataclasses as _dc
 from typing import Optional

{docker_composer-5.1.3 → docker_composer-5.2.0}/src/docker_composer/runner/cmd/create.py

@@ -1,5 +1,5 @@
 # DO NOT EDIT: Autogenerated by docker_composer/_utils/generate_class.py
-# for Docker Compose version v5.1.3
+# for Docker Compose version v5.2.0
 
 import dataclasses as _dc
 from typing import Optional

{docker_composer-5.1.3 → docker_composer-5.2.0}/src/docker_composer/runner/cmd/down.py

@@ -1,5 +1,5 @@
 # DO NOT EDIT: Autogenerated by docker_composer/_utils/generate_class.py
-# for Docker Compose version v5.1.3
+# for Docker Compose version v5.2.0
 
 import dataclasses as _dc
 from typing import Optional
@@ -19,11 +19,13 @@ class DockerComposeDown(DockerBaseRunner):
     remove_orphans: Optional[bool] = None
     """Remove containers for services not defined in the Compose file"""
     rmi: Optional[str] = None
-    """Remove images used by services. "local" remove only images that don't have a custom tag ("local"|"all")"""
+    """Remove images used by services. "local" remove only images that don't have a custom tag
+       ("local"|"all")"""
     timeout: Optional[int] = None
     """Specify a shutdown timeout in seconds"""
     volumes: Optional[bool] = None
-    """Remove named volumes declared in the "volumes" section of the Compose file and anonymous volumes attached to containers"""
+    """Remove named volumes declared in the "volumes" section of the Compose file and anonymous
+       volumes attached to containers"""
     _cmd: str = _dc.field(default="down", repr=False, init=False)
     _options: list[str] = _dc.field(
         default_factory=lambda: [

{docker_composer-5.1.3 → docker_composer-5.2.0}/src/docker_composer/runner/cmd/events.py

@@ -1,5 +1,5 @@
 # DO NOT EDIT: Autogenerated by docker_composer/_utils/generate_class.py
-# for Docker Compose version v5.1.3
+# for Docker Compose version v5.2.0
 
 import dataclasses as _dc
 from typing import Optional

{docker_composer-5.1.3 → docker_composer-5.2.0}/src/docker_composer/runner/cmd/exec.py

@@ -1,5 +1,5 @@
 # DO NOT EDIT: Autogenerated by docker_composer/_utils/generate_class.py
-# for Docker Compose version v5.1.3
+# for Docker Compose version v5.2.0
 
 import dataclasses as _dc
 from typing import Optional
@@ -23,7 +23,7 @@ class DockerComposeExec(DockerBaseRunner):
     index: Optional[int] = None
     """Index of the container if service has multiple replicas"""
     no_tty: Optional[bool] = None
-    """Disable pseudo-TTY allocation. By default 'docker compose exec' allocates a TTY. (default true)"""
+    """Disable pseudo-TTY allocation. By default 'docker compose exec' allocates a TTY."""
     privileged: Optional[bool] = None
     """Give extended privileges to the process"""
     user: Optional[str] = None

{docker_composer-5.1.3 → docker_composer-5.2.0}/src/docker_composer/runner/cmd/export.py

@@ -1,5 +1,5 @@
 # DO NOT EDIT: Autogenerated by docker_composer/_utils/generate_class.py
-# for Docker Compose version v5.1.3
+# for Docker Compose version v5.2.0
 
 import dataclasses as _dc
 from typing import Optional

{docker_composer-5.1.3 → docker_composer-5.2.0}/src/docker_composer/runner/cmd/images.py

@@ -1,5 +1,5 @@
 # DO NOT EDIT: Autogenerated by docker_composer/_utils/generate_class.py
-# for Docker Compose version v5.1.3
+# for Docker Compose version v5.2.0
 
 import dataclasses as _dc
 from typing import Optional

{docker_composer-5.1.3 → docker_composer-5.2.0}/src/docker_composer/runner/cmd/kill.py

@@ -1,5 +1,5 @@
 # DO NOT EDIT: Autogenerated by docker_composer/_utils/generate_class.py
-# for Docker Compose version v5.1.3
+# for Docker Compose version v5.2.0
 
 import dataclasses as _dc
 from typing import Optional

{docker_composer-5.1.3 → docker_composer-5.2.0}/src/docker_composer/runner/cmd/logs.py

@@ -1,5 +1,5 @@
 # DO NOT EDIT: Autogenerated by docker_composer/_utils/generate_class.py
-# for Docker Compose version v5.1.3
+# for Docker Compose version v5.2.0
 
 import dataclasses as _dc
 from typing import Optional

{docker_composer-5.1.3 → docker_composer-5.2.0}/src/docker_composer/runner/cmd/ls.py

@@ -1,5 +1,5 @@
 # DO NOT EDIT: Autogenerated by docker_composer/_utils/generate_class.py
-# for Docker Compose version v5.1.3
+# for Docker Compose version v5.2.0
 
 import dataclasses as _dc
 from typing import Optional

{docker_composer-5.1.3 → docker_composer-5.2.0}/src/docker_composer/runner/cmd/pause.py

@@ -1,5 +1,5 @@
 # DO NOT EDIT: Autogenerated by docker_composer/_utils/generate_class.py
-# for Docker Compose version v5.1.3
+# for Docker Compose version v5.2.0
 
 import dataclasses as _dc
 from typing import Optional

{docker_composer-5.1.3 → docker_composer-5.2.0}/src/docker_composer/runner/cmd/port.py

@@ -1,5 +1,5 @@
 # DO NOT EDIT: Autogenerated by docker_composer/_utils/generate_class.py
-# for Docker Compose version v5.1.3
+# for Docker Compose version v5.2.0
 
 import dataclasses as _dc
 from typing import Optional

{docker_composer-5.1.3 → docker_composer-5.2.0}/src/docker_composer/runner/cmd/ps.py

@@ -1,5 +1,5 @@
 # DO NOT EDIT: Autogenerated by docker_composer/_utils/generate_class.py
-# for Docker Compose version v5.1.3
+# for Docker Compose version v5.2.0
 
 import dataclasses as _dc
 from typing import Optional
@@ -26,7 +26,8 @@ class DockerComposePs(DockerBaseRunner):
        'table TEMPLATE':   Print output in table format using the given Go template
        'json':             Print in JSON format
        'TEMPLATE':         Print output using the given Go template.
-       Refer to https://docs.docker.com/go/formatting/ for more information about formatting output with templates (default "table")"""
+       Refer to https://docs.docker.com/go/formatting/ for more information about
+       formatting output with templates (default "table")"""
     no_trunc: Optional[bool] = None
     """Don't truncate output"""
     orphans: Optional[bool] = None
@@ -36,7 +37,8 @@ class DockerComposePs(DockerBaseRunner):
     services: Optional[bool] = None
     """Display services"""
     status: Optional[list] = None
-    """Filter services by status. Values: [paused | restarting | removing | running | dead | created | exited]"""
+    """Filter services by status. Values: [paused | restarting | removing | running | dead
+       | created | exited]"""
     _cmd: str = _dc.field(default="ps", repr=False, init=False)
     _options: list[str] = _dc.field(
         default_factory=lambda: [

{docker_composer-5.1.3 → docker_composer-5.2.0}/src/docker_composer/runner/cmd/publish.py

@@ -1,5 +1,5 @@
 # DO NOT EDIT: Autogenerated by docker_composer/_utils/generate_class.py
-# for Docker Compose version v5.1.3
+# for Docker Compose version v5.2.0
 
 import dataclasses as _dc
 from typing import Optional

{docker_composer-5.1.3 → docker_composer-5.2.0}/src/docker_composer/runner/cmd/pull.py

@@ -1,5 +1,5 @@
 # DO NOT EDIT: Autogenerated by docker_composer/_utils/generate_class.py
-# for Docker Compose version v5.1.3
+# for Docker Compose version v5.2.0
 
 import dataclasses as _dc
 from typing import Optional

{docker_composer-5.1.3 → docker_composer-5.2.0}/src/docker_composer/runner/cmd/push.py

@@ -1,5 +1,5 @@
 # DO NOT EDIT: Autogenerated by docker_composer/_utils/generate_class.py
-# for Docker Compose version v5.1.3
+# for Docker Compose version v5.2.0
 
 import dataclasses as _dc
 from typing import Optional

{docker_composer-5.1.3 → docker_composer-5.2.0}/src/docker_composer/runner/cmd/restart.py

@@ -1,5 +1,5 @@
 # DO NOT EDIT: Autogenerated by docker_composer/_utils/generate_class.py
-# for Docker Compose version v5.1.3
+# for Docker Compose version v5.2.0
 
 import dataclasses as _dc
 from typing import Optional

{docker_composer-5.1.3 → docker_composer-5.2.0}/src/docker_composer/runner/cmd/rm.py

@@ -1,5 +1,5 @@
 # DO NOT EDIT: Autogenerated by docker_composer/_utils/generate_class.py
-# for Docker Compose version v5.1.3
+# for Docker Compose version v5.2.0
 
 import dataclasses as _dc
 from typing import Optional

{docker_composer-5.1.3 → docker_composer-5.2.0}/src/docker_composer/runner/cmd/run.py

@@ -1,5 +1,5 @@
 # DO NOT EDIT: Autogenerated by docker_composer/_utils/generate_class.py
-# for Docker Compose version v5.1.3
+# for Docker Compose version v5.2.0
 
 import dataclasses as _dc
 from typing import Optional
@@ -37,7 +37,7 @@ class DockerComposeRun(DockerBaseRunner):
     name: Optional[str] = None
     """Assign a name to the container"""
     no_TTY: Optional[bool] = None
-    """Disable pseudo-TTY allocation (default: auto-detected) (default true)"""
+    """Disable pseudo-TTY allocation (default: auto-detected)"""
     no_deps: Optional[bool] = None
     """Don't start linked services"""
     publish: Optional[list] = None

{docker_composer-5.1.3 → docker_composer-5.2.0}/src/docker_composer/runner/cmd/scale.py

@@ -1,5 +1,5 @@
 # DO NOT EDIT: Autogenerated by docker_composer/_utils/generate_class.py
-# for Docker Compose version v5.1.3
+# for Docker Compose version v5.2.0
 
 import dataclasses as _dc
 from typing import Optional

{docker_composer-5.1.3 → docker_composer-5.2.0}/src/docker_composer/runner/cmd/start.py

@@ -1,5 +1,5 @@
 # DO NOT EDIT: Autogenerated by docker_composer/_utils/generate_class.py
-# for Docker Compose version v5.1.3
+# for Docker Compose version v5.2.0
 
 import dataclasses as _dc
 from typing import Optional

{docker_composer-5.1.3 → docker_composer-5.2.0}/src/docker_composer/runner/cmd/stats.py

@@ -1,5 +1,5 @@
 # DO NOT EDIT: Autogenerated by docker_composer/_utils/generate_class.py
-# for Docker Compose version v5.1.3
+# for Docker Compose version v5.2.0
 
 import dataclasses as _dc
 from typing import Optional
@@ -24,7 +24,8 @@ class DockerComposeStats(DockerBaseRunner):
        'table TEMPLATE':   Print output in table format using the given Go template
        'json':             Print in JSON format
        'TEMPLATE':         Print output using the given Go template.
-       Refer to https://docs.docker.com/engine/cli/formatting/ for more information about formatting output with templates"""
+       Refer to https://docs.docker.com/engine/cli/formatting/ for more information about
+       formatting output with templates"""
     no_stream: Optional[bool] = None
     """Disable streaming stats and only pull the first result"""
     no_trunc: Optional[bool] = None

{docker_composer-5.1.3 → docker_composer-5.2.0}/src/docker_composer/runner/cmd/stop.py

@@ -1,5 +1,5 @@
 # DO NOT EDIT: Autogenerated by docker_composer/_utils/generate_class.py
-# for Docker Compose version v5.1.3
+# for Docker Compose version v5.2.0
 
 import dataclasses as _dc
 from typing import Optional

{docker_composer-5.1.3 → docker_composer-5.2.0}/src/docker_composer/runner/cmd/top.py

@@ -1,5 +1,5 @@
 # DO NOT EDIT: Autogenerated by docker_composer/_utils/generate_class.py
-# for Docker Compose version v5.1.3
+# for Docker Compose version v5.2.0
 
 import dataclasses as _dc
 from typing import Optional

{docker_composer-5.1.3 → docker_composer-5.2.0}/src/docker_composer/runner/cmd/unpause.py

@@ -1,5 +1,5 @@
 # DO NOT EDIT: Autogenerated by docker_composer/_utils/generate_class.py
-# for Docker Compose version v5.1.3
+# for Docker Compose version v5.2.0
 
 import dataclasses as _dc
 from typing import Optional

{docker_composer-5.1.3 → docker_composer-5.2.0}/src/docker_composer/runner/cmd/up.py

@@ -1,5 +1,5 @@
 # DO NOT EDIT: Autogenerated by docker_composer/_utils/generate_class.py
-# for Docker Compose version v5.1.3
+# for Docker Compose version v5.2.0
 
 import dataclasses as _dc
 from typing import Optional
@@ -21,7 +21,8 @@ class DockerComposeUp(DockerBaseRunner):
     always_recreate_deps: Optional[bool] = None
     """Recreate dependent containers. Incompatible with --no-recreate."""
     attach: Optional[list] = None
-    """Restrict attaching to the specified services. Incompatible with --attach-dependencies."""
+    """Restrict attaching to the specified services. Incompatible with
+       --attach-dependencies."""
     attach_dependencies: Optional[bool] = None
     """Automatically attach to log output of dependent services"""
     build: Optional[bool] = None
@@ -31,11 +32,13 @@ class DockerComposeUp(DockerBaseRunner):
     dry_run: Optional[bool] = None
     """Execute command in dry run mode"""
     exit_code_from: Optional[str] = None
-    """Return the exit code of the selected service container. Implies --abort-on-container-exit"""
+    """Return the exit code of the selected service container. Implies
+       --abort-on-container-exit"""
     force_recreate: Optional[bool] = None
     """Recreate containers even if their configuration and image haven't changed"""
     menu: Optional[bool] = None
-    """Enable interactive shortcuts when running attached. Incompatible with --detach. Can also be enable/disable by setting COMPOSE_MENU environment var."""
+    """Enable interactive shortcuts when running attached. Incompatible with
+       --detach. Can also be enable/disable by setting COMPOSE_MENU environment var."""
     no_attach: Optional[list] = None
     """Do not attach (stream logs) to the specified services"""
     no_build: Optional[bool] = None
@@ -47,7 +50,8 @@ class DockerComposeUp(DockerBaseRunner):
     no_log_prefix: Optional[bool] = None
     """Don't print prefix in logs"""
     no_recreate: Optional[bool] = None
-    """If containers already exist, don't recreate them. Incompatible with --force-recreate."""
+    """If containers already exist, don't recreate them. Incompatible with
+       --force-recreate."""
     no_start: Optional[bool] = None
     """Don't start the services after creating them"""
     pull: Optional[str] = None
@@ -59,11 +63,14 @@ class DockerComposeUp(DockerBaseRunner):
     remove_orphans: Optional[bool] = None
     """Remove containers for services not defined in the Compose file"""
     renew_anon_volumes: Optional[bool] = None
-    """Recreate anonymous volumes instead of retrieving data from the previous containers"""
+    """Recreate anonymous volumes instead of retrieving data from the previous
+       containers"""
     scale: Optional[int] = None
-    """Scale SERVICE to NUM instances. Overrides the scale setting in the Compose file if present."""
+    """Scale SERVICE to NUM instances. Overrides the scale setting in the Compose
+       file if present."""
     timeout: Optional[int] = None
-    """Use this timeout in seconds for container shutdown when attached or when containers are already running"""
+    """Use this timeout in seconds for container shutdown when attached or when
+       containers are already running"""
     timestamps: Optional[bool] = None
     """Show timestamps"""
     wait: Optional[bool] = None

{docker_composer-5.1.3 → docker_composer-5.2.0}/src/docker_composer/runner/cmd/version.py

@@ -1,5 +1,5 @@
 # DO NOT EDIT: Autogenerated by docker_composer/_utils/generate_class.py
-# for Docker Compose version v5.1.3
+# for Docker Compose version v5.2.0
 
 import dataclasses as _dc
 from typing import Optional

{docker_composer-5.1.3 → docker_composer-5.2.0}/src/docker_composer/runner/cmd/volumes.py

@@ -1,5 +1,5 @@
 # DO NOT EDIT: Autogenerated by docker_composer/_utils/generate_class.py
-# for Docker Compose version v5.1.3
+# for Docker Compose version v5.2.0
 
 import dataclasses as _dc
 from typing import Optional
@@ -22,7 +22,8 @@ class DockerComposeVolumes(DockerBaseRunner):
        'table TEMPLATE':   Print output in table format using the given Go template
        'json':             Print in JSON format
        'TEMPLATE':         Print output using the given Go template.
-       Refer to https://docs.docker.com/go/formatting/ for more information about formatting output with templates (default "table")"""
+       Refer to https://docs.docker.com/go/formatting/ for more information about formatting
+       output with templates (default "table")"""
     quiet: Optional[bool] = None
     """Only display volume names"""
     _cmd: str = _dc.field(default="volumes", repr=False, init=False)

{docker_composer-5.1.3 → docker_composer-5.2.0}/src/docker_composer/runner/cmd/wait.py

@@ -1,5 +1,5 @@
 # DO NOT EDIT: Autogenerated by docker_composer/_utils/generate_class.py
-# for Docker Compose version v5.1.3
+# for Docker Compose version v5.2.0
 
 import dataclasses as _dc
 from typing import Optional

{docker_composer-5.1.3 → docker_composer-5.2.0}/src/docker_composer/runner/cmd/watch.py

@@ -1,5 +1,5 @@
 # DO NOT EDIT: Autogenerated by docker_composer/_utils/generate_class.py
-# for Docker Compose version v5.1.3
+# for Docker Compose version v5.2.0
 
 import dataclasses as _dc
 from typing import Optional

{docker_composer-5.1.3 → docker_composer-5.2.0}/src/docker_composer/runner/root.py

@@ -1,5 +1,5 @@
 # DO NOT EDIT: Autogenerated by docker_composer/_utils/generate_class.py
-# for Docker Compose version v5.1.3
+# for Docker Compose version v5.2.0
 
 import dataclasses as _dc
 from typing import Optional
@@ -54,7 +54,8 @@ class DockerComposeRoot(DockerBaseRunner):
     all_resources: Optional[bool] = None
     """Include all resources, even those not used by services"""
     ansi: Optional[str] = None
-    """Control when to print ANSI control characters ("never"|"always"|"auto") (default "auto")"""
+    """Control when to print ANSI control characters ("never"|"always"|"auto")
+       (default "auto")"""
     compatibility: Optional[bool] = None
     """Run compose in backward compatibility mode"""
     dry_run: Optional[bool] = None
@@ -145,7 +146,8 @@ class DockerComposeRoot(DockerBaseRunner):
         :param push: Push service images
         :param quiet: Suppress the build output
         :param sbom: Add a SBOM attestation
-        :param ssh: Set SSH authentications used when building service images. (use 'default' for using your default SSH Agent)
+        :param ssh: Set SSH authentications used when building service images. (use 'default' for
+           using your default SSH Agent)
         :param with_dependencies: Also build dependencies (transitively)
         """
         runner = docker_composer.runner.cmd.build.DockerComposeBuild(
@@ -307,9 +309,11 @@ class DockerComposeRoot(DockerBaseRunner):
 
         :param dry_run: Execute command in dry run mode
         :param remove_orphans: Remove containers for services not defined in the Compose file
-        :param rmi: Remove images used by services. "local" remove only images that don't have a custom tag ("local"|"all")
+        :param rmi: Remove images used by services. "local" remove only images that don't have a custom tag
+           ("local"|"all")
         :param timeout: Specify a shutdown timeout in seconds
-        :param volumes: Remove named volumes declared in the "volumes" section of the Compose file and anonymous volumes attached to containers
+        :param volumes: Remove named volumes declared in the "volumes" section of the Compose file and anonymous
+           volumes attached to containers
         """
         runner = docker_composer.runner.cmd.down.DockerComposeDown(
             **{k: v for k, v in locals().items() if k != "self"}
@@ -358,7 +362,7 @@ class DockerComposeRoot(DockerBaseRunner):
         :param dry_run: Execute command in dry run mode
         :param env: Set environment variables
         :param index: Index of the container if service has multiple replicas
-        :param no_tty: Disable pseudo-TTY allocation. By default 'docker compose exec' allocates a TTY. (default true)
+        :param no_tty: Disable pseudo-TTY allocation. By default 'docker compose exec' allocates a TTY.
         :param privileged: Give extended privileges to the process
         :param user: Run the command as this user
         :param workdir: Path to workdir directory for this command
@@ -544,12 +548,14 @@ class DockerComposeRoot(DockerBaseRunner):
            'table TEMPLATE':   Print output in table format using the given Go template
            'json':             Print in JSON format
            'TEMPLATE':         Print output using the given Go template.
-           Refer to https://docs.docker.com/go/formatting/ for more information about formatting output with templates (default "table")
+           Refer to https://docs.docker.com/go/formatting/ for more information about
+           formatting output with templates (default "table")
         :param no_trunc: Don't truncate output
         :param orphans: Include orphaned services (not declared by project) (default true)
         :param quiet: Only display IDs
         :param services: Display services
-        :param status: Filter services by status. Values: [paused | restarting | removing | running | dead | created | exited]
+        :param status: Filter services by status. Values: [paused | restarting | removing | running | dead
+           | created | exited]
         """
         runner = docker_composer.runner.cmd.ps.DockerComposePs(
             **{k: v for k, v in locals().items() if k != "self"}
@@ -719,7 +725,7 @@ class DockerComposeRoot(DockerBaseRunner):
         :param interactive: Keep STDIN open even if not attached (default true)
         :param label: Add or override a label
         :param name: Assign a name to the container
-        :param no_TTY: Disable pseudo-TTY allocation (default: auto-detected) (default true)
+        :param no_TTY: Disable pseudo-TTY allocation (default: auto-detected)
         :param no_deps: Don't start linked services
         :param publish: Publish a container's port(s) to the host
         :param pull: Pull image before running ("always"|"missing"|"never") (default "policy")
@@ -795,7 +801,8 @@ class DockerComposeRoot(DockerBaseRunner):
            'table TEMPLATE':   Print output in table format using the given Go template
            'json':             Print in JSON format
            'TEMPLATE':         Print output using the given Go template.
-           Refer to https://docs.docker.com/engine/cli/formatting/ for more information about formatting output with templates
+           Refer to https://docs.docker.com/engine/cli/formatting/ for more information about
+           formatting output with templates
         :param no_stream: Disable streaming stats and only pull the first result
         :param no_trunc: Do not truncate output
         """
@@ -891,28 +898,35 @@ class DockerComposeRoot(DockerBaseRunner):
         :param abort_on_container_exit: Stops all containers if any container was stopped. Incompatible with -d
         :param abort_on_container_failure: Stops all containers if any container exited with failure. Incompatible with -d
         :param always_recreate_deps: Recreate dependent containers. Incompatible with --no-recreate.
-        :param attach: Restrict attaching to the specified services. Incompatible with --attach-dependencies.
+        :param attach: Restrict attaching to the specified services. Incompatible with
+           --attach-dependencies.
         :param attach_dependencies: Automatically attach to log output of dependent services
         :param build: Build images before starting containers
         :param detach: Detached mode: Run containers in the background
         :param dry_run: Execute command in dry run mode
-        :param exit_code_from: Return the exit code of the selected service container. Implies --abort-on-container-exit
+        :param exit_code_from: Return the exit code of the selected service container. Implies
+           --abort-on-container-exit
         :param force_recreate: Recreate containers even if their configuration and image haven't changed
-        :param menu: Enable interactive shortcuts when running attached. Incompatible with --detach. Can also be enable/disable by setting COMPOSE_MENU environment var.
+        :param menu: Enable interactive shortcuts when running attached. Incompatible with
+           --detach. Can also be enable/disable by setting COMPOSE_MENU environment var.
         :param no_attach: Do not attach (stream logs) to the specified services
         :param no_build: Don't build an image, even if it's policy
         :param no_color: Produce monochrome output
         :param no_deps: Don't start linked services
         :param no_log_prefix: Don't print prefix in logs
-        :param no_recreate: If containers already exist, don't recreate them. Incompatible with --force-recreate.
+        :param no_recreate: If containers already exist, don't recreate them. Incompatible with
+           --force-recreate.
         :param no_start: Don't start the services after creating them
         :param pull: Pull image before running ("always"|"missing"|"never") (default "policy")
         :param quiet_build: Suppress the build output
         :param quiet_pull: Pull without printing progress information
         :param remove_orphans: Remove containers for services not defined in the Compose file
-        :param renew_anon_volumes: Recreate anonymous volumes instead of retrieving data from the previous containers
-        :param scale: Scale SERVICE to NUM instances. Overrides the scale setting in the Compose file if present.
-        :param timeout: Use this timeout in seconds for container shutdown when attached or when containers are already running
+        :param renew_anon_volumes: Recreate anonymous volumes instead of retrieving data from the previous
+           containers
+        :param scale: Scale SERVICE to NUM instances. Overrides the scale setting in the Compose
+           file if present.
+        :param timeout: Use this timeout in seconds for container shutdown when attached or when
+           containers are already running
         :param timestamps: Show timestamps
         :param wait: Wait for services to be running|healthy. Implies detached mode.
         :param wait_timeout: Maximum duration in seconds to wait for the project to be running|healthy
@@ -961,7 +975,8 @@ class DockerComposeRoot(DockerBaseRunner):
            'table TEMPLATE':   Print output in table format using the given Go template
            'json':             Print in JSON format
            'TEMPLATE':         Print output using the given Go template.
-           Refer to https://docs.docker.com/go/formatting/ for more information about formatting output with templates (default "table")
+           Refer to https://docs.docker.com/go/formatting/ for more information about formatting
+           output with templates (default "table")
         :param quiet: Only display volume names
         """
         runner = docker_composer.runner.cmd.volumes.DockerComposeVolumes(