supermegaexplosion 0.1.0__tar.gz → 0.2.0__tar.gz

supermegaexplosion-0.2.0/PKG-INFO

@@ -0,0 +1,60 @@
+Metadata-Version: 2.4
+Name: supermegaexplosion
+Version: 0.2.0
+Summary: DSA utility library — input helpers, algorithms, data structures, and AI assistant
+Author-email: "Hadoopnb.ai" <hadoopnb@example.com>
+License-Expression: MIT
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Provides-Extra: ai
+Requires-Dist: google-genai; extra == "ai"
+
+# supermegaexplosion
+
+DSA utility library — interactive input helpers, string/math/array algorithms, data structures, and an AI assistant powered by Google Gemini.
+
+```python
+from libbs import *
+
+show_commands()          # list everything available
+input_matrix()           # interactively type a matrix
+is_palindrome("racecar") # True
+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)
+respond_help("How to reverse a linked list?")
+```
+
+## Install
+
+```bash
+pip install supermegaexplosion              # core (zero deps)
+pip install supermegaexplosion[ai]          # with AI assistant (google-genai)
+```
+
+## AI Setup
+
+Get a free API key from https://aistudio.google.com/ and set it:
+
+```bash
+set GEMINI_API_KEY=your_api_key_here
+```
+
+Then use `respond_help("your question")` — free tier gives 60 requests/min, 1500/day.
+
+## Adding New Functions
+
+Run the interactive helper:
+
+```bash
+python -m libbs.tools.add_func
+```
+
+It appends the function to the right module, updates the catalog, bumps the version, and optionally rebuilds + uploads to PyPI.
+
+## License
+
+MIT

supermegaexplosion-0.2.0/README.md

@@ -0,0 +1,48 @@
+# supermegaexplosion
+
+DSA utility library — interactive input helpers, string/math/array algorithms, data structures, and an AI assistant powered by Google Gemini.
+
+```python
+from libbs import *
+
+show_commands()          # list everything available
+input_matrix()           # interactively type a matrix
+is_palindrome("racecar") # True
+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)
+respond_help("How to reverse a linked list?")
+```
+
+## Install
+
+```bash
+pip install supermegaexplosion              # core (zero deps)
+pip install supermegaexplosion[ai]          # with AI assistant (google-genai)
+```
+
+## AI Setup
+
+Get a free API key from https://aistudio.google.com/ and set it:
+
+```bash
+set GEMINI_API_KEY=your_api_key_here
+```
+
+Then use `respond_help("your question")` — free tier gives 60 requests/min, 1500/day.
+
+## Adding New Functions
+
+Run the interactive helper:
+
+```bash
+python -m libbs.tools.add_func
+```
+
+It appends the function to the right module, updates the catalog, bumps the version, and optionally rebuilds + uploads to PyPI.
+
+## License
+
+MIT

supermegaexplosion-0.2.0/libbs/ai_helper.py

@@ -0,0 +1,46 @@
+import os
+
+
+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
+
+    if api_key is None:
+        api_key = os.environ.get("GEMINI_API_KEY")
+    if not api_key:
+        print(
+            "Gemini API key not found.\n"
+            "Set the GEMINI_API_KEY environment variable:\n"
+            "  set GEMINI_API_KEY=your_key_here\n"
+            "Or pass api_key='your_key' to respond_help()."
+        )
+        return
+
+    try:
+        from google import genai
+    except ImportError:
+        print(
+            "Missing dependency. Install with:\n"
+            "  pip install supermegaexplosion[ai]"
+        )
+        return
+
+    try:
+        client = genai.Client(api_key=api_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.1.0 → supermegaexplosion-0.2.0}/libbs/catalog.py

@@ -55,7 +55,7 @@ COMMANDS = {
         "has_path_sum": "Check if root-to-leaf path sums to target.",
     },
     "AI Assistant": {
-        "respond_help": "Ask a coding/DSA question and get an answer from a free local AI model.",
+        "respond_help": "Ask a coding/DSA question via Google Gemini (free, needs GEMINI_API_KEY env var).",
     },
 }
 

