secploy 0.1.0__tar.gz

secploy-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 AGASTRONICS
+
+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.

secploy-0.1.0/MANIFEST.in

@@ -0,0 +1,2 @@
+include README.md
+include LICENSE

secploy-0.1.0/PKG-INFO

@@ -0,0 +1,204 @@
+Metadata-Version: 2.4
+Name: secploy
+Version: 0.1.0
+Summary: Python SDK for Secploy security monitoring and event tracking
+Author-email: Abdulsamad Abdulganiyu <agastronics@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2025 AGASTRONICS
+        
+        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.
+        
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.20.0
+Dynamic: license-file
+
+<p align="center">
+  <img src="https://secploy.vercel.app/logo.png" alt="Secploy Logo" width="180">
+</p>
+
+<h1 align="center">Secploy Python SDK</h1>
+
+<p align="center">
+  <em>Event tracking, heartbeat monitoring, and real-time status updates for your apps — powered by Secploy.</em>
+</p>
+
+---
+
+## 📌 Overview
+
+**Secploy** is a modern **security monitoring and observability platform** that helps you track **events, uptime, and live statuses** in real time.
+
+With the **Secploy Python SDK**, you can:
+- ✅ Send **events** from your Python applications or microservices.
+- 💓 Monitor uptime & availability using **heartbeats**.
+- 📊 Attach **environment** and **project metadata** automatically.
+- 📡 Receive **live project statuses** in your Secploy dashboard (`Running`, `Idle`, `Shutdown`).
+
+---
+
+## 🚀 Installation
+
+Install directly from **PyPI**:
+
+```bash
+pip install secploy
+````
+
+Or from source:
+
+```bash
+git clone https://github.com/your-org/secploy-python-sdk.git
+cd secploy-python-sdk
+pip install .
+```
+
+---
+
+## ⚡ Quick Start
+
+### 1️⃣ Initialize the Client
+
+```python
+from secploy import SecployClient
+
+client = SecployClient(
+    api_key="your_project_api_key",
+    environment="production"
+)
+```
+
+---
+
+### 2️⃣ Send Events
+
+```python
+client.track_event(
+    name="user_signup",
+    properties={
+        "user_id": 101,
+        "plan": "pro",
+        "referral": "campaign_2025"
+    }
+)
+```
+
+---
+
+### 3️⃣ Report an Incident
+
+```python
+incident = client.create_incident(
+    title="High Error Rate",
+    description="API error rate exceeded 5% in the EU region.",
+    severity="critical"
+)
+print("Incident ID:", incident.id)
+```
+
+---
+
+### 4️⃣ Monitor Heartbeats
+
+*(Ideal for background jobs, services, or scheduled tasks)*
+
+```python
+import time
+
+while True:
+    client.heartbeat()
+    time.sleep(60)  # every minute
+```
+
+---
+
+### 5️⃣ Listen for Live Status Updates
+
+*(Requires WebSocket + Django Channels backend)*
+
+```python
+for status in client.listen_status():
+    print(f"[STATUS UPDATE] Project is now {status}")
+```
+
+Possible statuses:
+
+* `running`
+* `idle`
+* `shutdown`
+
+---
+
+## 📌 Environments
+
+When you create a project in Secploy, multiple environments are automatically created:
+
+| Environment   | Purpose                |
+| ------------- | ---------------------- |
+| `production`  | Live, customer-facing  |
+| `staging`     | Pre-production testing |
+| `development` | Local development      |
+
+Each environment has its own **API key** — use the matching key for the environment you’re sending data from.
+
+---
+
+## 📡 SDK Methods
+
+| Method                                          | Description                    |
+| ----------------------------------------------- | ------------------------------ |
+| `track_event(name, properties)`                 | Send a structured event        |
+| `create_incident(title, description, severity)` | Create a new incident          |
+| `heartbeat()`                                   | Send a heartbeat signal        |
+| `listen_status()`                               | Stream live project status     |
+| `set_environment(env_code)`                     | Switch environment dynamically |
+
+---
+
+## 🛡 Requirements
+
+* Python **3.8+**
+* `requests`
+* `websocket-client`
+
+---
+
+## 🤝 Contributing
+
+1. Fork the repo
+2. Create your feature branch:
+
+   ```bash
+   git checkout -b feature/my-feature
+   ```
+3. Commit your changes:
+
+   ```bash
+   git commit -m "Add my feature"
+   ```
+4. Push to the branch and open a Pull Request
+
+---
+
+## 📄 License
+
+MIT License — See [LICENSE](LICENSE) for details.
+

secploy-0.1.0/README.md

@@ -0,0 +1,171 @@
+<p align="center">
+  <img src="https://secploy.vercel.app/logo.png" alt="Secploy Logo" width="180">
+</p>
+
+<h1 align="center">Secploy Python SDK</h1>
+
+<p align="center">
+  <em>Event tracking, heartbeat monitoring, and real-time status updates for your apps — powered by Secploy.</em>
+</p>
+
+---
+
+## 📌 Overview
+
+**Secploy** is a modern **security monitoring and observability platform** that helps you track **events, uptime, and live statuses** in real time.
+
+With the **Secploy Python SDK**, you can:
+- ✅ Send **events** from your Python applications or microservices.
+- 💓 Monitor uptime & availability using **heartbeats**.
+- 📊 Attach **environment** and **project metadata** automatically.
+- 📡 Receive **live project statuses** in your Secploy dashboard (`Running`, `Idle`, `Shutdown`).
+
+---
+
+## 🚀 Installation
+
+Install directly from **PyPI**:
+
+```bash
+pip install secploy
+````
+
+Or from source:
+
+```bash
+git clone https://github.com/your-org/secploy-python-sdk.git
+cd secploy-python-sdk
+pip install .
+```
+
+---
+
+## ⚡ Quick Start
+
+### 1️⃣ Initialize the Client
+
+```python
+from secploy import SecployClient
+
+client = SecployClient(
+    api_key="your_project_api_key",
+    environment="production"
+)
+```
+
+---
+
+### 2️⃣ Send Events
+
+```python
+client.track_event(
+    name="user_signup",
+    properties={
+        "user_id": 101,
+        "plan": "pro",
+        "referral": "campaign_2025"
+    }
+)
+```
+
+---
+
+### 3️⃣ Report an Incident
+
+```python
+incident = client.create_incident(
+    title="High Error Rate",
+    description="API error rate exceeded 5% in the EU region.",
+    severity="critical"
+)
+print("Incident ID:", incident.id)
+```
+
+---
+
+### 4️⃣ Monitor Heartbeats
+
+*(Ideal for background jobs, services, or scheduled tasks)*
+
+```python
+import time
+
+while True:
+    client.heartbeat()
+    time.sleep(60)  # every minute
+```
+
+---
+
+### 5️⃣ Listen for Live Status Updates
+
+*(Requires WebSocket + Django Channels backend)*
+
+```python
+for status in client.listen_status():
+    print(f"[STATUS UPDATE] Project is now {status}")
+```
+
+Possible statuses:
+
+* `running`
+* `idle`
+* `shutdown`
+
+---
+
+## 📌 Environments
+
+When you create a project in Secploy, multiple environments are automatically created:
+
+| Environment   | Purpose                |
+| ------------- | ---------------------- |
+| `production`  | Live, customer-facing  |
+| `staging`     | Pre-production testing |
+| `development` | Local development      |
+
+Each environment has its own **API key** — use the matching key for the environment you’re sending data from.
+
+---
+
+## 📡 SDK Methods
+
+| Method                                          | Description                    |
+| ----------------------------------------------- | ------------------------------ |
+| `track_event(name, properties)`                 | Send a structured event        |
+| `create_incident(title, description, severity)` | Create a new incident          |
+| `heartbeat()`                                   | Send a heartbeat signal        |
+| `listen_status()`                               | Stream live project status     |
+| `set_environment(env_code)`                     | Switch environment dynamically |
+
+---
+
+## 🛡 Requirements
+
+* Python **3.8+**
+* `requests`
+* `websocket-client`
+
+---
+
+## 🤝 Contributing
+
+1. Fork the repo
+2. Create your feature branch:
+
+   ```bash
+   git checkout -b feature/my-feature
+   ```
+3. Commit your changes:
+
+   ```bash
+   git commit -m "Add my feature"
+   ```
+4. Push to the branch and open a Pull Request
+
+---
+
+## 📄 License
+
+MIT License — See [LICENSE](LICENSE) for details.
+

