supermegaexplosion 0.3.0__tar.gz → 0.4.0__tar.gz

{supermegaexplosion-0.3.0 → supermegaexplosion-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: supermegaexplosion
-Version: 0.3.0
+Version: 0.4.0
 Summary: DSA utility library — input helpers, algorithms, data structures, and AI assistant
 Author-email: "Hadoopnb.ai" <hadoopnb@example.com>
 License-Expression: MIT
@@ -8,11 +8,12 @@ Classifier: Programming Language :: Python :: 3
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 Provides-Extra: ai
-Requires-Dist: google-genai; extra == "ai"
+Requires-Dist: groq; extra == "ai"
+Requires-Dist: azure-ai-inference; extra == "ai"
 
 # supermegaexplosion
 
-DSA utility library — interactive input helpers, string/math/array algorithms, data structures, and an AI assistant powered by Google Gemini.
+DSA utility library — interactive input helpers, string/math/array algorithms, data structures, and an AI assistant powered by Groq (primary), GitHub Models, and Stack Overflow.
 
 ```python
 from libbs import *
@@ -24,26 +25,35 @@ sieve(100)               # primes up to 100
 max_subarray_sum([-2,1,-3,4,-1,2,1,-5,4])  # 6
 ListNode.from_list([1,2,3,4,5])
 
-# AI assistant (requires API key + dependency)
+# AI assistant — works out of the box (free embedded Groq key)
 respond_help("How to reverse a linked list?")
+
+# Direct Stack Overflow search — also works out of the box
+stack_overflow("python reverse linked list")
 ```
 
 ## Install
 
 ```bash
 pip install supermegaexplosion              # core (zero deps)
-pip install supermegaexplosion[ai]          # with AI assistant (google-genai)
+pip install supermegaexplosion[ai]          # with Groq + GitHub Models
 ```
 
 ## AI Setup
 
-Get a free API key from https://aistudio.google.com/ and set it:
+`respond_help` works immediately with the embedded Groq key. For better quota, set your own:
+
+```bash
+set GROQ_API_KEY=gsk_your_key_here
+```
+
+Optional — GitHub Models fallback:
 
 ```bash
-set GEMINI_API_KEY=your_api_key_here
+set GITHUB_TOKEN=ghp_your_token_here
 ```
 
-Then use `respond_help("your question")` — free tier gives 60 requests/min, 1500/day.
+Provider chain: Groq (fastest) -> GitHub Models -> Stack Overflow -> built-in DSA answers.
 
 ## Adding New Functions
 

{supermegaexplosion-0.3.0 → supermegaexplosion-0.4.0}/README.md

@@ -1,6 +1,6 @@
 # supermegaexplosion
 
-DSA utility library — interactive input helpers, string/math/array algorithms, data structures, and an AI assistant powered by Google Gemini.
+DSA utility library — interactive input helpers, string/math/array algorithms, data structures, and an AI assistant powered by Groq (primary), GitHub Models, and Stack Overflow.
 
 ```python
 from libbs import *
@@ -12,26 +12,35 @@ sieve(100)               # primes up to 100
 max_subarray_sum([-2,1,-3,4,-1,2,1,-5,4])  # 6
 ListNode.from_list([1,2,3,4,5])
 
-# AI assistant (requires API key + dependency)
+# AI assistant — works out of the box (free embedded Groq key)
 respond_help("How to reverse a linked list?")
+
+# Direct Stack Overflow search — also works out of the box
+stack_overflow("python reverse linked list")
 ```
 
 ## Install
 
 ```bash
 pip install supermegaexplosion              # core (zero deps)
-pip install supermegaexplosion[ai]          # with AI assistant (google-genai)
+pip install supermegaexplosion[ai]          # with Groq + GitHub Models
 ```
 
 ## AI Setup
 
-Get a free API key from https://aistudio.google.com/ and set it:
+`respond_help` works immediately with the embedded Groq key. For better quota, set your own:
+
+```bash
+set GROQ_API_KEY=gsk_your_key_here
+```
+
+Optional — GitHub Models fallback:
 
 ```bash
-set GEMINI_API_KEY=your_api_key_here
+set GITHUB_TOKEN=ghp_your_token_here
 ```
 
-Then use `respond_help("your question")` — free tier gives 60 requests/min, 1500/day.
+Provider chain: Groq (fastest) -> GitHub Models -> Stack Overflow -> built-in DSA answers.
 
 ## Adding New Functions
 

{supermegaexplosion-0.3.0 → supermegaexplosion-0.4.0}/libbs/__init__.py

@@ -4,6 +4,7 @@ from libbs.math_utils import *
 from libbs.arrays import *
 from libbs.ds import *
 from libbs.ai_helper import respond_help
+from libbs.so_helper import stack_overflow
 from libbs.catalog import show_commands, show_command
 
-__version__ = "0.1.0"
+__version__ = "0.4.0"

supermegaexplosion-0.4.0/libbs/ai_helper.py

@@ -0,0 +1,301 @@
+import base64
+import json
+import os
+import re
+import threading
+import time
+
+_CONFIG_DIR = os.path.expanduser("~/.config/supermegaexplosion")
+_CONFIG_FILE = os.path.join(_CONFIG_DIR, "config.json")
+
+_EMBEDDED_GROQ_KEY = base64.b64decode(
+    "Z3NrX3A5cWdDQlp3OFFSWDBQdkhtdXphV0dkeWIzRllTd1lJT29Kd25YSnBlRHVod2ZIWHgyQng="
+).decode()
+
+_lock = threading.Lock()
+_request_times = []
+
+_FALLBACKS = {
+    "reverse linked list": """def reverse_linked_list(head):
+    prev = None
+    cur = head
+    while cur:
+        nxt = cur.next
+        cur.next = prev
+        prev = cur
+        cur = nxt
+    return prev""",
+    "two sum": """def two_sum(nums, target):
+    seen = {}
+    for i, v in enumerate(nums):
+        comp = target - v
+        if comp in seen:
+            return [seen[comp], i]
+        seen[v] = i
+    return []""",
+    "palindrome": """def is_palindrome(s):
+    s = ''.join(c.lower() for c in s if c.isalnum())
+    return s == s[::-1]""",
+    "zig zag": """def zigzag(n):
+    for i in range(n):
+        print(' ' * (n - i - 1) + '* ' * (i + 1))
+    for i in range(n - 1):
+        print(' ' * (i + 1) + '* ' * (n - i - 1))""",
+    "anagram": """def is_anagram(s1, s2):
+    from collections import Counter
+    return Counter(s1) == Counter(s2)""",
+    "fibonacci": """def fibonacci(n):
+    if n <= 0: return []
+    seq = [0, 1]
+    for _ in range(2, n):
+        seq.append(seq[-1] + seq[-2])
+    return seq[:n]""",
+    "binary search": """def binary_search(arr, target):
+    lo, hi = 0, len(arr) - 1
+    while lo <= hi:
+        mid = (lo + hi) // 2
+        if arr[mid] == target: return mid
+        if arr[mid] < target: lo = mid + 1
+        else: hi = mid - 1
+    return -1""",
+    "bubble sort": """def bubble_sort(arr):
+    n = len(arr)
+    for i in range(n):
+        for j in range(n - 1 - i):
+            if arr[j] > arr[j + 1]:
+                arr[j], arr[j + 1] = arr[j + 1], arr[j]""",
+    "merge sort": """def merge_sort(arr):
+    if len(arr) <= 1: return arr
+    mid = len(arr) // 2
+    left = merge_sort(arr[:mid])
+    right = merge_sort(arr[mid:])
+    return merge(left, right)
+
+def merge(a, b):
+    res = []
+    i = j = 0
+    while i < len(a) and j < len(b):
+        if a[i] <= b[j]:
+            res.append(a[i]); i += 1
+        else:
+            res.append(b[j]); j += 1
+    return res + a[i:] + b[j:]""",
+    "quick sort": """def quick_sort(arr):
+    if len(arr) <= 1: return arr
+    pivot = arr[0]
+    left = [x for x in arr[1:] if x <= pivot]
+    right = [x for x in arr[1:] if x > pivot]
+    return quick_sort(left) + [pivot] + quick_sort(right)""",
+    "linked list cycle": """def has_cycle(head):
+    slow = fast = head
+    while fast and fast.next:
+        slow = slow.next
+        fast = fast.next.next
+        if slow is fast: return True
+    return False""",
+    "level order": """from collections import deque
+def level_order(root):
+    if not root: return []
+    res, q = [], deque([root])
+    while q:
+        level = []
+        for _ in range(len(q)):
+            node = q.popleft()
+            level.append(node.val)
+            if node.left: q.append(node.left)
+            if node.right: q.append(node.right)
+        res.append(level)
+    return res""",
+    "max subarray": """def max_subarray(nums):
+    cur = max_sum = nums[0]
+    for v in nums[1:]:
+        cur = max(v, cur + v)
+        max_sum = max(max_sum, cur)
+    return max_sum""",
+    "lru cache": """class LRUCache:
+    def __init__(self, cap):
+        self.cap = cap
+        self.cache = {}
+        self.order = []
+
+    def get(self, key):
+        if key not in self.cache: return -1
+        self.order.remove(key)
+        self.order.append(key)
+        return self.cache[key]
+
+    def put(self, key, val):
+        if key in self.cache:
+            self.order.remove(key)
+        elif len(self.cache) >= self.cap:
+            oldest = self.order.pop(0)
+            del self.cache[oldest]
+        self.cache[key] = val
+        self.order.append(key)""",
+}
+
+
+def _load_config():
+    try:
+        with open(_CONFIG_FILE) as f:
+            return json.load(f)
+    except (FileNotFoundError, json.JSONDecodeError):
+        return {}
+
+
+def _save_config(data):
+    os.makedirs(_CONFIG_DIR, exist_ok=True)
+    with open(_CONFIG_FILE, "w") as f:
+        json.dump(data, f)
+
+
+def _get_groq_key(api_key=None):
+    if api_key:
+        return api_key
+    env = os.environ.get("GROQ_API_KEY")
+    if env:
+        return env
+    cfg = _load_config()
+    return cfg.get("groq_key") or _EMBEDDED_GROQ_KEY
+
+
+def _get_github_token():
+    token = os.environ.get("GITHUB_TOKEN")
+    if token:
+        return token
+    return _load_config().get("github_token")
+
+
+def _rate_limit_wait():
+    with _lock:
+        now = time.time()
+        cutoff = now - 60
+        recent = [t for t in _request_times if t > cutoff]
+        _request_times[:] = recent
+        if len(recent) >= 4:
+            wait = recent[0] + 60 - now
+            return max(wait, 1)
+        _request_times.append(now)
+    return 0
+
+
+def _extract_retry_delay(error_text):
+    match = re.search(r"retry in (\d+(?:\.\d+)?)\s*s", error_text, re.IGNORECASE)
+    if match:
+        return float(match.group(1))
+    match = re.search(r"retryDelay.*?(\d+)s", error_text, re.IGNORECASE)
+    if match:
+        return float(match.group(1))
+    return None
+
+
+def _countdown(seconds, label="Retrying"):
+    bar_width = 20
+    interval = max(0.5, seconds / bar_width)
+    steps = max(1, int(seconds / interval))
+    for i in range(steps, 0, -1):
+        filled = int((steps - i + 1) * bar_width / steps)
+        bar = "#" * filled + "." * (bar_width - filled)
+        remaining = seconds * i / steps
+        print(f"\r  [{bar}] {label} in {remaining:.0f}s  ", end="", flush=True)
+        time.sleep(interval)
+    print("\r" + " " * 55 + "\r", end="", flush=True)
+
+
+def _find_fallback(query):
+    q = query.lower().strip()
+    for keyword, answer in _FALLBACKS.items():
+        if keyword in q:
+            return answer
+    return None
+
+
+def _groq_answer(query, api_key=None):
+    from groq import Groq
+    key = _get_groq_key(api_key)
+    client = Groq(api_key=key)
+    response = client.chat.completions.create(
+        model="llama-3.1-8b-instant",
+        messages=[
+            {"role": "system", "content": "You are a DSA and Python coding assistant. Answer concisely with code examples."},
+            {"role": "user", "content": query},
+        ],
+        max_tokens=512,
+        temperature=0.3,
+    )
+    return response.choices[0].message.content
+
+
+def _github_answer(query):
+    token = _get_github_token()
+    if not token:
+        raise RuntimeError("GITHUB_TOKEN not set")
+    from azure.ai.inference import ChatCompletionsClient
+    from azure.core.credentials import AzureKeyCredential
+    client = ChatCompletionsClient(
+        endpoint="https://models.inference.ai.azure.com",
+        credential=AzureKeyCredential(token),
+    )
+    response = client.complete(
+        messages=[
+            {"role": "system", "content": "You are a DSA and Python coding assistant. Answer concisely with code examples."},
+            {"role": "user", "content": query},
+        ],
+        model="gpt-4o-mini",
+        max_tokens=512,
+        temperature=0.3,
+    )
+    return response.choices[0].message.content
+
+
+def _so_answer(query):
+    from libbs.so_helper import stack_overflow
+    result = stack_overflow(query)
+    if not result or result.startswith("No results") or "error" in result.lower():
+        raise RuntimeError(result or "No answer from Stack Overflow")
+    return result
+
+
+def respond_help(query=None, api_key=None):
+    interactive = query is None
+    if interactive:
+        query = input("Ask a DSA/Python question: ").strip()
+        if not query:
+            return
+
+    fallback = _find_fallback(query)
+
+    providers = [
+        ("Groq", lambda: _groq_answer(query, api_key)),
+        ("GitHub Models", lambda: _github_answer(query)),
+        ("Stack Overflow", lambda: _so_answer(query)),
+    ]
+
+    for name, func in providers:
+        for attempt in range(3):
+            wait = _rate_limit_wait()
+            if wait > 0:
+                _countdown(wait, "Cooling down")
+
+            try:
+                result = func()
+                if result:
+                    print(result)
+                    return
+            except ImportError:
+                break
+            except Exception as e:
+                error = str(e)
+                if not error:
+                    break
+                err_lower = error.lower()
+                if attempt < 2 and ("429" in error or "quota" in err_lower or "limit" in err_lower or "rate" in err_lower):
+                    delay = _extract_retry_delay(error)
+                    _countdown(delay or 5 * (attempt + 1), f"Retry {name} {attempt+1}/2")
+                else:
+                    break
+
+    if fallback:
+        print(fallback)
+    else:
+        print("No answer found. Try: stack_overflow('your question here')")

{supermegaexplosion-0.3.0 → supermegaexplosion-0.4.0}/libbs/catalog.py

@@ -55,7 +55,8 @@ COMMANDS = {
         "has_path_sum": "Check if root-to-leaf path sums to target.",
     },
     "AI Assistant": {
-        "respond_help": "Ask a coding/DSA question via Google Gemini (free, needs GEMINI_API_KEY env var).",
+        "respond_help": "Ask a coding/DSA question via Groq (AI, free) with automatic fallback to GitHub Models, Stack Overflow, and built-in answers.",
+        "stack_overflow": "Search Stack Overflow directly. Returns top-voted answers with code. No API key needed (embedded key provided).",
     },
 }
 

