dycw-utilities 0.175.17__py3-none-any.whl → 0.185.8__py3-none-any.whl

dycw_utilities-0.175.17.dist-info/RECORD

@@ -1,103 +0,0 @@
-utilities/__init__.py,sha256=8_tM295sqZUhpgJO-NkFFdbuntYma_XUNSt0IM3-C_0,61
-utilities/altair.py,sha256=TLfRFbG9HwG7SLXoJ-v0r-t49ZaGgTQZD82cpjVi4vs,9085
-utilities/asyncio.py,sha256=aJySVxBY0gqsIYnoNmH7-1r8djKuf4vSsU69VCD08t8,16772
-utilities/atomicwrites.py,sha256=tPo6r-Rypd9u99u66B9z86YBPpnLrlHtwox_8Z7T34Y,5790
-utilities/atools.py,sha256=6neeCcgXxK2dlsc0xp15Za7nSucbCgFtAJepGI_-WXU,2549
-utilities/cachetools.py,sha256=2S9LMHIunDYMIu8JGI7OLN04sQ7-xZGdEdP1Li0vksA,2775
-utilities/click.py,sha256=ScLzBLoBp8Si5YjgB18A0IVMAR-r4sGUnVfJbAaru98,19191
-utilities/concurrent.py,sha256=fHeW2SZ_TEMfFY0C8pyQI6aPlnecvx9x6SuUwBWj_JY,2853
-utilities/contextlib.py,sha256=iP7R2tIm6ZsbfLD5ks6UKBYwj50e9gBI8AkpLN-chro,7476
-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=N__PKd3cnSRsXNEMHMLdLneLdyzfbr2ESkElcwrovvQ,7940
-utilities/enum.py,sha256=5l6pwZD1cjSlVW4ss-zBPspWvrbrYrdtJWcg6f5_J5w,5781
-utilities/errors.py,sha256=mFlDGSM0LI1jZ1pbqwLAH3ttLZ2JVIxyZLojw8tGVZU,1479
-utilities/fastapi.py,sha256=TqyKvBjiMS594sXPjrz-KRTLMb3l3D3rZ1zAYV7GfOk,1454
-utilities/fpdf2.py,sha256=dSiYz0FJTD2sQuxpxqFWwwIe2-p6Y7oTB9Tv0Jajit0,1866
-utilities/functions.py,sha256=18Zda7nTloARdcEudH8YJ4e13xAdWShAGhPNN4w2Gyc,21498
-utilities/functools.py,sha256=I00ru2gQPakZw2SHVeKIKXfTv741655s6HI0lUoE0D4,1552
-utilities/getpass.py,sha256=DfN5UgMAtFCqS3dSfFHUfqIMZX2shXvwphOz_6J6f6A,103
-utilities/git.py,sha256=U1RFvCTANGENgx9wVBDvllioqBQZM2ns12ivKhOsaO4,414
-utilities/grp.py,sha256=1vV3gNR9dQsl1vtUtvC_2qgVdQzm7O8lLMSh56cTbeg,694
-utilities/gzip.py,sha256=fkGP3KdsBfXlstodT4wtlp-PwNyUsogpbDCVVVGdsm4,781
-utilities/hashlib.py,sha256=SVTgtguur0P4elppvzOBbLEjVM3Pea0eWB61yg2ilxo,309
-utilities/http.py,sha256=TsavEfHlRtlLaeV21Z6KZh0qbPw-kvD1zsQdZ7Kep5Q,977
-utilities/hypothesis.py,sha256=NUu30pl5kjL3tzo-m8SMRwTqLAmTWK-_Sau2NemJcQo,46773
-utilities/importlib.py,sha256=SkVVtIjVC7bjJ36doXnmnmFiYe5tLbip4YAfYJj8Ycg,892
-utilities/inflect.py,sha256=v7YkOWSu8NAmVghPcf4F3YBZQoJCS47_DLf9jbfWIs0,581
-utilities/ipython.py,sha256=V2oMYHvEKvlNBzxDXdLvKi48oUq2SclRg5xasjaXStw,763
-utilities/iterables.py,sha256=t2TsW-K3rVlS6y4_tqcc1fk9RwJV-bi7G_VwduMABK0,42558
-utilities/jinja2.py,sha256=JpNHMcyMJDguX8rBN4wEz-v4En7w6WHXvYJr4Xw-F0o,4691
-utilities/json.py,sha256=-WcGtSsCr9Y42wHZzAMnfvU6ihAfVftylFfRUORaDFo,2102
-utilities/jupyter.py,sha256=ft5JA7fBxXKzP-L9W8f2-wbF0QeYc_2uLQNFDVk4Z-M,2917
-utilities/libcst.py,sha256=ngD4wxnR3Kh-RBVmU5l5ST7cuZLhMZwyMDjHZe5mhTs,5581
-utilities/lightweight_charts.py,sha256=YM3ojBvJxuCSUBu_KrhFBmaMCvRPvupKC3qkm-UVZq4,2751
-utilities/logging.py,sha256=mckcX_0Q5njVgnhtIoePcDHjYjTVELw7ExutiiDnzsU,18724
-utilities/math.py,sha256=cevB-YyEYAzJTWtkAr7qeeu-hbxorDI3gMznXlmNQkw,26897
-utilities/memory_profiler.py,sha256=XzN56jDCa5aqXS_DxEjb_K4L6aIWh_5zyKi6OhcIxw0,853
-utilities/modules.py,sha256=iuvLluJya-hvl1Q25-Jk3dLgx2Es3ck4SjJiEkAlVTs,3195
-utilities/more_itertools.py,sha256=syfIPhQF_WS-YiicdGe2h5F1G-Ld12Q2XsVduL2hA40,10908
-utilities/numpy.py,sha256=Xn23sA2ZbVNqwUYEgNJD3XBYH6IbCri_WkHSNhg3NkY,26122
-utilities/operator.py,sha256=C3NylZWGTVWRpwYHOPVhaLgRhw0DfpS4_XQ8KfPhBLQ,3613
-utilities/optuna.py,sha256=C-fhWYiXHVPo1l8QctYkFJ4DyhbSrGorzP1dJb_qvd8,1933
-utilities/orjson.py,sha256=T_0SlK811ysg46d3orvIPY3JpBa4FRMpP2wlPQo7-gU,41854
-utilities/os.py,sha256=kjKKSQfnRqFTTZ315iavaaGd3gGuYNoSWlxVLCJjyQs,4852
-utilities/parse.py,sha256=g7Qm9eBOIeDId2tGA021CIaeF6jp1TI8rx4srdvlyoo,17937
-utilities/pathlib.py,sha256=N4Ip8R9eCM-6GfvxUJ3T9oQIle2C2P52F-13BCFRdTg,9345
-utilities/permissions.py,sha256=vLXlWztSVYffbrxptne7ksj6dU1HLekm4fEvS4ny_4Q,8944
-utilities/pickle.py,sha256=MBT2xZCsv0pH868IXLGKnlcqNx2IRVKYNpRcqiQQqxw,653
-utilities/platform.py,sha256=R3ldt2-DlI7la9ng6Rxt1CThd2lL0Ai2tC0TbabtCC0,2800
-utilities/polars.py,sha256=JPzN4UqQDC7R4IXsIuXEIXRiwHSrkiSZcD8UOfwGPuE,87535
-utilities/polars_ols.py,sha256=LNTFNLPuYW7fcAHymlbnams_DhitToblYvib3mhKbwI,5615
-utilities/postgres.py,sha256=g3tEwTI8TdmiCbRME61ffQ0xaibdpXPu8mJOOHvjPKc,12532
-utilities/pottery.py,sha256=nA0SsF9irvfC0tk68YAr08tuL9lGRSlBKihSx7Ibk84,3963
-utilities/pqdm.py,sha256=idv2seRVP2f6NeSfpeEnT5A-tQezaHZKDyeu16g2-0E,3091
-utilities/psutil.py,sha256=KUlu4lrUw9Zg1V7ZGetpWpGb9DB8l_SSDWGbANFNCPU,2104
-utilities/pwd.py,sha256=pzlLkBfSTZsCVkMrAxEmuEoNmm-6goklfAygVmOEZqs,707
-utilities/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-utilities/pydantic.py,sha256=z_PnYXN_UNNLQwo_XF7cr4GDcf5wicvscD6aFYVOEvA,238
-utilities/pydantic_settings.py,sha256=53tQTpHFtA6UIuzHKzauZtW_bSRwL5lQnNwTWeO4Fjw,7608
-utilities/pydantic_settings_sops.py,sha256=9Ou6Cx6PiYOU49vtkKqqW1Sdp_i3WlVyg8KkUUKNliM,2310
-utilities/pyinstrument.py,sha256=hnXaL-4HE7wWBI5JKaPfYTpsrXe68YiuZKahHV0VJn8,841
-utilities/pytest.py,sha256=9HHwYgZQe6CRF0ekHQEFH05gmoP4Ne0V54RrtUNDfi4,10524
-utilities/pytest_plugins/__init__.py,sha256=U4S_2y3zgLZVfMenHRaJFBW8yqh2mUBuI291LGQVOJ8,35
-utilities/pytest_plugins/pytest_randomly.py,sha256=B1qYVlExGOxTywq2r1SMi5o7btHLk2PNdY_b1p98dkE,409
-utilities/pytest_plugins/pytest_regressions.py,sha256=mnHYBfdprz50UGVkVzV1bZERZN5CFfoF8YbokGxdFwU,1639
-utilities/pytest_regressions.py,sha256=tJxW38u-zpoyjW1N4zogBx4V_07r-ibDInddcEUyXmc,4763
-utilities/random.py,sha256=hZlH4gnAtoaofWswuJYjcygejrY8db4CzP-z_adO2Mo,4165
-utilities/re.py,sha256=S4h-DLL6ScMPqjboZ_uQ1BVTJajrqV06r_81D--_HCE,4573
-utilities/redis.py,sha256=gybjqKea33Jy50n4dHTS14JdquqHaJqHF2dixQljYWQ,30172
-utilities/reprlib.py,sha256=ssYTcBW-TeRh3fhCJv57sopTZHF5FrPyyUg9yp5XBlo,3953
-utilities/scipy.py,sha256=wZJM7fEgBAkLSYYvSmsg5ac-QuwAI0BGqHVetw1_Hb0,947
-utilities/sentinel.py,sha256=A_p5jX2K0Yc5XBfoYHyBLqHsEWzE1ByOdDuzzA2pZnE,1434
-utilities/shelve.py,sha256=4OzjQI6kGuUbJciqf535rwnao-_IBv66gsT6tRGiUt0,759
-utilities/shutil.py,sha256=knJ7hx42FtIfGByxQZMcOSgQCDlaSony325g505ps3A,480
-utilities/slack_sdk.py,sha256=76-DYtcGiUhEvl-voMamc5OjfF7Y7nCq54Bys1arqzw,2233
-utilities/socket.py,sha256=K77vfREvzoVTrpYKo6MZakol0EYu2q1sWJnnZqL0So0,118
-utilities/sqlalchemy.py,sha256=HQYpd7LFxdTF5WYVWYtCJeEBI71EJm7ytvCGyAH9B-U,37163
-utilities/sqlalchemy_polars.py,sha256=JCGhB37raSR7fqeWV5dTsciRTMVzIdVT9YSqKT0piT0,13370
-utilities/statsmodels.py,sha256=koyiBHvpMcSiBfh99wFUfSggLNx7cuAw3rwyfAhoKpQ,3410
-utilities/string.py,sha256=shmBK87zZwzGyixuNuXCiUbqzfeZ9xlrFwz6JTaRvDk,582
-utilities/subprocess.py,sha256=nFPIXVzXomI_Oby8PYF9HNWrsWtcSsCtgFnj_22QYlI,43753
-utilities/tempfile.py,sha256=QyvIdfV4r4YZ0NeNYsg0tCijThLKa7Z32u5Kxy6ZsGo,3619
-utilities/testbook.py,sha256=j1KmaVbrX9VrbeMgtPh5gk55myAsn3dyRUn7jGbPbRk,1294
-utilities/text.py,sha256=7SvwcSR2l_5cOrm1samGnR4C-ZI6qyFLHLzSpO1zeHQ,13958
-utilities/threading.py,sha256=GvBOp4CyhHfN90wGXZuA2VKe9fGzMaEa7oCl4f3nnPU,1009
-utilities/timer.py,sha256=BGlwEVznx67scuLOUohyWJ4d5rTnwtk-IR4yLXFiNfo,2574
-utilities/traceback.py,sha256=B_sc0TRUv-mGDnF-ek05nbqjmBiHr3-wvxliAqIF5hI,9608
-utilities/types.py,sha256=UwxYajRnupKTCnzReaYWYqtKdpIPeSO-d97Wu4bLEq8,18878
-utilities/typing.py,sha256=xuR8LxzjD-XlSftTM3TNvGVdQyV1mzpdwWdDMzWwCPE,25310
-utilities/tzdata.py,sha256=fgNVj66yUbCSI_-vrRVzSD3gtf-L_8IEJEPjP_Jel5Y,266
-utilities/tzlocal.py,sha256=KyCXEgCTjqGFx-389JdTuhMRUaT06U1RCMdWoED-qro,728
-utilities/uuid.py,sha256=nQZs6tFX4mqtc2Ku3KqjloYCqwpTKeTj8eKwQwh3FQI,1572
-utilities/version.py,sha256=ipBj5-WYY_nelp2uwFlApfWWCzTLzPwpovUi9x_OBMs,5085
-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.17.dist-info/WHEEL,sha256=RRVLqVugUmFOqBedBFAmA4bsgFcROUBiSUKlERi0Hcg,79
-dycw_utilities-0.175.17.dist-info/entry_points.txt,sha256=cOGtKeJI0KXLSV7MJ8Dhc2G8jPgDcBDm53MVNJU4ycI,136
-dycw_utilities-0.175.17.dist-info/METADATA,sha256=obLY4pbYFf5oCFvSPuNf1mXsv1VC5nCC7sGJtizR-AA,1443
-dycw_utilities-0.175.17.dist-info/RECORD,,

