Metadata-Version: 2.4
Name: utlib
Version: 0.2.0
Summary: A utility library that contains useful functions, decorators and more
Author-email: Myroslav Repin <myroslavrepin@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/MyroslavRepin/utlib
Keywords: utilities,decorators,tools
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# Utlib - Utility Library

**utlib** is a lightweight and customizable utility library designed to simplify everyday Python programming.  
Created by Myroslav Repin, the project is in **active development** and will continue to grow with new features and improvements.

---

## ✨ Current Features

- `digit_sum(n)`
  - Returns the sum of all digits in an integer.
  - Example: `digit_sum(1234)` → `10`

- `is_polindrome(text)`
  - Checks if a given string is a palindrome (reads the same forwards and backwards).
  - Example: `is_polindrome("level")` → `True`

- `word_count(text)`
  - Returns the number of words in a given text.
  - Example: `word_count("Hello world!")` → `2`

- `vowels(lang='eng', consonants=False)` 
  - Returns the list of vowels of supported languages including: English (eng), Russian (ru), Spanish (es), French (fr), German (de)
  - Using secong parametr of the function you can select which list you want to return: vowels or consonants

- `average_value(values, decimal)`
  - Returns the average of a list of numbers, rounded to the given decimal places.
  - Planned to add a functionality to get the nearest value
  - If `nearest=True`, returns the value from the list closest to the average.
  - **Note**: the output is **Decimal** class
  - Example:
    ```python
    average_value([1, 2, 3, 4, 5], 2)        # → 3.00
    average_value([1, 2, 3, 4, 5], 6)  # → 3.000000
    ```

---

## 🚧 Planned Features

- **Advanced math helpers**  
- Filtering tools  
- *AI-based utilities*  
- Custom data structures  
- Useful decorators and wrappers
- Useful function

---

## 📦 Installation

To install the latest version from [PyPI](https://pypi.org/project/utlib), use:

``` bash
pip install utlib
````

---

## 📄 Documentation

Official documentation is coming soon.
For now, explore the source code and **README** to understand available functionality.

If you have any ideas or requests for the documentation, feel free to share!

---

## 💌 Feedback & Contact

If you find a bug or want to request a feature:

📧 Email: [myroslavrepin@gmail.com](mailto:myroslavrepin@gmail.com)
📁 GitHub: [github.com/MyroslavRepin/utlib](https://github.com/MyroslavRepin/utlib)


---

## 📌 License

This project is licensed under the [MIT License](LICENSE).

```
