dycw-utilities 0.125.16__py3-none-any.whl → 0.125.17__py3-none-any.whl

{dycw_utilities-0.125.16.dist-info → dycw_utilities-0.125.17.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dycw-utilities
-Version: 0.125.16
+Version: 0.125.17
 Author-email: Derek Wan <d.wan@icloud.com>
 License-File: LICENSE
 Requires-Python: >=3.12

{dycw_utilities-0.125.16.dist-info → dycw_utilities-0.125.17.dist-info}/RECORD

@@ -1,4 +1,4 @@
-utilities/__init__.py,sha256=_Jk4nXvJPOIX38g8WhJA-81T9Lr_sSEU7Sp5uNotGcs,61
+utilities/__init__.py,sha256=JqEeevqna4OC3ISKNcQNituXeLjwLF3svzhZ0e7XCNA,61
 utilities/altair.py,sha256=Gpja-flOo-Db0PIPJLJsgzAlXWoKUjPU1qY-DQ829ek,9156
 utilities/asyncio.py,sha256=D1o5dwq1y17Nk5tzeDyw5vAwxzqdy9WMY5u-uA6NMPw,50716
 utilities/atomicwrites.py,sha256=geFjn9Pwn-tTrtoGjDDxWli9NqbYfy3gGL6ZBctiqSo,5393
@@ -71,6 +71,7 @@ utilities/sqlalchemy.py,sha256=p8vsHaNRoeq5zJouIKyp9piFM26wtm5yR4DkzCMFDSw,35471
 utilities/sqlalchemy_polars.py,sha256=s7hQNep2O5DTgIRXyN_JRQma7a4DAtNd25tshaZW8iw,15490
 utilities/statsmodels.py,sha256=koyiBHvpMcSiBfh99wFUfSggLNx7cuAw3rwyfAhoKpQ,3410
 utilities/streamlit.py,sha256=U9PJBaKP1IdSykKhPZhIzSPTZsmLsnwbEPZWzNhJPKk,2955
+utilities/string.py,sha256=XmU-s04qIV_tODnKl2pQiwmHaxzgOqRKU-RyzdrfvSE,620
 utilities/sys.py,sha256=h0Xr7Vj86wNalvwJVP1wj5Y0kD_VWm1vzuXZ_jw94mE,2743
 utilities/tempfile.py,sha256=VqmZJAhTJ1OaVywFzk5eqROV8iJbW9XQ_QYAV0bpdRo,1384
 utilities/tenacity.py,sha256=1PUvODiBVgeqIh7G5TRt5WWMSqjLYkEqP53itT97WQc,4914
@@ -88,7 +89,7 @@ utilities/warnings.py,sha256=un1LvHv70PU-LLv8RxPVmugTzDJkkGXRMZTE2-fTQHw,1771
 utilities/whenever.py,sha256=jS31ZAY5OMxFxLja_Yo5Fidi87Pd-GoVZ7Vi_teqVDA,16743
 utilities/zipfile.py,sha256=24lQc9ATcJxHXBPc_tBDiJk48pWyRrlxO2fIsFxU0A8,699
 utilities/zoneinfo.py,sha256=-5j7IQ9nb7gR43rdgA7ms05im-XuqhAk9EJnQBXxCoQ,1874
-dycw_utilities-0.125.16.dist-info/METADATA,sha256=9y-tFV-n1PnxG6amsUhKiEKegf9t4ijGRLU6bSBhxsE,12852
-dycw_utilities-0.125.16.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-dycw_utilities-0.125.16.dist-info/licenses/LICENSE,sha256=gppZp16M6nSVpBbUBrNL6JuYfvKwZiKgV7XoKKsHzqo,1066
-dycw_utilities-0.125.16.dist-info/RECORD,,
+dycw_utilities-0.125.17.dist-info/METADATA,sha256=1zWyRHa0Ts5fvvHZN6YLaR881cwWsMYko0Y61BSepg8,12852
+dycw_utilities-0.125.17.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+dycw_utilities-0.125.17.dist-info/licenses/LICENSE,sha256=gppZp16M6nSVpBbUBrNL6JuYfvKwZiKgV7XoKKsHzqo,1066
+dycw_utilities-0.125.17.dist-info/RECORD,,

utilities/__init__.py

@@ -1,3 +1,3 @@
 from __future__ import annotations
 
-__version__ = "0.125.16"
+__version__ = "0.125.17"

utilities/string.py

@@ -0,0 +1,21 @@
+from __future__ import annotations
+
+from os import environ
+from pathlib import Path
+from string import Template
+from typing import Any, assert_never
+
+
+def substitute_environ(path_or_text: Path | str, /, **kwargs: Any) -> str:
+    """Substitute the environment variables in a file."""
+    match path_or_text:
+        case Path() as path:
+            with path.open() as fh:
+                return substitute_environ(fh.read(), **kwargs)
+        case str() as text:
+            return Template(text).substitute(environ, **kwargs)
+        case _ as never:
+            assert_never(never)
+
+
+__all__ = ["substitute_environ"]