Metadata-Version: 2.4
Name: liblaf-grapes
Version: 0.1.1
Summary: Add your description here
Project-URL: Changelog, https://github.com/liblaf/grapes/blob/main/CHANGELOG.md
Project-URL: Documentation, https://liblaf.github.io/grapes/
Project-URL: Homepage, https://github.com/liblaf/grapes
Project-URL: Issue Tracker, https://github.com/liblaf/grapes/issues
Project-URL: Release Notes, https://github.com/liblaf/grapes/releases
Project-URL: Source Code, https://github.com/liblaf/grapes
Author-email: liblaf <30631553+liblaf@users.noreply.github.com>
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Requires-Python: >=3.12
Requires-Dist: about-time<5,>=4.2.1
Requires-Dist: autoregistry<2,>=1.1.2
Requires-Dist: environs<15,>=14.1.1
Requires-Dist: etils<2,>=1.12.0
Requires-Dist: lazy-loader<0.5,>=0.4
Requires-Dist: loguru<0.8,>=0.7.3
Requires-Dist: pydantic<3,>=2.10.6
Requires-Dist: rich<14,>=13.9.4
Requires-Dist: ruamel-yaml<0.19,>=0.18.10
Requires-Dist: tomlkit<0.14,>=0.13.2
Description-Content-Type: text/markdown

<div align="center" markdown><a name="readme-top"></a>

<img height="160" src="https://raw.githubusercontent.com/microsoft/fluentui-emoji/main/assets/Grapes/3D/grapes_3d.png" />

<h1>Grapes</h1>

Grapes is a comprehensive Python utility library offering robust tools for environment configuration, human-readable formatting, logging, progress tracking, serialization, and timing. Built with extensibility and performance in mind, it integrates seamlessly with popular libraries like Pydantic, Loguru, and Rich, providing developers with a powerful toolkit for building efficient and maintainable applications. <br />
[**Explore the docs »**](https://liblaf.github.io/grapes/)

[![PyPI - Version](https://img.shields.io/pypi/v/liblaf-grapes?logo=PyPI&logoColor=3775A9&label=PyPI)](https://pypi.org/project/liblaf-grapes/)
[![PyPI - Downloads](https://img.shields.io/pypi/dm/liblaf-grapes?logo=PyPI&logoColor=3775A9)](https://pypi.org/project/liblaf-grapes/)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/liblaf-grapes?logo=Python&logoColor=3776AB&label=Python)](https://pypi.org/project/liblaf-grapes/) <br />
[![GitHub contributors](https://img.shields.io/github/contributors/liblaf/grapes)](https://github.com/liblaf/grapes/graphs/contributors)
[![GitHub forks](https://img.shields.io/github/forks/liblaf/grapes)](https://github.com/liblaf/grapes/forks)
[![GitHub Repo stars](https://img.shields.io/github/stars/liblaf/grapes)](https://github.com/liblaf/grapes/stargazers)
[![GitHub Issues](https://img.shields.io/github/issues/liblaf/grapes)](https://github.com/liblaf/grapes/issues)
[![GitHub License](https://img.shields.io/github/license/liblaf/grapes)](https://github.com/liblaf/grapes/blob/main/LICENSE)

[Changelog](https://github.com/liblaf/grapes/blob/main/CHANGELOG.md) · [Report Bug](https://github.com/liblaf/grapes/issues) · [Request Feature](https://github.com/liblaf/grapes/issues)

![banner](https://raw.githubusercontent.com/andreasbm/readme/master/assets/lines/rainbow.png)

</div>

## ✨ Features

- 🍇 **Comprehensive Utility Library:** A rich collection of utility functions and classes to enhance your Python projects, covering a wide range of common tasks.
- ⚡ **High-Performance Timing:** Advanced timing utilities for precise performance measurement, including support for multiple time counters and human-readable duration formatting.
- 📊 **Progress Tracking:** Elegant progress bar and tracking functionality with customizable columns, making it easy to monitor the progress of long-running tasks.
- 🗂️ **Serialization and Deserialization:** Flexible and efficient data serialization and deserialization for JSON, TOML, YAML, and Pydantic models, ensuring seamless data handling.
- 📝 **Human-Readable Formats:** Functions to convert numerical values into human-readable formats, such as durations, counts, and throughput, enhancing the readability of your application's output.
- 🛠️ **Environment Configuration:** Simplified environment configuration management, allowing you to easily read and manage environment variables with a prefix.
- 🎨 **Rich Logging Integration:** Enhanced logging with Rich, Loguru, and IceCream, providing colorful, detailed, and user-friendly log outputs.
- 🧪 **Optional Imports:** Graceful handling of optional dependencies, ensuring that your application can run smoothly even if some dependencies are missing.
- 📄 **Text Processing:** Utilities for text processing, including comment stripping, to help clean up and process text data efficiently.
- 🤝 **Extensive Documentation:** Detailed and well-structured documentation, making it easy to understand and use the library's features.

<div align="right" markdown>

[![BACK TO TOP](https://img.shields.io/badge/-BACK_TO_TOP-black?style=flat-square)](#readme-top)

</div>

## 📦 Installation

To install `liblaf-grapes`, run the following command:

```bash
uv tool install liblaf-grapes
```

<div align="right" markdown>

[![BACK TO TOP](https://img.shields.io/badge/-BACK_TO_TOP-black?style=flat-square)](#readme-top)

</div>

## ⌨️ Local Development

You can use Github Codespaces for online development:

[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/liblaf/grapes)

Or clone it for local development:

```bash
git clone https://github.com/liblaf/grapes.git
cd grapes
eval "$(pixi shell-hook)"
```

<div align="right" markdown>

[![BACK TO TOP](https://img.shields.io/badge/-BACK_TO_TOP-black?style=flat-square)](#readme-top)

</div>

## 🤝 Contributing

Contributions of all types are more than welcome, if you are interested in contributing code, feel free to check out our GitHub [Issues](https://github.com/liblaf/grapes/issues) to get stuck in to show us what you're made of.

[![🤯 PR WELCOME](https://img.shields.io/badge/%F0%9F%A4%AF%20PR%20WELCOME-%E2%86%92-ffcb47?labelColor=black&style=for-the-badge)](https://github.com/liblaf/grapes/pulls)

[![Contributors](https://contrib.rocks/image?repo=liblaf%2Fgrapes)](https://github.com/liblaf/grapes/graphs/contributors)

<div align="right" markdown>

[![BACK TO TOP](https://img.shields.io/badge/-BACK_TO_TOP-black?style=flat-square)](#readme-top)

</div>

---

#### 📝 License

Copyright © 2025 [liblaf](https://github.com/liblaf). <br />
This project is [MIT](https://github.com/liblaf/grapes/blob/main/LICENSE) licensed.
