aioaudiobookshelf 0.1.8__py3-none-any.whl → 0.1.11__py3-none-any.whl

aioaudiobookshelf/__init__.py

@@ -8,7 +8,7 @@ from aioaudiobookshelf.exceptions import LoginError, TokenIsMissingError
 from aioaudiobookshelf.helpers import get_login_response
 from aioaudiobookshelf.schema.calls_login import AuthorizeResponse
 
-__version__ = "0.1.8"
+__version__ = "0.1.11"
 
 
 async def _get_authorize_response(*, session_config: SessionConfiguration) -> AuthorizeResponse:

aioaudiobookshelf/client/_base.py

@@ -73,6 +73,7 @@ class BaseClient:
                 ssl=self.session_config.verify_ssl,
                 headers=self.session_config.headers,
                 raise_for_status=True,
+                timeout=self.session_config.timeout,
             )
 
         try:
@@ -82,17 +83,16 @@ class BaseClient:
                 if self.session_config.auto_refresh:
                     self.logger.debug("Auto refreshing tokens.")
                     await self.refresh()
+                    # TODO: remove redundant clause
+                    try:
+                        response = await _request()
+                    except ClientResponseError as inner_exc:
+                        raise ApiError(f"API POST call to {endpoint} failed.") from inner_exc
                 else:
                     raise AccessTokenExpiredError from exc
             else:
                 raise ApiError(f"API POST call to {endpoint} failed.") from exc
 
-        # TODO: remove redundant clause
-        try:
-            response = await _request()
-        except ClientResponseError as exc:
-            raise ApiError(f"API POST call to {endpoint} failed.") from exc
-
         return await response.read()
 
     async def _get(self, endpoint: str, params: dict[str, str | int] | None = None) -> bytes:
@@ -104,6 +104,7 @@ class BaseClient:
                 params=params,
                 ssl=self.session_config.verify_ssl,
                 headers=self.session_config.headers,
+                timeout=self.session_config.timeout,
             )
 
         response = await _request()
@@ -132,6 +133,7 @@ class BaseClient:
                 ssl=self.session_config.verify_ssl,
                 headers=self.session_config.headers,
                 raise_for_status=True,
+                timeout=self.session_config.timeout,
             )
 
         try:
@@ -141,16 +143,15 @@ class BaseClient:
                 if self.session_config.auto_refresh:
                     self.logger.debug("Auto refreshing tokens.")
                     await self.refresh()
+                    try:
+                        await _request()
+                    except ClientResponseError as inner_exc:
+                        raise ApiError(f"API PATCH call to {endpoint} failed.") from inner_exc
                 else:
                     raise AccessTokenExpiredError from exc
             else:
                 raise ApiError(f"API PATCH call to {endpoint} failed.") from exc
 
-        try:
-            await _request()
-        except ClientResponseError as exc:
-            raise ApiError(f"API PATCH call to {endpoint} failed.") from exc
-
     async def _delete(self, endpoint: str) -> None:
         """DELETE request to abs api."""
 
@@ -160,6 +161,7 @@ class BaseClient:
                 ssl=self.session_config.verify_ssl,
                 headers=self.session_config.headers,
                 raise_for_status=True,
+                timeout=self.session_config.timeout,
             )
 
         try:
@@ -169,16 +171,15 @@ class BaseClient:
                 if self.session_config.auto_refresh:
                     self.logger.debug("Auto refreshing tokens.")
                     await self.refresh()
+                    try:
+                        await _request()
+                    except ClientResponseError as inner_exc:
+                        raise ApiError(f"API DELETE call to {endpoint} failed.") from inner_exc
                 else:
                     raise AccessTokenExpiredError from exc
             else:
                 raise ApiError(f"API DELETE call to {endpoint} failed.") from exc
 
-        try:
-            await _request()
-        except ClientResponseError as exc:
-            raise ApiError(f"API DELETE call to {endpoint} failed.") from exc
-
     async def refresh(self) -> None:
         """Refresh tokens."""
         await self.session_config.refresh()

aioaudiobookshelf/client/authors.py

@@ -1,10 +1,19 @@
 """Calls to /api/authors."""
 