secploy-0.1.0/pyproject.toml

@@ -0,0 +1,19 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "secploy"
+version = "0.1.0"
+description = "Python SDK for Secploy security monitoring and event tracking"
+authors = [
+  { name="Abdulsamad Abdulganiyu", email="agastronics@gmail.com" }
+]
+readme = "README.md"
+license = {file="LICENSE"}
+requires-python = ">=3.7"
+dependencies = ["requests>=2.20.0"]
+
+[tool.setuptools]
+packages = ["secploy"]
+package-dir = {"" = "."}

secploy-0.1.0/secploy/__init__.py

@@ -0,0 +1,5 @@
+from .client import SecployClient
+
+__version__ = "0.1.0"
+__all__ = ["SecployClient"]
+

secploy-0.1.0/secploy/client.py

@@ -0,0 +1,60 @@
+import threading
+import time
+import requests
+
+from lib.secploy_logger import setup_logger
+from .utils import log
+
+class SecployClient:
+    def __init__(self, api_key, ingest_url, heartbeat_interval=30, max_retry=3, debug=False, log_level='INFO'):
+        self.api_key = api_key
+        self.ingest_url = ingest_url.rstrip("/")
+        self.heartbeat_interval = heartbeat_interval
+        self.max_retry = max_retry
+        self.debug = debug
+        self.log_level = log_level
+        self._stop_event = threading.Event()
+        self._thread = None
+        setup_logger(log_level=log_level)
+    
+    def _headers(self):
+        return {
+            "Authorization": f"Bearer {self.api_key}",
+            "Content-Type": "application/json"
+        }
+
+    def send_event(self, event_type, payload):
+        url = f"{self.ingest_url}/events"
+        data = {"type": event_type, "payload": payload}
+        for attempt in range(self.max_retry):
+            try:
+                resp = requests.post(url, json=data, headers=self._headers(), timeout=5)
+                if resp.status_code == 200:
+                    log("Event sent successfully", self.debug)
+                    return True
+            except Exception as e:
+                log(f"Send event failed: {e}", self.debug)
+            time.sleep(1)
+        return False
+
+    def _heartbeat_loop(self):
+        url = f"{self.ingest_url}/heartbeat"
+        while not self._stop_event.is_set():
+            try:
+                resp = requests.post(url, headers=self._headers(), timeout=5)
+                log(f"Heartbeat sent: {resp.status_code}", self.debug)
+            except Exception as e:
+                log(f"Heartbeat failed: {e}", self.debug)
+            time.sleep(self.heartbeat_interval)
+
+    def start(self):
+        log("Starting heartbeat...", self.debug)
+        self._stop_event.clear()
+        self._thread = threading.Thread(target=self._heartbeat_loop, daemon=True)
+        self._thread.start()
+
+    def stop(self):
+        log("Stopping heartbeat...", self.debug)
+        self._stop_event.set()
+        if self._thread:
+            self._thread.join()

