devin-install-scheduler 0.1.0__tar.gz

devin_install_scheduler-0.1.0/PKG-INFO

@@ -0,0 +1,32 @@
+Metadata-Version: 2.4
+Name: devin-install-scheduler
+Version: 0.1.0
+Summary: Shared daily-job installer for the devin-state packages — cron, Task Scheduler, or config-registry fallback.
+Author: Icaro0310
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+
+# devin-install-scheduler
+
+Shared installer for the `devin-state` packages' daily jobs. Registers a
+tagged `crontab` line on Linux/macOS, a `schtasks` entry on Windows, or a
+job record in `<config-dir>/.devin-ecosystem/scheduled.json` (the F6
+elapsed fallback ticked by devin-powerups' `UserPromptSubmit` hook).
+
+Used by `devin-backup` (`devin-backup-daily`) and `devin-janitor`
+(`devin-janitor-daily`). Not a Devin-facing CLI — library only.
+
+```python
+from devin_install_scheduler import install_daily
+
+install_daily(
+    job_name="my-job-daily",
+    command=f'"{sys.executable}" -m my_pkg.cli run',
+)
+```
+
+> Unofficial community project. Not affiliated with, endorsed by, or
+> sponsored by Cognition AI. "Devin" is a trademark of Cognition AI.

devin_install_scheduler-0.1.0/README.md

@@ -0,0 +1,21 @@
+# devin-install-scheduler
+
+Shared installer for the `devin-state` packages' daily jobs. Registers a
+tagged `crontab` line on Linux/macOS, a `schtasks` entry on Windows, or a
+job record in `<config-dir>/.devin-ecosystem/scheduled.json` (the F6
+elapsed fallback ticked by devin-powerups' `UserPromptSubmit` hook).
+
+Used by `devin-backup` (`devin-backup-daily`) and `devin-janitor`
+(`devin-janitor-daily`). Not a Devin-facing CLI — library only.
+
+```python
+from devin_install_scheduler import install_daily
+
+install_daily(
+    job_name="my-job-daily",
+    command=f'"{sys.executable}" -m my_pkg.cli run',
+)
+```
+
+> Unofficial community project. Not affiliated with, endorsed by, or
+> sponsored by Cognition AI. "Devin" is a trademark of Cognition AI.

devin_install_scheduler-0.1.0/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "devin-install-scheduler"
+version = "0.1.0"
+description = "Shared daily-job installer for the devin-state packages — cron, Task Scheduler, or config-registry fallback."
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10"
+authors = [{ name = "Icaro0310" }]
+dependencies = []
+
+[project.optional-dependencies]
+dev = ["pytest>=8"]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

devin_install_scheduler-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

devin_install_scheduler-0.1.0/src/devin_install_scheduler/__init__.py

@@ -0,0 +1,5 @@
+"""Shared daily-job installer for devin-state packages."""
+
+from devin_install_scheduler.install import install_daily
+
+__all__ = ["install_daily"]

devin_install_scheduler-0.1.0/src/devin_install_scheduler/install.py

@@ -0,0 +1,132 @@
+"""Install a daily scheduled job for a devin-state package.
+
+The F6 scheduling foundation — the same backends and registry format as
+``devin-powerups/tools/schedule.py``:
+
+- **cron** (Linux/macOS): a tagged ``crontab`` line.
+- **tasksch** (Windows): a daily ``schtasks`` entry.
+- **elapsed** (corporate fallback): a job record in
+  ``<config-dir>/.devin-ecosystem/scheduled.json`` that the F6
+  ``UserPromptSubmit`` hook ticks — see powerups' schedule.py.
+
+Callers supply the job name and the command to schedule; this module owns
+backend selection and the registry write.
+"""
+
+from __future__ import annotations
+
+import json
+import os
+import shutil
+import subprocess
+import sys
+import tempfile
+import time
+from pathlib import Path
+
+
+def _config_dir(override: str | None) -> Path:
+    if override:
+        return Path(override).expanduser()
+    env = os.environ.get("DEVIN_CONFIG_DIR")
+    if env:
+        return Path(env).expanduser()
+    if sys.platform.startswith("win"):
+        base = os.environ.get("APPDATA") or str(
+            Path.home() / "AppData" / "Roaming")
+        return Path(base) / "Devin"
+    if sys.platform == "darwin":
+        return Path.home() / "Library" / "Application Support" / "Devin"
+    xdg = os.environ.get("XDG_CONFIG_HOME") or str(Path.home() / ".config")
+    for name in ("Devin", "devin"):
+        if (Path(xdg) / name).is_dir():
+            return Path(xdg) / name
+    return Path(xdg) / "devin"
+
+
+def _registry_path(config_dir: Path) -> Path:
+    return config_dir / ".devin-ecosystem" / "scheduled.json"
+
+
+def _load_registry(config_dir: Path) -> dict:
+    try:
+        data = json.loads(_registry_path(config_dir).read_text(
+            encoding="utf-8"))
+        if isinstance(data.get("jobs"), dict):
+            return data
+    except (OSError, ValueError):
+        pass
+    return {"version": 1, "jobs": {}}
+
+
+def _save_registry(config_dir: Path, reg: dict) -> None:
+    p = _registry_path(config_dir)
+    p.parent.mkdir(parents=True, exist_ok=True)
+    fd, tmp = tempfile.mkstemp(dir=p.parent, suffix=".tmp")
+    with os.fdopen(fd, "w", encoding="utf-8") as fh:
+        json.dump(reg, fh, indent=2)
+    os.replace(tmp, p)
+
+
+def _install_cron(command: str, cron_tag: str) -> bool:
+    """Append the tagged daily line to crontab. Returns False if no cron."""
+    # shutil.which IS the capability check: no crontab.exe exists on a
+    # vanilla Windows PATH, so an explicit sys.platform guard adds nothing
+    # and makes the line-building logic untestable there.
+    if not shutil.which("crontab"):
+        return False
+    out = subprocess.run(["crontab", "-l"], capture_output=True, text=True)
+    current = out.stdout if out.returncode == 0 else ""
+    kept = [l for l in current.splitlines() if cron_tag not in l]
+    kept.append(f"@daily {command}  {cron_tag}")
+    subprocess.run(["crontab", "-"], input="\n".join(kept) + "\n",
+                   text=True, check=True)
+    return True
+
+
+def _install_tasksch(command: str, job_name: str) -> bool:
+    if not sys.platform.startswith("win") or not shutil.which("schtasks"):
+        return False
+    subprocess.run(
+        ["schtasks", "/create", "/f", "/tn", job_name,
+         "/sc", "DAILY", "/tr", command], check=True)
+    return True
+
+
+def install_daily(job_name: str,
+                  command: str,
+                  config_dir: str | None = None,
+                  backend: str = "auto") -> dict:
+    """Register a daily job; returns what was done."""
+    cron_tag = f"# devin-ecosystem:{job_name}"
+    cfg = _config_dir(config_dir)
+    used = backend
+    if backend == "auto":
+        if _install_tasksch(command, job_name):
+            used = "tasksch"
+        elif _install_cron(command, cron_tag):
+            used = "cron"
+        else:
+            used = "elapsed"
+    elif backend == "tasksch":
+        _install_tasksch(command, job_name)
+    elif backend == "cron":
+        if not _install_cron(command, cron_tag):
+            raise RuntimeError("cron backend requested but `crontab` "
+                               "is not available")
+    elif backend != "elapsed":
+        raise ValueError(f"unknown backend {backend!r}")
+
+    reg = _load_registry(cfg)
+    reg["jobs"][job_name] = {
+        "command": command,
+        "guarded_command": command,
+        "interval_h": 24,
+        "backend": used,
+        "requires_devin_closed": False,
+        "installed_at": int(time.time()),
+        "last_run": 0,
+    }
+    _save_registry(cfg, reg)
+    return {"job": job_name, "backend": used, "command": command,
+            "registry": str(_registry_path(cfg))}

devin_install_scheduler-0.1.0/src/devin_install_scheduler.egg-info/PKG-INFO

@@ -0,0 +1,32 @@
+Metadata-Version: 2.4
+Name: devin-install-scheduler
+Version: 0.1.0
+Summary: Shared daily-job installer for the devin-state packages — cron, Task Scheduler, or config-registry fallback.
+Author: Icaro0310
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+
+# devin-install-scheduler
+
+Shared installer for the `devin-state` packages' daily jobs. Registers a
+tagged `crontab` line on Linux/macOS, a `schtasks` entry on Windows, or a
+job record in `<config-dir>/.devin-ecosystem/scheduled.json` (the F6
+elapsed fallback ticked by devin-powerups' `UserPromptSubmit` hook).
+
+Used by `devin-backup` (`devin-backup-daily`) and `devin-janitor`
+(`devin-janitor-daily`). Not a Devin-facing CLI — library only.
+
+```python
+from devin_install_scheduler import install_daily
+
+install_daily(
+    job_name="my-job-daily",
+    command=f'"{sys.executable}" -m my_pkg.cli run',
+)
+```
+
+> Unofficial community project. Not affiliated with, endorsed by, or
+> sponsored by Cognition AI. "Devin" is a trademark of Cognition AI.

devin_install_scheduler-0.1.0/src/devin_install_scheduler.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+README.md
+pyproject.toml
+src/devin_install_scheduler/__init__.py
+src/devin_install_scheduler/install.py
+src/devin_install_scheduler.egg-info/PKG-INFO
+src/devin_install_scheduler.egg-info/SOURCES.txt
+src/devin_install_scheduler.egg-info/dependency_links.txt
+src/devin_install_scheduler.egg-info/requires.txt
+src/devin_install_scheduler.egg-info/top_level.txt
+tests/test_install.py

devin_install_scheduler-0.1.0/src/devin_install_scheduler.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

devin_install_scheduler-0.1.0/src/devin_install_scheduler.egg-info/requires.txt

@@ -0,0 +1,3 @@
+
+[dev]
+pytest>=8

devin_install_scheduler-0.1.0/src/devin_install_scheduler.egg-info/top_level.txt

@@ -0,0 +1 @@
+devin_install_scheduler

devin_install_scheduler-0.1.0/tests/test_install.py

@@ -0,0 +1,43 @@
+import json
+import subprocess
+from pathlib import Path
+
+import pytest
+
+from devin_install_scheduler import install as sched
+from devin_install_scheduler import install_daily
+
+
+def test_elapsed_writes_f6_registry(tmp_path):
+    res = install_daily("devin-test-daily", '"py" -m pkg.cli run',
+                        config_dir=str(tmp_path / "cfg"), backend="elapsed")
+    assert res["backend"] == "elapsed"
+    reg = json.loads(Path(res["registry"]).read_text())
+    job = reg["jobs"]["devin-test-daily"]
+    assert job["command"] == '"py" -m pkg.cli run'
+    assert job["guarded_command"] == job["command"]
+    assert job["interval_h"] == 24
+    assert job["requires_devin_closed"] is False
+    assert job["installed_at"] > 0 and job["last_run"] == 0
+
+
+def test_bad_backend(tmp_path):
+    with pytest.raises(ValueError):
+        install_daily("j", "cmd", config_dir=str(tmp_path), backend="bogus")
+
+
+def test_cron_tagged_line(tmp_path, monkeypatch):
+    calls = []
+    monkeypatch.setattr(sched.shutil, "which", lambda _c: "/usr/bin/crontab")
+
+    def fake_run(argv, **kw):
+        calls.append((argv, kw))
+        return subprocess.CompletedProcess(argv, 0, "", "")
+
+    monkeypatch.setattr(sched.subprocess, "run", fake_run)
+    res = install_daily("devin-test-daily", '"py" -m pkg.cli run',
+                        config_dir=str(tmp_path / "cfg"), backend="cron")
+    assert res["backend"] == "cron"
+    stdin = calls[-1][1]["input"]
+    assert "@daily" in stdin
+    assert "# devin-ecosystem:devin-test-daily" in stdin