utilities/atomicwrites.py

@@ -1,182 +0,0 @@
-from __future__ import annotations
-
-import gzip
-import shutil
-from contextlib import ExitStack, contextmanager
-from dataclasses import dataclass
-from pathlib import Path
-from shutil import copyfileobj, rmtree
-from typing import TYPE_CHECKING, assert_never, override
-
-from atomicwrites import replace_atomic
-
-from utilities.errors import ImpossibleCaseError
-from utilities.iterables import transpose
-from utilities.tempfile import TemporaryDirectory
-
-if TYPE_CHECKING:
-    from collections.abc import Iterator
-
-    from utilities.types import PathLike
-
-
-def move(
-    source: PathLike, destination: PathLike, /, *, overwrite: bool = False
-) -> None:
-    """Move/replace a file/directory atomically."""
-    source, destination = map(Path, [source, destination])
-    match (
-        source.is_file(),
-        source.is_dir(),
-        destination.is_file(),
-        destination.is_dir(),
-        overwrite,
-    ):
-        case False, False, _, _, _:
-            raise _MoveSourceNotFoundError(source=source)
-        # files
-        case (True, False, True, False, False) | (True, False, False, True, False):
-            raise _MoveFileExistsError(source=source, destination=destination) from None
-        case True, False, False, True, _:
-            rmtree(destination, ignore_errors=True)
-            return replace_atomic(str(source), str(destination))  # must be `str`s
-        case True, False, _, _, _:
-            return replace_atomic(str(source), str(destination))  # must be `str`s
-        # directories
-        case (False, True, True, False, False) | (False, True, False, True, False):
-            raise _MoveDirectoryExistsError(source=source, destination=destination)
-        case False, True, False, True, _:
-            rmtree(destination, ignore_errors=True)
-            _ = shutil.move(source, destination)
-            return None
-        case False, True, _, _, _:
-            destination.unlink(missing_ok=True)
-            _ = shutil.move(source, destination)
-            return None
-        case True, True, _, _, _:  # pragma: no cover
-            raise ImpossibleCaseError(
-                case=[f"{source.is_file()=}", f"{source.is_dir()=}"]
-            )
-        case never:
-            assert_never(never)
-
-
-@dataclass(kw_only=True, slots=True)
-class MoveError(Exception): ...
-
-
-@dataclass(kw_only=True, slots=True)
-class _MoveSourceNotFoundError(MoveError):
-    source: Path
-
-    @override
-    def __str__(self) -> str:
-        return f"Source {str(self.source)!r} does not exist"
-
-
-@dataclass(kw_only=True, slots=True)
-class _MoveFileExistsError(MoveError):
-    source: Path
-    destination: Path
-
-    @override
-    def __str__(self) -> str:
-        return f"Cannot move file {str(self.source)!r} as destination {str(self.destination)!r} already exists"
-
-
-@dataclass(kw_only=True, slots=True)
-class _MoveDirectoryExistsError(MoveError):
-    source: Path
-    destination: Path
-
-    @override
-    def __str__(self) -> str:
-        return f"Cannot move directory {str(self.source)!r} as destination {str(self.destination)!r} already exists"
-
-
-##
-
-
-def move_many(*paths: tuple[PathLike, PathLike], overwrite: bool = False) -> None:
-    """Move a set of files concurrently."""
-    sources, destinations = transpose(paths)
-    with ExitStack() as stack:
-        temp_paths = [
-            stack.enter_context(writer(p, overwrite=overwrite)) for p in destinations
-        ]
-        for source, temp_path in zip(sources, temp_paths, strict=True):
-            move(source, temp_path, overwrite=overwrite)
-
-
-##
-
-
-@contextmanager
-def writer(
-    path: PathLike, /, *, compress: bool = False, overwrite: bool = False
-) -> Iterator[Path]:
-    """Yield a path for atomically writing files to disk."""
-    path = Path(path)
-    parent = path.parent
-    parent.mkdir(parents=True, exist_ok=True)
-    name = path.name
-    with TemporaryDirectory(suffix=".tmp", prefix=name, dir=parent) as temp_dir:
-        temp_path1 = Path(temp_dir, name)
-        try:
-            yield temp_path1
-        except KeyboardInterrupt:
-            rmtree(temp_dir)
-        else:
-            if compress:
-                temp_path2 = Path(temp_dir, f"{name}.gz")
-                with (
-                    temp_path1.open("rb") as source,
-                    gzip.open(temp_path2, mode="wb") as dest,
-                ):
-                    copyfileobj(source, dest)
-            else:
-                temp_path2 = temp_path1
-            try:
-                move(temp_path2, path, overwrite=overwrite)
-            except _MoveSourceNotFoundError as error:
-                raise _WriterTemporaryPathEmptyError(temp_path=error.source) from None
-            except _MoveFileExistsError as error:
-                raise _WriterFileExistsError(destination=error.destination) from None
-            except _MoveDirectoryExistsError as error:
-                raise _WriterDirectoryExistsError(
-                    destination=error.destination
-                ) from None
-
-
-@dataclass(kw_only=True, slots=True)
-class WriterError(Exception): ...
-
-
-@dataclass(kw_only=True, slots=True)
-class _WriterTemporaryPathEmptyError(WriterError):
-    temp_path: Path
-
-    @override
-    def __str__(self) -> str:
-        return f"Temporary path {str(self.temp_path)!r} is empty"
-
-
-@dataclass(kw_only=True, slots=True)
-class _WriterFileExistsError(WriterError):
-    destination: Path
-
-    @override
-    def __str__(self) -> str:
-        return f"Cannot write to {str(self.destination)!r} as file already exists"
-
-
-@dataclass(kw_only=True, slots=True)
-class _WriterDirectoryExistsError(WriterError):
-    destination: Path
-
-    @override
-    def __str__(self) -> str:
-        return f"Cannot write to {str(self.destination)!r} as directory already exists"
-
-
-__all__ = ["MoveError", "WriterError", "move", "move_many", "writer"]