+from enum import StrEnum
+
 from aioaudiobookshelf.client._base import BaseClient
 from aioaudiobookshelf.schema.author import Author
 from aioaudiobookshelf.schema.calls_authors import AuthorWithItems, AuthorWithItemsAndSeries
 
 
+class AuthorImageFormat(StrEnum):
+    """AuthorImageFormat."""
+
+    JPEG = "jpeg"
+    WEBP = "webp"
+
+
 class AuthorsClient(BaseClient):
     """AuthorsClient."""
 
@@ -31,4 +40,18 @@ class AuthorsClient(BaseClient):
 
     # update author
     # match author
-    # get author image
+    async def get_author_image(
+        self,
+        *,
+        author_id: str,
+        width: int = 400,
+        height: int | None = None,
+        format_: AuthorImageFormat = AuthorImageFormat.JPEG,
+        raw: bool = False,
+    ) -> bytes:
+        """Get image of author. If height is None, image is scaled proportionally."""
+        endpoint = f"/api/authors/{author_id}/image"
+        params = {"width": width, "format": format_.value, "raw": int(raw)}
+        if height:
+            params["height"] = height
+        return await self._get(endpoint, params=params)

aioaudiobookshelf/client/session.py

@@ -1,7 +1,10 @@
 """Calls to /api/session."""
 
 from aioaudiobookshelf.client._base import BaseClient
-from aioaudiobookshelf.schema.calls_session import CloseOpenSessionsParameters
+from aioaudiobookshelf.schema.calls_session import (
+    CloseOpenSessionsParameters,
+    SyncOpenSessionParameters,
+)
 from aioaudiobookshelf.schema.session import PlaybackSessionExpanded
 
 
@@ -24,7 +27,11 @@ class SessionClient(BaseClient):
         )
         return psession
 
