aioaudiobookshelf 0.1.4__py3-none-any.whl → 0.1.6__py3-none-any.whl

aioaudiobookshelf/__init__.py

@@ -6,7 +6,7 @@ from aioaudiobookshelf.client import AdminClient, SessionConfiguration, SocketCl
 from aioaudiobookshelf.exceptions import LoginError, TokenIsMissingError
 from aioaudiobookshelf.schema.calls_login import AuthorizeResponse, LoginParameters, LoginResponse
 
-__version__ = "0.1.4"
+__version__ = "0.1.6"
 
 
 async def _get_login_response(

aioaudiobookshelf/client/_base.py

@@ -32,9 +32,8 @@ class BaseClient:
             self.logger = self.session_config.logger
 
         self.logger.debug(
-            "Initialized client %s, token: %s",
+            "Initialized client %s",
             self.__class__.__name__,
-            self._token,
         )
 
         self._verify_user()

aioaudiobookshelf/client/libraries.py

@@ -3,6 +3,7 @@
 from collections.abc import AsyncGenerator
 from typing import TypeVar
 
+from mashumaro.codecs.json import json_decode
 from mashumaro.mixins.json import DataClassJSONMixin
 
 from aioaudiobookshelf.client._base import BaseClient
@@ -18,6 +19,14 @@ from aioaudiobookshelf.schema.calls_library import (
     LibraryWithFilterDataResponse,
 )
 from aioaudiobookshelf.schema.library import Library, LibraryFilterData
+from aioaudiobookshelf.schema.shelf import (
+    Shelf,
+    ShelfAuthors,
+    ShelfBook,
+    ShelfEpisode,
+    ShelfPodcast,
+    ShelfSeries,
+)
 
 ResponseMinified = TypeVar("ResponseMinified", bound=DataClassJSONMixin)
 ResponseNormal = TypeVar("ResponseNormal", bound=DataClassJSONMixin)
@@ -147,7 +156,17 @@ class LibrariesClient(BaseClient):
         ):
             yield result
 
-    # get library's personalized view
+    async def get_library_personalized_view(
+        self, *, library_id: str, limit: int = 10
+    ) -> list[ShelfBook | ShelfPodcast | ShelfAuthors | ShelfEpisode | ShelfSeries]:
+        """Get personalized view of library.
+
+        TODO: Add rssfeed
+        """
+        response = await self._get(
+            endpoint=f"/api/libraries/{library_id}/personalized", params={"limit": limit}
+        )
+        return json_decode(response, list[Shelf])
 
     async def get_library_filterdata(self, *, library_id: str) -> LibraryFilterData:
         """Get filterdata of library."""

aioaudiobookshelf/schema/shelf.py

