libadvian

What it is and what it does

libadvian is a grab-bag utility library that collects small helpers too narrow to justify their own package. It provides type-hinted functions for common tasks: initializing logging with a standard format, encoding/decoding UUIDs to URL-safe base64, ensuring consistent bytes or string handling, managing fire-and-forget async tasks via TaskMaster, and dividing iterables into fixed-size chunks. The library also includes an optional HTTP logging handler that can ship logs to aggregation services like Vector or Logstash by POSTing structured records with custom headers and labels.

The package is designed as a lightweight dependency with zero runtime requirements, making it suitable for inclusion in other libraries without adding transitive bloat. It supports Python 3.9 through 3.13 and is distributed under the permissive MIT license. The code is fully type-hinted and documented, though the project is aging—last released 448 days ago—so updates and bug fixes may be slower than in actively maintained packages.

Use it for:

• Initialize application logging with a standard format and optional HTTP shipping to log aggregators
• Convert UUIDs to compact URL-safe base64 strings for use in APIs or database keys
• Normalize string/bytes handling in code that receives mixed input types
• Fire-and-forget async task execution without manual event loop management
• Batch-process large iterables by dividing them into fixed-size chunks for memory efficiency

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides a collection of small utility helpers for logging, UUID/base64 encoding, string/bytes conversion, async task management, and iterable chunking.

Yes, if you need a lightweight grab-bag of utilities and can tolerate slower maintenance. The package has no dependencies, low install friction, and covers several common tasks (logging, UUID encoding, async tasks, chunking) in one place. The aging maintenance status (last release 448 days ago) means you should not expect rapid bug fixes or feature updates, but the code is stable and compatible with modern Python. Use it for internal utilities or as a dependency in your own libraries where the permissive MIT license and zero-dependency footprint are advantages.

Install

libadvian on PyPI

pip install libadvian

uv add libadvian

poetry add libadvian

Installing libadvian

Before you install

Low install friction with no runtime dependencies. Maintenance status is aging—last release was 448 days ago—so expect slower response to issues, though the package remains compatible with current Python versions through 3.13.

License in practice

MIT license is permissive; you can use, modify, and distribute this package freely in commercial and open-source projects with minimal restrictions.

Quickstart

pip install libadvian

from libadvian.logging import init_logging
from libadvian.binpackers import uuid_to_b64
from libadvian.iter import chunked

init_logging()
encoded = uuid_to_b64(my_uuid)
for chunk in chunked(my_list, 10):
    process(chunk)

Requires Python 3.9 or later. HTTP logging features require installing the 'http' extra and setting LOG_HTTP_TARGET_URI environment variable.

Verify before relying

• Whether the package is actively maintained or in maintenance-only mode despite aging status
• Performance characteristics and memory overhead of TaskMaster.singleton() for high-volume async tasks
• Compatibility of HTTP logging handler with specific log aggregation platforms beyond Vector/Logstash

Package facts

Evidence: libadvian-1.9.0-py3-none-any.whl

Tags

More Software Development packages