utilities/cryptography.py

@@ -1,41 +0,0 @@
-from __future__ import annotations
-
-from dataclasses import dataclass
-from os import getenv
-from typing import override
-
-from cryptography.fernet import Fernet
-
-_ENV_VAR = "FERNET_KEY"
-
-
-def encrypt(text: str, /, *, env_var: str = _ENV_VAR) -> bytes:
-    """Encrypt a string."""
-    return get_fernet(env_var).encrypt(text.encode())
-
-
-def decrypt(text: bytes, /, *, env_var: str = _ENV_VAR) -> str:
-    """Encrypt a string."""
-    return get_fernet(env_var).decrypt(text).decode()
-
-
-##
-
-
-def get_fernet(env_var: str = _ENV_VAR, /) -> Fernet:
-    """Get the Fernet key."""
-    if (key := getenv(env_var)) is None:
-        raise GetFernetError(env_var=env_var)
-    return Fernet(key.encode())
-
-
-@dataclass(kw_only=True, slots=True)
-class GetFernetError(Exception):
-    env_var: str
-
-    @override
-    def __str__(self) -> str:
-        return f"Environment variable {self.env_var!r} is None"
-
-
-__all__ = ["GetFernetError", "decrypt", "encrypt", "get_fernet"]

utilities/getpass.py