@@ -0,0 +1,188 @@
+"""Schema for shelf, the response object to library's personalized view."""
+# Discriminators don't work together with aliases.
+# https://github.com/Fatal1ty/mashumaro/issues/254
+# ruff: noqa: N815
+
+from dataclasses import dataclass
+from enum import StrEnum
+from typing import Annotated
+
+from mashumaro.types import Alias, Discriminator
+
+from aioaudiobookshelf.schema.author import AuthorExpanded
+from aioaudiobookshelf.schema.book import BookMinified
+
+from . import _BaseModel
+from .library import LibraryMediaType, _LibraryItemBase
+from .podcast import PodcastEpisode, PodcastMinified
+from .series import Series
+
+
+class ShelfId(StrEnum):
+    """ShelfId."""
+
+    LISTEN_AGAIN = "listen-again"
+    CONTINUE_LISTENING = "continue-listening"
+    CONTINUE_SERIES = "continue-series"
+    RECOMMENDED = "recommended"
+    RECENTLY_ADDED = "recently-added"
+    EPISODES_RECENTLY_ADDED = "episodes-recently-added"
+    RECENT_SERIES = "recent-series"
+    NEWEST_AUTHORS = "newest-authors"
+    NEWEST_EPISODES = "newest-episodes"
+    DISCOVER = "discover"
+
+
+@dataclass(kw_only=True)
+class ShelfLibraryItemMinified(_LibraryItemBase):
+    """ShelfLibraryItemMinified.
+
+    Beside using type, there is another distinction on which attributes
+    are available based on the id. We allow ourselves the easy route
+    here, and just make all of them optional.
+    """
+
+    # episode (type) and
+    # id: continue-listening, listen-again, episodes-recently-added
+    recent_episode: Annotated[PodcastEpisode | None, Alias("recentEpisode")] = None
+
+    # id: continue-listening
+    progress_last_update_ms: Annotated[int | None, Alias("progressLastUpdate")] = None
+
+    # id: continue-series
+    previous_book_in_progress_last_update_ms: Annotated[
+        int | None, Alias("prevBookInProgressLastUpdate")
+    ] = None
+    # TODO: minified item has seriesSequence, which we currently ignore
+
+    # id: recommended
+    weight: float | None = None
+
+    # id: listen-again
+    finished_at_ms: Annotated[int | None, Alias("finishedAt")] = None
+
+    # This and the two subclasses are copied over from libraries, as we otherwise
+    # face issues with the discriminator
+    class Config(_LibraryItemBase.Config):
+        """Config."""
+
+        discriminator = Discriminator(
+            field="mediaType",
+            include_subtypes=True,
+        )
+
+    num_files: Annotated[int, Alias("numFiles")]
+    size: int
+
+
+@dataclass(kw_only=True)
+class LibraryItemMinifiedBook(ShelfLibraryItemMinified):
+    """LibraryItemMinifiedBook."""
+
+    media: BookMinified
+    mediaType: LibraryMediaType = LibraryMediaType.BOOK
+
+
+@dataclass(kw_only=True)
+class LibraryItemMinifiedPodcast(ShelfLibraryItemMinified):
+    """LibraryItemMinifiedPodcast."""
+
+    media: PodcastMinified
+    mediaType: LibraryMediaType = LibraryMediaType.PODCAST
+
+
+@dataclass(kw_only=True)
+class LibraryItemMinifiedBookSeriesShelf(ShelfLibraryItemMinified):
+    """LibraryItemMinifiedBookSeriesShelf."""
+
+    # this appears not to be around?
+    series_sequence: Annotated[str | int | None, Alias("seriesSequence")] = None
+
+
+@dataclass(kw_only=True)
+class SeriesShelf(Series):
+    """SeriesShelf."""
+
+    books: list[LibraryItemMinifiedBookSeriesShelf]
+    in_progress: Annotated[bool | None, Alias("inProgress")] = None
+    has_active_book: Annotated[bool | None, Alias("hasActiveBook")] = None
+    hide_from_continue_listening: Annotated[bool | None, Alias("hideFromContinueListening")] = None
+    book_in_progress_last_update_ms: Annotated[int | None, Alias("bookInProgressLastUpdate")] = None
+    first_book_unread: Annotated[
+        LibraryItemMinifiedBookSeriesShelf | None, Alias("firstBookUnread")
+    ] = None
+
+
+class ShelfType(StrEnum):
+    """ShelfType."""
+
+    BOOK = "book"
+    SERIES = "series"
+    AUTHORS = "authors"
+    EPISODE = "episode"
+    PODCAST = "podcast"
+
+
+@dataclass(kw_only=True)
+class _ShelfBase(_BaseModel):
+    """Shelf."""
+
+    id_: Annotated[ShelfId | str, Alias("id")]
+    label: str
+    label_string_key: Annotated[str, Alias("labelStringKey")]
+    type_: Annotated[ShelfType, Alias("type")]
+    category: str | None = None
+
+
+@dataclass(kw_only=True)
+class Shelf(_ShelfBase):
+    """Shelf."""
+
+    class Config(_ShelfBase.Config):
+        """Config."""
+
+        discriminator = Discriminator(
+            field="type",
+            include_subtypes=True,
+        )
+
+
+@dataclass(kw_only=True)
+class ShelfBook(Shelf):
+    """ShelfBook."""
+
+    type = ShelfType.BOOK
+    entities: list[ShelfLibraryItemMinified]
+
+
+@dataclass(kw_only=True)
+class ShelfPodcast(Shelf):
+    """ShelfBook."""
+
+    type = ShelfType.PODCAST
+    entities: list[ShelfLibraryItemMinified]
+
+
+@dataclass(kw_only=True)
+class ShelfEpisode(Shelf):
+    """ShelfBook."""
+
+    type = ShelfType.EPISODE
+    entities: list[ShelfLibraryItemMinified]
+
+
+@dataclass(kw_only=True)
+class ShelfAuthors(Shelf):
+    """ShelfAuthor."""
+
+    type = ShelfType.AUTHORS
+
+    entities: list[AuthorExpanded]
+
+
+@dataclass(kw_only=True)
+class ShelfSeries(Shelf):
+    """ShelfSeries."""
+
+    type = ShelfType.SERIES
+    entities: list[SeriesShelf]

