roast-api 1.4.0__tar.gz

roast_api-1.4.0/PKG-INFO

@@ -0,0 +1,243 @@
+Metadata-Version: 2.4
+Name: roast-api
+Version: 1.4.0
+Summary: A Python client for RaaS — Roast as a Service. CDN-served static JSON API for developer roasts.
+Author-email: Maizied <mdshuvo40@gmail.com>
+License: MIT
+Project-URL: Homepage, https://maijied.github.io/roast-as-a-service/
+Project-URL: Repository, https://github.com/Maijied/roast-as-a-service
+Keywords: roast,api,developer,humor,fun,cdn
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.20.0
+
+# 🥵 Roast as a Service (RaaS)
+
+<p align="center">
+  <img src="https://maijied.github.io/roast-as-a-service/assets/logo.png" width="128" alt="RaaS Logo" />
+</p>
+<p align="center">
+  <img src="https://hits.sh/maijied.github.io/roast-as-a-service.svg?view=today-total&style=flat-square&label=visitors&color=ec4899&labelColor=020617" alt="Visitor Count" />
+  <a href="https://www.npmjs.com/package/roast-api"><img src="https://img.shields.io/npm/v/roast-api?style=flat-square&color=f97316&labelColor=020617" alt="npm version" /></a>
+  <a href="https://www.npmjs.com/package/roast-api"><img src="https://img.shields.io/npm/dm/roast-api?style=flat-square&color=ec4899&labelColor=020617" alt="npm downloads" /></a>
+  <a href="https://pypi.org/project/roast-api/"><img src="https://img.shields.io/pypi/v/roast-api?style=flat-square&color=3b82f6&labelColor=020617" alt="PyPI version" /></a>
+  <a href="https://packagist.org/packages/maizied/roast-api"><img src="https://img.shields.io/packagist/v/maizied/roast-api?style=flat-square&color=10b981&labelColor=020617" alt="Packagist version" /></a>
+  <a href="https://github.com/Maijied/roast-as-a-service/actions/workflows/deploy.yml"><img src="https://github.com/Maijied/roast-as-a-service/actions/workflows/deploy.yml/badge.svg" alt="Deploy to GitHub Pages" /></a>
+</p>
+
+Random developer roasts, delivered via a blazing‑fast static API on GitHub Pages. Plug it into your apps, bots, terminals, or CI logs when “nice error messages” just aren’t enough.
+
+> **Part of the [Lorapok Ecosystem](https://github.com/Maijied/lorapok)** — Building the future of AI-driven developer tools. 🐛
+
+---
+
+## 🚀 What is RaaS?
+
+Roast as a Service is a GitHub‑hosted, CDN‑backed JSON API that returns developer‑themed roasts in English and Bangla.  
+It’s completely static (no servers), but feels dynamic thanks to a smart client SDK that shards, caches, and randomly selects roasts on the fly.
+
+Use it when you want your:
+
+- CLI tools to roast the user on failure.  
+- CI pipeline to roast you when tests fail.  
+- Discord/Slack bots to respond with spicy dev insults.  
+- Portfolio or landing page to show random roasts on each visit.
+
+---
+
+## 🌐 Live Service
+
+- **Website:** https://maijied.github.io/roast-as-a-service/
+- **API Base Path:** https://maijied.github.io/roast-as-a-service/api/
+
+---
+
+## ⚡ Quick Start
+
+### 1. Install via npm
+```bash
+npm install roast-api
+# or
+npm install @maizied/roast-as-a-service
+```
+
+```javascript
+const RaaS = require('roast-api');
+
+RaaS.getRandomRoast({ lang: 'en' })
+  .then(r => console.log(r.text));
+```
+
+### 2. Script Include (Browser)
+Load the client SDK directly in your browser:
+
+```html
+<script src="https://maijied.github.io/roast-as-a-service/api/client.js"></script>
+
+<script>
+  // Fetch a random Bangla roast with intensity 2
+  RaaS.getRandomRoast({ lang: 'bn', intensity: 2 })
+    .then(r => console.log(r.text));
+</script>
+```
+
+### 3. Install via Composer (PHP)
+```bash
+composer require maizied/roast-api
+```
+
+```php
+use Maizied\RoastApi\RaaS;
+
+$roast = RaaS::getRandomRoast(['lang' => 'en']);
+echo $roast['text'];
+```
+
+### 4. Install via pip (Python)
+```bash
+pip install roast-api
+```
+
+```python
+from roast_api import get_random_roast
+
+roast = get_random_roast(lang='en')
+print(roast['text'])
+```
+
+### 5. Direct Fetch
+Or just fetch the JSON files directly:
+
+```javascript
+fetch('https://maijied.github.io/roast-as-a-service/api/en/roasts-en-1.json')
+  .then(res => res.json())
+  .then(data => {
+    const list = data.roasts;
+    const pick = list[Math.floor(Math.random() * list.length)];
+    console.log(pick.text);
+  });
+```
+
+---
+
+## 🛠 How it works
+
+RaaS exposes sharded JSON datasets over GitHub Pages, then a tiny client SDK picks, filters, and caches roasts in the browser, giving you an API‑like experience with pure static hosting.
+
+- **Static API**: Roasts are stored in language‑specific shards (`en`, `bn`) and served as JSON over GitHub Pages’ global CDN for low TTFB.
+- **Smart client**: The bundled client fetches a small shard, caches it, and returns random roasts with optional intensity and length filters.
+- **Zero ops**: No servers, no cold starts, no scaling issues. Push to main, let Pages deploy and cache everything at the edge.
+
+---
+
+## 📦 API Overview
+
+This is a **static** API: data comes from versioned JSON files served over CDN, and a lightweight JS client handles randomness, filtering and caching in the browser.
+
+### Endpoints (static JSON)
+
+- **Manifest:**  
+  `GET https://maijied.github.io/roast-as-a-service/api/manifest.json`
+
+- **English Shard #1:**  
+  `GET https://maijied.github.io/roast-as-a-service/api/en/roasts-en-1.json`
+
+- **Bangla Shard #1:**  
+  `GET https://maijied.github.io/roast-as-a-service/api/bn/roasts-bn-1.json`
+
+### Example Response Structure
+Each shard looks like:
+
+```json
+{
+  "language": "en",
+  "shard": 1,
+  "total_shards": 5,
+  "count": 300,
+  "tags": ["dev", "general"],
+  "roasts": [
+    {
+      "id": "en-1-1",
+      "text": "Your codebase looks like it was written during a live outage.",
+      "intensity": 2,
+      "length": 61
+    }
+  ]
+}
+```
+
+### Usage Example (curl + jq)
+```bash
+curl -s https://maijied.github.io/roast-as-a-service/api/en/roasts-en-1.json \
+  | jq '.roasts[0].text'
+```
+
+---
+
+## 🧬 Why this architecture is “state of the art”
+
+Roast as a Service is intentionally built as a **static API** on top of GitHub Pages and a CDN, instead of a traditional backend. For this use case (serving pre‑made content), this gives you the same “API experience” with less cost, less complexity, and better global latency.
+
+Key points:
+
+- **Static JSON over CDN**  
+  All responses are just versioned JSON files served by GitHub Pages’ global edge network, which is highly cache‑friendly and extremely fast for read‑heavy traffic.
+
+- **Zero backend, zero cold starts**  
+  There is no application server to boot, scale, or warm up. Every request hits static content that can be served from edge cache with minimal TTFB.
+
+- **Sharded data layout**  
+  Roasts are split into language‑specific shards (e.g. `en/roasts-en-1.json`) so each response stays small and cacheable even if the total dataset becomes large.
+
+- **Client‑side selection and filtering**  
+  A tiny SDK handles randomness, intensity filters, and length limits in the client, so the “API” stays read‑only and ultra fast instead of computing on every request.
+
+- **Edge‑friendly cache behavior**  
+  Because the content is static and not personalized, CDN nodes can cache responses aggressively without worrying about user‑specific data. That’s exactly what CDNs are optimized for.
+
+- **Version‑controlled API**  
+  All JSON lives in Git; you can roll back, branch, and review changes like any other codebase while GitHub Pages redeploys and re‑caches automatically.
+
+This combination (static JSON + sharding + client‑side logic + CDN caching) is effectively the “fast path” that many dynamic APIs end up approximating with layers of caching—here it’s the default.
+
+## ⚡ Performance & Benchmarks
+
+RaaS is built for extreme speed and low overhead. By sharding data and relying on CDN edge caching + local browser caching, it achieves massive throughput.
+
+**Latest Benchmark Results:**
+- **Requests/sec**: ~2,000 (Tested with 5,000 total requests)
+- **Success Rate**: 100% (Zero failures under high concurrency)
+- **Avg Latency**: ~58ms
+- **P95 Latency**: ~159ms
+- **Cache Efficiency**: 90%+ (Manifest and shard reuse)
+
+> [!TIP]
+> This "Static API" approach beats the latency of traditional dynamic APIs by removing backend processing, cold starts, and database queries from the request path.
+
+---
+
+## 🐛 More from Lorapok
+
+RaaS is a proud member of the **Lorapok** family. Check out our other tools:
+
+- **[Lorapok CLI](https://github.com/Maijied/lorapok):** The intelligent AI agent framework for developers.
+- **[Lorapok Media Player](https://github.com/Maijied/Lorapok_Media_Player):** A modern, feature-rich media player built for power users.
+
+---
+
+## 👤 Author
+
+**Maizied**  
+📧 [mdshuvo40@gmail.com](mailto:mdshuvo40@gmail.com)  
+🔗 [GitHub](https://github.com/Maijied) · [npm](https://www.npmjs.com/~maizied)
+
+---
+
+## 📄 License
+
+MIT © Maizied

roast_api-1.4.0/README.md

@@ -0,0 +1,225 @@
+# 🥵 Roast as a Service (RaaS)
+
+<p align="center">
+  <img src="https://maijied.github.io/roast-as-a-service/assets/logo.png" width="128" alt="RaaS Logo" />
+</p>
+<p align="center">
+  <img src="https://hits.sh/maijied.github.io/roast-as-a-service.svg?view=today-total&style=flat-square&label=visitors&color=ec4899&labelColor=020617" alt="Visitor Count" />
+  <a href="https://www.npmjs.com/package/roast-api"><img src="https://img.shields.io/npm/v/roast-api?style=flat-square&color=f97316&labelColor=020617" alt="npm version" /></a>
+  <a href="https://www.npmjs.com/package/roast-api"><img src="https://img.shields.io/npm/dm/roast-api?style=flat-square&color=ec4899&labelColor=020617" alt="npm downloads" /></a>
+  <a href="https://pypi.org/project/roast-api/"><img src="https://img.shields.io/pypi/v/roast-api?style=flat-square&color=3b82f6&labelColor=020617" alt="PyPI version" /></a>
+  <a href="https://packagist.org/packages/maizied/roast-api"><img src="https://img.shields.io/packagist/v/maizied/roast-api?style=flat-square&color=10b981&labelColor=020617" alt="Packagist version" /></a>
+  <a href="https://github.com/Maijied/roast-as-a-service/actions/workflows/deploy.yml"><img src="https://github.com/Maijied/roast-as-a-service/actions/workflows/deploy.yml/badge.svg" alt="Deploy to GitHub Pages" /></a>
+</p>
+
+Random developer roasts, delivered via a blazing‑fast static API on GitHub Pages. Plug it into your apps, bots, terminals, or CI logs when “nice error messages” just aren’t enough.
+
+> **Part of the [Lorapok Ecosystem](https://github.com/Maijied/lorapok)** — Building the future of AI-driven developer tools. 🐛
+
+---
+
+## 🚀 What is RaaS?
+
+Roast as a Service is a GitHub‑hosted, CDN‑backed JSON API that returns developer‑themed roasts in English and Bangla.  
+It’s completely static (no servers), but feels dynamic thanks to a smart client SDK that shards, caches, and randomly selects roasts on the fly.
+
+Use it when you want your:
+
+- CLI tools to roast the user on failure.  
+- CI pipeline to roast you when tests fail.  
+- Discord/Slack bots to respond with spicy dev insults.  
+- Portfolio or landing page to show random roasts on each visit.
+
+---
+
+## 🌐 Live Service
+
+- **Website:** https://maijied.github.io/roast-as-a-service/
+- **API Base Path:** https://maijied.github.io/roast-as-a-service/api/
+
+---
+
+## ⚡ Quick Start
+
+### 1. Install via npm
+```bash
+npm install roast-api
+# or
+npm install @maizied/roast-as-a-service
+```
+
+```javascript
+const RaaS = require('roast-api');
+
+RaaS.getRandomRoast({ lang: 'en' })
+  .then(r => console.log(r.text));
+```
+
+### 2. Script Include (Browser)
+Load the client SDK directly in your browser:
+
+```html
+<script src="https://maijied.github.io/roast-as-a-service/api/client.js"></script>
+
+<script>
+  // Fetch a random Bangla roast with intensity 2
+  RaaS.getRandomRoast({ lang: 'bn', intensity: 2 })
+    .then(r => console.log(r.text));
+</script>
+```
+
+### 3. Install via Composer (PHP)
+```bash
+composer require maizied/roast-api
+```
+
+```php
+use Maizied\RoastApi\RaaS;
+
+$roast = RaaS::getRandomRoast(['lang' => 'en']);
+echo $roast['text'];
+```
+
+### 4. Install via pip (Python)
+```bash
+pip install roast-api
+```
+
+```python
+from roast_api import get_random_roast
+
+roast = get_random_roast(lang='en')
+print(roast['text'])
+```
+
+### 5. Direct Fetch
+Or just fetch the JSON files directly:
+
+```javascript
+fetch('https://maijied.github.io/roast-as-a-service/api/en/roasts-en-1.json')
+  .then(res => res.json())
+  .then(data => {
+    const list = data.roasts;
+    const pick = list[Math.floor(Math.random() * list.length)];
+    console.log(pick.text);
+  });
+```
+
+---
+
+## 🛠 How it works
+
+RaaS exposes sharded JSON datasets over GitHub Pages, then a tiny client SDK picks, filters, and caches roasts in the browser, giving you an API‑like experience with pure static hosting.
+
+- **Static API**: Roasts are stored in language‑specific shards (`en`, `bn`) and served as JSON over GitHub Pages’ global CDN for low TTFB.
+- **Smart client**: The bundled client fetches a small shard, caches it, and returns random roasts with optional intensity and length filters.
+- **Zero ops**: No servers, no cold starts, no scaling issues. Push to main, let Pages deploy and cache everything at the edge.
+
+---
+
+## 📦 API Overview
+
+This is a **static** API: data comes from versioned JSON files served over CDN, and a lightweight JS client handles randomness, filtering and caching in the browser.
+
+### Endpoints (static JSON)
+
+- **Manifest:**  
+  `GET https://maijied.github.io/roast-as-a-service/api/manifest.json`
+
+- **English Shard #1:**  
+  `GET https://maijied.github.io/roast-as-a-service/api/en/roasts-en-1.json`
+
+- **Bangla Shard #1:**  
+  `GET https://maijied.github.io/roast-as-a-service/api/bn/roasts-bn-1.json`
+
+### Example Response Structure
+Each shard looks like:
+
+```json
+{
+  "language": "en",
+  "shard": 1,
+  "total_shards": 5,
+  "count": 300,
+  "tags": ["dev", "general"],
+  "roasts": [
+    {
+      "id": "en-1-1",
+      "text": "Your codebase looks like it was written during a live outage.",
+      "intensity": 2,
+      "length": 61
+    }
+  ]
+}
+```
+
+### Usage Example (curl + jq)
+```bash
+curl -s https://maijied.github.io/roast-as-a-service/api/en/roasts-en-1.json \
+  | jq '.roasts[0].text'
+```
+
+---
+
+## 🧬 Why this architecture is “state of the art”
+
+Roast as a Service is intentionally built as a **static API** on top of GitHub Pages and a CDN, instead of a traditional backend. For this use case (serving pre‑made content), this gives you the same “API experience” with less cost, less complexity, and better global latency.
+
+Key points:
+
+- **Static JSON over CDN**  
+  All responses are just versioned JSON files served by GitHub Pages’ global edge network, which is highly cache‑friendly and extremely fast for read‑heavy traffic.
+
+- **Zero backend, zero cold starts**  
+  There is no application server to boot, scale, or warm up. Every request hits static content that can be served from edge cache with minimal TTFB.
+
+- **Sharded data layout**  
+  Roasts are split into language‑specific shards (e.g. `en/roasts-en-1.json`) so each response stays small and cacheable even if the total dataset becomes large.
+
+- **Client‑side selection and filtering**  
+  A tiny SDK handles randomness, intensity filters, and length limits in the client, so the “API” stays read‑only and ultra fast instead of computing on every request.
+
+- **Edge‑friendly cache behavior**  
+  Because the content is static and not personalized, CDN nodes can cache responses aggressively without worrying about user‑specific data. That’s exactly what CDNs are optimized for.
+
+- **Version‑controlled API**  
+  All JSON lives in Git; you can roll back, branch, and review changes like any other codebase while GitHub Pages redeploys and re‑caches automatically.
+
+This combination (static JSON + sharding + client‑side logic + CDN caching) is effectively the “fast path” that many dynamic APIs end up approximating with layers of caching—here it’s the default.
+
+## ⚡ Performance & Benchmarks
+
+RaaS is built for extreme speed and low overhead. By sharding data and relying on CDN edge caching + local browser caching, it achieves massive throughput.
+
+**Latest Benchmark Results:**
+- **Requests/sec**: ~2,000 (Tested with 5,000 total requests)
+- **Success Rate**: 100% (Zero failures under high concurrency)
+- **Avg Latency**: ~58ms
+- **P95 Latency**: ~159ms
+- **Cache Efficiency**: 90%+ (Manifest and shard reuse)
+
+> [!TIP]
+> This "Static API" approach beats the latency of traditional dynamic APIs by removing backend processing, cold starts, and database queries from the request path.
+
+---
+
+## 🐛 More from Lorapok
+
+RaaS is a proud member of the **Lorapok** family. Check out our other tools:
+
+- **[Lorapok CLI](https://github.com/Maijied/lorapok):** The intelligent AI agent framework for developers.
+- **[Lorapok Media Player](https://github.com/Maijied/Lorapok_Media_Player):** A modern, feature-rich media player built for power users.
+
+---
+
+## 👤 Author
+
+**Maizied**  
+📧 [mdshuvo40@gmail.com](mailto:mdshuvo40@gmail.com)  
+🔗 [GitHub](https://github.com/Maijied) · [npm](https://www.npmjs.com/~maizied)
+
+---
+
+## 📄 License
+
+MIT © Maizied

roast_api-1.4.0/pyproject.toml

@@ -0,0 +1,32 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "roast-api"
+version = "1.4.0"
+description = "A Python client for RaaS — Roast as a Service. CDN-served static JSON API for developer roasts."
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.7"
+authors = [
+    {name = "Maizied", email = "mdshuvo40@gmail.com"}
+]
+keywords = ["roast", "api", "developer", "humor", "fun", "cdn"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "requests>=2.20.0",
+]
+
+[project.urls]
+Homepage = "https://maijied.github.io/roast-as-a-service/"
+Repository = "https://github.com/Maijied/roast-as-a-service"
+
+[tool.setuptools.packages.find]
+include = ["roast_api*"]

roast_api-1.4.0/roast_api/__init__.py

@@ -0,0 +1,29 @@
+"""
+RaaS — Roast as a Service Python Client
+
+A lightweight Python client for fetching developer roasts from the
+RaaS static JSON API hosted on GitHub Pages.
+
+Usage:
+    from roast_api import get_random_roast, get_all_roasts
+
+    roast = get_random_roast(lang='en')
+    print(roast['text'])
+"""
+
+from roast_api.client import (
+    get_random_roast,
+    get_all_roasts,
+    get_manifest,
+    get_shard,
+    clear_cache,
+)
+
+__version__ = "1.4.0"
+__all__ = [
+    "get_random_roast",
+    "get_all_roasts",
+    "get_manifest",
+    "get_shard",
+    "clear_cache",
+]

roast_api-1.4.0/roast_api/client.py

@@ -0,0 +1,89 @@
+"""
+RaaS Python Client — core logic.
+
+Fetches roasts from the static JSON API on GitHub Pages,
+with in-memory caching and optional filtering.
+"""
+
+import random
+from typing import Any, Dict, List, Optional
+
+import requests
+
+BASE_URL = "https://maijied.github.io/roast-as-a-service/api"
+
+# In-memory caches
+_manifest_cache: Optional[Dict[str, Any]] = None
+_shard_cache: Dict[str, Dict[str, Any]] = {}
+
+
+def get_manifest() -> Dict[str, Any]:
+    """Fetch and cache the API manifest."""
+    global _manifest_cache
+    if _manifest_cache is not None:
+        return _manifest_cache
+
+    url = f"{BASE_URL}/manifest.json"
+    resp = requests.get(url, timeout=10)
+    resp.raise_for_status()
+    _manifest_cache = resp.json()
+    return _manifest_cache
+
+
+def get_shard(lang: str = "en", shard: int = 1) -> Dict[str, Any]:
+    """Fetch and cache a specific language shard."""
+    key = f"{lang}-{shard}"
+    if key in _shard_cache:
+        return _shard_cache[key]
+
+    url = f"{BASE_URL}/{lang}/roasts-{lang}-{shard}.json"
+    resp = requests.get(url, timeout=10)
+    resp.raise_for_status()
+    _shard_cache[key] = resp.json()
+    return _shard_cache[key]
+
+
+def get_random_roast(
+    lang: str = "en",
+    intensity: Optional[int] = None,
+    max_length: Optional[int] = None,
+) -> Dict[str, Any]:
+    """
+    Get a random roast.
+
+    Args:
+        lang: Language code ('en' or 'bn'). Default: 'en'.
+        intensity: Filter by intensity (1–3). Default: None (any).
+        max_length: Maximum text length. Default: None (any).
+
+    Returns:
+        A dict with keys: id, text, intensity, length.
+
+    Raises:
+        ValueError: If no roasts match the given filters.
+    """
+    data = get_shard(lang)
+    roasts: List[Dict[str, Any]] = data.get("roasts", [])
+
+    if intensity is not None:
+        roasts = [r for r in roasts if r.get("intensity") == intensity]
+    if max_length is not None:
+        roasts = [r for r in roasts if r.get("length", 0) <= max_length]
+
+    if not roasts:
+        raise ValueError("No roasts match the given filters.")
+
+    return random.choice(roasts)
+
+
+def get_all_roasts(lang: str = "en") -> List[Dict[str, Any]]:
+    """Get all roasts for a language."""
+    data = get_shard(lang)
+    return data.get("roasts", [])
+
+
+def clear_cache() -> None:
+    """Clear the in-memory caches."""
+    global _manifest_cache, _shard_cache
+    _manifest_cache = None
+    _shard_cache = {}

roast_api-1.4.0/roast_api.egg-info/PKG-INFO

@@ -0,0 +1,243 @@
+Metadata-Version: 2.4
+Name: roast-api
+Version: 1.4.0
+Summary: A Python client for RaaS — Roast as a Service. CDN-served static JSON API for developer roasts.
+Author-email: Maizied <mdshuvo40@gmail.com>
+License: MIT
+Project-URL: Homepage, https://maijied.github.io/roast-as-a-service/
+Project-URL: Repository, https://github.com/Maijied/roast-as-a-service
+Keywords: roast,api,developer,humor,fun,cdn
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.20.0
+
+# 🥵 Roast as a Service (RaaS)
+
+<p align="center">
+  <img src="https://maijied.github.io/roast-as-a-service/assets/logo.png" width="128" alt="RaaS Logo" />
+</p>
+<p align="center">
+  <img src="https://hits.sh/maijied.github.io/roast-as-a-service.svg?view=today-total&style=flat-square&label=visitors&color=ec4899&labelColor=020617" alt="Visitor Count" />
+  <a href="https://www.npmjs.com/package/roast-api"><img src="https://img.shields.io/npm/v/roast-api?style=flat-square&color=f97316&labelColor=020617" alt="npm version" /></a>
+  <a href="https://www.npmjs.com/package/roast-api"><img src="https://img.shields.io/npm/dm/roast-api?style=flat-square&color=ec4899&labelColor=020617" alt="npm downloads" /></a>
+  <a href="https://pypi.org/project/roast-api/"><img src="https://img.shields.io/pypi/v/roast-api?style=flat-square&color=3b82f6&labelColor=020617" alt="PyPI version" /></a>
+  <a href="https://packagist.org/packages/maizied/roast-api"><img src="https://img.shields.io/packagist/v/maizied/roast-api?style=flat-square&color=10b981&labelColor=020617" alt="Packagist version" /></a>
+  <a href="https://github.com/Maijied/roast-as-a-service/actions/workflows/deploy.yml"><img src="https://github.com/Maijied/roast-as-a-service/actions/workflows/deploy.yml/badge.svg" alt="Deploy to GitHub Pages" /></a>
+</p>
+
+Random developer roasts, delivered via a blazing‑fast static API on GitHub Pages. Plug it into your apps, bots, terminals, or CI logs when “nice error messages” just aren’t enough.
+
+> **Part of the [Lorapok Ecosystem](https://github.com/Maijied/lorapok)** — Building the future of AI-driven developer tools. 🐛
+
+---
+
+## 🚀 What is RaaS?
+
+Roast as a Service is a GitHub‑hosted, CDN‑backed JSON API that returns developer‑themed roasts in English and Bangla.  
+It’s completely static (no servers), but feels dynamic thanks to a smart client SDK that shards, caches, and randomly selects roasts on the fly.
+
+Use it when you want your:
+
+- CLI tools to roast the user on failure.  
+- CI pipeline to roast you when tests fail.  
+- Discord/Slack bots to respond with spicy dev insults.  
+- Portfolio or landing page to show random roasts on each visit.
+
+---
+
+## 🌐 Live Service
+
+- **Website:** https://maijied.github.io/roast-as-a-service/
+- **API Base Path:** https://maijied.github.io/roast-as-a-service/api/
+
+---
+
+## ⚡ Quick Start
+
+### 1. Install via npm
+```bash
+npm install roast-api
+# or
+npm install @maizied/roast-as-a-service
+```
+
+```javascript
+const RaaS = require('roast-api');
+
+RaaS.getRandomRoast({ lang: 'en' })
+  .then(r => console.log(r.text));
+```
+
+### 2. Script Include (Browser)
+Load the client SDK directly in your browser:
+
+```html
+<script src="https://maijied.github.io/roast-as-a-service/api/client.js"></script>
+
+<script>
+  // Fetch a random Bangla roast with intensity 2
+  RaaS.getRandomRoast({ lang: 'bn', intensity: 2 })
+    .then(r => console.log(r.text));
+</script>
+```
+
+### 3. Install via Composer (PHP)
+```bash
+composer require maizied/roast-api
+```
+
+```php
+use Maizied\RoastApi\RaaS;
+
+$roast = RaaS::getRandomRoast(['lang' => 'en']);
+echo $roast['text'];
+```
+
+### 4. Install via pip (Python)
+```bash
+pip install roast-api
+```
+
+```python
+from roast_api import get_random_roast
+
+roast = get_random_roast(lang='en')
+print(roast['text'])
+```
+
+### 5. Direct Fetch
+Or just fetch the JSON files directly:
+
+```javascript
+fetch('https://maijied.github.io/roast-as-a-service/api/en/roasts-en-1.json')
+  .then(res => res.json())
+  .then(data => {
+    const list = data.roasts;
+    const pick = list[Math.floor(Math.random() * list.length)];
+    console.log(pick.text);
+  });
+```
+
+---
+
+## 🛠 How it works
+
+RaaS exposes sharded JSON datasets over GitHub Pages, then a tiny client SDK picks, filters, and caches roasts in the browser, giving you an API‑like experience with pure static hosting.
+
+- **Static API**: Roasts are stored in language‑specific shards (`en`, `bn`) and served as JSON over GitHub Pages’ global CDN for low TTFB.
+- **Smart client**: The bundled client fetches a small shard, caches it, and returns random roasts with optional intensity and length filters.
+- **Zero ops**: No servers, no cold starts, no scaling issues. Push to main, let Pages deploy and cache everything at the edge.
+
+---
+
+## 📦 API Overview
+
+This is a **static** API: data comes from versioned JSON files served over CDN, and a lightweight JS client handles randomness, filtering and caching in the browser.
+
+### Endpoints (static JSON)
+
+- **Manifest:**  
+  `GET https://maijied.github.io/roast-as-a-service/api/manifest.json`
+
+- **English Shard #1:**  
+  `GET https://maijied.github.io/roast-as-a-service/api/en/roasts-en-1.json`
+
+- **Bangla Shard #1:**  
+  `GET https://maijied.github.io/roast-as-a-service/api/bn/roasts-bn-1.json`
+
+### Example Response Structure
+Each shard looks like:
+
+```json
+{
+  "language": "en",
+  "shard": 1,
+  "total_shards": 5,
+  "count": 300,
+  "tags": ["dev", "general"],
+  "roasts": [
+    {
+      "id": "en-1-1",
+      "text": "Your codebase looks like it was written during a live outage.",
+      "intensity": 2,
+      "length": 61
+    }
+  ]
+}
+```
+
+### Usage Example (curl + jq)
+```bash
+curl -s https://maijied.github.io/roast-as-a-service/api/en/roasts-en-1.json \
+  | jq '.roasts[0].text'
+```
+
+---
+
+## 🧬 Why this architecture is “state of the art”
+
+Roast as a Service is intentionally built as a **static API** on top of GitHub Pages and a CDN, instead of a traditional backend. For this use case (serving pre‑made content), this gives you the same “API experience” with less cost, less complexity, and better global latency.
+
+Key points:
+
+- **Static JSON over CDN**  
+  All responses are just versioned JSON files served by GitHub Pages’ global edge network, which is highly cache‑friendly and extremely fast for read‑heavy traffic.
+
+- **Zero backend, zero cold starts**  
+  There is no application server to boot, scale, or warm up. Every request hits static content that can be served from edge cache with minimal TTFB.
+
+- **Sharded data layout**  
+  Roasts are split into language‑specific shards (e.g. `en/roasts-en-1.json`) so each response stays small and cacheable even if the total dataset becomes large.
+
+- **Client‑side selection and filtering**  
+  A tiny SDK handles randomness, intensity filters, and length limits in the client, so the “API” stays read‑only and ultra fast instead of computing on every request.
+
+- **Edge‑friendly cache behavior**  
+  Because the content is static and not personalized, CDN nodes can cache responses aggressively without worrying about user‑specific data. That’s exactly what CDNs are optimized for.
+
+- **Version‑controlled API**  
+  All JSON lives in Git; you can roll back, branch, and review changes like any other codebase while GitHub Pages redeploys and re‑caches automatically.
+
+This combination (static JSON + sharding + client‑side logic + CDN caching) is effectively the “fast path” that many dynamic APIs end up approximating with layers of caching—here it’s the default.
+
+## ⚡ Performance & Benchmarks
+
+RaaS is built for extreme speed and low overhead. By sharding data and relying on CDN edge caching + local browser caching, it achieves massive throughput.
+
+**Latest Benchmark Results:**
+- **Requests/sec**: ~2,000 (Tested with 5,000 total requests)
+- **Success Rate**: 100% (Zero failures under high concurrency)
+- **Avg Latency**: ~58ms
+- **P95 Latency**: ~159ms
+- **Cache Efficiency**: 90%+ (Manifest and shard reuse)
+
+> [!TIP]
+> This "Static API" approach beats the latency of traditional dynamic APIs by removing backend processing, cold starts, and database queries from the request path.
+
+---
+
+## 🐛 More from Lorapok
+
+RaaS is a proud member of the **Lorapok** family. Check out our other tools:
+
+- **[Lorapok CLI](https://github.com/Maijied/lorapok):** The intelligent AI agent framework for developers.
+- **[Lorapok Media Player](https://github.com/Maijied/Lorapok_Media_Player):** A modern, feature-rich media player built for power users.
+
+---
+
+## 👤 Author
+
+**Maizied**  
+📧 [mdshuvo40@gmail.com](mailto:mdshuvo40@gmail.com)  
+🔗 [GitHub](https://github.com/Maijied) · [npm](https://www.npmjs.com/~maizied)
+
+---
+
+## 📄 License
+
+MIT © Maizied

roast_api-1.4.0/roast_api.egg-info/SOURCES.txt

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

roast_api-1.4.0/roast_api.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

roast_api-1.4.0/roast_api.egg-info/requires.txt

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

roast_api-1.4.0/roast_api.egg-info/top_level.txt

@@ -0,0 +1 @@
+roast_api

roast_api-1.4.0/setup.cfg

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