@@ -1,8 +0,0 @@
-from __future__ import annotations
-
-from getpass import getuser
-
-USER = getuser()
-
-
-__all__ = ["USER"]

utilities/git.py

@@ -1,19 +0,0 @@
-from __future__ import annotations
-
-from pathlib import Path
-from typing import TYPE_CHECKING
-
-from git import Repo
-
-from utilities.pathlib import to_path
-
-if TYPE_CHECKING:
-    from utilities.types import MaybeCallablePathLike
-
-
-def get_repo(path: MaybeCallablePathLike = Path.cwd, /) -> Repo:
-    """Get the repo object."""
-    return Repo(to_path(path), search_parent_directories=True)
-
-
-__all__ = ["get_repo"]

utilities/grp.py

@@ -1,28 +0,0 @@
-from __future__ import annotations
-
-from typing import assert_never
-
-from utilities.os import EFFECTIVE_GROUP_ID
-from utilities.platform import SYSTEM
-
-
-def get_gid_name(gid: int, /) -> str | None:
-    """Get the name of a group."""
-    match SYSTEM:
-        case "windows":  # skipif-not-windows
-            return None
-        case "mac" | "linux":
-            from grp import getgrgid
-
-            return getgrgid(gid).gr_name
-        case never:
-            assert_never(never)
-
-
-ROOT_GROUP_NAME = get_gid_name(0)
-EFFECTIVE_GROUP_NAME = (
-    None if EFFECTIVE_GROUP_ID is None else get_gid_name(EFFECTIVE_GROUP_ID)
-)
-
-
-__all__ = ["EFFECTIVE_GROUP_NAME", "ROOT_GROUP_NAME", "get_gid_name"]

