https://github.com/liblaf/grapes

🍇 Supercharge your Python with rich logging, precise timing, and seamless serialization.
https://github.com/liblaf/grapes

cli documentation library logging mkdocs progress-bar python rich serialization timer

Last synced: 4 months ago
JSON representation

🍇 Supercharge your Python with rich logging, precise timing, and seamless serialization.

• Host: GitHub
• URL: https://github.com/liblaf/grapes
• Owner: liblaf
• License: mit
• Created: 2025-01-13T07:56:21.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2026-01-25T01:08:59.000Z (5 months ago)
• Last Synced: 2026-01-25T14:44:29.262Z (5 months ago)
• Topics: cli, documentation, library, logging, mkdocs, progress-bar, python, rich, serialization, timer
• Language: Python
• Homepage: https://liblaf-grapes.readthedocs.io
• Size: 3.59 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](https://socialify.git.ci/liblaf/grapes/image?description=1&forks=1&issues=1&language=1&logo=https%3A%2F%2Fraw.githubusercontent.com%2Fmicrosoft%2Ffluentui-emoji%2Frefs%2Fheads%2Fmain%2Fassets%2FGrapes%2F3D%2Fgrapes_3d.png&name=1&owner=1&pattern=Transparent&pulls=1&stargazers=1&theme=Auto)

**[Explore the docs »](https://liblaf.github.io/grapes/)**

[![codecov](https://codecov.io/gh/liblaf/grapes/graph/badge.svg)](https://codecov.io/gh/liblaf/grapes)

[![MegaLinter](https://github.com/liblaf/grapes/actions/workflows/mega-linter.yaml/badge.svg)](https://github.com/liblaf/grapes/actions/workflows/mega-linter.yaml)

[![Test](https://github.com/liblaf/grapes/actions/workflows/test.yaml/badge.svg)](https://github.com/liblaf/grapes/actions/workflows/test.yaml)

[![pre-commit.ci status](https://results.pre-commit.ci/badge/github/liblaf/grapes/main.svg)](https://results.pre-commit.ci/latest/github/liblaf/grapes/main)

[![CodSpeed Badge](https://img.shields.io/endpoint?url=https://codspeed.io/badge.json)](https://codspeed.io/liblaf/grapes)

[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)

[![PyPI - Downloads](https://img.shields.io/pypi/dm/liblaf-grapes?logo=PyPI&label=Downloads)](https://pypi.org/project/liblaf-grapes)

[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/liblaf-grapes?logo=Python&label=Python)](https://pypi.org/project/liblaf-grapes)

[![PyPI - Version](https://img.shields.io/pypi/v/liblaf-grapes?logo=PyPI&label=PyPI)](https://pypi.org/project/liblaf-grapes)

[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)

![](https://cdn.jsdelivr.net/gh/andreasbm/readme/assets/lines/rainbow.png)



## ✨ 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:

```bash

uv add liblaf-grapes

```

## ⌨️ Local Development

You can use Github Codespaces for online development:

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

Or clone it for local development:

```bash

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](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.nn.ci/api?repo=liblaf/grapes)](https://github.com/liblaf/grapes/graphs/contributors)

## 🔗 More Projects

- **[🍇 Grapes](https://github.com/liblaf/grapes)** - Supercharge your Python with rich logging, precise timing, and seamless serialization.

- **[🍉 Melon](https://github.com/liblaf/melon)** - A comprehensive Python library for 3D mesh processing with advanced I/O capabilities, proximity analysis, and integration with external mesh processing tools.

- **[🍊 Tangerine](https://github.com/liblaf/tangerine)** - Squeeze dynamic content into your files with Tangerine's template magic.

- **[🍋‍🟩 Lime](https://github.com/liblaf/lime)** - AI-powered Git commit assistant and repository documentation generator

- **[🍎 Apple](https://github.com/liblaf/apple)** - A JAX and Warp library for differentiable physics simulation, featuring elastic energy models and finite element methods.

- **[🍒 Cherries](https://github.com/liblaf/cherries)** - Sweet experiment tracking with Comet, DVC, and Git integration.

---

#### 📝 License

Copyright © 2025 [liblaf](https://github.com/liblaf). 


This project is [MIT](https://github.com/liblaf/grapes/blob/main/LICENSE) licensed.