cronbark 0.0.1__tar.gz

cronbark-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CronBark
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

cronbark-0.0.1/PKG-INFO

@@ -0,0 +1,161 @@
+Metadata-Version: 2.4
+Name: cronbark
+Version: 0.0.1
+Summary: CronBark Python SDK & CLI — 크론잡 모니터링을 위한 간편 연동 도구
+Author: CronBark Team
+License: MIT
+Project-URL: Homepage, https://github.com/wookja-0/cronbark-sdk
+Project-URL: Repository, https://github.com/wookja-0/cronbark-sdk
+Project-URL: Issues, https://github.com/wookja-0/cronbark-sdk/issues
+Project-URL: Documentation, https://cronbark.com/docs
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+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.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Monitoring
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: click>=8.0.0
+Dynamic: license-file
+
+# CronBark Python SDK
+
+Python SDK and CLI for [CronBark](https://cronbark.com) — monitor any cron job
+with a single decorator.
+
+> **Preview / Alpha.** This SDK is in preview and the CronBark SaaS service is
+> launching soon. The public API may change in backwards-incompatible ways
+> before the 1.0 release.
+
+## Install
+
+```bash
+pip install cronbark
+```
+
+Requires **Python 3.9+**.
+
+## Quickstart
+
+Get an API token from your CronBark dashboard, then pick whichever style fits
+your job best.
+
+### 1. Context manager
+
+Wrap any block of code — `start` is sent on entry, and `success` or `fail`
+(with the traceback) is sent on exit.
+
+```python
+import cronbark
+
+cronbark.configure(token="YOUR_TOKEN")
+
+with cronbark.monitor():
+    run_backup()
+```
+
+### 2. Decorator
+
+Instrument an existing function in one line.
+
+```python
+import cronbark
+
+@cronbark.job("YOUR_TOKEN")
+def generate_report():
+    ...
+```
+
+### 3. CLI — wrap any command
+
+The easiest way to monitor an existing cron entry without touching its source:
+
+```bash
+cronbark exec --token YOUR_TOKEN "python backup.py"
+```
+
+Use it directly in `crontab`:
+
+```crontab
+# Before
+0 * * * * /usr/bin/python3 /opt/scripts/backup.py
+
+# After
+0 * * * * cronbark exec --token YOUR_TOKEN "/usr/bin/python3 /opt/scripts/backup.py"
+```
+
+The CLI captures stdout/stderr, forwards them to CronBark, and exits with the
+same status code as the wrapped command.
+
+## Configuration
+
+The SDK reads configuration from environment variables by default:
+
+| Variable | Purpose | Default |
+|----------|---------|---------|
+| `CRONBARK_TOKEN` | Your job's API token | _(none — required)_ |
+| `CRONBARK_URL` | API base URL override (self-hosted, staging, etc.) | `https://api.cronbark.com` |
+
+You can also configure the SDK programmatically:
+
+```python
+import cronbark
+
+cronbark.configure(
+    token="YOUR_TOKEN",
+    base_url="https://api.cronbark.com",  # optional
+    timeout=10,                            # seconds, optional
+)
+```
+
+## Public API
+
+Top-level functions exported from the `cronbark` package:
+
+| Symbol | Description |
+|--------|-------------|
+| `configure(token, base_url, timeout)` | Set global SDK configuration. |
+| `monitor(token=None)` | Context manager — auto `start` / `success` / `fail`. |
+| `job(token=None)` | Decorator wrapping a function with `monitor`. |
+| `ping(token=None)` | One-shot `start + success`. |
+| `start(token=None)` | Report execution start. |
+| `success(token=None, output=None, metrics=None)` | Report success. |
+| `fail(token=None, error_message=None, output=None)` | Report failure. |
+| `tick(token=None)` | Heartbeat — report success without a prior `start`. |
+
+CLI commands (`cronbark --help`):
+
+```
+cronbark exec --token TOKEN "<command>"   # wrap and run a command
+cronbark ping TOKEN                     # one-shot start+success
+cronbark start TOKEN
+cronbark success TOKEN
+cronbark fail TOKEN --msg "..."
+cronbark tick TOKEN
+cronbark discover                       # scan local crontab
+```
+
+All HTTP calls are best-effort: network errors are swallowed and returned as
+`{"status": "error", "message": "..."}` so an unreachable monitoring service
+will never break your job.
+
+## Links
+
+- Website: [cronbark.com](https://cronbark.com)
+- Documentation: [cronbark.com/docs](https://cronbark.com/docs) _(coming soon)_
+- Issues: [github.com/wookja-0/cronbark-sdk/issues](https://github.com/wookja-0/cronbark-sdk/issues)
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

cronbark-0.0.1/README.md

@@ -0,0 +1,130 @@
+# CronBark Python SDK
+
+Python SDK and CLI for [CronBark](https://cronbark.com) — monitor any cron job
+with a single decorator.
+
+> **Preview / Alpha.** This SDK is in preview and the CronBark SaaS service is
+> launching soon. The public API may change in backwards-incompatible ways
+> before the 1.0 release.
+
+## Install
+
+```bash
+pip install cronbark
+```
+
+Requires **Python 3.9+**.
+
+## Quickstart
+
+Get an API token from your CronBark dashboard, then pick whichever style fits
+your job best.
+
+### 1. Context manager
+
+Wrap any block of code — `start` is sent on entry, and `success` or `fail`
+(with the traceback) is sent on exit.
+
+```python
+import cronbark
+
+cronbark.configure(token="YOUR_TOKEN")
+
+with cronbark.monitor():
+    run_backup()
+```
+
+### 2. Decorator
+
+Instrument an existing function in one line.
+
+```python
+import cronbark
+
+@cronbark.job("YOUR_TOKEN")
+def generate_report():
+    ...
+```
+
+### 3. CLI — wrap any command
+
+The easiest way to monitor an existing cron entry without touching its source:
+
+```bash
+cronbark exec --token YOUR_TOKEN "python backup.py"
+```
+
+Use it directly in `crontab`:
+
+```crontab
+# Before
+0 * * * * /usr/bin/python3 /opt/scripts/backup.py
+
+# After
+0 * * * * cronbark exec --token YOUR_TOKEN "/usr/bin/python3 /opt/scripts/backup.py"
+```
+
+The CLI captures stdout/stderr, forwards them to CronBark, and exits with the
+same status code as the wrapped command.
+
+## Configuration
+
+The SDK reads configuration from environment variables by default:
+
+| Variable | Purpose | Default |
+|----------|---------|---------|
+| `CRONBARK_TOKEN` | Your job's API token | _(none — required)_ |
+| `CRONBARK_URL` | API base URL override (self-hosted, staging, etc.) | `https://api.cronbark.com` |
+
+You can also configure the SDK programmatically:
+
+```python
+import cronbark
+
+cronbark.configure(
+    token="YOUR_TOKEN",
+    base_url="https://api.cronbark.com",  # optional
+    timeout=10,                            # seconds, optional
+)
+```
+
+## Public API
+
+Top-level functions exported from the `cronbark` package:
+
+| Symbol | Description |
+|--------|-------------|
+| `configure(token, base_url, timeout)` | Set global SDK configuration. |
+| `monitor(token=None)` | Context manager — auto `start` / `success` / `fail`. |
+| `job(token=None)` | Decorator wrapping a function with `monitor`. |
+| `ping(token=None)` | One-shot `start + success`. |
+| `start(token=None)` | Report execution start. |
+| `success(token=None, output=None, metrics=None)` | Report success. |
+| `fail(token=None, error_message=None, output=None)` | Report failure. |
+| `tick(token=None)` | Heartbeat — report success without a prior `start`. |
+
+CLI commands (`cronbark --help`):
+
+```
+cronbark exec --token TOKEN "<command>"   # wrap and run a command
+cronbark ping TOKEN                     # one-shot start+success
+cronbark start TOKEN
+cronbark success TOKEN
+cronbark fail TOKEN --msg "..."
+cronbark tick TOKEN
+cronbark discover                       # scan local crontab
+```
+
+All HTTP calls are best-effort: network errors are swallowed and returned as
+`{"status": "error", "message": "..."}` so an unreachable monitoring service
+will never break your job.
+
+## Links
+
+- Website: [cronbark.com](https://cronbark.com)
+- Documentation: [cronbark.com/docs](https://cronbark.com/docs) _(coming soon)_
+- Issues: [github.com/wookja-0/cronbark-sdk/issues](https://github.com/wookja-0/cronbark-sdk/issues)
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

cronbark-0.0.1/cronbark/__init__.py

@@ -0,0 +1,50 @@
+"""
+CronBark Python SDK
+크론잡 모니터링을 위한 간편 연동 라이브러리.
+
+사용 예:
+    import cronbark
+
+    # 환경변수 또는 직접 설정
+    cronbark.configure(token="YOUR_TOKEN", base_url="https://api.cronbark.com")
+
+    # 컨텍스트 매니저 — 자동 start/success/fail
+    with cronbark.monitor("backup-daily"):
+        run_backup()
+
+    # 데코레이터
+    @cronbark.job("report-gen")
+    def generate_report():
+        ...
+
+    # 수동 호출
+    cronbark.ping("YOUR_TOKEN")
+    cronbark.start("YOUR_TOKEN")
+    cronbark.success("YOUR_TOKEN", output="Done: 100 rows")
+    cronbark.fail("YOUR_TOKEN", error_message="Connection refused")
+    cronbark.tick("YOUR_TOKEN")
+"""
+
+from cronbark.client import (
+    configure,
+    fail,
+    job,
+    monitor,
+    ping,
+    start,
+    success,
+    tick,
+)
+
+__version__ = "0.0.1"
+
+__all__ = [
+    "configure",
+    "monitor",
+    "job",
+    "ping",
+    "start",
+    "success",
+    "fail",
+    "tick",
+]

cronbark-0.0.1/cronbark/cli.py

@@ -0,0 +1,185 @@
+"""
+CronBark CLI — 터미널에서 크론잡을 모니터링하는 명령줄 도구.
+
+사용 예:
+    # 명령어 감싸기 (자동 start → 실행 → success/fail)
+    cronbark exec --token TOKEN "python backup.py"
+
+    # 수동 이벤트 전송
+    cronbark ping TOKEN
+    cronbark start TOKEN
+    cronbark success TOKEN
+    cronbark fail TOKEN --msg "Connection refused"
+    cronbark tick TOKEN
+
+    # crontab 자동 스캔
+    cronbark discover
+"""
+
+import os
+import subprocess
+import sys
+
+import click
+
+from cronbark.client import configure, fail, ping, start, success, tick
+
+
+@click.group()
+@click.option(
+    "--url",
+    envvar="CRONBARK_URL",
+    default="https://api.cronbark.com",
+    help="CronBark API URL (기본: https://api.cronbark.com)",
+)
+def main(url: str):
+    """CronBark CLI - 크론잡 모니터링 도구"""
+    configure(base_url=url)
+
+
+@main.command(name="ping")
+@click.argument("token")
+def do_ping(token: str):
+    """간단 ping (start + success 한 번에)"""
+    result = ping(token)
+    click.echo(f"[cronbark] {result.get('status', 'error')}: {result.get('message', '')}")
+
+
+@main.command(name="start")
+@click.argument("token")
+def do_start(token: str):
+    """실행 시작 알림"""
+    result = start(token)
+    click.echo(f"[cronbark] {result.get('status', 'error')}: {result.get('message', '')}")
+
+
+@main.command(name="success")
+@click.argument("token")
+def do_success(token: str):
+    """실행 성공 알림"""
+    result = success(token)
+    click.echo(f"[cronbark] {result.get('status', 'error')}: {result.get('message', '')}")
+
+
+@main.command(name="fail")
+@click.argument("token")
+@click.option("--msg", default=None, help="에러 메시지")
+def do_fail(token: str, msg: str):
+    """실행 실패 알림"""
+    result = fail(token, error_message=msg)
+    click.echo(f"[cronbark] {result.get('status', 'error')}: {result.get('message', '')}")
+
+
+@main.command(name="tick")
+@click.argument("token")
+def do_tick(token: str):
+    """하트비트 전송"""
+    result = tick(token)
+    click.echo(f"[cronbark] {result.get('status', 'error')}: {result.get('message', '')}")
+
+
+@main.command(name="exec")
+@click.option("--token", envvar="CRONBARK_TOKEN", required=True, help="API 토큰")
+@click.argument("command", nargs=-1, required=True)
+def do_exec(token: str, command: tuple):
+    """
+    명령어를 실행하고 결과를 자동 보고한다.
+
+    사용: cronbark exec --token TOKEN "python backup.py"
+    """
+    cmd_str = " ".join(command)
+    click.echo(f"[cronbark] 실행: {cmd_str}")
+
+    # start 전송
+    start(token)
+
+    try:
+        # 명령어 실행
+        result = subprocess.run(
+            cmd_str,
+            shell=True,
+            capture_output=True,
+            text=True,
+        )
+
+        output = ""
+        if result.stdout:
+            output += result.stdout
+        if result.stderr:
+            output += "\n--- STDERR ---\n" + result.stderr
+
+        if result.returncode == 0:
+            # 성공
+            resp = success(token, output=output[:1_000_000] if output else None)
+            click.echo(f"[cronbark] 성공 (exit code 0)")
+        else:
+            # 실패
+            error_msg = f"Exit code {result.returncode}"
+            if result.stderr:
+                error_msg += f": {result.stderr[:500]}"
+            resp = fail(token, error_message=error_msg, output=output[:1_000_000] if output else None)
+            click.echo(f"[cronbark] 실패 (exit code {result.returncode})")
+
+        sys.exit(result.returncode)
+
+    except Exception as e:
+        fail(token, error_message=str(e))
+        click.echo(f"[cronbark] 에러: {e}")
+        sys.exit(1)
+
+
+@main.command()
+def discover():
+    """
+    시스템의 crontab을 스캔하여 등록 가능한 크론잡 목록을 표시한다.
+    """
+    click.echo("[cronbark] crontab 스캔 중...")
+
+    try:
+        # 현재 사용자의 crontab 조회
+        result = subprocess.run(
+            ["crontab", "-l"],
+            capture_output=True,
+            text=True,
+        )
+
+        if result.returncode != 0:
+            click.echo("[cronbark] crontab이 비어있거나 접근할 수 없습니다.")
+            return
+
+        lines = result.stdout.strip().split("\n")
+        jobs = []
+        for line in lines:
+            line = line.strip()
+            # 주석과 빈 줄 건너뛰기
+            if not line or line.startswith("#"):
+                continue
+            # 환경변수 설정 건너뛰기
+            if "=" in line.split()[0]:
+                continue
+            jobs.append(line)
+
+        if not jobs:
+            click.echo("[cronbark] 등록된 crontab 작업이 없습니다.")
+            return
+
+        click.echo(f"\n발견된 크론잡 {len(jobs)}개:\n")
+        click.echo(f"{'#':<4} {'스케줄':<20} {'명령어'}")
+        click.echo("-" * 70)
+        for i, job_line in enumerate(jobs, 1):
+            parts = job_line.split(None, 5)
+            if len(parts) >= 6:
+                schedule = " ".join(parts[:5])
+                command = parts[5]
+            else:
+                schedule = "파싱 불가"
+                command = job_line
+            click.echo(f"{i:<4} {schedule:<20} {command}")
+
+        click.echo(f"\n[cronbark] 위 크론잡을 CronBark에 등록하려면 각 crontab 명령어를 다음처럼 감싸세요:")
+        click.echo('  cronbark exec --token YOUR_TOKEN "명령어"')
+
+    except FileNotFoundError:
+        click.echo("[cronbark] crontab 명령어를 찾을 수 없습니다. (Windows에서는 지원되지 않습니다)")
+    except Exception as e:
+        click.echo(f"[cronbark] 스캔 에러: {e}")

cronbark-0.0.1/cronbark/client.py

@@ -0,0 +1,161 @@
+"""
+CronBark Python SDK 클라이언트.
+HTTP API를 래핑하여 간편한 크론잡 모니터링을 제공한다.
+"""
+
+import functools
+import os
+import sys
+import traceback
+from contextlib import contextmanager
+from typing import Any, Callable, Optional
+
+import httpx
+
+# ── 글로벌 설정 ────────────────────────────────────────────────
+
+_config = {
+    "token": os.environ.get("CRONBARK_TOKEN", ""),
+    "base_url": os.environ.get("CRONBARK_URL", "https://api.cronbark.com"),
+    "timeout": 10,
+}
+
+
+def configure(
+    token: Optional[str] = None,
+    base_url: Optional[str] = None,
+    timeout: int = 10,
+) -> None:
+    """SDK 글로벌 설정을 변경한다."""
+    if token is not None:
+        _config["token"] = token
+    if base_url is not None:
+        _config["base_url"] = base_url
+    _config["timeout"] = timeout
+
+
+def _get_token(token: Optional[str] = None) -> str:
+    """토큰을 결정한다 (직접 전달 > 환경변수 > 글로벌 설정)."""
+    return token or _config["token"] or os.environ.get("CRONBARK_TOKEN", "")
+
+
+def _api_url(token: str, endpoint: str) -> str:
+    """API URL을 구성한다."""
+    base = _config["base_url"].rstrip("/")
+    return f"{base}/api/v1/health/{token}/{endpoint}"
+
+
+def _send(token: str, endpoint: str, body: Optional[dict] = None) -> dict:
+    """
+    텔레메트리 이벤트를 전송한다.
+    실패해도 예외를 발생시키지 않고 에러 dict를 반환한다.
+    """
+    url = _api_url(token, endpoint)
+    try:
+        with httpx.Client(timeout=_config["timeout"]) as client:
+            if body:
+                resp = client.post(url, json=body)
+            else:
+                resp = client.post(url)
+            return resp.json()
+    except Exception as e:
+        return {"status": "error", "message": str(e)}
+
+
+# ── 공개 API ─────────────────────────────────────────────────
+
+
+def ping(token: Optional[str] = None) -> dict:
+    """간단 ping — start+success를 한 번에."""
+    t = _get_token(token)
+    base = _config["base_url"].rstrip("/")
+    url = f"{base}/api/v1/ping/{t}"
+    try:
+        with httpx.Client(timeout=_config["timeout"]) as client:
+            resp = client.get(url)
+            return resp.json()
+    except Exception as e:
+        return {"status": "error", "message": str(e)}
+
+
+def start(token: Optional[str] = None) -> dict:
+    """실행 시작을 알린다."""
+    return _send(_get_token(token), "start")
+
+
+def success(
+    token: Optional[str] = None,
+    output: Optional[str] = None,
+    metrics: Optional[dict] = None,
+) -> dict:
+    """실행 성공을 알린다. output/metrics를 함께 전송할 수 있다."""
+    body = {}
+    if output:
+        body["output"] = output
+    if metrics:
+        body["metrics"] = metrics
+    return _send(_get_token(token), "success", body or None)
+
+
+def fail(
+    token: Optional[str] = None,
+    error_message: Optional[str] = None,
+    output: Optional[str] = None,
+) -> dict:
+    """실행 실패를 알린다."""
+    body = {}
+    if error_message:
+        body["error_message"] = error_message
+    if output:
+        body["output"] = output
+    return _send(_get_token(token), "fail", body or None)
+
+
+def tick(token: Optional[str] = None) -> dict:
+    """하트비트를 전송한다 (start 없이 즉시 성공)."""
+    return _send(_get_token(token), "tick")
+
+
+# ── 컨텍스트 매니저 & 데코레이터 ───────────────────────────────
+
+
+@contextmanager
+def monitor(token: Optional[str] = None):
+    """
+    컨텍스트 매니저 — with 블록 진입 시 start, 종료 시 success/fail 자동 전송.
+
+    사용 예:
+        with cronbark.monitor("YOUR_TOKEN"):
+            run_backup()
+    """
+    t = _get_token(token)
+    start(t)
+    try:
+        yield
+        success(t)
+    except Exception as e:
+        # stdout/stderr 캡처
+        tb = traceback.format_exc()
+        fail(t, error_message=str(e), output=tb)
+        raise
+
+
+def job(token: Optional[str] = None) -> Callable:
+    """
+    데코레이터 — 함수 실행을 자동으로 모니터링한다.
+
+    사용 예:
+        @cronbark.job("YOUR_TOKEN")
+        def generate_report():
+            ...
+    """
+
+    def decorator(func: Callable) -> Callable:
+        @functools.wraps(func)
+        def wrapper(*args: Any, **kwargs: Any) -> Any:
+            with monitor(token):
+                return func(*args, **kwargs)
+
+        return wrapper
+
+    return decorator

cronbark-0.0.1/cronbark.egg-info/PKG-INFO

@@ -0,0 +1,161 @@
+Metadata-Version: 2.4
+Name: cronbark
+Version: 0.0.1
+Summary: CronBark Python SDK & CLI — 크론잡 모니터링을 위한 간편 연동 도구
+Author: CronBark Team
+License: MIT
+Project-URL: Homepage, https://github.com/wookja-0/cronbark-sdk
+Project-URL: Repository, https://github.com/wookja-0/cronbark-sdk
+Project-URL: Issues, https://github.com/wookja-0/cronbark-sdk/issues
+Project-URL: Documentation, https://cronbark.com/docs
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+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.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Monitoring
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: click>=8.0.0
+Dynamic: license-file
+
+# CronBark Python SDK
+
+Python SDK and CLI for [CronBark](https://cronbark.com) — monitor any cron job
+with a single decorator.
+
+> **Preview / Alpha.** This SDK is in preview and the CronBark SaaS service is
+> launching soon. The public API may change in backwards-incompatible ways
+> before the 1.0 release.
+
+## Install
+
+```bash
+pip install cronbark
+```
+
+Requires **Python 3.9+**.
+
+## Quickstart
+
+Get an API token from your CronBark dashboard, then pick whichever style fits
+your job best.
+
+### 1. Context manager
+
+Wrap any block of code — `start` is sent on entry, and `success` or `fail`
+(with the traceback) is sent on exit.
+
+```python
+import cronbark
+
+cronbark.configure(token="YOUR_TOKEN")
+
+with cronbark.monitor():
+    run_backup()
+```
+
+### 2. Decorator
+
+Instrument an existing function in one line.
+
+```python
+import cronbark
+
+@cronbark.job("YOUR_TOKEN")
+def generate_report():
+    ...
+```
+
+### 3. CLI — wrap any command
+
+The easiest way to monitor an existing cron entry without touching its source:
+
+```bash
+cronbark exec --token YOUR_TOKEN "python backup.py"
+```
+
+Use it directly in `crontab`:
+
+```crontab
+# Before
+0 * * * * /usr/bin/python3 /opt/scripts/backup.py
+
+# After
+0 * * * * cronbark exec --token YOUR_TOKEN "/usr/bin/python3 /opt/scripts/backup.py"
+```
+
+The CLI captures stdout/stderr, forwards them to CronBark, and exits with the
+same status code as the wrapped command.
+
+## Configuration
+
+The SDK reads configuration from environment variables by default:
+
+| Variable | Purpose | Default |
+|----------|---------|---------|
+| `CRONBARK_TOKEN` | Your job's API token | _(none — required)_ |
+| `CRONBARK_URL` | API base URL override (self-hosted, staging, etc.) | `https://api.cronbark.com` |
+
+You can also configure the SDK programmatically:
+
+```python
+import cronbark
+
+cronbark.configure(
+    token="YOUR_TOKEN",
+    base_url="https://api.cronbark.com",  # optional
+    timeout=10,                            # seconds, optional
+)
+```
+
+## Public API
+
+Top-level functions exported from the `cronbark` package:
+
+| Symbol | Description |
+|--------|-------------|
+| `configure(token, base_url, timeout)` | Set global SDK configuration. |
+| `monitor(token=None)` | Context manager — auto `start` / `success` / `fail`. |
+| `job(token=None)` | Decorator wrapping a function with `monitor`. |
+| `ping(token=None)` | One-shot `start + success`. |
+| `start(token=None)` | Report execution start. |
+| `success(token=None, output=None, metrics=None)` | Report success. |
+| `fail(token=None, error_message=None, output=None)` | Report failure. |
+| `tick(token=None)` | Heartbeat — report success without a prior `start`. |
+
+CLI commands (`cronbark --help`):
+
+```
+cronbark exec --token TOKEN "<command>"   # wrap and run a command
+cronbark ping TOKEN                     # one-shot start+success
+cronbark start TOKEN
+cronbark success TOKEN
+cronbark fail TOKEN --msg "..."
+cronbark tick TOKEN
+cronbark discover                       # scan local crontab
+```
+
+All HTTP calls are best-effort: network errors are swallowed and returned as
+`{"status": "error", "message": "..."}` so an unreachable monitoring service
+will never break your job.
+
+## Links
+
+- Website: [cronbark.com](https://cronbark.com)
+- Documentation: [cronbark.com/docs](https://cronbark.com/docs) _(coming soon)_
+- Issues: [github.com/wookja-0/cronbark-sdk/issues](https://github.com/wookja-0/cronbark-sdk/issues)
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

cronbark-0.0.1/cronbark.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+LICENSE
+README.md
+pyproject.toml
+cronbark/__init__.py
+cronbark/cli.py
+cronbark/client.py
+cronbark.egg-info/PKG-INFO
+cronbark.egg-info/SOURCES.txt
+cronbark.egg-info/dependency_links.txt
+cronbark.egg-info/entry_points.txt
+cronbark.egg-info/requires.txt
+cronbark.egg-info/top_level.txt
+tests/test_smoke.py

cronbark-0.0.1/cronbark.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

cronbark-0.0.1/cronbark.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+cronbark = cronbark.cli:main

cronbark-0.0.1/cronbark.egg-info/requires.txt

@@ -0,0 +1,2 @@
+httpx>=0.25.0
+click>=8.0.0

cronbark-0.0.1/cronbark.egg-info/top_level.txt

@@ -0,0 +1 @@
+cronbark

cronbark-0.0.1/pyproject.toml

@@ -0,0 +1,63 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "cronbark"
+version = "0.0.1"
+description = "CronBark Python SDK & CLI — 크론잡 모니터링을 위한 간편 연동 도구"
+readme = "README.md"
+requires-python = ">=3.9"
+license = {text = "MIT"}
+authors = [{name = "CronBark Team"}]
+dependencies = [
+    "httpx>=0.25.0",
+    "click>=8.0.0",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Intended Audience :: System Administrators",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: System :: Monitoring",
+]
+
+[project.scripts]
+cronbark = "cronbark.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/wookja-0/cronbark-sdk"
+Repository = "https://github.com/wookja-0/cronbark-sdk"
+Issues = "https://github.com/wookja-0/cronbark-sdk/issues"
+Documentation = "https://cronbark.com/docs"
+
+[tool.setuptools.packages.find]
+include = ["cronbark*"]
+
+[tool.ruff]
+# 초기 릴리스 — 느슨한 설정, 나중에 조일 수 있음
+line-length = 100
+target-version = "py39"
+
+[tool.ruff.lint]
+# pycodestyle/pyflakes 기본만, 노이즈 규칙 제외
+select = ["E", "F", "W"]
+ignore = [
+    "E501",  # line too long (line-length 로 제어)
+]
+
+[tool.ruff.lint.per-file-ignores]
+"__init__.py" = ["F401"]  # 재수출 허용
+"tests/*" = ["F401", "F811"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

cronbark-0.0.1/setup.cfg

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

cronbark-0.0.1/tests/test_smoke.py

@@ -0,0 +1,19 @@
+"""스모크 테스트 — 패키지 임포트 및 버전 확인."""
+
+import cronbark
+
+
+def test_import():
+    """패키지가 정상적으로 임포트되는지 확인."""
+    assert cronbark is not None
+
+
+def test_version():
+    """버전이 예상 값과 일치하는지 확인."""
+    assert cronbark.__version__ == "0.0.1"
+
+
+def test_public_api():
+    """공개 API가 모두 export 되어 있는지 확인."""
+    for name in ("configure", "monitor", "job", "ping", "start", "success", "fail", "tick"):
+        assert hasattr(cronbark, name), f"cronbark.{name} 누락"