pymon-sdk 0.1.3__tar.gz

pymon_sdk-0.1.3/PKG-INFO

@@ -0,0 +1,41 @@
+Metadata-Version: 2.4
+Name: pymon-sdk
+Version: 0.1.3
+Summary: Monitor your Python jobs with one decorator.
+Author-email: Antony Kimanzi <antony.kim345@gmail.com>
+License: MIT
+Project-URL: Homepage, https://pymon.dev
+Project-URL: Repository, https://github.com/antony_kimanzi/pymon-python-sdk
+Keywords: monitoring,cron,jobs,celery,alerts,devops
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+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: Topic :: System :: Monitoring
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.28.0
+
+# PyMon Python SDK 🐍
+
+Monitor your Python jobs with one decorator. Get instant alerts with full stack traces when they fail.
+
+## Why PyMon?
+
+- 🐍 **One decorator:** No complex setup, no YAML files, no infrastructure changes.
+- 📋 **Stack traces in alerts:** Know exactly which line of code failed instantly.
+- ⚡ **Async support:** Works perfectly with `async`/`await` using `@monitor_async`.
+- 🛡️ **Non-blocking:** If the PyMon API goes down, your script will *never* crash.
+- 🆓 **Free forever:** No credit card, no hidden limits.
+
+## Installation
+
+You can install the SDK directly via pip:
+
+```bash
+pip install pymon-sdk

pymon_sdk-0.1.3/README.md

@@ -0,0 +1,18 @@
+# PyMon Python SDK 🐍
+
+Monitor your Python jobs with one decorator. Get instant alerts with full stack traces when they fail.
+
+## Why PyMon?
+
+- 🐍 **One decorator:** No complex setup, no YAML files, no infrastructure changes.
+- 📋 **Stack traces in alerts:** Know exactly which line of code failed instantly.
+- ⚡ **Async support:** Works perfectly with `async`/`await` using `@monitor_async`.
+- 🛡️ **Non-blocking:** If the PyMon API goes down, your script will *never* crash.
+- 🆓 **Free forever:** No credit card, no hidden limits.
+
+## Installation
+
+You can install the SDK directly via pip:
+
+```bash
+pip install pymon-sdk

pymon_sdk-0.1.3/pymon/__init__.py

@@ -0,0 +1,6 @@
+from .client import Client
+from .decorators import monitor, monitor_async
+
+__version__ = "0.1.0"
+
+__all__ = ["Client", "monitor", "monitor_async"]

pymon_sdk-0.1.3/pymon/client.py

@@ -0,0 +1,75 @@
+from datetime import datetime, timezone
+import os
+import traceback
+from typing import Optional, Dict, Any
+import requests
+
+
+class Client:
+    """Client for communicating with the PyMon API."""
+
+    def __init__(
+            self,
+            api_key: Optional[str] = None,
+            base_url: Optional[str] = None,
+            timeout: int = 5,
+    ):
+        # Read from environment variables if not passed explicitly
+        self.api_key = api_key or os.environ.get("PYMON_API_KEY")
+        self.base_url = base_url or os.environ.get("PYMON_API_BASE_URL", "http://localhost:8080/api/v1")
+        self.timeout = timeout
+
+        if not self.api_key:
+            raise ValueError(
+                "PyMon API Key is required."
+                "Set the PYMON_API_KEY environment variable or pass api_key"
+            )
+
+    def _get_headers(self) -> Dict[str, str]:
+            return {
+                "Authorization": f"Bearer {self.api_key}",
+                "Content-Type": "application/json",
+                "User-Agent": "pymon-python/0.1.0",
+            }
+
+    def ping_success(self, duration_ms: int) -> bool:
+            """Send a success ping tp the backend"""
+            try:
+                url = f"{self.base_url}/ping/{self.api_key}"
+                payload = {"durationMs" : duration_ms}
+
+                response = requests.post(
+                    url,
+                    json=payload,
+                    headers=self._get_headers(),
+                    timeout=self.timeout,
+                )
+                response.raise_for_status()
+                return True
+            except requests.RequestException as e:
+                print(f"DEBUG: Ping failed -> {e}")  # ADD THIS
+                return False
+
+    def report_failure(self, error: Exception) -> bool:
+            """Report a failure with the full stack trace"""
+            try:
+                url = f"{self.base_url}/ping/{self.api_key}/fail"
+
+                payload = {
+                    "errorType": type(error).__name__,
+                    "errorMessage": str(error),
+                    "stackTrace": traceback.format_exc(),
+                    "occurredAt": datetime.now(timezone.utc).isoformat()
+                }
+
+                response = requests.post(
+                    url,
+                    json=payload,
+                    headers=self._get_headers(),
+                    timeout=self.timeout,
+                )
+                response.raise_for_status()
+                return True
+            except requests.RequestException as e:
+                print(f"DEBUG: Failure report failed -> {e}") # ADD THIS
+                return False

