Skip to main content

Add your description here

Project description

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 »

PyPI - Downloads PyPI - Python Version PyPI - Version Codecov GitHub Actions Workflow Status
GitHub Contributors GitHub Forks GitHub Repo Stars GitHub Issues GitHub License

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


📝 License

Copyright © 2025 liblaf.
This project is MIT licensed.

Release history Release notifications | RSS feed

This version

1.1.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

liblaf_grapes-1.1.0.tar.gz (33.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

liblaf_grapes-1.1.0-py3-none-any.whl (70.1 kB view details)

Uploaded Python 3

File details

Details for the file liblaf_grapes-1.1.0.tar.gz.

File metadata

  • Download URL: liblaf_grapes-1.1.0.tar.gz
  • Upload date:
  • Size: 33.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for liblaf_grapes-1.1.0.tar.gz
Algorithm Hash digest
SHA256 0db2758feb5f42d6f8750b128d53862852c9067bd6ed355d5215e3f4345033b7
MD5 6672989f5c9c873c6a0c022cb5d62b9d
BLAKE2b-256 639c6231da745e3ec2dc9d72c1af9cec357e3dc639310b538327132696082722

See more details on using hashes here.

Provenance

The following attestation bundles were made for liblaf_grapes-1.1.0.tar.gz:

Publisher: release.yaml on liblaf/grapes

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file liblaf_grapes-1.1.0-py3-none-any.whl.

File metadata

  • Download URL: liblaf_grapes-1.1.0-py3-none-any.whl
  • Upload date:
  • Size: 70.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for liblaf_grapes-1.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 d8d7d5f816414520f17ad85f2bba39ba05a2237f62f1a4fa8a0f0b8b70af5581
MD5 c3c427ce0b66b1e1498404fcfc68c56a
BLAKE2b-256 c7543fdea60b7ab806d59707c98b49ae3723d68a331e2fe47fdabb8c61e0c5fb

See more details on using hashes here.

Provenance

The following attestation bundles were made for liblaf_grapes-1.1.0-py3-none-any.whl:

Publisher: release.yaml on liblaf/grapes

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page