py-simple-wrap 0.3.2__tar.gz → 0.3.4__tar.gz

{py_simple_wrap-0.3.2/py_simple_package/src/py_simple_wrap.egg-info → py_simple_wrap-0.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: py_simple_wrap
-Version: 0.3.2
+Version: 0.3.4
 Summary: A package to make complex python functionality simple
 Author-email: Sara Czasak <sara.p.czasak.m@gmail.com>
 Maintainer: jagjitkaur0000, atiqur-rahman-pro, Gaohar Imran, Yassin Azzouzi
@@ -74,14 +74,18 @@ Dynamic: license-file
 
 [![Home](https://img.shields.io/badge/🏠_home-py--simple--wrap-3F51B5?style=for-the-badge)](https://sara-czasak.github.io/py-simple-wrap/)
 [![Docs](https://img.shields.io/badge/docs-online-blue?style=for-the-badge)](https://sara-czasak.github.io/py-simple-wrap/docs/)
-[![Contributor Hub](https://img.shields.io/badge/🤝_contributor_hub-start_here-b8863b?style=for-the-badge)](https://sara-czasak.github.io/py-simple-wrap/docs/contributor-hub/docstring_template/)
+[![Contributor Hub](https://img.shields.io/badge/🤝_contributor_hub-start_here-b8863b?style=for-the-badge)](https://sara-czasak.github.io/py-simple-wrap/docs/contributor-hub/)
 [![Contributors Quest](https://img.shields.io/badge/🗺️_contributors_quest-play_now-b8863b?style=for-the-badge)](https://sara-czasak.github.io/py-simple-wrap/quest/)
 
-[![PyPI](https://img.shields.io/pypi/v/py-simple-wrap?style=for-the-badge)](https://pypi.org/project/py-simple-wrap/)
 [![Contributors](https://img.shields.io/badge/contributors-25-orange?style=for-the-badge)](#contributors-)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)](https://github.com/sara-czasak/py-simple-wrap/blob/main/LICENSE.md)
 [![GitHub stars](https://img.shields.io/github/stars/sara-czasak/py-simple-wrap?style=for-the-badge)](https://github.com/sara-czasak/py-simple-wrap)
 
+[![Downloads/day](https://img.shields.io/pypi/dd/py-simple-wrap?style=for-the-badge)](https://pypistats.org/packages/py-simple-wrap)
+[![Downloads/week](https://img.shields.io/pypi/dw/py-simple-wrap?style=for-the-badge)](https://pypistats.org/packages/py-simple-wrap)
+[![Downloads/month](https://img.shields.io/pypi/dm/py-simple-wrap?style=for-the-badge)](https://pypistats.org/packages/py-simple-wrap)
+[![Latest version](https://img.shields.io/pypi/v/py-simple-wrap?style=for-the-badge)](https://pypi.org/project/py-simple-wrap/)
+
 
 py-simple-wrap is a beginner-friendly Python wrapper package designed to help beginners and developers perform common tasks using simple, intuitive functions.
 
@@ -265,8 +269,8 @@ py-simple-wrap provides simple modules designed to make common Python tasks easi
 
 <br>
 
-|------------------------------|---------------------------------------------|---------------------------------------------------------------|
 | Function                     | What it does                                | Example                                                       |
+|------------------------------|---------------------------------------------|---------------------------------------------------------------|
 | `truncate(text, length)`     | Shorten text and add an ellipsis            | `truncate("Hello world!", 5)` → `"Hello…"`                    |
 | `remove_punctuation(text)`   | Strip punctuation, keep letters and numbers | `remove_punctuation("Hello, world!")` → `"Hello world"`       |
 | `reverse_words(text)`        | Reverse the order of words                  | `reverse_words("Hello world")` → `"world Hello"`              |
@@ -562,6 +566,21 @@ py-simple-wrap provides simple modules designed to make common Python tasks easi
 
 </details>
 
+### 📈 Easy Data Visualization
+
+<details>
+<summary>Click to expand — auto-picks the right chart type for your data, no matplotlib boilerplate</summary>
+
+<br>
+
+| Function          | What it does                                                                                 | Example                                                        |
+|-------------------|----------------------------------------------------------------------------------------------|----------------------------------------------------------------|
+| `plot_data(X)`    | Infers whether `X` is quantitative or categorical and plots the right chart(s) automatically | `plot_data([1, 2, 2, 3, 5, 5, 5, 8])` → histogram + line chart |
+| `plot_data(X, Y)` | Same, but plots `X` against a second series `Y`                                              | `plot_data(["A", "B", "C"], [10, 20, 30])` → bar chart         |
+
+</details>
+
+
 ### 🎮 Easy Game
 
 <details>
@@ -580,6 +599,24 @@ py-simple-wrap provides simple modules designed to make common Python tasks easi
 
 </details>
 
+### 🎲 Easy Generator
+
+<details>
+<summary>Click to expand — passwords, QR codes, UUIDs, and API keys without the boilerplate</summary>
+
+<br>
+
+| Function                                                                   | What it does                                                     | Example                                                                                      |
+|----------------------------------------------------------------------------|------------------------------------------------------------------|----------------------------------------------------------------------------------------------|
+| `generate_password(16, uppercase_chars=3, digit_chars=3, special_chars=3)` | Generates a random password with no repeated adjacent characters | `generate_password(16, uppercase_chars=3, digit_chars=3, special_chars=3)` → `"Kx9!mQ2z..."` |
+| `generate_otp(6, with_letters=True)`                                       | Generates a random one-time password code                        | `generate_otp(6, with_letters=True)` → `"a1B9x3"`                                            |
+| `generate_api_key()`                                                       | Generates a secure, URL-safe API key                             | `generate_api_key()` → `"kZ8x...Q1w"`                                                        |
+| `generate_uuid()`                                                          | Generates a random UUID (version 4)                              | `generate_uuid()` → `"3f2504e0-4f89-11d3-9a0c-0305e82c3301"`                                 |
+| `generate_qr_code("https://example.com")`                                  | Generates a QR code image and saves it to disk                   | Saves `qrcode0.png` (or the next free filename)                                              |
+
+</details>
+
+
 ## 🤝 Contributing
 
 I would love to have your help in making Python simpler for everyone!
@@ -665,7 +702,7 @@ A huge thank you to these wonderful people for helping make Python simpler for e
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/smirnov-danil"><img src="https://github.com/smirnov-danil.png?s=80" width="80px;" alt="d.smirnov"/><br /><sub><b>d.smirnov</b></sub></a><br /><a href="https://github.com/sara-czasak/py_simple/commits?author=smirnov-danil" title="Code">💻</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/Venkat4real"><img src="https://github.com/Venkat4real.png?s=80" width="80px;" alt="Venkat"/><br /><sub><b>Venkat</b></sub></a><br /><a href="https://github.com/sara-czasak/py_simple/commits?author=Venkat4real" title="Docs">📖</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/E4x7k"><img src="https://github.com/E4x7k.png?s=80" width="80px;" alt="E4x7k"/><br /><sub><b>E4x7k</b></sub></a><br /><a href="https://github.com/sara-czasak/py_simple/commits?author=E4x7k" title="Docs">📖</a></td>
-      <td align="center" valign="top" width="14.28%"><a href="https://github.com/jbsilva"><img src="https://github.com/jbsilva.png?s=80" width="80px;" alt="Julio Batista Silva"/><br /><sub><b>Julio Batista Silva</b></sub></a><br /><a href="https://github.com/sara-czasak/py_simple/commits?author=jbsilva " title="Infrastructure">🚇</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/jbsilva"><img src="https://github.com/jbsilva.png?s=80" width="80px;" alt="Julio Batista Silva"/><br /><sub><b>Julio Batista Silva</b></sub></a><br /><a href="https://github.com/sara-czasak/py_simple/commits?author=jbsilva" title="Infrastructure">🚇</a></td>
     </tr>
   </tbody>
 </table>

{py_simple_wrap-0.3.2 → py_simple_wrap-0.3.4}/README.md

@@ -7,14 +7,18 @@
 
 [![Home](https://img.shields.io/badge/🏠_home-py--simple--wrap-3F51B5?style=for-the-badge)](https://sara-czasak.github.io/py-simple-wrap/)
 [![Docs](https://img.shields.io/badge/docs-online-blue?style=for-the-badge)](https://sara-czasak.github.io/py-simple-wrap/docs/)
-[![Contributor Hub](https://img.shields.io/badge/🤝_contributor_hub-start_here-b8863b?style=for-the-badge)](https://sara-czasak.github.io/py-simple-wrap/docs/contributor-hub/docstring_template/)
+[![Contributor Hub](https://img.shields.io/badge/🤝_contributor_hub-start_here-b8863b?style=for-the-badge)](https://sara-czasak.github.io/py-simple-wrap/docs/contributor-hub/)
 [![Contributors Quest](https://img.shields.io/badge/🗺️_contributors_quest-play_now-b8863b?style=for-the-badge)](https://sara-czasak.github.io/py-simple-wrap/quest/)
 
-[![PyPI](https://img.shields.io/pypi/v/py-simple-wrap?style=for-the-badge)](https://pypi.org/project/py-simple-wrap/)
 [![Contributors](https://img.shields.io/badge/contributors-25-orange?style=for-the-badge)](#contributors-)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)](https://github.com/sara-czasak/py-simple-wrap/blob/main/LICENSE.md)
 [![GitHub stars](https://img.shields.io/github/stars/sara-czasak/py-simple-wrap?style=for-the-badge)](https://github.com/sara-czasak/py-simple-wrap)
 
+[![Downloads/day](https://img.shields.io/pypi/dd/py-simple-wrap?style=for-the-badge)](https://pypistats.org/packages/py-simple-wrap)
+[![Downloads/week](https://img.shields.io/pypi/dw/py-simple-wrap?style=for-the-badge)](https://pypistats.org/packages/py-simple-wrap)
+[![Downloads/month](https://img.shields.io/pypi/dm/py-simple-wrap?style=for-the-badge)](https://pypistats.org/packages/py-simple-wrap)
+[![Latest version](https://img.shields.io/pypi/v/py-simple-wrap?style=for-the-badge)](https://pypi.org/project/py-simple-wrap/)
+
 
 py-simple-wrap is a beginner-friendly Python wrapper package designed to help beginners and developers perform common tasks using simple, intuitive functions.
 
@@ -198,8 +202,8 @@ py-simple-wrap provides simple modules designed to make common Python tasks easi
 
 <br>
 
-|------------------------------|---------------------------------------------|---------------------------------------------------------------|
 | Function                     | What it does                                | Example                                                       |
+|------------------------------|---------------------------------------------|---------------------------------------------------------------|
 | `truncate(text, length)`     | Shorten text and add an ellipsis            | `truncate("Hello world!", 5)` → `"Hello…"`                    |
 | `remove_punctuation(text)`   | Strip punctuation, keep letters and numbers | `remove_punctuation("Hello, world!")` → `"Hello world"`       |
 | `reverse_words(text)`        | Reverse the order of words                  | `reverse_words("Hello world")` → `"world Hello"`              |
@@ -495,6 +499,21 @@ py-simple-wrap provides simple modules designed to make common Python tasks easi
 
 </details>
 
+### 📈 Easy Data Visualization
+
+<details>
+<summary>Click to expand — auto-picks the right chart type for your data, no matplotlib boilerplate</summary>
+
+<br>
+
+| Function          | What it does                                                                                 | Example                                                        |
+|-------------------|----------------------------------------------------------------------------------------------|----------------------------------------------------------------|
+| `plot_data(X)`    | Infers whether `X` is quantitative or categorical and plots the right chart(s) automatically | `plot_data([1, 2, 2, 3, 5, 5, 5, 8])` → histogram + line chart |
+| `plot_data(X, Y)` | Same, but plots `X` against a second series `Y`                                              | `plot_data(["A", "B", "C"], [10, 20, 30])` → bar chart         |
+
+</details>
+
+
 ### 🎮 Easy Game
 
 <details>
@@ -513,6 +532,24 @@ py-simple-wrap provides simple modules designed to make common Python tasks easi
 
 </details>
 
+### 🎲 Easy Generator
+
+<details>
+<summary>Click to expand — passwords, QR codes, UUIDs, and API keys without the boilerplate</summary>
+
+<br>
+
+| Function                                                                   | What it does                                                     | Example                                                                                      |
+|----------------------------------------------------------------------------|------------------------------------------------------------------|----------------------------------------------------------------------------------------------|
+| `generate_password(16, uppercase_chars=3, digit_chars=3, special_chars=3)` | Generates a random password with no repeated adjacent characters | `generate_password(16, uppercase_chars=3, digit_chars=3, special_chars=3)` → `"Kx9!mQ2z..."` |
+| `generate_otp(6, with_letters=True)`                                       | Generates a random one-time password code                        | `generate_otp(6, with_letters=True)` → `"a1B9x3"`                                            |
+| `generate_api_key()`                                                       | Generates a secure, URL-safe API key                             | `generate_api_key()` → `"kZ8x...Q1w"`                                                        |
+| `generate_uuid()`                                                          | Generates a random UUID (version 4)                              | `generate_uuid()` → `"3f2504e0-4f89-11d3-9a0c-0305e82c3301"`                                 |
+| `generate_qr_code("https://example.com")`                                  | Generates a QR code image and saves it to disk                   | Saves `qrcode0.png` (or the next free filename)                                              |
+
+</details>
+
+
 ## 🤝 Contributing
 
 I would love to have your help in making Python simpler for everyone!
@@ -598,7 +635,7 @@ A huge thank you to these wonderful people for helping make Python simpler for e
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/smirnov-danil"><img src="https://github.com/smirnov-danil.png?s=80" width="80px;" alt="d.smirnov"/><br /><sub><b>d.smirnov</b></sub></a><br /><a href="https://github.com/sara-czasak/py_simple/commits?author=smirnov-danil" title="Code">💻</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/Venkat4real"><img src="https://github.com/Venkat4real.png?s=80" width="80px;" alt="Venkat"/><br /><sub><b>Venkat</b></sub></a><br /><a href="https://github.com/sara-czasak/py_simple/commits?author=Venkat4real" title="Docs">📖</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/E4x7k"><img src="https://github.com/E4x7k.png?s=80" width="80px;" alt="E4x7k"/><br /><sub><b>E4x7k</b></sub></a><br /><a href="https://github.com/sara-czasak/py_simple/commits?author=E4x7k" title="Docs">📖</a></td>
-      <td align="center" valign="top" width="14.28%"><a href="https://github.com/jbsilva"><img src="https://github.com/jbsilva.png?s=80" width="80px;" alt="Julio Batista Silva"/><br /><sub><b>Julio Batista Silva</b></sub></a><br /><a href="https://github.com/sara-czasak/py_simple/commits?author=jbsilva " title="Infrastructure">🚇</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/jbsilva"><img src="https://github.com/jbsilva.png?s=80" width="80px;" alt="Julio Batista Silva"/><br /><sub><b>Julio Batista Silva</b></sub></a><br /><a href="https://github.com/sara-czasak/py_simple/commits?author=jbsilva" title="Infrastructure">🚇</a></td>
     </tr>
   </tbody>
 </table>

py_simple_wrap-0.3.4/docs/contributor-hub/error_template.md

@@ -0,0 +1,95 @@
+# Custom Exception Template
+
+`py-simple-wrap` wraps risky operations (network calls, file I/O, JSON parsing, external libraries) so beginners get one clear, readable error instead of a random builtin traceback. This page is the template for adding a new custom exception when a module needs one.
+
+Modeled on the real exceptions already in the codebase — `SomethingWentWrongError` in `easy_web.py`, `EasyJsonError` in `easy_json.py`, `EasyFlowError`, `EasyAsyncError`, `EasyGameError`, `EasyGeneratorError`, `ImageProcessingError`, and `InvalidExtension` in `easy_file_manager.py` — all follow the same shape.
+
+## Why bother with a custom exception at all?
+
+If `easy_web.get_page_content()` just let `requests`' own exceptions bubble up, a beginner would see something like `requests.exceptions.ConnectionError` or `requests.exceptions.Timeout` — different exception types depending on *how* the network failed, none of which say anything about *py-simple-wrap*. A custom exception gives one predictable name per module (`SomethingWentWrongError`) that always means "this py_simple function couldn't do its job," with a plain-English message explaining why. Beginners can write one `except` clause instead of memorizing every exception type a third-party library might throw.
+
+## The template
+
+Copy this whole block and fill in the placeholders:
+
+````python
+class ModuleNameError(Exception):
+    """
+    Raised when <the specific situation this covers>.
+
+    <A sentence or two on what this covers and, importantly, what it
+    does NOT cover — e.g. "this is only for real failures; a function
+    that can succeed with an empty result returns None/[] instead of
+    raising.">
+
+    Args:
+        message (str): Description of what went wrong, usually
+            including the original error message.
+    """
+    def __init__(self, message):
+        self.message = message
+        super().__init__(self.message)
+````
+
+And where you raise it, wrap the risky call:
+
+````python
+def do_the_risky_thing(...):
+    """... normal docstring ..."""
+    try:
+        return _actually_risky_stdlib_or_third_party_call(...)
+    except Exception as e:
+        raise ModuleNameError(f"Couldn't do the thing: {e}") from None
+````
+
+## Rules of thumb
+
+- **Name it `<Module>Error`.** `SomethingWentWrongError`, `EasyJsonError`, `EasyFlowError` all follow this. (`InvalidExtension` in `easy_file_manager.py` is the one exception to the pattern in this codebase — new exceptions should still follow `<Module>Error` rather than add another one-off name.)
+- **Always subclass `Exception` directly**, not a more specific builtin like `ValueError` or `IOError`. Every custom exception in this codebase does this — it keeps the public API surface to one predictable exception type per module, rather than making users guess which builtin subclass a given failure maps to.
+- **Store the message and call `super().__init__()`** exactly like the template — this is what makes `str(the_exception)` and `print(the_exception)` show the readable message, and keeps the exception compatible with normal Python exception handling.
+- **Use `raise ModuleError(...) from None`** when wrapping another exception. The `from None` suppresses Python's "During handling of the above exception, another exception occurred" chained traceback — a beginner doesn't need to see `requests`' internal stack trace, they need to see *your* message. Compare `easy_web.py`'s `get_page_content` for a real example.
+- **Only raise for real failures.** If a function can reasonably return "nothing found" (an empty list, `None`), do that instead of raising — this is called out explicitly in `SomethingWentWrongError`'s own docstring. Custom exceptions are for "the operation could not complete," not "the operation completed and found nothing."
+- **Document what it does and doesn't cover** in the exception's own docstring, not just in the function that raises it — someone catching `EasyJsonError` should be able to read its docstring alone and know what triggers it.
+
+## A minimal worked example
+
+```python
+class EasyColorsError(Exception):
+    """
+    Raised when a color value can't be parsed or converted.
+
+    Covers malformed hex codes, out-of-range RGB values, and any other
+    input that isn't a valid color py_simple can work with.
+
+    Args:
+        message (str): Description of what went wrong.
+    """
+    def __init__(self, message):
+        self.message = message
+        super().__init__(self.message)
+
+
+def hex_to_rgb(hex_code: str) -> tuple:
+    """... docstring ..."""
+    try:
+        hex_code = hex_code.lstrip("#")
+        return tuple(int(hex_code[i:i+2], 16) for i in (0, 2, 4))
+    except (ValueError, IndexError) as e:
+        raise EasyColorsError(f"'{hex_code}' isn't a valid hex color: {e}") from None
+```
+
+And how a user of the package would catch it today:
+
+```python
+from py_simple import hex_to_rgb
+from py_simple.easy_colors import EasyColorsError
+
+try:
+    rgb = hex_to_rgb("not-a-color")
+except EasyColorsError as e:
+    print(f"Oops: {e}")
+```
+
+## A known gap worth knowing about
+
+None of the eight existing custom exceptions (`SomethingWentWrongError`, `EasyJsonError`, `EasyFlowError`, `EasyAsyncError`, `EasyGameError`, `EasyGeneratorError`, `ImageProcessingError`, `InvalidExtension`) are currently exported from `py_simple/__init__.py` — only functions are. That means today, catching any of them requires importing from the submodule directly (`from py_simple.easy_web import SomethingWentWrongError`), not the flatter `from py_simple import ...` style every function in this package uses. This is inconsistent with the project's whole "simple, flat imports" philosophy, but it's the current reality, not a documentation error — worth raising with the maintainer as its own fix rather than quietly working around it here.

py_simple_wrap-0.3.4/docs/contributor-hub/index.md

@@ -0,0 +1,20 @@
+# Contributor Hub
+
+New here, or making your first contribution to an open-source project ever? You're in the right place. Nobody expects you to already know how this project formats things — that's what this page is for.
+
+Pick whatever's stressing you out below, and go straight to it. You don't need to read all of it, and you don't need to read it in order.
+
+## What do you need help with?
+
+**📝 "I need to write a docstring and I don't know what that even means."**
+Totally normal. The [Docstring Template](docstring_template.md) has a copy-paste block — just fill in the blanks. It also explains *why* the format looks the way it does, in case you're curious, but you don't have to read that part to use it.
+
+**📖 "I added a new module and need to write a tutorial page, but I've never written docs before."**
+The [Tutorial Template](tutorial_template.md) walks through the exact structure every tutorial page in this project uses, with a real example to copy from. You're not writing from a blank page.
+
+**🚨 "My function needs to raise an error, and I don't know how this project wants errors to look."**
+The [Custom Exception Template](error_template.md) has a fill-in-the-blanks class definition, plus a worked example showing both raising and catching it. Errors sound intimidating, but the pattern here is always the same one — once you've seen it once, you'll recognize it everywhere in this codebase.
+
+## Still stuck, or something's not covered here?
+
+That's okay too. Open an issue, or mention it in your pull request, and it'll get sorted out together — see [CONTRIBUTING.md](https://github.com/sara-czasak/py-simple-wrap/blob/main/CONTRIBUTING.md) for how to reach out. Nobody's expected to figure this out alone.

{py_simple_wrap-0.3.2 → py_simple_wrap-0.3.4/py_simple_package/src/py_simple_wrap.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: py_simple_wrap
-Version: 0.3.2
+Version: 0.3.4
 Summary: A package to make complex python functionality simple
 Author-email: Sara Czasak <sara.p.czasak.m@gmail.com>
 Maintainer: jagjitkaur0000, atiqur-rahman-pro, Gaohar Imran, Yassin Azzouzi
@@ -74,14 +74,18 @@ Dynamic: license-file
 
 [![Home](https://img.shields.io/badge/🏠_home-py--simple--wrap-3F51B5?style=for-the-badge)](https://sara-czasak.github.io/py-simple-wrap/)
 [![Docs](https://img.shields.io/badge/docs-online-blue?style=for-the-badge)](https://sara-czasak.github.io/py-simple-wrap/docs/)
-[![Contributor Hub](https://img.shields.io/badge/🤝_contributor_hub-start_here-b8863b?style=for-the-badge)](https://sara-czasak.github.io/py-simple-wrap/docs/contributor-hub/docstring_template/)
+[![Contributor Hub](https://img.shields.io/badge/🤝_contributor_hub-start_here-b8863b?style=for-the-badge)](https://sara-czasak.github.io/py-simple-wrap/docs/contributor-hub/)
 [![Contributors Quest](https://img.shields.io/badge/🗺️_contributors_quest-play_now-b8863b?style=for-the-badge)](https://sara-czasak.github.io/py-simple-wrap/quest/)
 
-[![PyPI](https://img.shields.io/pypi/v/py-simple-wrap?style=for-the-badge)](https://pypi.org/project/py-simple-wrap/)
 [![Contributors](https://img.shields.io/badge/contributors-25-orange?style=for-the-badge)](#contributors-)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)](https://github.com/sara-czasak/py-simple-wrap/blob/main/LICENSE.md)
 [![GitHub stars](https://img.shields.io/github/stars/sara-czasak/py-simple-wrap?style=for-the-badge)](https://github.com/sara-czasak/py-simple-wrap)
 
+[![Downloads/day](https://img.shields.io/pypi/dd/py-simple-wrap?style=for-the-badge)](https://pypistats.org/packages/py-simple-wrap)
+[![Downloads/week](https://img.shields.io/pypi/dw/py-simple-wrap?style=for-the-badge)](https://pypistats.org/packages/py-simple-wrap)
+[![Downloads/month](https://img.shields.io/pypi/dm/py-simple-wrap?style=for-the-badge)](https://pypistats.org/packages/py-simple-wrap)
+[![Latest version](https://img.shields.io/pypi/v/py-simple-wrap?style=for-the-badge)](https://pypi.org/project/py-simple-wrap/)
+
 
 py-simple-wrap is a beginner-friendly Python wrapper package designed to help beginners and developers perform common tasks using simple, intuitive functions.
 
@@ -265,8 +269,8 @@ py-simple-wrap provides simple modules designed to make common Python tasks easi
 
 <br>
 
-|------------------------------|---------------------------------------------|---------------------------------------------------------------|
 | Function                     | What it does                                | Example                                                       |
+|------------------------------|---------------------------------------------|---------------------------------------------------------------|
 | `truncate(text, length)`     | Shorten text and add an ellipsis            | `truncate("Hello world!", 5)` → `"Hello…"`                    |
 | `remove_punctuation(text)`   | Strip punctuation, keep letters and numbers | `remove_punctuation("Hello, world!")` → `"Hello world"`       |
 | `reverse_words(text)`        | Reverse the order of words                  | `reverse_words("Hello world")` → `"world Hello"`              |
@@ -562,6 +566,21 @@ py-simple-wrap provides simple modules designed to make common Python tasks easi
 
 </details>
 
+### 📈 Easy Data Visualization
+
+<details>
+<summary>Click to expand — auto-picks the right chart type for your data, no matplotlib boilerplate</summary>
+
+<br>
+
+| Function          | What it does                                                                                 | Example                                                        |
+|-------------------|----------------------------------------------------------------------------------------------|----------------------------------------------------------------|
+| `plot_data(X)`    | Infers whether `X` is quantitative or categorical and plots the right chart(s) automatically | `plot_data([1, 2, 2, 3, 5, 5, 5, 8])` → histogram + line chart |
+| `plot_data(X, Y)` | Same, but plots `X` against a second series `Y`                                              | `plot_data(["A", "B", "C"], [10, 20, 30])` → bar chart         |
+
+</details>
+
+
 ### 🎮 Easy Game
 
 <details>
@@ -580,6 +599,24 @@ py-simple-wrap provides simple modules designed to make common Python tasks easi
 
 </details>
 
+### 🎲 Easy Generator
+
+<details>
+<summary>Click to expand — passwords, QR codes, UUIDs, and API keys without the boilerplate</summary>
+
+<br>
+
+| Function                                                                   | What it does                                                     | Example                                                                                      |
+|----------------------------------------------------------------------------|------------------------------------------------------------------|----------------------------------------------------------------------------------------------|
+| `generate_password(16, uppercase_chars=3, digit_chars=3, special_chars=3)` | Generates a random password with no repeated adjacent characters | `generate_password(16, uppercase_chars=3, digit_chars=3, special_chars=3)` → `"Kx9!mQ2z..."` |
+| `generate_otp(6, with_letters=True)`                                       | Generates a random one-time password code                        | `generate_otp(6, with_letters=True)` → `"a1B9x3"`                                            |
+| `generate_api_key()`                                                       | Generates a secure, URL-safe API key                             | `generate_api_key()` → `"kZ8x...Q1w"`                                                        |
+| `generate_uuid()`                                                          | Generates a random UUID (version 4)                              | `generate_uuid()` → `"3f2504e0-4f89-11d3-9a0c-0305e82c3301"`                                 |
+| `generate_qr_code("https://example.com")`                                  | Generates a QR code image and saves it to disk                   | Saves `qrcode0.png` (or the next free filename)                                              |
+
+</details>
+
+
 ## 🤝 Contributing
 
 I would love to have your help in making Python simpler for everyone!
@@ -665,7 +702,7 @@ A huge thank you to these wonderful people for helping make Python simpler for e
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/smirnov-danil"><img src="https://github.com/smirnov-danil.png?s=80" width="80px;" alt="d.smirnov"/><br /><sub><b>d.smirnov</b></sub></a><br /><a href="https://github.com/sara-czasak/py_simple/commits?author=smirnov-danil" title="Code">💻</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/Venkat4real"><img src="https://github.com/Venkat4real.png?s=80" width="80px;" alt="Venkat"/><br /><sub><b>Venkat</b></sub></a><br /><a href="https://github.com/sara-czasak/py_simple/commits?author=Venkat4real" title="Docs">📖</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/E4x7k"><img src="https://github.com/E4x7k.png?s=80" width="80px;" alt="E4x7k"/><br /><sub><b>E4x7k</b></sub></a><br /><a href="https://github.com/sara-czasak/py_simple/commits?author=E4x7k" title="Docs">📖</a></td>
-      <td align="center" valign="top" width="14.28%"><a href="https://github.com/jbsilva"><img src="https://github.com/jbsilva.png?s=80" width="80px;" alt="Julio Batista Silva"/><br /><sub><b>Julio Batista Silva</b></sub></a><br /><a href="https://github.com/sara-czasak/py_simple/commits?author=jbsilva " title="Infrastructure">🚇</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/jbsilva"><img src="https://github.com/jbsilva.png?s=80" width="80px;" alt="Julio Batista Silva"/><br /><sub><b>Julio Batista Silva</b></sub></a><br /><a href="https://github.com/sara-czasak/py_simple/commits?author=jbsilva" title="Infrastructure">🚇</a></td>
     </tr>
   </tbody>
 </table>

{py_simple_wrap-0.3.2 → py_simple_wrap-0.3.4}/py_simple_package/src/py_simple_wrap.egg-info/SOURCES.txt

@@ -7,6 +7,8 @@ docs/readme.md
 docs/about/contributors.md
 docs/about/license.md
 docs/contributor-hub/docstring_template.md
+docs/contributor-hub/error_template.md
+docs/contributor-hub/index.md
 docs/contributor-hub/tutorial_template.md
 docs/how-to/contributing.md
 docs/reference/easy_async.md

{py_simple_wrap-0.3.2 → py_simple_wrap-0.3.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "py_simple_wrap"
-version = "0.3.2"
+version = "0.3.4"
 authors = [
   { name="Sara Czasak", email="sara.p.czasak.m@gmail.com" },
 ]