dycw-utilities 0.175.30__py3-none-any.whl → 0.175.32__py3-none-any.whl

{dycw_utilities-0.175.30.dist-info → dycw_utilities-0.175.32.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: dycw-utilities
-Version: 0.175.30
+Version: 0.175.32
 Summary: Miscellaneous Python utilities
 Author: Derek Wan
 Author-email: Derek Wan <d.wan@icloud.com>

{dycw_utilities-0.175.30.dist-info → dycw_utilities-0.175.32.dist-info}/RECORD

@@ -1,4 +1,4 @@
-utilities/__init__.py,sha256=MtsJJrbSJrW256hO7llrT3qk9914hd3MBaFYuonK4KU,61
+utilities/__init__.py,sha256=7U4Xd87qzllL41jIo34W_Ske0_0FA06dOeqtqpEx2p8,61
 utilities/altair.py,sha256=TLfRFbG9HwG7SLXoJ-v0r-t49ZaGgTQZD82cpjVi4vs,9085
 utilities/asyncio.py,sha256=aJySVxBY0gqsIYnoNmH7-1r8djKuf4vSsU69VCD08t8,16772
 utilities/atomicwrites.py,sha256=tPo6r-Rypd9u99u66B9z86YBPpnLrlHtwox_8Z7T34Y,5790
@@ -11,7 +11,7 @@ utilities/contextvars.py,sha256=J8OhC7jqozAGYOCe2KUWysbPXNGe5JYz3HfaY_mIs08,883
 utilities/cryptography.py,sha256=5PFrzsNUGHay91dFgYnDKwYprXxahrBqztmUqViRzBk,956
 utilities/cvxpy.py,sha256=Rv1-fD-XYerosCavRF8Pohop2DBkU3AlFaGTfD8AEAA,13776
 utilities/dataclasses.py,sha256=xbU3QN1GFy7RC6hIJRZIeUZm7YRlodrgEWmahWG6k2g,32465
-utilities/docker.py,sha256=nzeuR5-OQKL2yhtY-SSqLS2ftl-iev0cUrshwEMwB2k,9808
+utilities/docker.py,sha256=0OQdmMvB_cgtRpUoWH98IMzlQyrcxEekGmgWvd8UUt4,10675
 utilities/enum.py,sha256=5l6pwZD1cjSlVW4ss-zBPspWvrbrYrdtJWcg6f5_J5w,5781
 utilities/errors.py,sha256=mFlDGSM0LI1jZ1pbqwLAH3ttLZ2JVIxyZLojw8tGVZU,1479
 utilities/fastapi.py,sha256=TqyKvBjiMS594sXPjrz-KRTLMb3l3D3rZ1zAYV7GfOk,1454
@@ -97,7 +97,7 @@ utilities/warnings.py,sha256=un1LvHv70PU-LLv8RxPVmugTzDJkkGXRMZTE2-fTQHw,1771
 utilities/whenever.py,sha256=F4ek0-OBWxHYrZdmoZt76N2RnNyKY5KrEHt7rqO4AQE,60183
 utilities/zipfile.py,sha256=24lQc9ATcJxHXBPc_tBDiJk48pWyRrlxO2fIsFxU0A8,699
 utilities/zoneinfo.py,sha256=tdIScrTB2-B-LH0ukb1HUXKooLknOfJNwHk10MuMYvA,3619
-dycw_utilities-0.175.30.dist-info/WHEEL,sha256=RRVLqVugUmFOqBedBFAmA4bsgFcROUBiSUKlERi0Hcg,79
-dycw_utilities-0.175.30.dist-info/entry_points.txt,sha256=cOGtKeJI0KXLSV7MJ8Dhc2G8jPgDcBDm53MVNJU4ycI,136
-dycw_utilities-0.175.30.dist-info/METADATA,sha256=X2Hiaa6YhG9ZkFu1AfxlEDbXKDKYepqcVZylTh5hVds,1443
-dycw_utilities-0.175.30.dist-info/RECORD,,
+dycw_utilities-0.175.32.dist-info/WHEEL,sha256=RRVLqVugUmFOqBedBFAmA4bsgFcROUBiSUKlERi0Hcg,79
+dycw_utilities-0.175.32.dist-info/entry_points.txt,sha256=cOGtKeJI0KXLSV7MJ8Dhc2G8jPgDcBDm53MVNJU4ycI,136
+dycw_utilities-0.175.32.dist-info/METADATA,sha256=Ydsvjv-Zb-V82ofDdKk1xhFSi7SsViGqFXBPHOp-clE,1443
+dycw_utilities-0.175.32.dist-info/RECORD,,

utilities/__init__.py

@@ -1,3 +1,3 @@
 from __future__ import annotations
 
-__version__ = "0.175.30"
+__version__ = "0.175.32"

utilities/docker.py

@@ -28,9 +28,18 @@ if TYPE_CHECKING:
     )
 
 
