Metadata-Version: 2.4
Name: randmplus
Version: 1.0.0
Summary: An unpredictable expansion of Python's random module, because random wasn't random enough.
Author: NoodleBoodle
License: MIT
Keywords: random,fun,chaos,random_plus
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown

(This was written by ChatGPT because i'm bad at markdown, please "check important info" or something)
# 🎲 RandomPlus

RandomPlus is a chaotic and fun expansion of Python’s built-in `random` module.  
It adds weird, funny, and sometimes useful ways to generate randomness, because normal random just wasn’t random enough.

---

## 🚀 Installation

After uploading to PyPI, people will be able to install it with:

```bash
pip install randomplus
```

Or, if you’re just testing locally:

```bash
pip install .
```

---

## 🧩 Features

| Function                                                | Description                                                 |
| ------------------------------------------------------- | ----------------------------------------------------------- |
| `randstr(length=8, digits=1)`                           | Generate a random string of letters, digits, or both.       |
| `maybe(prob=0.5)`                                       | Returns `True` or `False` with a given probability.         |
| `randomplus(step=0.000000000000001)`                    | Returns a random float rounded to a step size.              |
| `randcase(text)`                                        | Randomly flips the casing of each character.                |
| `randlist(listlength=5, itemlength=5, digitsonly=True)` | Creates a list of random numbers or strings.                |
| `randchar(min, max)`                                    | Returns a random Unicode character between two code points. |
| `randrev(text)`                                         | Reverses a random part of a string for *utter chaos*.       |

---

## 🧠 Examples

```python
import randomplus

print(randomplus.randstr())         # 'G5aKw8Xb'
print(randomplus.maybe())           # True or False
print(randomplus.randcase("hello")) # 'HeLLo'
print(randomplus.randrev("This is normal text.")) # 'This is nmroal text.'
```

---
## ⚠️ DISCLAIMER
If you do `from randomplus import X` then because some functions reference other functions in the module, it might not work.

---
## 💥 Bonus Fun

For *maximum* chaos:

```python
print(randomplus.randrev(randomplus.randstr()))
```

---

## 🧑‍💻 About

Made by NoodleBoodle, the creator of **RandomPlus**, because the regular `random` module was just too calm.