supermegaexplosion-0.2.0/libbs/tools/add_func.py

@@ -0,0 +1,145 @@
+import os
+import re
+import subprocess
+import sys
+
+
+MODULE_MAP = {
+    "1": ("arrays.py", "Arrays", "arrays"),
+    "2": ("strings.py", "Strings", "strings"),
+    "3": ("math_utils.py", "Math", "math_utils"),
+    "4": ("ds.py", "Data Structures", "ds"),
+    "5": ("input_utils.py", "Input", "input_utils"),
+}
+
+MODULE_CHOICES = "\n".join(
+    f"  {k}. {v[1]}" for k, v in MODULE_MAP.items()
+)
+
+
+def main():
+    sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__)))))
+
+    root = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+
+    print("=== Add Function to libbs ===\n")
+
+    name = input("Function name: ").strip()
+    if not name:
+        print("Aborted.")
+        return
+
+    print(f"\nSelect module:\n{MODULE_CHOICES}")
+    mod_key = input("Module number: ").strip()
+    if mod_key not in MODULE_MAP:
+        print("Invalid choice.")
+        return
+
+    filename, category, module_name = MODULE_MAP[mod_key]
+
+    desc = input("Description: ").strip()
+
+    print("\nPaste function body (empty line to finish):")
+    lines = []
+    while True:
+        line = input()
+        if not line.strip():
+            break
+        lines.append(line)
+    body = "\n".join(lines)
+
+    if not body:
+        print("No body provided. Aborted.")
+        return
+
+    # 1. Append to module file
+    mod_path = os.path.join(root, filename)
+    with open(mod_path, "a", encoding="utf-8") as f:
+        f.write("\n\n" + body)
+
+    # 2. Update __all__ in module
+    with open(mod_path, "r", encoding="utf-8") as f:
+        content = f.read()
+
+    all_match = re.search(r"__all__\s*=\s*\[(.*?)\]", content, re.DOTALL)
+    if all_match:
+        existing = all_match.group(1)
+        new_all = f'__all__ = [{existing}    "{name}",\n]'
+        content = content.replace(all_match.group(0), new_all)
+        with open(mod_path, "w", encoding="utf-8") as f:
+            f.write(content)
+
+    # 3. Update catalog
+    catalog_path = os.path.join(root, "catalog.py")
+    with open(catalog_path, "r", encoding="utf-8") as f:
+        content = f.read()
+
+    section_pattern = rf'("{category}": \{{\n)(.*?)(\n    \}},)'
+
+    def add_to_section(m):
+        pre = m.group(1)
+        mid = m.group(2)
+        suf = m.group(3)
+        entry = f'\n        "{name}": "{desc}",'
+        return pre + mid + entry + suf
+
+    new_content = re.sub(section_pattern, add_to_section, content, count=1, flags=re.DOTALL)
+    if new_content != content:
+        with open(catalog_path, "w", encoding="utf-8") as f:
+            f.write(new_content)
+        print("  catalog.py: updated")
+    else:
+        print("  Warning: catalog section not found, update manually.")
+
+    # 4. Bump patch version
+    pyproject_path = os.path.join(root, "..", "pyproject.toml")
+    with open(pyproject_path, "r", encoding="utf-8") as f:
+        content = f.read()
+
+    ver_match = re.search(r'version = "(\d+)\.(\d+)\.(\d+)"', content)
+    if ver_match:
+        major, minor, patch = map(int, ver_match.groups())
+        new_ver = f"{major}.{minor}.{patch + 1}"
+        content = content.replace(ver_match.group(0), f'version = "{new_ver}"')
+        with open(pyproject_path, "w", encoding="utf-8") as f:
+            f.write(content)
+        print(f"  pyproject.toml: version {new_ver}")
+    else:
+        print("  Warning: could not bump version.")
+
+    print(f"\nDone. Function '{name}' added.\n")
+
+    ans = input("Build and upload to PyPI now? (y/n): ").strip().lower()
+    if ans == "y":
+        _build_and_upload(root)
+
+
+def _build_and_upload(root):
+    os.chdir(os.path.join(root, ".."))
+    print("\nBuilding...")
+    r = subprocess.run([sys.executable, "-m", "build"], capture_output=True, text=True)
+    if r.returncode != 0:
+        print("Build failed:", r.stderr)
+        return
+    print("Build OK.")
+
+    token = os.environ.get("TWINE_PASSWORD")
+    if not token:
+        token = input("PyPI API token: ").strip()
+
+    env = os.environ.copy()
+    env["TWINE_USERNAME"] = "__token__"
+    env["TWINE_PASSWORD"] = token
+    print("Uploading...")
+    r = subprocess.run(
+        [sys.executable, "-m", "twine", "upload", "dist/*"],
+        env=env, capture_output=True, text=True,
+    )
+    if r.returncode == 0:
+        print("Uploaded to PyPI!")
+    else:
+        print("Upload failed:", r.stderr)
+
+
+if __name__ == "__main__":
+    main()

