liblaf-cherries 0.0.8__py3-none-any.whl → 0.0.10__py3-none-any.whl

liblaf/cherries/git/_grapes.py

@@ -1,3 +0,0 @@
-from liblaf.grapes.git import GitInfo, info, root, root_safe
-
-__all__ = ["GitInfo", "info", "root", "root_safe"]

liblaf/cherries/git/github/__init__.pyi

@@ -1,4 +0,0 @@
-from ._link import permalink
-from ._repo import user_repo
-
-__all__ = ["permalink", "user_repo"]

liblaf/cherries/git/github/_link.py

@@ -1,25 +0,0 @@
-import os
-from pathlib import Path
-
-import git
-
-from . import user_repo
-
-
-def permalink(
-    repo: git.Repo | None = None, filepath: str | os.PathLike[str] | None = None
-) -> str | None:
-    if repo is None:
-        repo = git.Repo(search_parent_directories=True)
-    user: str | None
-    repo_str: str | None
-    user, repo_str = user_repo(repo)
-    if not (user and repo):
-        return None
-    sha: str = repo.head.commit.hexsha
-    link: str = f"https://github.com/{user}/{repo_str}/tree/{sha}"
-    if filepath:
-        filepath = Path(filepath).absolute()
-        if not filepath.is_relative_to(repo.working_dir):
-            return None
-        link += f"/{Path(filepath).as_posix()}"

liblaf/cherries/git/github/_repo.py

@@ -1,23 +0,0 @@
-import re
-
-import git
-
-GITHUB_URL_PATTERNS: list[str] = [
-    r"https://github\.com/(?P<user>[^/]+)/(?P<repo>[^/]+)(?:\.git)?"
-]
-
-
-def user_repo(
-    repo: git.Repo | None = None,
-) -> tuple[str, str] | tuple[None, None]:
-    if repo is None:
-        repo = git.Repo(search_parent_directories=True)
-    remote: git.Remote = repo.remote()
-    for pattern in GITHUB_URL_PATTERNS:
-        match: re.Match[str] | None = re.match(pattern, remote.url)
-        if not match:
-            continue
-        user: str = match.group("user")
-        repo_name: str = match.group("repo")
-        return user, repo_name
-    return None, None

liblaf/cherries/integration/__init__.pyi

@@ -1,5 +0,0 @@
-from ._backend import Backend
-from ._factory import backend_factory
-from ._neptune import BackendNeptune
-
-__all__ = ["Backend", "BackendNeptune", "backend_factory"]

liblaf/cherries/integration/_backend.py

@@ -1,53 +0,0 @@
-import datetime
-import functools
-from pathlib import Path
-from typing import Any
-
-import pydantic_settings as ps
-
-from liblaf import cherries
-
-
-class Backend(ps.BaseSettings):
-    model_config = ps.SettingsConfigDict(
-        frozen=True, env_prefix=cherries.ENV_PREFIX + "DUMMY_"
-    )
-    enabled: bool = True
-
-    @property
-    def backend(self) -> str:
-        return "dummy"
-
-    @functools.cached_property
-    def entrypoint(self) -> Path:
-        return cherries.entrypoint()
-
-    @property
-    def id(self) -> str:
-        raise NotImplementedError
-
-    @property
-    def name(self) -> str:
-        raise NotImplementedError
-
-    @functools.cached_property
-    def start_time(self) -> datetime.datetime:
-        return datetime.datetime.now().astimezone()
-
-    @property
-    def url(self) -> str:
-        raise NotImplementedError
-
-    def start(self) -> None: ...
-    def end(self) -> None: ...
-    def log_metric(
-        self,
-        key: str,
-        value: float,
-        *,
-        step: float | None = None,
-        timestamp: float | None = None,
-        **kwargs,
-    ) -> None: ...
-    def log_other(self, key: str, value: Any, **kwargs) -> None: ...
-    def upload_file(self, key: str, path: Path, **kwargs) -> None: ...

liblaf/cherries/integration/_factory.py

@@ -1,13 +0,0 @@
-from liblaf import cherries
-
-
-def backend_factory(backend: str | None = None) -> cherries.Backend:
-    backend = backend or cherries.env.str("BACKEND", "dummy")
-    match backend:
-        case "neptune":
-            return cherries.BackendNeptune()
-        case "dummy":
-            return cherries.Backend()
-        case _:
-            msg: str = f"Unknown backend: {backend}"
-            raise ValueError(msg)

