Skip to content
/ grapes Public

πŸ‡ Supercharge your Python with rich logging, precise timing, and seamless serialization.

License

liblaf/grapes

✨ Features

  • 🎨 Rich Logging: Beautiful, structured logging with loguru integration, multiple output formats (rich console, JSONL, file), and customizable profiles for different environments;
  • ⏱️ Precise Timing: Easy-to-use timing decorators and context managers with detailed statistics (mean, median, stdev) and automatic logging integration;
  • πŸ“¦ Multi-Format Serialization: Unified interface for JSON, TOML, and YAML serialization with Pydantic model support and customizable encoding/decoding hooks;
  • πŸ‘₯ Human-Readable Formats: Intelligent conversion of numbers, durations, and throughput into human-readable strings with appropriate units and precision;
  • πŸ”„ Progress Tracking: Integrated progress bars with rich visualization, timing integration, and parallel processing support through joblib;
  • βš™οΈ Smart Configuration: Environment-aware configuration system using Pydantic with automatic environment variable parsing and type-safe settings.

πŸ“¦ 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
mise run install

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

PR Welcome

Contributors

πŸ”— More Projects

  • πŸ‡ Grapes - Supercharge your Python with rich logging, precise timing, and seamless serialization.
  • πŸ‰ Melon - A comprehensive Python library for 3D mesh processing with advanced I/O capabilities, proximity analysis, and integration with external mesh processing tools.
  • 🍊 Tangerine - Squeeze dynamic content into your files with Tangerine's template magic.
  • πŸ‹β€πŸŸ© Lime - AI-powered Git commit assistant and repository documentation generator
  • 🍎 Apple - A JAX and Warp library for differentiable physics simulation, featuring elastic energy models and finite element methods.
  • πŸ’ Cherries - Sweet experiment tracking with Comet, DVC, and Git integration.

πŸ“ License

Copyright Β© 2025 liblaf.
This project is MIT licensed.

About

πŸ‡ Supercharge your Python with rich logging, precise timing, and seamless serialization.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Sponsor this project

Packages

No packages published

Contributors 6