https://github.com/liblaf/grapes
🍇 Powerful Python utilities for logging, timing, and more, making development smoother!
https://github.com/liblaf/grapes
cli documentation library logging mkdocs progress-bar python rich serialization timer
Last synced: 24 days ago
JSON representation
🍇 Powerful Python utilities for logging, timing, and more, making development smoother!
- Host: GitHub
- URL: https://github.com/liblaf/grapes
- Owner: liblaf
- License: mit
- Created: 2025-01-13T07:56:21.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-04-13T03:21:42.000Z (25 days ago)
- Last Synced: 2025-04-13T04:27:06.776Z (25 days ago)
- Topics: cli, documentation, library, logging, mkdocs, progress-bar, python, rich, serialization, timer
- Language: Python
- Homepage: https://liblaf.github.io/grapes/
- Size: 2.01 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Grapes
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.
[**Explore the docs »**](https://liblaf.github.io/grapes/)
[](https://pypi.org/project/liblaf-grapes)
[](https://pypi.org/project/liblaf-grapes)
[](https://pypi.org/project/liblaf-grapes)
[](https://codecov.io/gh/liblaf/grapes)
[](https://github.com/liblaf/grapes/actions/workflows/test.yaml)
[](https://github.com/liblaf/grapes/graphs/contributors)
[](https://github.com/liblaf/grapes/forks)
[](https://github.com/liblaf/grapes/stargazers)
[](https://github.com/liblaf/grapes/issues)
[](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)
## ✨ 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.
[](#readme-top)
## 📦 Installation
To install `liblaf-grapes`, run the following command:
```bash
$ uv add liblaf-grapes
```
[](#readme-top)
## ⌨️ Local Development
You can use Github Codespaces for online development:
[](https://codespaces.new/liblaf/grapes)
Or clone it for local development:
```bash
$ gh repo clone liblaf/grapes
$ cd grapes
$ just test
```
[](#readme-top)
## 🤝 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.
[](https://github.com/liblaf/grapes/pulls)
[](https://github.com/liblaf/grapes/graphs/contributors)
[](#readme-top)
## 🔗 Links
### More Projects
- **[🍇 grapes](https://github.com/liblaf/grapes)** - Powerful Python utilities for logging, timing, and more, making development smoother!
### Credits
- **Python** -
[](#readme-top)
---
#### 📝 License
Copyright © 2025 [liblaf](https://github.com/liblaf).
This project is [MIT](https://github.com/liblaf/grapes/blob/main/LICENSE) licensed.