cronradar 0.0.1__tar.gz

cronradar-0.0.1/LICENSE

@@ -0,0 +1,41 @@
+CronRadar SDK License
+
+Copyright (c) 2025 CronRadar. All rights reserved.
+
+## Permitted Use
+
+You may use this software solely in connection with the CronRadar monitoring
+service available at cronradar.com. You may view, study, and modify the source
+code for the purpose of fixing bugs or improving functionality.
+
+## Contributions
+
+If you modify this software to fix bugs or add improvements, you may submit
+those modifications back to CronRadar via pull request. By submitting, you
+grant CronRadar a perpetual, worldwide, non-exclusive, royalty-free license
+to use, modify, and distribute your contributions under any terms.
+
+## Restrictions
+
+You may NOT:
+- Use this software with any service other than CronRadar
+- Fork or use this software for your own projects or products
+- Redistribute this software (use official package managers only)
+- Create derivative works for purposes other than contributing back to CronRadar
+- Remove or modify any license, copyright, or attribution notices
+- Use this software to create a competing monitoring service
+
+## Termination
+
+Your license terminates immediately if you violate any restriction. Upon
+termination, you must stop using the software.
+
+## Disclaimer
+
+THIS SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED. IN NO EVENT SHALL CRONRADAR BE LIABLE FOR ANY DAMAGES ARISING FROM
+THE USE OF THIS SOFTWARE.
+
+## Questions
+
+For licensing questions: support@cronradar.com

cronradar-0.0.1/PKG-INFO