{aioaudiobookshelf-0.1.4.dist-info → aioaudiobookshelf-0.1.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: aioaudiobookshelf
-Version: 0.1.4
+Version: 0.1.6
 Summary: Async library for Audiobookshelf
 Author-email: Fabian Munkes <105975993+fmunkes@users.noreply.github.com>
 License: Apache-2.0
@@ -109,7 +109,7 @@ async def abs_basics():
 
         # get a single podcast
         podcast_id = "dda96167-eaad-4012-83e1-149c6700d3e8"
-        podcast_expanded = client.get_library_item_podcast(podcast_id=podcast_id, expanded=True)
+        podcast_expanded = await client.get_library_item_podcast(podcast_id=podcast_id, expanded=True)
 
 
 asyncio.run(abs_basics())

{aioaudiobookshelf-0.1.4.dist-info → aioaudiobookshelf-0.1.6.dist-info}/RECORD

@@ -1,12 +1,12 @@
-aioaudiobookshelf/__init__.py,sha256=zihAWwXc_wjsyXfWPt8TJ4r3Ichm5so7484NsDXThP0,4138
+aioaudiobookshelf/__init__.py,sha256=V20kFZaBlByTjA2mNdWR20JPpzjC-YY_CKremymscRI,4138
 aioaudiobookshelf/exceptions.py,sha256=JQNdqBaR5AhuCUBg5DH5-orkfJrx_CJpe53ignWD6vE,377
 aioaudiobookshelf/helpers.py,sha256=ImZntca2l39P285TVVrFah82MjrP4wXLnVd7LMoD5Ck,1581
 aioaudiobookshelf/client/__init__.py,sha256=YnrNm2ZmQeVqGQ8EfAKIPRI4p2cLFqCzv4uKgL6HJPM,6931
-aioaudiobookshelf/client/_base.py,sha256=1S0ACN-fiXKy0uVVLb422LGFB4bOvVFnSvyEDM47-v0,3815
+aioaudiobookshelf/client/_base.py,sha256=cxzivvqAitDkpyjqr0o_GjtaoWn6-kQ4GXCrkhZ3ufI,3779
 aioaudiobookshelf/client/authors.py,sha256=8bXN0NsPvH1rvF166xUu7rVC-0P0Sp4N7oxZrO666nc,1129
 aioaudiobookshelf/client/collections_.py,sha256=Z3r7dxHhzMm_cGCMRJkVzN5-Eesftib3d0bs4iXmmzY,879
 aioaudiobookshelf/client/items.py,sha256=4yWy7Shd6sbKj4MSGYJXklXs-yZH2q95qGIm4L-PS5o,3624
-aioaudiobookshelf/client/libraries.py,sha256=ejzxUCFgCfWtJQMCjAlo7LHWLk82Kl2BdkjpRVKtBck,6250
+aioaudiobookshelf/client/libraries.py,sha256=VK1VqX9V6_8PAhPVx-eIPOgsS8t_U1a6iFML2nOyi14,6852
 aioaudiobookshelf/client/me.py,sha256=cYmXNoFJHZgEI6Ds19Pf6gNQMBVOqrtcKmiyXHFFIL0,3586
 aioaudiobookshelf/client/playlists.py,sha256=sTsmuBqjSlKyTo31mc9Ha-WtzX7bh0hH7n1BcnlO7YY,875
 aioaudiobookshelf/client/podcasts.py,sha256=f1ECD43cn4EIwWpRvwM_RosfzDr8popFDFbRYgCZQxs,684
@@ -37,9 +37,10 @@ aioaudiobookshelf/schema/series.py,sha256=XmwDvMchb-W2y-Tm-eKiE-3rPjs4kXC3Ib2dZO
 aioaudiobookshelf/schema/series_books.py,sha256=rs8a4JmSHqJR6WPA2XKXmC6XDq8D9wmzxftLlPhvub8,868
 aioaudiobookshelf/schema/server.py,sha256=yWBRxtwtX1USs43yGFuDIM3jfWbmduW3GRahisOUCqw,2726
 aioaudiobookshelf/schema/session.py,sha256=jqCHNUthuzE6jhgG3UwFgagl1HA_rfDwn6Te38jaqC8,2684
+aioaudiobookshelf/schema/shelf.py,sha256=npPr5iacm6b5FfJYF9_lFZaitJNJ3SVvBOScbxlF5MQ,5064
 aioaudiobookshelf/schema/user.py,sha256=Zcnl6gqfc97dmHrNOHVsX_OOqwcJq-eFMhc9zVMLIs4,2057
-aioaudiobookshelf-0.1.4.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-aioaudiobookshelf-0.1.4.dist-info/METADATA,sha256=OmHbBKE2vAJ8-wU1v1NKsrnTEfwjz5-MTqRnQNKJt6o,4377
-aioaudiobookshelf-0.1.4.dist-info/WHEEL,sha256=jB7zZ3N9hIM9adW7qlTAyycLYW9npaWKLRzaoVcLKcM,91
-aioaudiobookshelf-0.1.4.dist-info/top_level.txt,sha256=2_I2_xz98xmVIT84pcF3tlq3NdZNKskfs7BqUmYZylk,18
-aioaudiobookshelf-0.1.4.dist-info/RECORD,,
+aioaudiobookshelf-0.1.6.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+aioaudiobookshelf-0.1.6.dist-info/METADATA,sha256=VuR5OVJBBkIXh0omjtvIpv3Be9k0ov7BzXL6-SA4AVo,4383
+aioaudiobookshelf-0.1.6.dist-info/WHEEL,sha256=52BFRY2Up02UkjOa29eZOS2VxUrpPORXg1pkohGGUS8,91
+aioaudiobookshelf-0.1.6.dist-info/top_level.txt,sha256=2_I2_xz98xmVIT84pcF3tlq3NdZNKskfs7BqUmYZylk,18
+aioaudiobookshelf-0.1.6.dist-info/RECORD,,

{aioaudiobookshelf-0.1.4.dist-info → aioaudiobookshelf-0.1.6.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (75.8.2)
+Generator: setuptools (76.0.0)
 Root-Is-Purelib: true
 Tag: py3-none-any