secploy-0.1.0/secploy/config.py

@@ -0,0 +1,5 @@
+class SDKConfig:
+    def __init__(self, api_key, ingest_url):
+        self.api_key = api_key
+        self.ingest_url = ingest_url.rstrip("/")
+

secploy-0.1.0/secploy/events.py

@@ -0,0 +1,33 @@
+import queue
+import threading
+import requests
+import time
+
+class EventQueue(threading.Thread):
+    def __init__(self, config):
+        super().__init__(daemon=True)
+        self.config = config
+        self.events = queue.Queue()
+        self._stop_event = threading.Event()
+
+    def add_event(self, event_type, payload):
+        self.events.put({"type": event_type, "payload": payload})
+
+    def run(self):
+        while not self._stop_event.is_set():
+            try:
+                event = self.events.get(timeout=1)
+                requests.post(
+                    f"{self.config.ingest_url}/event",
+                    json={"api_key": self.config.api_key, **event},
+                    timeout=5
+                )
+            except queue.Empty:
+                continue
+            except Exception as e:
+                print(f"[Secploy] Event send error: {e}")
+                time.sleep(2)
+
+    def stop(self):
+        self._stop_event.set()
+

secploy-0.1.0/secploy/heartbeat.py

@@ -0,0 +1,25 @@
+import requests
+import threading
+import time
+
+class HeartbeatThread(threading.Thread):
+    def __init__(self, config, interval=30):
+        super().__init__(daemon=True)
+        self.config = config
+        self.interval = interval
+        self._stop_event = threading.Event()
+
+    def run(self):
+        while not self._stop_event.is_set():
+            try:
+                requests.post(
+                    f"{self.config.ingest_url}/heartbeat",
+                    json={"api_key": self.config.api_key, "status": "running"},
+                    timeout=5
+                )
+            except Exception as e:
+                print(f"[Secploy] Heartbeat error: {e}")
+            time.sleep(self.interval)
+
+    def stop(self):
+        self._stop_event.set()

secploy-0.1.0/secploy/utils.py

@@ -0,0 +1,5 @@
+
+def log(message, debug):
+    if debug:
+        print(f"[Secploy] {message}")
+

secploy-0.1.0/secploy.egg-info/PKG-INFO

