de-scorpio 0.2.2__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,31 @@
1
+ Metadata-Version: 2.5
2
+ Name: de-scorpio
3
+ Version: 0.2.2
4
+ Summary: Scorpio — freshness, lineage and operational alerts
5
+ Project-URL: Homepage, https://github.com/KooEric/de-arsenal
6
+ Project-URL: Repository, https://github.com/KooEric/de-arsenal
7
+ License-Expression: Apache-2.0
8
+ Classifier: License :: OSI Approved :: Apache Software License
9
+ Classifier: Operating System :: OS Independent
10
+ Classifier: Programming Language :: Python :: 3
11
+ Classifier: Programming Language :: Python :: 3.11
12
+ Classifier: Programming Language :: Python :: 3.12
13
+ Requires-Python: >=3.11
14
+ Description-Content-Type: text/markdown
15
+
16
+ # Scorpio
17
+
18
+ 운영 관측 패키지. Arsenal 상태 DB의 마지막 완료 시각을 기준으로 freshness를
19
+ 판정하고 stale alert를 만든다.
20
+
21
+ PyPI 배포명은 `de-scorpio`이며 Python import 경로는 `scorpio`를 유지한다.
22
+
23
+ ```bash
24
+ pip install de-scorpio
25
+ ```
26
+
27
+ ```python
28
+ from scorpio import assess_freshness
29
+
30
+ status = assess_freshness(last_completed_at, max_age_seconds=3600)
31
+ ```
@@ -0,0 +1,6 @@
1
+ scorpio/__init__.py,sha256=xs3ooOgDDvK1nJWoS6KJ8kOBN0tkB7dgkcGUIXkHVoc,326
2
+ scorpio/freshness.py,sha256=xVuNiYLfDA4KmxD2J8mzsmblLmc0-b9CfFJL0m4z2E8,1664
3
+ scorpio/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
4
+ de_scorpio-0.2.2.dist-info/METADATA,sha256=fdW38rat0ysGlFiyxsM60YzLS9mMpa8g9WC_EzJ4ZQU,991
5
+ de_scorpio-0.2.2.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
6
+ de_scorpio-0.2.2.dist-info/RECORD,,
@@ -0,0 +1,4 @@
1
+ Wheel-Version: 1.0
2
+ Generator: hatchling 1.32.0
3
+ Root-Is-Purelib: true
4
+ Tag: py3-none-any
scorpio/__init__.py ADDED
@@ -0,0 +1,12 @@
1
+ """Scorpio — operational freshness checks and alerts."""
2
+
3
+ from importlib.metadata import PackageNotFoundError, version
4
+
5
+ try:
6
+ __version__ = version("de-scorpio")
7
+ except PackageNotFoundError:
8
+ __version__ = "0.2.2"
9
+
10
+ from scorpio.freshness import Freshness, assess_freshness
11
+
12
+ __all__ = ["Freshness", "assess_freshness"]
scorpio/freshness.py ADDED
@@ -0,0 +1,49 @@
1
+ """Deterministic freshness evaluation for state-store timestamps."""
2
+
3
+ from dataclasses import dataclass
4
+ from datetime import UTC, datetime
5
+
6
+
7
+ @dataclass(frozen=True)
8
+ class Freshness:
9
+ status: str # fresh | stale | unknown
10
+ age_seconds: float | None
11
+ max_age_seconds: float
12
+ last_completed_at: str | None
13
+ message: str
14
+
15
+ @property
16
+ def alert(self) -> bool:
17
+ return self.status == "stale"
18
+
19
+
20
+ def assess_freshness(
21
+ last_completed_at: str | None,
22
+ *,
23
+ max_age_seconds: float,
24
+ now: datetime | None = None,
25
+ ) -> Freshness:
26
+ """Classify the last completed run as fresh, stale, or unknown."""
27
+ if max_age_seconds <= 0:
28
+ raise ValueError("max_age_seconds must be positive")
29
+ if last_completed_at is None:
30
+ return Freshness(
31
+ status="unknown",
32
+ age_seconds=None,
33
+ max_age_seconds=max_age_seconds,
34
+ last_completed_at=None,
35
+ message="no completed unit has been recorded",
36
+ )
37
+ try:
38
+ completed = datetime.fromisoformat(last_completed_at)
39
+ except ValueError as e:
40
+ raise ValueError(f"invalid completion timestamp: {last_completed_at!r}") from e
41
+ if completed.tzinfo is None:
42
+ completed = completed.replace(tzinfo=UTC)
43
+ reference = now or datetime.now(UTC)
44
+ if reference.tzinfo is None:
45
+ reference = reference.replace(tzinfo=UTC)
46
+ age = max(0.0, (reference - completed).total_seconds())
47
+ status = "fresh" if age <= max_age_seconds else "stale"
48
+ message = f"last completion is {age:.1f}s old (limit {max_age_seconds:.1f}s)"
49
+ return Freshness(status, age, max_age_seconds, last_completed_at, message)
scorpio/py.typed ADDED
File without changes