-    # sync open session
+    async def sync_open_session(
+        self, *, session_id: str, parameters: SyncOpenSessionParameters
+    ) -> None:
+        """Sync an open session."""
+        await self._post(f"/api/session/{session_id}/sync", data=parameters.to_dict())
 
     async def close_open_session(
         self, *, session_id: str, parameters: CloseOpenSessionsParameters | None = None

aioaudiobookshelf/client/session_configuration.py

@@ -4,7 +4,7 @@ import asyncio
 import logging
 from dataclasses import dataclass
 
-from aiohttp.client import ClientSession
+from aiohttp.client import DEFAULT_TIMEOUT, ClientSession, ClientTimeout
 from aiohttp.client_exceptions import ClientResponseError
 
 from aioaudiobookshelf.exceptions import (
@@ -32,6 +32,7 @@ class SessionConfiguration:
     refresh_token: str | None = None  # > v2.26
     auto_refresh: bool = True  # automatically refresh access token, should it be expired.
     pagination_items_per_page: int = 10
+    timeout: ClientTimeout = DEFAULT_TIMEOUT
     logger: logging.Logger | None = None
 
     @property

aioaudiobookshelf/schema/book.py

@@ -18,7 +18,7 @@ class EBookFile(_BaseModel):
 
     ino: str
     metadata: FileMetadata
-    ebook_format: Annotated[str, Alias("ebookFormat")]
+    ebook_format: Annotated[str | None, Alias("ebookFormat")] = None
     added_at: Annotated[int, Alias("addedAt")]  # time in ms since unix epoch
     updated_at: Annotated[int, Alias("updatedAt")]  # time in ms since unix epoch
 

aioaudiobookshelf/schema/calls_session.py

@@ -15,3 +15,6 @@ class CloseOpenSessionsParameters(_BaseModel):
     current_time: Annotated[float, Alias("currentTime")]
     time_listened: Annotated[float, Alias("timeListened")]
     duration: float
+
+
+SyncOpenSessionParameters = CloseOpenSessionsParameters

{aioaudiobookshelf-0.1.8.dist-info → aioaudiobookshelf-0.1.11.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aioaudiobookshelf
-Version: 0.1.8
+Version: 0.1.11
 Summary: Async library for Audiobookshelf
 Author-email: Fabian Munkes <105975993+fmunkes@users.noreply.github.com>
 License: Apache-2.0

{aioaudiobookshelf-0.1.8.dist-info → aioaudiobookshelf-0.1.11.dist-info}/RECORD

@@ -1,9 +1,9 @@
-aioaudiobookshelf/__init__.py,sha256=qJeq9-dgajENDo6mWUr_LJ8NRSQFFFooL1cjgHMd6wI,3507
+aioaudiobookshelf/__init__.py,sha256=xebDvWxDTQNfKKQi9I9V7yKxke3WZoBks6e2nYDPle8,3508
 aioaudiobookshelf/exceptions.py,sha256=G3z99KrxHoSoj7kpSRVpa7Rp_RkL3jmW6266ak8h_p0,661
 aioaudiobookshelf/helpers.py,sha256=gvoBWsu6PSiGYyXe5BH9TP6WydzAMp_6Ye9RUivvk9Y,2700
 aioaudiobookshelf/client/__init__.py,sha256=6xwDrY0xWWC8cXHn5GK3Mc1jPpmmtfJ9HGO9aryKL8U,7993
-aioaudiobookshelf/client/_base.py,sha256=eQjybEvl79GmvLUCJKTJmuivrF9fTo6SEt_W0BHYbSw,7183
-aioaudiobookshelf/client/authors.py,sha256=8bXN0NsPvH1rvF166xUu7rVC-0P0Sp4N7oxZrO666nc,1129
+aioaudiobookshelf/client/_base.py,sha256=J_RjItJFaq17Po66aEzwrpq6PiCns3xYXWAtewy48K0,7584
+aioaudiobookshelf/client/authors.py,sha256=9F8_tiTqh-5Srn_5I0wdEa1qs_495UctzSF6OlxFOJw,1808
 aioaudiobookshelf/client/collections_.py,sha256=Z3r7dxHhzMm_cGCMRJkVzN5-Eesftib3d0bs4iXmmzY,879
 aioaudiobookshelf/client/items.py,sha256=4yWy7Shd6sbKj4MSGYJXklXs-yZH2q95qGIm4L-PS5o,3624
 aioaudiobookshelf/client/libraries.py,sha256=VK1VqX9V6_8PAhPVx-eIPOgsS8t_U1a6iFML2nOyi14,6852
@@ -11,12 +11,12 @@ aioaudiobookshelf/client/me.py,sha256=cYmXNoFJHZgEI6Ds19Pf6gNQMBVOqrtcKmiyXHFFIL
 aioaudiobookshelf/client/playlists.py,sha256=sTsmuBqjSlKyTo31mc9Ha-WtzX7bh0hH7n1BcnlO7YY,875
 aioaudiobookshelf/client/podcasts.py,sha256=f1ECD43cn4EIwWpRvwM_RosfzDr8popFDFbRYgCZQxs,684
 aioaudiobookshelf/client/series.py,sha256=bS4RO8k1Im5wpeKt0oNcBSeeZCRIGCi9otTCEOy7xMo,820
-aioaudiobookshelf/client/session.py,sha256=YWv4GkrW5fMbq1AdnMOWQHM_YzAH1U6varzsyXlP0Jc,1249
-aioaudiobookshelf/client/session_configuration.py,sha256=AbDYT2OixncuStLz0ovMF83RNuyHTKKHdzaJKqSL7X0,3881
+aioaudiobookshelf/client/session.py,sha256=1eMI_caj6dSTtyC3aqKgLCDqWLEOodFtBkEGoqTOmnw,1508
+aioaudiobookshelf/client/session_configuration.py,sha256=_Y-uDA9iW87siiN9xe-pCOxMS0V41Fl6MGWY4EuZ1tA,3958
 aioaudiobookshelf/schema/__init__.py,sha256=vEEwPVweT0j2VqlBj2V34Xk5J9OBZ7zkd6eLOUx-RdU,358
 aioaudiobookshelf/schema/audio.py,sha256=PFKkGsZgJSDYJS-7VwoTvYTcVfR8ip8qOuE8hQa9TtE,2105
 aioaudiobookshelf/schema/author.py,sha256=OZGcCUHOfXvN8N2SRUiIRnDS2Lz3UrQFWOaOZ1sKV0U,976
-aioaudiobookshelf/schema/book.py,sha256=Ckfc_eC6jXtQnQQzl0QaB0edp91G8gIiUJTE7IfctuM,3372
+aioaudiobookshelf/schema/book.py,sha256=mf_PZqClvbfoxUQtm88Cqz14xT-594NZPi6nkQe1_Hk,3386
 aioaudiobookshelf/schema/calls_authors.py,sha256=eIvdyEcrmXuOxFJuCX39cGU9HSZprl40yKn8s2VjfAM,703
 aioaudiobookshelf/schema/calls_collections.py,sha256=nXurha41Y1atAuOWG9aXJbYo66qgcFUaW02QPEVdo4w,319
 aioaudiobookshelf/schema/calls_items.py,sha256=KF8s6WNbsVUIxAuN9TZBBGsysnxfw-FQWM9XRTljOpo,1547
@@ -25,7 +25,7 @@ aioaudiobookshelf/schema/calls_login.py,sha256=DpIBtAzg5uQtS0CLDfEXHkOh_RGfDI5ep
 aioaudiobookshelf/schema/calls_me.py,sha256=jdpvExRytoqX8FHkzq4N9RtKn50cmTc_B693e9lLCHQ,693
 aioaudiobookshelf/schema/calls_playlists.py,sha256=Ll1scstd1NNc6PXgkhmWUfqSzIR07LKzqBCEvrVHACE,305
 aioaudiobookshelf/schema/calls_series.py,sha256=aUdlTR01UE2APN0pGS1h7x0ydsREqZf53mKaHq2zeh4,597
-aioaudiobookshelf/schema/calls_session.py,sha256=j2NLUwS4820SwzqPXksteTACXtUXvNtio_wBfvwHHM0,416
+aioaudiobookshelf/schema/calls_session.py,sha256=E90uPxkZrV1FUTSYS9owbzTm8HaRjH4CRmb88XrGqOA,474
 aioaudiobookshelf/schema/collection.py,sha256=fB1VFQXE0hzM_NyWEHj9A11VztD_8rYo4t9OWkDj-Lc,883
 aioaudiobookshelf/schema/events_socket.py,sha256=r24ssixH0dWfyOhv0K5P6GgzGrbYC9Yh8Y2w76-bkeM,1420
 aioaudiobookshelf/schema/file.py,sha256=frymCwsiqOh6fnZPBnkUz1pfyUuKkH4ssRd2WHpsajk,639
@@ -40,8 +40,8 @@ aioaudiobookshelf/schema/server.py,sha256=yWBRxtwtX1USs43yGFuDIM3jfWbmduW3GRahis
 aioaudiobookshelf/schema/session.py,sha256=jqCHNUthuzE6jhgG3UwFgagl1HA_rfDwn6Te38jaqC8,2684
 aioaudiobookshelf/schema/shelf.py,sha256=npPr5iacm6b5FfJYF9_lFZaitJNJ3SVvBOScbxlF5MQ,5064
 aioaudiobookshelf/schema/user.py,sha256=cm2Oev9i062mjM3Ku-yaAjm_o4-sJOkJTczdq43_qrY,2485
-aioaudiobookshelf-0.1.8.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-aioaudiobookshelf-0.1.8.dist-info/METADATA,sha256=lnsXI8B8rQsaaoQ2NCDEpd4hD8s9lSPX25r6COqV69o,4405
-aioaudiobookshelf-0.1.8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-aioaudiobookshelf-0.1.8.dist-info/top_level.txt,sha256=2_I2_xz98xmVIT84pcF3tlq3NdZNKskfs7BqUmYZylk,18
-aioaudiobookshelf-0.1.8.dist-info/RECORD,,
+aioaudiobookshelf-0.1.11.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+aioaudiobookshelf-0.1.11.dist-info/METADATA,sha256=uMPo-whmeNF-pi58S6OOA-7vejepwzgNS4lcTfodzvM,4406
+aioaudiobookshelf-0.1.11.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+aioaudiobookshelf-0.1.11.dist-info/top_level.txt,sha256=2_I2_xz98xmVIT84pcF3tlq3NdZNKskfs7BqUmYZylk,18
+aioaudiobookshelf-0.1.11.dist-info/RECORD,,

{aioaudiobookshelf-0.1.8.dist-info → aioaudiobookshelf-0.1.11.dist-info}/WHEEL

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