@@ -0,0 +1,204 @@
+Metadata-Version: 2.4
+Name: secploy
+Version: 0.1.0
+Summary: Python SDK for Secploy security monitoring and event tracking
+Author-email: Abdulsamad Abdulganiyu <agastronics@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2025 AGASTRONICS
+        
+        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.
+        
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.20.0
+Dynamic: license-file
+
+<p align="center">
+  <img src="https://secploy.vercel.app/logo.png" alt="Secploy Logo" width="180">
+</p>
+
+<h1 align="center">Secploy Python SDK</h1>
+
+<p align="center">
+  <em>Event tracking, heartbeat monitoring, and real-time status updates for your apps — powered by Secploy.</em>
+</p>
+
+---
+
+## 📌 Overview
+
+**Secploy** is a modern **security monitoring and observability platform** that helps you track **events, uptime, and live statuses** in real time.
+
+With the **Secploy Python SDK**, you can:
+- ✅ Send **events** from your Python applications or microservices.
+- 💓 Monitor uptime & availability using **heartbeats**.
+- 📊 Attach **environment** and **project metadata** automatically.
+- 📡 Receive **live project statuses** in your Secploy dashboard (`Running`, `Idle`, `Shutdown`).
+
+---
+
+## 🚀 Installation
+
+Install directly from **PyPI**:
+
+```bash
+pip install secploy
+````
+
+Or from source:
+
+```bash
+git clone https://github.com/your-org/secploy-python-sdk.git
+cd secploy-python-sdk
+pip install .
+```
+
+---
+
+## ⚡ Quick Start
+
+### 1️⃣ Initialize the Client
+
+```python
+from secploy import SecployClient
+
+client = SecployClient(
+    api_key="your_project_api_key",
+    environment="production"
+)
+```
+
+---
+
+### 2️⃣ Send Events
+
+```python
+client.track_event(
+    name="user_signup",
+    properties={
+        "user_id": 101,
+        "plan": "pro",
+        "referral": "campaign_2025"
+    }
+)
+```
+
+---
+
+### 3️⃣ Report an Incident
+
+```python
+incident = client.create_incident(
+    title="High Error Rate",
+    description="API error rate exceeded 5% in the EU region.",
+    severity="critical"
+)
+print("Incident ID:", incident.id)
+```
+
+---
+
+### 4️⃣ Monitor Heartbeats
+
+*(Ideal for background jobs, services, or scheduled tasks)*
+
+```python
+import time
+
+while True:
+    client.heartbeat()
+    time.sleep(60)  # every minute
+```
+
+---
+
+### 5️⃣ Listen for Live Status Updates
+
+*(Requires WebSocket + Django Channels backend)*
+
+```python
+for status in client.listen_status():
+    print(f"[STATUS UPDATE] Project is now {status}")
+```
+
+Possible statuses:
+
+* `running`
+* `idle`
+* `shutdown`
+
+---
+
+## 📌 Environments
+
+When you create a project in Secploy, multiple environments are automatically created:
+
+| Environment   | Purpose                |
+| ------------- | ---------------------- |
+| `production`  | Live, customer-facing  |
+| `staging`     | Pre-production testing |
+| `development` | Local development      |
+
+Each environment has its own **API key** — use the matching key for the environment you’re sending data from.
+
+---
+
+## 📡 SDK Methods
+
+| Method                                          | Description                    |
+| ----------------------------------------------- | ------------------------------ |
+| `track_event(name, properties)`                 | Send a structured event        |
+| `create_incident(title, description, severity)` | Create a new incident          |
+| `heartbeat()`                                   | Send a heartbeat signal        |
+| `listen_status()`                               | Stream live project status     |
+| `set_environment(env_code)`                     | Switch environment dynamically |
+
+---
+
+## 🛡 Requirements
+
+* Python **3.8+**
+* `requests`
+* `websocket-client`
+
+---
+
+## 🤝 Contributing
+
+1. Fork the repo
+2. Create your feature branch:
+
+   ```bash
+   git checkout -b feature/my-feature
+   ```
+3. Commit your changes:
+
+   ```bash
+   git commit -m "Add my feature"
+   ```
+4. Push to the branch and open a Pull Request
+
+---
+
+## 📄 License
+
+MIT License — See [LICENSE](LICENSE) for details.
+

secploy-0.1.0/secploy.egg-info/SOURCES.txt

@@ -0,0 +1,24 @@
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+setup.cfg
+./secploy/__init__.py
+./secploy/client.py
+./secploy/config.py
+./secploy/events.py
+./secploy/exceptions.py
+./secploy/heartbeat.py
+./secploy/utils.py
+secploy/__init__.py
+secploy/client.py
+secploy/config.py
+secploy/events.py
+secploy/exceptions.py
+secploy/heartbeat.py
+secploy/utils.py
+secploy.egg-info/PKG-INFO
+secploy.egg-info/SOURCES.txt
+secploy.egg-info/dependency_links.txt
+secploy.egg-info/requires.txt
+secploy.egg-info/top_level.txt

secploy-0.1.0/secploy.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

secploy-0.1.0/secploy.egg-info/requires.txt

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

secploy-0.1.0/secploy.egg-info/top_level.txt

@@ -0,0 +1 @@
+secploy

secploy-0.1.0/setup.cfg

@@ -0,0 +1,11 @@
+[metadata]
+license_file = LICENSE
+
+[options]
+packages = find:
+include_package_data = True
+
+[egg_info]
+tag_build = 
+tag_date = 0
+