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

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-2.0.1.tar.gz (32.2 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-2.0.1-py3-none-any.whl (66.5 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for liblaf_grapes-2.0.1.tar.gz
Algorithm Hash digest
SHA256 e2b0ca4a596a234162df0810f1f34ac2a8640daddf8debe1d8c1db1d57e44959
MD5 cc396bcf19f32d6290524d350d889dac
BLAKE2b-256 2985b1dc43726f47ba8a30a3fa1c26b30bf96c5f751a052f906c36565cd5b1da

See more details on using hashes here.

Provenance

The following attestation bundles were made for liblaf_grapes-2.0.1.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-2.0.1-py3-none-any.whl.

File metadata

  • Download URL: liblaf_grapes-2.0.1-py3-none-any.whl
  • Upload date:
  • Size: 66.5 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-2.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 0055084152cb2d15aa1bd3b0585494501020e47fbe56c30886036f84cea81ce8
MD5 9592365892306d1252c1545517094b29
BLAKE2b-256 a755549102d0ec58a5da61a2b69e0d5af58200be4670882e936e1fafe98cc968

See more details on using hashes here.

Provenance

The following attestation bundles were made for liblaf_grapes-2.0.1-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