supermegaexplosion 0.4.0

DSA utility library — input helpers, algorithms, data structures, and AI assistant

supermegaexplosion

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.

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 — 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

pip install supermegaexplosion              # core (zero deps)
pip install supermegaexplosion[ai]          # with Groq + GitHub Models

AI Setup

respond_help works immediately with the embedded Groq key. For better quota, set your own:

set GROQ_API_KEY=gsk_your_key_here

Optional — GitHub Models fallback:

set GITHUB_TOKEN=ghp_your_token_here

Provider chain: Groq (fastest) -> GitHub Models -> Stack Overflow -> built-in DSA answers.

Adding New Functions

Run the interactive helper:

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