supermegaexplosion-0.4.0/libbs/so_helper.py

@@ -0,0 +1,62 @@
+import base64
+import html
+import json
+import os
+import re
+import urllib.parse
+import urllib.request
+import urllib.error
+
+_EMBEDDED_SO_KEY = base64.b64decode("cmxfUWFuS1lNMkhWVzRRZVZGTHRqWE4xaGlOdg==").decode()
+
+
+def _resolve_key(api_key=None):
+    if api_key:
+        return api_key
+    env = os.environ.get("STACK_OVERFLOW_KEY")
+    if env:
+        return env
+    return _EMBEDDED_SO_KEY
+
+
+def stack_overflow(query, api_key=None):
+    key = _resolve_key(api_key)
+    params = {
+        "order": "desc",
+        "sort": "votes",
+        "q": query,
+        "key": key,
+        "site": "stackoverflow",
+        "pagesize": 2,
+        "filter": "withbody",
+    }
+    url = "https://api.stackexchange.com/2.3/search/advanced?" + urllib.parse.urlencode(params)
+
+    try:
+        with urllib.request.urlopen(url, timeout=15) as resp:
+            data = json.loads(resp.read().decode())
+    except Exception as e:
+        return f"Stack Overflow API error: {e}"
+
+    if "items" not in data or not data["items"]:
+        return "No results found on Stack Overflow."
+
+    result_parts = []
+    for item in data["items"][:2]:
+        title = item.get("title", "Untitled")
+        score = item.get("score", 0)
+        body = item.get("body", "")
+
+        codes = re.findall(r"<pre><code>(.*?)</code></pre>", body, re.DOTALL)
+        text = html.unescape(re.sub(r"<[^>]+>", "", body))[:300].strip()
+
+        result_parts.append(f"[{score} votes] {title}")
+        result_parts.append(f"  {text}\n")
+        for code in codes[:2]:
+            cleaned = html.unescape(code.strip())
+            result_parts.append(f"  ---")
+            for line in cleaned.split("\n"):
+                result_parts.append(f"  {line}")
+            result_parts.append("")
+
+    return "\n".join(result_parts).strip()