-def docker_compose_down(*, files: MaybeIterable[PathLike] | None = None) -> None:
+def docker_compose_down(
+    *,
+    files: MaybeIterable[PathLike] | None = None,
+    print: bool = False,  # noqa: A002
+    print_stdout: bool = False,
+    print_stderr: bool = False,
+) -> None:
     """Stop and remove containers."""
-    run(*docker_compose_down_cmd(files=files))  # pragma: no cover
+    args = docker_compose_down_cmd(files=files)  # pragma: no cover
+    run(  # pragma: no cover
+        *args, print=print, print_stdout=print_stdout, print_stderr=print_stderr
+    )
 
 
 def docker_compose_down_cmd(
@@ -40,9 +49,18 @@ def docker_compose_down_cmd(
     return _docker_compose_cmd("down", files=files)
 
 
-def docker_compose_pull(*, files: MaybeIterable[PathLike] | None = None) -> None:
+def docker_compose_pull(
+    *,
+    files: MaybeIterable[PathLike] | None = None,
+    print: bool = False,  # noqa: A002
+    print_stdout: bool = False,
+    print_stderr: bool = False,
+) -> None:
     """Pull service images."""
-    run(*docker_compose_pull_cmd(files=files))  # pragma: no cover
+    args = docker_compose_pull_cmd(files=files)  # pragma: no cover
+    run(  # pragma: no cover
+        *args, print=print, print_stdout=print_stdout, print_stderr=print_stderr
+    )
 
 
 def docker_compose_pull_cmd(
@@ -52,24 +70,39 @@ def docker_compose_pull_cmd(
     return _docker_compose_cmd("pull", files=files)
 
 
-def docker_compose_up(*, files: MaybeIterable[PathLike] | None = None) -> None:
+def docker_compose_up(
+    *,
+    files: MaybeIterable[PathLike] | None = None,
+    detach: bool = True,
+    print: bool = False,  # noqa: A002
+    print_stdout: bool = False,
+    print_stderr: bool = False,
+) -> None:
     """Create and start containers."""
-    run(*docker_compose_up_cmd(files=files))  # pragma: no cover
+    args = docker_compose_up_cmd(files=files, detach=detach)  # pragma: no cover
+    run(  # pragma: no cover
+        *args, print=print, print_stdout=print_stdout, print_stderr=print_stderr
+    )
 
 
-def docker_compose_up_cmd(*, files: MaybeIterable[PathLike] | None = None) -> list[str]:
+def docker_compose_up_cmd(
+    *, files: MaybeIterable[PathLike] | None = None, detach: bool = True
+) -> list[str]:
     """Command to use 'docker compose up' to create and start containers."""
-    return _docker_compose_cmd("up", files=files)
+    args: list[str] = []
+    if detach:
+        args.append("--detach")
+    return _docker_compose_cmd("up", *args, files=files)
 
 
 def _docker_compose_cmd(
-    cmd: str, /, *, files: MaybeIterable[PathLike] | None = None
+    cmd: str, /, *args: str, files: MaybeIterable[PathLike] | None = None
 ) -> list[str]:
-    args: list[str] = ["docker", "compose"]
+    all_args: list[str] = ["docker", "compose"]
     if files is not None:
         for file in always_iterable(files):
-            args.extend(["--file", str(file)])
-    return [*args, cmd]
+            all_args.extend(["--file", str(file)])
+    return [*all_args, cmd, *args]
 
 
 ##