{supermegaexplosion-0.1.0 → supermegaexplosion-0.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "supermegaexplosion"
-version = "0.1.0"
+version = "0.2.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 = ["transformers>=4.30.0", "torch>=2.0.0"]
+ai = ["google-genai"]

supermegaexplosion-0.2.0/supermegaexplosion.egg-info/PKG-INFO

@@ -0,0 +1,60 @@
+Metadata-Version: 2.4
+Name: supermegaexplosion
+Version: 0.2.0
+Summary: DSA utility library — input helpers, algorithms, data structures, and AI assistant
+Author-email: "Hadoopnb.ai" <hadoopnb@example.com>
+License-Expression: MIT
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Provides-Extra: ai
+Requires-Dist: google-genai; extra == "ai"
+
+# supermegaexplosion
+
+DSA utility library — interactive input helpers, string/math/array algorithms, data structures, and an AI assistant powered by Google Gemini.
+
+```python
+from libbs import *
+
+show_commands()          # list everything available
+input_matrix()           # interactively type a matrix
+is_palindrome("racecar") # True
+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)
+respond_help("How to reverse a linked list?")
+```
+
+## Install
+
+```bash
+pip install supermegaexplosion              # core (zero deps)
+pip install supermegaexplosion[ai]          # with AI assistant (google-genai)
+```
+
+## AI Setup
+
+Get a free API key from https://aistudio.google.com/ and set it:
+
+```bash
+set GEMINI_API_KEY=your_api_key_here
+```
+
+Then use `respond_help("your question")` — free tier gives 60 requests/min, 1500/day.
+
+## Adding New Functions
+
+Run the interactive helper:
+
+```bash
+python -m libbs.tools.add_func
+```
+
+It appends the function to the right module, updates the catalog, bumps the version, and optionally rebuilds + uploads to PyPI.
+
+## License
+
+MIT

{supermegaexplosion-0.1.0 → supermegaexplosion-0.2.0}/supermegaexplosion.egg-info/SOURCES.txt

@@ -8,6 +8,8 @@ libbs/ds.py
 libbs/input_utils.py
 libbs/math_utils.py
 libbs/strings.py
+libbs/tools/__init__.py
+libbs/tools/add_func.py
 supermegaexplosion.egg-info/PKG-INFO
 supermegaexplosion.egg-info/SOURCES.txt
 supermegaexplosion.egg-info/dependency_links.txt

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

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

supermegaexplosion-0.1.0/PKG-INFO

@@ -1,39 +0,0 @@
-Metadata-Version: 2.4
-Name: supermegaexplosion
-Version: 0.1.0
-Summary: DSA utility library — input helpers, algorithms, data structures, and AI assistant
-Author-email: "Hadoopnb.ai" <hadoopnb@example.com>
-License-Expression: MIT
-Classifier: Programming Language :: Python :: 3
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-Provides-Extra: ai
-Requires-Dist: transformers>=4.30.0; extra == "ai"
-Requires-Dist: torch>=2.0.0; extra == "ai"
-
-# libbs
-
-DSA utility library — interactive input helpers, string/math/array algorithms, data structures, and an optional AI coding assistant.
-
-```python
-from libbs import *
-
-show_commands()          # list everything available
-input_matrix()           # interactively type a matrix
-is_palindrome("racecar") # True
-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])
-respond_help("How to reverse a linked list?")  # requires: pip install libbs[ai]
-```
-
-## Install
-
-```bash
-pip install libbs           # core
-pip install libbs[ai]       # with AI assistant (transformers + torch)
-```
-
-## License
-
-MIT

supermegaexplosion-0.1.0/README.md

@@ -1,26 +0,0 @@
-# libbs
-
-DSA utility library — interactive input helpers, string/math/array algorithms, data structures, and an optional AI coding assistant.
-
-```python
-from libbs import *
-
-show_commands()          # list everything available
-input_matrix()           # interactively type a matrix
-is_palindrome("racecar") # True
-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])
-respond_help("How to reverse a linked list?")  # requires: pip install libbs[ai]
-```
-
-## Install
-
-```bash
-pip install libbs           # core
-pip install libbs[ai]       # with AI assistant (transformers + torch)
-```
-
-## License
-
-MIT

supermegaexplosion-0.1.0/libbs/ai_helper.py

@@ -1,30 +0,0 @@
-def respond_help(query, model_name="TinyLlama/TinyLlama-1.1B-Chat-v1.0"):
-    try:
-        from transformers import pipeline
-    except ImportError:
-        print(
-            "The AI helper requires extra dependencies.\n"
-            "Install them with: pip install libbs[ai]\n"
-            "Or: pip install transformers torch"
-        )
-        return
-
-    print(f"Loading AI model ({model_name})... This may take a while on first run.")
-    pipe = pipeline(
-        "text-generation",
-        model=model_name,
-        trust_remote_code=True,
-    )
-    prompt = (
-        "You are a helpful DSA and Python coding assistant. "
-        "Answer the following question concisely with code examples.\n\n"
-        f"Question: {query}\n\nAnswer:"
-    )
-    result = pipe(
-        prompt,
-        max_new_tokens=512,
-        temperature=0.3,
-        do_sample=True,
-        pad_token_id=pipe.tokenizer.eos_token_id,
-    )
-    print(result[0]["generated_text"].split("Answer:")[-1].strip())

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

@@ -1,39 +0,0 @@
-Metadata-Version: 2.4
-Name: supermegaexplosion
-Version: 0.1.0
-Summary: DSA utility library — input helpers, algorithms, data structures, and AI assistant
-Author-email: "Hadoopnb.ai" <hadoopnb@example.com>
-License-Expression: MIT
-Classifier: Programming Language :: Python :: 3
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-Provides-Extra: ai
-Requires-Dist: transformers>=4.30.0; extra == "ai"
-Requires-Dist: torch>=2.0.0; extra == "ai"
-
-# libbs
-
-DSA utility library — interactive input helpers, string/math/array algorithms, data structures, and an optional AI coding assistant.
-
-```python
-from libbs import *
-
-show_commands()          # list everything available
-input_matrix()           # interactively type a matrix
-is_palindrome("racecar") # True
-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])
-respond_help("How to reverse a linked list?")  # requires: pip install libbs[ai]
-```
-
-## Install
-
-```bash
-pip install libbs           # core
-pip install libbs[ai]       # with AI assistant (transformers + torch)
-```
-
-## License
-
-MIT

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

@@ -1,4 +0,0 @@
-
-[ai]
-transformers>=4.30.0
-torch>=2.0.0