Metadata-Version: 2.4
Name: supermegaexplosion
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
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Provides-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 Groq (primary), GitHub Models, and Stack Overflow.

```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 — 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 Groq + GitHub Models
```

## AI Setup

`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 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:

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