utilities/gzip.py

@@ -1,31 +0,0 @@
-from __future__ import annotations
-
-import gzip
-from pathlib import Path
-from typing import TYPE_CHECKING
-
-from utilities.atomicwrites import writer
-
-if TYPE_CHECKING:
-    from utilities.types import PathLike
-
-
-def read_binary(path: PathLike, /, *, decompress: bool = False) -> bytes:
-    """Read a byte string from disk."""
-    path = Path(path)
-    if decompress:
-        with gzip.open(path) as gz:
-            return gz.read()
-    else:
-        return path.read_bytes()
-
-
-def write_binary(
-    data: bytes, path: PathLike, /, *, compress: bool = False, overwrite: bool = False
-) -> None:
-    """Write a byte string to disk."""
-    with writer(path, compress=compress, overwrite=overwrite) as temp:
-        _ = temp.write_bytes(data)
-
-
-__all__ = ["read_binary", "write_binary"]

utilities/json.py

@@ -1,70 +0,0 @@
-from __future__ import annotations
-
-from contextlib import suppress
-from dataclasses import dataclass
-from pathlib import Path
-from subprocess import check_output
-from typing import TYPE_CHECKING, assert_never, overload, override
-
-from utilities.atomicwrites import writer
-from utilities.gzip import write_binary
-
-if TYPE_CHECKING:
-    from utilities.types import PathLike
-
-
-##
-
-
-@overload
-def run_prettier(source: bytes, /) -> bytes: ...
-@overload
-def run_prettier(source: str, /) -> str: ...
-@overload
-def run_prettier(source: Path, /) -> None: ...
-def run_prettier(source: bytes | str | Path, /) -> bytes | str | None:
-    """Run `prettier` on a string/path."""
-    match source:  # skipif-ci
-        case bytes() as data:
-            return _run_prettier_core(data, text=False)
-        case str() as text:
-            if (path := Path(text)).is_file():
-                return run_prettier(path)
-            return _run_prettier_core(text, text=True)
-        case Path() as path:
-            result = run_prettier(path.read_bytes())
-            with writer(path, overwrite=True) as temp:
-                _ = temp.write_bytes(result)
-            return None
-        case never:
-            assert_never(never)
-
-
-def _run_prettier_core(data: bytes | str, /, *, text: bool) -> bytes | str:
-    """Run `prettier` on a string/path."""
-    try:  # skipif-ci
-        return check_output(["prettier", "--parser=json"], input=data, text=text)
-    except FileNotFoundError:  # pragma: no cover
-        raise RunPrettierError from None
-
-
-@dataclass(kw_only=True, slots=True)
-class RunPrettierError(Exception):
-    @override
-    def __str__(self) -> str:
-        return "Unable to find 'prettier'"  # pragma: no cover
-
-
-##
-
-
-def write_formatted_json(
-    data: bytes, path: PathLike, /, *, compress: bool = False, overwrite: bool = False
-) -> None:
-    """Write a formatted byte string to disk."""
-    with suppress(RunPrettierError):
-        data = run_prettier(data)
-    write_binary(data, path, compress=compress, overwrite=overwrite)
-
-
-__all__ = ["RunPrettierError", "run_prettier", "write_formatted_json"]