{supermegaexplosion-0.3.0 → supermegaexplosion-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "supermegaexplosion"
-version = "0.3.0"
+version = "0.4.0"
 description = "DSA utility library — input helpers, algorithms, data structures, and AI assistant"
 readme = "README.md"
 authors = [{ name = "Hadoopnb.ai", email = "hadoopnb@example.com" }]
@@ -15,4 +15,4 @@ classifiers = [
 requires-python = ">=3.8"
 
 [project.optional-dependencies]
-ai = ["google-genai"]
+ai = ["groq", "azure-ai-inference"]

{supermegaexplosion-0.3.0 → supermegaexplosion-0.4.0}/supermegaexplosion.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: supermegaexplosion
-Version: 0.3.0
+Version: 0.4.0
 Summary: DSA utility library — input helpers, algorithms, data structures, and AI assistant
 Author-email: "Hadoopnb.ai" <hadoopnb@example.com>
 License-Expression: MIT
@@ -8,11 +8,12 @@ Classifier: Programming Language :: Python :: 3
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 Provides-Extra: ai
-Requires-Dist: google-genai; extra == "ai"
+Requires-Dist: groq; extra == "ai"
+Requires-Dist: azure-ai-inference; extra == "ai"
 
 # supermegaexplosion
 
-DSA utility library — interactive input helpers, string/math/array algorithms, data structures, and an AI assistant powered by Google Gemini.
+DSA utility library — interactive input helpers, string/math/array algorithms, data structures, and an AI assistant powered by Groq (primary), GitHub Models, and Stack Overflow.
 
 ```python
 from libbs import *
@@ -24,26 +25,35 @@ sieve(100)               # primes up to 100
 max_subarray_sum([-2,1,-3,4,-1,2,1,-5,4])  # 6
 ListNode.from_list([1,2,3,4,5])
 
-# AI assistant (requires API key + dependency)
+# AI assistant — works out of the box (free embedded Groq key)
 respond_help("How to reverse a linked list?")
+
+# Direct Stack Overflow search — also works out of the box
+stack_overflow("python reverse linked list")
 ```
 
 ## Install
 
 ```bash
 pip install supermegaexplosion              # core (zero deps)
-pip install supermegaexplosion[ai]          # with AI assistant (google-genai)
+pip install supermegaexplosion[ai]          # with Groq + GitHub Models
 ```
 
 ## AI Setup
 
-Get a free API key from https://aistudio.google.com/ and set it:
+`respond_help` works immediately with the embedded Groq key. For better quota, set your own:
+
+```bash
+set GROQ_API_KEY=gsk_your_key_here
+```
+
+Optional — GitHub Models fallback:
 
 ```bash
-set GEMINI_API_KEY=your_api_key_here
+set GITHUB_TOKEN=ghp_your_token_here
 ```
 
-Then use `respond_help("your question")` — free tier gives 60 requests/min, 1500/day.
+Provider chain: Groq (fastest) -> GitHub Models -> Stack Overflow -> built-in DSA answers.
 
 ## Adding New Functions
 

{supermegaexplosion-0.3.0 → supermegaexplosion-0.4.0}/supermegaexplosion.egg-info/SOURCES.txt

@@ -7,6 +7,7 @@ libbs/catalog.py
 libbs/ds.py
 libbs/input_utils.py
 libbs/math_utils.py
+libbs/so_helper.py
 libbs/strings.py
 libbs/tools/__init__.py
 libbs/tools/add_func.py

supermegaexplosion-0.4.0/supermegaexplosion.egg-info/requires.txt

@@ -0,0 +1,4 @@
+
+[ai]
+groq
+azure-ai-inference

supermegaexplosion-0.3.0/libbs/ai_helper.py

@@ -1,74 +0,0 @@
-import os
-import json
-import base64
-
-_CONFIG_DIR = os.path.expanduser("~/.config/supermegaexplosion")
-_CONFIG_FILE = os.path.join(_CONFIG_DIR, "config.json")
-
-_EMBEDDED_KEY = base64.b64decode(
-    "QVEuQWI4Uk42TEFaTm14Tmh3UnJ0T0p1TWhFQjh3UzI2bDkzRWRfR2RPOWdGalJMbFdNY1E="
-).decode()
-
-
-def _load_config():
-    try:
-        with open(_CONFIG_FILE) as f:
-            return json.load(f)
-    except (FileNotFoundError, json.JSONDecodeError):
-        return {}
-
-
-def _save_config(data):
-    os.makedirs(_CONFIG_DIR, exist_ok=True)
-    with open(_CONFIG_FILE, "w") as f:
-        json.dump(data, f)
-
-
-def respond_help(query=None, api_key=None, model="gemini-2.0-flash-lite"):
-    if query is None:
-        query = input("Ask a DSA/Python question: ").strip()
-        if not query:
-            return
-
-    try:
-        from google import genai
-    except ImportError:
-        print(
-            "Missing dependency. Install with:\n"
-            "  pip install supermegaexplosion[ai]"
-        )
-        return
-
-    key = api_key or os.environ.get("GEMINI_API_KEY") or _load_config().get("api_key")
-
-    if not key:
-        print(
-            "No API key found. Using a shared demo key (rate-limited).\n"
-            "Set your own free key at https://aistudio.google.com/ for better quota.\n"
-        )
-        key = _EMBEDDED_KEY
-        _save_config({"api_key": ""})
-
-    if key == _EMBEDDED_KEY and not _load_config().get("api_key"):
-        ans = input("Enter your Gemini API key (or press Enter to use the demo key): ").strip()
-        if ans:
-            key = ans
-            _save_config({"api_key": ans})
-
-    try:
-        client = genai.Client(api_key=key)
-        resp = client.models.generate_content(
-            model=model,
-            contents=(
-                "You are a DSA and Python coding assistant. "
-                "Answer concisely with code examples.\n\n"
-                f"Question: {query}"
-            ),
-            config={
-                "max_output_tokens": 512,
-                "temperature": 0.3,
-            },
-        )
-        print(resp.text)
-    except Exception as e:
-        print(f"Error: {e}")

supermegaexplosion-0.3.0/supermegaexplosion.egg-info/requires.txt

@@ -1,3 +0,0 @@
-
-[ai]
-google-genai