liblaf/cherries/integration/_neptune.py

@@ -1,66 +0,0 @@
-import os
-from pathlib import Path
-from typing import Any
-
-import neptune
-import neptune.common.exceptions
-import neptune.utils
-import pydantic
-import pydantic_settings as ps
-
-from liblaf import cherries
-
-
-class BackendNeptune(cherries.Backend):
-    model_config = ps.SettingsConfigDict(frozen=True, env_prefix="NEPTUNE_")
-    monitoring_namespace: str | None = None
-    _backend: neptune.Run = pydantic.PrivateAttr()
-
-    @property
-    def backend(self) -> str:
-        return "neptune"
-
-    @property
-    def id(self) -> str:
-        return self._backend["sys/id"].fetch()
-
-    @property
-    def name(self) -> str:
-        return self._backend["sys/name"].fetch()
-
-    @property
-    def url(self) -> str:
-        return self._backend.get_url()
-
-    def start(self) -> None:
-        neptune.common.exceptions.STYLES.update(neptune.common.exceptions.EMPTY_STYLES)
-        self._backend = neptune.init_run(monitoring_namespace=self.monitoring_namespace)
-
-    def end(self) -> None:
-        self._backend.stop()
-
-    def log_metric(
-        self,
-        key: str,
-        value: float,
-        *,
-        step: float | None = None,
-        timestamp: float | None = None,
-        **kwargs,
-    ) -> None:
-        self._backend[key].append(value, step=step, timestamp=timestamp, **kwargs)
-
-    def log_other(self, key: str, value: Any, **kwargs) -> None:
-        value = stringify_unsupported(value)
-        self._backend[key].assign(value, **kwargs)
-
-    def upload_file(self, key: str, path: Path, **kwargs) -> None:
-        return self._backend[key].upload(str(path), **kwargs)
-
-
-def stringify_unsupported(value: Any) -> Any:
-    if isinstance(value, pydantic.BaseModel):
-        return value.model_dump()
-    if isinstance(value, os.PathLike):
-        return str(value)
-    return value

liblaf/cherries/plugin/_default.py

@@ -1,9 +0,0 @@
-from liblaf import cherries
-
-
-def default_plugins() -> list[cherries.Plugin]:
-    return [
-        cherries.plugin.PluginLogging(),
-        cherries.plugin.PluginGit(),
-        cherries.plugin.PluginRestic(),
-    ]

liblaf/cherries/plugin/_restic.py

@@ -1,60 +0,0 @@
-import contextlib
-import json
-import os
-import subprocess as sp
-from pathlib import Path
-from typing import Any
-
-import pydantic
-import pydantic_settings as ps
-from loguru import logger
-
-from liblaf import cherries
-
-
-def default_config() -> Path:
-    git_root: Path = cherries.git.root()
-    for path in [
-        git_root / ".config" / "resticprofile.toml",
-        git_root / "resticprofile.toml",
-    ]:
-        if path.exists():
-            return path
-    return git_root / ".config" / "resticprofile.toml"
-
-
-class PluginRestic(cherries.Plugin):
-    model_config = ps.SettingsConfigDict(env_prefix=cherries.ENV_PREFIX + "RESTIC_")
-    config: Path = pydantic.Field(default_factory=default_config)
-    name: str | None = None
-    dry_run: bool = False
-
-    def _pre_end(self, run: cherries.Experiment) -> None:
-        if not self.config.exists():
-            logger.warning("configuration file '{}' was not found", self.config)
-            return
-        args: list[str | os.PathLike[str]] = [
-            "resticprofile",
-            "--config",
-            self.config,
-            "backup",
-            "--json",
-        ]
-        if self.name:
-            args += ["--name", self.name]
-        if self.dry_run:
-            args.append("--dry-run")
-        args += ["--time", run.start_time.strftime("%Y-%m-%d %H:%M:%S")]
-        proc: sp.Popen[str] = sp.Popen(
-            args, stdout=sp.PIPE, cwd=cherries.git.root(), text=True
-        )
-        assert proc.stdout is not None
-        for line_ in proc.stdout:
-            line: str = line_.rstrip()
-            logger.debug("{}", line)
-            with contextlib.suppress(json.JSONDecodeError):
-                log: dict[str, Any] = json.loads(line)
-                if log["message_type"] == "summary":
-                    run.log_other("cherries/restic", log)
-        returncode: int = proc.wait()
-        run.log_other("cherries/restic/returncode", returncode)

