aioaudiobookshelf-plus

aioaudiobookshelf-plus

A fully typed async client for the Audiobookshelf API.

The library exposes strongly typed data models (backed by mashumaro) and an async client built on aiohttp and python-socketio. Every public surface is type annotated and the package ships a py.typed marker, so downstream consumers get full inline types and mypy --strict support.

Status

Phase 1: the typed model layer under aioaudiobookshelf_plus.schema is in place. The async client layer is under active development and lands in a later phase.

Installation

pip install aioaudiobookshelf-plus

Usage

from aioaudiobookshelf_plus.schema.media_progress import MediaProgress

progress = MediaProgress.from_json(raw_json)

Attribution and licensing

This project is licensed under the Apache License, Version 2.0. See LICENSE.

The model layer in src/aioaudiobookshelf_plus/schema/ is derived from music-assistant/aioaudiobookshelf, which is also licensed under Apache-2.0. See NOTICE for the full attribution. The client layer is original work.