Metadata-Version: 2.4
Name: handybox
Version: 0.2.0
Summary: A lightweight toolbox of handy Python helper functions
Author-email: Gabriel Valentoni Guelfi <gabriel.valguelfi@gmail.com>
License: MIT License 
         
        Copyright (c) 2021 Dynamo PHP Community 
         
        Permission is hereby granted, free of charge, to any person obtaining a 
        copy 
        of this software and associated documentation files (the "Software"), to 
        deal 
        in the Software without restriction, including without limitation the 
        rights 
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 
        copies of the Software, and to permit persons to whom the Software is 
        furnished to do so, subject to the following conditions: 
         
        The above copyright notice and this permission notice shall be included in 
        all 
        copies or substantial portions of the Software. 
         
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL 
        THE 
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING 
        FROM, 
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN 
        THE 
        SOFTWARE.
Keywords: utilities,helpers,toolkit,python
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# handybox

*A lightweight toolbox of handy Python helper functions*

[![PyPI version](https://badge.fury.io/py/handybox.svg)](https://pypi.org/project/handybox/)

## 📦 Installation
Install using pip:

```bash
pip install handybox
```

## 📘 Description
**handybox** is a compact Python utility library that offers a curated set of useful helper functions for everyday development. It avoids bloat, has no dependencies, and is built for clarity and speed.

## 🔧 Features

### 🔤 String Utilities
- `camelToSnake(str)` — Converts CamelCase strings to snake_case.
- `slugify(str)` — Converts a string into a URL-friendly slug.

```python
from handybox import camelToSnake, slugify

camelToSnake("MyVariableName")   # "my_variable_name"
slugify("Hello, World!")           # "hello-world"
```

### 📅 Date Utilities
- `nowiso()` — Returns the current datetime in ISO format.
- `todayStr()` — Returns today’s date as a string (YYYY-MM-DD).

```python
from handybox import nowiso, todayStr

nowiso()     # "2025-05-01T17:45:00.123456"
todayStr()   # "2025-05-01"
```

### 🧰 Miscelaneous Utilities
- `uniqid(prefix="")` — Generates a unique ID string, similar to PHP’s `uniqid()`.

```python
from handybox import uniqid

uniqid()             # "f5e3a9c0b1d2"
uniqid("user")      # "user-f5e3a9c0b1d2"
```

## 🚀 Why handybox?
- ✅ Lightweight and dependency-free  
- ✅ Easy to install and use  
- ✅ Common utilities in one place  
- ✅ Minimal API surface  
- ✅ Built for real-world usage  

## 📄 License
MIT License  
© 2025 Gabriel Valentoni Guelfi

## 👤 Author
**Gabriel Valentoni Guelfi**  
📧 [gabriel.valguelfi@gmail.com](mailto:gabriel.valguelfi@gmail.com)  
🔗 [LinkedIn](https://www.linkedin.com/in/gabriel-valentoni-guelfi/)