liblaf_cherries-0.0.8.dist-info/METADATA

@@ -1,153 +0,0 @@
-Metadata-Version: 2.4
-Name: liblaf-cherries
-Version: 0.0.8
-Summary: Add your description here
-Project-URL: Changelog, https://github.com/liblaf/cherries/blob/main/CHANGELOG.md
-Project-URL: Homepage, https://github.com/liblaf/cherries
-Project-URL: Issue Tracker, https://github.com/liblaf/cherries/issues
-Project-URL: Release Notes, https://github.com/liblaf/cherries/releases
-Project-URL: Source Code, https://github.com/liblaf/cherries
-Author-email: liblaf <30631553+liblaf@users.noreply.github.com>
-License-Expression: MIT
-License-File: LICENSE
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: Intended Audience :: Science/Research
-Classifier: License :: OSI Approved
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Topic :: Software Development
-Classifier: Topic :: Software Development :: Bug Tracking
-Classifier: Topic :: Software Development :: Debuggers
-Classifier: Topic :: Software Development :: Libraries
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Classifier: Topic :: System
-Classifier: Topic :: System :: Logging
-Classifier: Topic :: Utilities
-Classifier: Typing :: Typed
-Requires-Python: >=3.12
-Requires-Dist: comet-ml<4,>=3.49.5
-Requires-Dist: gitpython<4,>=3.1.44
-Requires-Dist: giturlparse<0.13,>=0.12.0
-Requires-Dist: lazy-loader<0.5,>=0.4
-Requires-Dist: liblaf-grapes<0.2,>=0.1.10
-Requires-Dist: loguru<0.8,>=0.7.3
-Requires-Dist: neptune<2,>=1.13.0
-Requires-Dist: pydantic-settings<3,>=2.8.1
-Requires-Dist: pydantic<3,>=2.10.6
-Description-Content-Type: text/markdown
-
-<!-- -*- mode: markdown -*- -->
-
-<div align="center"><a name="readme-top"></a>
-
-<img height="160" src="https://api.iconify.design/logos/python.svg" />
-
-# Cherries
-
-TODO: DESCRIPTION
-
-[**Explore the docs »**](https://liblaf.github.io/cherries/)
-
-[![PyPI - Downloads](https://img.shields.io/pypi/dm/liblaf-cherries?logo=PyPI&label=Downloads)](https://pypi.org/project/liblaf-cherries)
-[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/liblaf-cherries?logo=Python&label=Python)](https://pypi.org/project/liblaf-cherries)
-[![PyPI - Version](https://img.shields.io/pypi/v/liblaf-cherries?logo=PyPI&label=PyPI)](https://pypi.org/project/liblaf-cherries)
-[![Codecov](https://img.shields.io/codecov/c/github/liblaf/cherries?logo=Codecov&label=Coverage)](https://codecov.io/gh/liblaf/cherries)
-[![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/liblaf/cherries/test.yaml?logo=GitHub%20Actions&label=Test)](https://github.com/liblaf/cherries/actions/workflows/test.yaml)
-<br />
-[![GitHub Contributors](https://img.shields.io/github/contributors/liblaf/cherries?logo=GitHub&label=Contributors)](https://github.com/liblaf/cherries/graphs/contributors)
-[![GitHub Forks](https://img.shields.io/github/forks/liblaf/cherries)](https://github.com/liblaf/cherries/forks)
-[![GitHub Repo Stars](https://img.shields.io/github/stars/liblaf/cherries)](https://github.com/liblaf/cherries/stargazers)
-[![GitHub Issues](https://img.shields.io/github/issues/liblaf/cherries?logo=GitHub&label=Issues)](https://github.com/liblaf/cherries/issues)
-[![GitHub License](https://img.shields.io/github/license/liblaf/cherries?label=License)](https://github.com/liblaf/cherries/blob/main/LICENSE)
-
-[Changelog](https://github.com/liblaf/cherries/blob/main/CHANGELOG.md) · [Report Bug](https://github.com/liblaf/cherries/issues) · [Request Feature](https://github.com/liblaf/cherries/issues)
-
-![](https://raw.githubusercontent.com/andreasbm/readme/master/assets/lines/rainbow.png)
-
-</div>
-
-## ✨ Features
-
-- [x] ✨ **TODO:** FEATURES;
-
-<div align="right">
-
-[![](https://img.shields.io/badge/-BACK_TO_TOP-black?style=flat-square)](#readme-top)
-
-</div>
-
-## 📦 Installation
-
-To install `liblaf-cherries`, run the following command:
-
-```bash
-$ uv add liblaf-cherries
-```
-
-<div align="right">
-
-[![](https://img.shields.io/badge/-BACK_TO_TOP-black?style=flat-square)](#readme-top)
-
-</div>
-
-## ⌨️ Local Development
-
-You can use Github Codespaces for online development:
-
-[![](https://github.com/codespaces/badge.svg)](https://codespaces.new/liblaf/cherries)
-
-Or clone it for local development:
-
-```bash
-$ gh repo clone liblaf/cherries
-$ cd cherries
-$ just test
-```
-
-<div align="right">
-
-[![](https://img.shields.io/badge/-BACK_TO_TOP-black?style=flat-square)](#readme-top)
-
-</div>
-
-## 🤝 Contributing
-
-Contributions of all types are more than welcome, if you are interested in contributing code, feel free to check out our GitHub [Issues](https://github.com/liblaf/cherries/issues) to get stuck in to show us what you're made of.
-
-[![](https://img.shields.io/badge/%F0%9F%A4%AF%20PR%20WELCOME-%E2%86%92-ffcb47?labelColor=black&style=for-the-badge)](https://github.com/liblaf/cherries/pulls)
-
-[![](https://contrib.rocks/image?repo=liblaf%2Fcherries)](https://github.com/liblaf/cherries/graphs/contributors)
-
-<div align="right">
-
-[![](https://img.shields.io/badge/-BACK_TO_TOP-black?style=flat-square)](#readme-top)
-
-</div>
-
-## 🔗 Links
-
-### More Projects
-
-- **[🍇 cherries](https://github.com/liblaf/cherries)** - Powerful Python utilities for logging, timing, and more, making development smoother!
-
-### Credits
-
-- **Python** - <https://www.python.org/>
-
-<div align="right">
-
-[![](https://img.shields.io/badge/-BACK_TO_TOP-black?style=flat-square)](#readme-top)
-
-</div>
-
----
-
-#### 📝 License
-
-Copyright © 2025 [liblaf](https://github.com/liblaf). <br />
-This project is [MIT](https://github.com/liblaf/cherries/blob/main/LICENSE) licensed.

liblaf_cherries-0.0.8.dist-info/RECORD

@@ -1,36 +0,0 @@
-liblaf/cherries/__init__.py,sha256=OHb6Xou2v6u42swTgjRfzej4CIlRg4OmgOIQXUiRjKA,97
-liblaf/cherries/__init__.pyi,sha256=u-eKDd-6imkzIue3LmuJJmpjLDV1yGfV0XP9aN0VdWQ,827
-liblaf/cherries/_config.py,sha256=rm-Y6roi8hBvQYdH-VQh_ovWCyVsX_7R0x1jokBPCDM,741
-liblaf/cherries/_env.py,sha256=RK9NMHIok-AkCLMqW44cXLl0d_daLjpEcjhreSP1vm0,92
-liblaf/cherries/_experiment.py,sha256=E6r5DyojfY75lKsIDxYpyaCgXFXMJTaUIglIk9Xs-Sw,3181
-liblaf/cherries/_main.py,sha256=R8vWc9e94MViqCzMiG257--QtSoOU50lmR59oIRc6nw,1237
-liblaf/cherries/_start.py,sha256=iGAhDm8sF_JCaWPWdMIFL0d5nODFU8IcBPdNihhiSp4,685
-liblaf/cherries/_version.py,sha256=SbamvXnLxfCU9pL5KMng4JCEwFYPcZcxEC7yaD9HbZ4,511
-liblaf/cherries/_version.pyi,sha256=Pnv4Bxw13LHeuVkPLPsTtnp4N4jOGcAfFJw05uMMgBY,108
-liblaf/cherries/git/__init__.py,sha256=OHb6Xou2v6u42swTgjRfzej4CIlRg4OmgOIQXUiRjKA,97
-liblaf/cherries/git/__init__.pyi,sha256=kHd7B4_atL4929so2AnrBcCJNgGg-i-HEi4PeGh3csk,383
-liblaf/cherries/git/_commit.py,sha256=jnAtCKljNnzhXK90cj3adAYkPvcnLnOrHWA8YWhtZF4,482
-liblaf/cherries/git/_entrypoint.py,sha256=My_TmLqpGX4NJV4qjQvmHtnwhxX_B2ilfuYvpj2ftaM,262
-liblaf/cherries/git/_grapes.py,sha256=f9RRn2ci-fC5FqkbPJoIjNcJpUMwo2qBeu7CMre_t1o,113
-liblaf/cherries/git/github/__init__.py,sha256=OHb6Xou2v6u42swTgjRfzej4CIlRg4OmgOIQXUiRjKA,97
-liblaf/cherries/git/github/__init__.pyi,sha256=jspOamBde7EtGOqsIzWg75jFToVHRhG4hfiEw1MDz80,96
-liblaf/cherries/git/github/_link.py,sha256=f_AcdKMhukUZ2fgBtC0usBrwnpAHaLYo9EhkZYesZuQ,693
-liblaf/cherries/git/github/_repo.py,sha256=I3vjgonI_SPrytf68qzLAej880Zn7cPryaK4PPoVZpU,627
-liblaf/cherries/integration/__init__.py,sha256=OHb6Xou2v6u42swTgjRfzej4CIlRg4OmgOIQXUiRjKA,97
-liblaf/cherries/integration/__init__.pyi,sha256=n2QqtCl9oTVJatyt8LhiTJVnr_uoyYgfrN8virEqezQ,165
-liblaf/cherries/integration/_backend.py,sha256=iwpwTB3NgAI9oUCdWYMmH8qI8xYmUsZmES0pyw9_6D0,1241
-liblaf/cherries/integration/_factory.py,sha256=KJPse2efpOLv6s4sPQAPnzh9vwYcIQVsOg1ucxzTmIo,412
-liblaf/cherries/integration/_neptune.py,sha256=MhvPZUblAae6vmGRjgDELl_2wcOhrb90nCIsg8xpRMs,1789
-liblaf/cherries/plugin/__init__.py,sha256=OHb6Xou2v6u42swTgjRfzej4CIlRg4OmgOIQXUiRjKA,97
-liblaf/cherries/plugin/__init__.pyi,sha256=3wmkKoe27SI3q5zbyejf3KmaBRUhAu-OEefJAxxbECs,248
-liblaf/cherries/plugin/_abc.py,sha256=kMDFzDAEDifpxWbnQhp4M4sr24-D55x-B6MPIZW_1jA,848
-liblaf/cherries/plugin/_default.py,sha256=H7_vym_uxxba41xR2ERBeBt0kBX4s4tjzjifyKjXxS0,215
-liblaf/cherries/plugin/_git.py,sha256=Gyv8Uc2AnPpZul23oGm6Dba2YOaiFx6WAytrQ8ylSsk,866
-liblaf/cherries/plugin/_logging.py,sha256=yTp2IgwmTgWs6fkiFp6GyKz8IOTJZrHn_61VRZ_3eEY,1004
-liblaf/cherries/plugin/_restic.py,sha256=4ArmgD42ZUotkVdCwdMvlmJF0Z8PuKe8EukzRoWyQK8,1926
-liblaf/cherries/utils/__init__.py,sha256=OHb6Xou2v6u42swTgjRfzej4CIlRg4OmgOIQXUiRjKA,97
-liblaf/cherries/utils/__init__.pyi,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-liblaf_cherries-0.0.8.dist-info/METADATA,sha256=jsqjgGh9hySIGVpLhQ-HvrjHhsOAA79iPlfk-8ux4kQ,5789
-liblaf_cherries-0.0.8.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-liblaf_cherries-0.0.8.dist-info/licenses/LICENSE,sha256=Ph4NzyU3lGVDeYv-mf8aRmImH8v9rVL9F362FV4G6Ow,1063
-liblaf_cherries-0.0.8.dist-info/RECORD,,