pymon_sdk-0.1.3/pymon/decorators.py

@@ -0,0 +1,72 @@
+import functools
+import time
+from typing import Optional, Callable, Any
+
+from pymon.client import Client
+
+
+def monitor(check_name: str, client: Optional[Client] = None):
+    """
+    Decorator to monitor a synchronous function.
+
+    Usage:
+        @monitor("nightly-backup")
+        def backup():
+            ...
+    """
+
+    def decorator(func: Callable) -> Callable:
+        @functools.wraps(func)
+        def wrapper(*args, **kwargs) -> Any:
+            _client = client or Client()
+            start_time = time.time()
+
+            try:
+                # Run the user's function
+                result = func(*args, **kwargs)
+
+                # If iy succeeds, calculate time and send success ping
+                duration_ms = int((time.time() - start_time) * 1000)
+                _client.ping_success(duration_ms)
+                return result
+
+            except Exception as e:
+                # If it fails, report the failure, then re-raise the error
+                _client.report_failure(e)
+                raise e
+
+        return wrapper
+    return decorator
+
+def monitor_async(check_name: str, client: Optional[Client] = None):
+    """
+       Decorator to monitor an asynchronous function.
+
+       Usage:
+           @monitor_async("daily-report")
+           async def generate_report():
+               ...
+       """
+    def decorator(func: Callable) -> Callable:
+        @functools.wraps(func)
+        async def wrapper(*args, **kwargs) -> Any:
+            _client = client or Client()
+            start_time = time.time()
+
+            try:
+                # Run the user's async function
+                result = await func(*args, **kwargs)
+
+                # Send success ping
+                duration_ms = int((time.time() - start_time) * 1000)
+                _client.ping_success(duration_ms)
+
+                return result
+
+            except Exception as e:
+                # Report failure, then re-raise
+                _client.report_failure(e)
+                raise e
+
+        return wrapper
+    return decorator

pymon_sdk-0.1.3/pymon_sdk.egg-info/PKG-INFO

@@ -0,0 +1,41 @@
+Metadata-Version: 2.4
+Name: pymon-sdk
+Version: 0.1.3
+Summary: Monitor your Python jobs with one decorator.
+Author-email: Antony Kimanzi <antony.kim345@gmail.com>
+License: MIT
+Project-URL: Homepage, https://pymon.dev
+Project-URL: Repository, https://github.com/antony_kimanzi/pymon-python-sdk
+Keywords: monitoring,cron,jobs,celery,alerts,devops
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+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: Topic :: System :: Monitoring
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.28.0
+
+# PyMon Python SDK 🐍
+
+Monitor your Python jobs with one decorator. Get instant alerts with full stack traces when they fail.
+
+## Why PyMon?
+
+- 🐍 **One decorator:** No complex setup, no YAML files, no infrastructure changes.
+- 📋 **Stack traces in alerts:** Know exactly which line of code failed instantly.
+- ⚡ **Async support:** Works perfectly with `async`/`await` using `@monitor_async`.
+- 🛡️ **Non-blocking:** If the PyMon API goes down, your script will *never* crash.
+- 🆓 **Free forever:** No credit card, no hidden limits.
+
+## Installation
+
+You can install the SDK directly via pip:
+
+```bash
+pip install pymon-sdk

pymon_sdk-0.1.3/pymon_sdk.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+README.md
+pyproject.toml
+pymon/__init__.py
+pymon/client.py
+pymon/decorators.py
+pymon_sdk.egg-info/PKG-INFO
+pymon_sdk.egg-info/SOURCES.txt
+pymon_sdk.egg-info/dependency_links.txt
+pymon_sdk.egg-info/requires.txt
+pymon_sdk.egg-info/top_level.txt

pymon_sdk-0.1.3/pymon_sdk.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

pymon_sdk-0.1.3/pymon_sdk.egg-info/requires.txt

@@ -0,0 +1 @@
+requests>=2.28.0

pymon_sdk-0.1.3/pymon_sdk.egg-info/top_level.txt

@@ -0,0 +1 @@
+pymon

pymon_sdk-0.1.3/pyproject.toml

@@ -0,0 +1,34 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pymon-sdk"
+version = "0.1.3"
+description = "Monitor your Python jobs with one decorator."
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [
+    { name = "Antony Kimanzi", email = "antony.kim345@gmail.com"}
+]
+keywords = ["monitoring", "cron", "jobs", "celery", "alerts", "devops"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: System :: Monitoring",
+]
+dependencies = [
+    "requests>=2.28.0"
+]
+
+[project.urls]
+Homepage = "https://pymon.dev"
+Repository = "https://github.com/antony_kimanzi/pymon-python-sdk"

pymon_sdk-0.1.3/setup.cfg

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