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 »

Changelog · Report Bug · Request Feature

✨ 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.

📦 Installation¤

To install liblaf-grapes, run the following command:

$ uv add liblaf-grapes

⌨️ Local Development¤

You can use Github Codespaces for online development:

Or clone it for local development:

$ gh repo clone liblaf/grapes
$ cd grapes
$ just test

🤝 Contributing¤

Contributions of all types are more than welcome, if you are interested in contributing code, feel free to check out our GitHub Issues to get stuck in to show us what you're made of.

🔗 Links¤

More Projects¤

🍇 grapes - Powerful Python utilities for logging, timing, and more, making development smoother!

Credits¤

Python - https://www.python.org/