@@ -0,0 +1,76 @@
+Metadata-Version: 2.4
+Name: cronradar
+Version: 0.0.1
+Summary: Dead-simple cron job monitoring with auto-registration. Two functions: ping() and sync_monitor(). Self-healing monitors.
+Home-page: https://github.com/cronradar/cronradar-python
+Author: Administrator
+Author-email: contact@cronradar.com
+License: Proprietary
+Project-URL: Documentation, https://cronradar.com/docs
+Project-URL: Source, https://github.com/cronradar/cronradar-python
+Project-URL: Tracker, https://github.com/cronradar/cronradar-python/issues
+Keywords: cron monitoring scheduler job task ping sync auto-register
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: Other/Proprietary License
+Classifier: Operating System :: OS Independent
+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 :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Monitoring
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: requires-python
+Dynamic: summary
+
+# CronRadar Python SDK
+
+Monitor cron jobs with one function call.
+
+## Installation
+
+```bash
+pip install cronradar
+```
+
+## Usage
+
+```python
+import cronradar
+
+# After your cron job completes successfully
+cronradar.ping('daily-backup')
+
+# With self-healing (auto-register if monitor doesn't exist)
+cronradar.ping('daily-backup', schedule='0 2 * * *', grace_period=300)
+```
+
+## Configuration
+
+Set environment variable:
+- `CRONRADAR_API_KEY`: Your API key from cronradar.com
+- `CRONRADAR_BASE_URL`: Base URL override (optional, default: `https://cronradar.com`)
+- `CRONRADAR_METHOD`: HTTP method for ping (optional, default: `GET`)
+
+## Documentation
+
+See [cronradar.com/docs](https://cronradar.com/docs) for full documentation.
+
+## License
+
+MIT

cronradar-0.0.1/README.md

@@ -0,0 +1,36 @@
+# CronRadar Python SDK
+
+Monitor cron jobs with one function call.
+
+## Installation
+
+```bash
+pip install cronradar
+```
+
+## Usage
+
+```python
+import cronradar
+
+# After your cron job completes successfully
+cronradar.ping('daily-backup')
+
+# With self-healing (auto-register if monitor doesn't exist)
+cronradar.ping('daily-backup', schedule='0 2 * * *', grace_period=300)
+```
+
+## Configuration
+
+Set environment variable:
+- `CRONRADAR_API_KEY`: Your API key from cronradar.com
+- `CRONRADAR_BASE_URL`: Base URL override (optional, default: `https://cronradar.com`)
+- `CRONRADAR_METHOD`: HTTP method for ping (optional, default: `GET`)
+
+## Documentation
+
+See [cronradar.com/docs](https://cronradar.com/docs) for full documentation.
+
+## License
+
+MIT

cronradar-0.0.1/cronradar/__init__.py

@@ -0,0 +1,221 @@
+"""
+CronRadar Python SDK
+
+Dead-simple cron job monitoring with auto-registration support.
+Two main functions: ping() for execution confirmation, sync_monitor() for registration.
+"""
+
+import os
+import sys
+import base64
+import json
+import traceback
+from typing import Optional
+from urllib.request import Request, urlopen
+from urllib.error import URLError, HTTPError
+
+
+__version__ = "0.0.1"
+
+
+def ping(monitor_key: str, schedule: Optional[str] = None) -> None:
+    """
+    Ping CronRadar to indicate your job has run successfully.
+    Optionally provide schedule for self-healing (auto-registration on 404).
+
+    Args:
+        monitor_key: The monitor key identifying your job
+        schedule: Optional cron schedule for auto-registration if monitor doesn't exist
+
+    Returns:
+        None
+
+    Raises:
+        Never throws - all errors are suppressed to protect job execution
+    """
+    try:
+        api_key = os.environ.get('CRONRADAR_API_KEY', '')
+        if not api_key:
+            print(f"[CronRadar] Warning: CRONRADAR_API_KEY environment variable not set. Monitor '{monitor_key}' will not be tracked.", file=sys.stderr)
+            return
+
+        # Try to ping
+        status_code = _send_ping_internal(monitor_key, api_key)
+
+        # Self-healing: if monitor doesn't exist and schedule provided, create it
+        if status_code == 404 and schedule:
+            print(f"[CronRadar] Monitor '{monitor_key}' not found. Auto-registering with schedule '{schedule}'...", file=sys.stderr)
+
+            source = _detect_source()
+            sync_monitor(monitor_key, schedule, source=source)
+
+            # Retry ping
+            _send_ping_internal(monitor_key, api_key)
+    except Exception as e:
+        # Never throw - protect user's job execution
+        # Optionally log for debugging
+        print(f"[CronRadar] Error during ping: {e}", file=sys.stderr)
+
+
+def sync_monitor(
+    monitor_key: str,
+    schedule: str,
+    source: Optional[str] = None,
+    name: Optional[str] = None
+) -> None:
+    """
+    Register a monitor with CronRadar, setting up expectations for when it should run.
+    Used by extensions to sync discovered jobs.
+
+    Args:
+        monitor_key: The unique identifier for this monitor
+        schedule: Cron expression defining when the job runs
+        source: Source framework (e.g., "celery", "airflow"). Auto-detected if None.
+        name: Human-readable name. Generated from key if None.
+
+    Returns:
+        None
+
+    Raises:
+        Never throws - all errors are suppressed to protect job execution
+    """
+    try:
+        api_key = os.environ.get('CRONRADAR_API_KEY', '')
+        if not api_key:
+            print(f"[CronRadar] Warning: CRONRADAR_API_KEY environment variable not set. Monitor '{monitor_key}' will not be synced.", file=sys.stderr)
+            return
+
+        source = source or _detect_source()
+        name = name or _generate_readable_name(monitor_key)
+
+        sync_request = {
+            'source': source,
+            'monitors': [{
+                'key': monitor_key,
+                'name': name,
+                'schedule': schedule,
+                'gracePeriod': 60
+            }]
+        }
+
+        url = 'https://api.cronradar.com/api/sync'
+
+        # Prepare request
+        data = json.dumps(sync_request).encode('utf-8')
+        auth_string = f"{api_key}:".encode('utf-8')
+        auth_header = base64.b64encode(auth_string).decode('ascii')
+
+        request = Request(url, data=data, method='POST')
+        request.add_header('Content-Type', 'application/json')
+        request.add_header('Authorization', f'Basic {auth_header}')
+
+        # Send request with timeout
+        response = urlopen(request, timeout=5)
+
+        if 200 <= response.status < 300:
+            print(f"[CronRadar] Monitor '{monitor_key}' synced successfully.", file=sys.stderr)
+        else:
+            print(f"[CronRadar] Failed to sync monitor '{monitor_key}': HTTP {response.status}", file=sys.stderr)
+
+    except Exception as e:
+        print(f"[CronRadar] Error syncing monitor '{monitor_key}': {e}", file=sys.stderr)
+        # Never throw - protect user's job execution
+
+
+def _send_ping_internal(monitor_key: str, api_key: str) -> Optional[int]:
+    """Send ping internally and return status code."""
+    try:
+        from urllib.parse import quote
+        url = f"https://api.cronradar.com/ping/{quote(monitor_key, safe='')}"
+
+        # Prepare request
+        auth_string = f"{api_key}:".encode('utf-8')
+        auth_header = base64.b64encode(auth_string).decode('ascii')
+
+        request = Request(url, method='GET')
+        request.add_header('Authorization', f'Basic {auth_header}')
+
+        # Send request with timeout
+        response = urlopen(request, timeout=5)
+        return response.status
+
+    except HTTPError as e:
+        return e.code
+    except Exception:
+        return None
+
+
+def _detect_source() -> str:
+    """
+    Detect the calling source/framework based on stack trace and imported modules.
+
+    Returns:
+        Source identifier string
+    """
+    try:
+        # Check for Celery
+        if 'celery' in sys.modules:
+            return 'celery'
+
+        # Check for Airflow
+        if 'airflow' in sys.modules:
+            return 'airflow'
+
+        # Check for APScheduler
+        if 'apscheduler' in sys.modules:
+            return 'apscheduler'
+
+        # Check stack trace
+        stack = traceback.extract_stack()
+        for frame in stack:
+            filename = frame.filename.lower()
+            if 'celery' in filename:
+                return 'celery-direct'
+            if 'airflow' in filename:
+                return 'airflow-direct'
+            if 'django' in filename:
+                return 'django-direct'
+            if 'flask' in filename:
+                return 'flask-direct'
+
+    except Exception:
+        pass
+
+    return 'manual'
+
+
+def _generate_readable_name(monitor_key: str) -> str:
+    """
+    Generate a human-readable name from a monitor key.
+    Converts kebab-case or snake_case to Title Case.
+
+    Args:
+        monitor_key: The monitor key
+
+    Returns:
+        Human-readable name
+    """
+    if not monitor_key:
+        return monitor_key
+
+    # Handle kebab-case: "check-overdue-pings" -> "Check Overdue Pings"
+    if '-' in monitor_key:
+        return ' '.join(word.capitalize() for word in monitor_key.split('-'))
+
+    # Handle snake_case: "check_overdue_pings" -> "Check Overdue Pings"
+    if '_' in monitor_key:
+        return ' '.join(word.capitalize() for word in monitor_key.split('_'))
+
+    # Handle PascalCase: "CheckOverduePings" -> "Check Overdue Pings"
+    if monitor_key and monitor_key[0].isupper():
+        import re
+        # Insert space before capital letters
+        result = re.sub(r'(?<!^)([A-Z])', r' \1', monitor_key)
+        return result
+
+    # Default: just capitalize first letter
+    return monitor_key.capitalize()
+
+
+# Export public API
+__all__ = ['ping', 'sync_monitor', '__version__']

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

@@ -0,0 +1,76 @@
+Metadata-Version: 2.4
+Name: cronradar
+Version: 0.0.1
+Summary: Dead-simple cron job monitoring with auto-registration. Two functions: ping() and sync_monitor(). Self-healing monitors.
+Home-page: https://github.com/cronradar/cronradar-python
+Author: Administrator
+Author-email: contact@cronradar.com
+License: Proprietary
+Project-URL: Documentation, https://cronradar.com/docs
+Project-URL: Source, https://github.com/cronradar/cronradar-python
+Project-URL: Tracker, https://github.com/cronradar/cronradar-python/issues
+Keywords: cron monitoring scheduler job task ping sync auto-register
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: Other/Proprietary License
+Classifier: Operating System :: OS Independent
+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 :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Monitoring
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: requires-python
+Dynamic: summary
+
+# CronRadar Python SDK
+
+Monitor cron jobs with one function call.
+
+## Installation
+
+```bash
+pip install cronradar
+```
+
+## Usage
+
+```python
+import cronradar
+
+# After your cron job completes successfully
+cronradar.ping('daily-backup')
+
+# With self-healing (auto-register if monitor doesn't exist)
+cronradar.ping('daily-backup', schedule='0 2 * * *', grace_period=300)
+```
+
+## Configuration
+
+Set environment variable:
+- `CRONRADAR_API_KEY`: Your API key from cronradar.com
+- `CRONRADAR_BASE_URL`: Base URL override (optional, default: `https://cronradar.com`)
+- `CRONRADAR_METHOD`: HTTP method for ping (optional, default: `GET`)
+
+## Documentation
+
+See [cronradar.com/docs](https://cronradar.com/docs) for full documentation.
+
+## License
+
+MIT

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

@@ -0,0 +1,8 @@
+LICENSE
+README.md
+setup.py
+cronradar/__init__.py
+cronradar.egg-info/PKG-INFO
+cronradar.egg-info/SOURCES.txt
+cronradar.egg-info/dependency_links.txt
+cronradar.egg-info/top_level.txt

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1 @@
+cronradar

cronradar-0.0.1/setup.cfg

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

cronradar-0.0.1/setup.py

@@ -0,0 +1,38 @@
+from setuptools import setup, find_packages
+
+with open("README.md", "r", encoding="utf-8") as fh:
+    long_description = fh.read()
+
+setup(
+    name="cronradar",
+    version="0.0.1",
+    author="Administrator",
+    author_email="contact@cronradar.com",
+    description="Dead-simple cron job monitoring with auto-registration. Two functions: ping() and sync_monitor(). Self-healing monitors.",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    url="https://github.com/cronradar/cronradar-python",
+    project_urls={
+        "Documentation": "https://cronradar.com/docs",
+        "Source": "https://github.com/cronradar/cronradar-python",
+        "Tracker": "https://github.com/cronradar/cronradar-python/issues",
+    },
+    packages=find_packages(),
+    classifiers=[
+        "Development Status :: 5 - Production/Stable",
+        "Intended Audience :: Developers",
+        "License :: Other/Proprietary License",
+        "Operating System :: OS Independent",
+        "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 :: Software Development :: Libraries :: Python Modules",
+        "Topic :: System :: Monitoring",
+    ],
+    python_requires=">=3.8",
+    keywords="cron monitoring scheduler job task ping sync auto-register",
+    license="Proprietary",
+)