Metadata-Version: 2.4
Name: supermegaexplosion
Version: 0.3.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
