flet-audio 0.2.0.dev58__tar.gz → 0.2.0.dev67__tar.gz

{flet_audio-0.2.0.dev58/src/flet_audio.egg-info → flet_audio-0.2.0.dev67}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flet-audio
-Version: 0.2.0.dev58
+Version: 0.2.0.dev67
 Summary: Eases audio integration and playback in Flet apps.
 Author-email: Flet contributors <hello@flet.dev>
 License-Expression: Apache-2.0
@@ -41,7 +41,9 @@ This package supports the following platforms:
 | Android  |     ✅     |
 | Web      |     ✅     |
 
-## Installation
+## Usage
+
+### Installation
 
 To install the `flet-audio` package and add it to your project dependencies:
 
@@ -61,6 +63,6 @@ To install the `flet-audio` package and add it to your project dependencies:
     poetry add flet-audio
     ```
 
-## Examples
+### Examples
 
-For examples, see [this](./examples)
+For examples, see [these](./examples).

{flet_audio-0.2.0.dev58 → flet_audio-0.2.0.dev67}/README.md

@@ -25,7 +25,9 @@ This package supports the following platforms:
 | Android  |     ✅     |
 | Web      |     ✅     |
 
-## Installation
+## Usage
+
+### Installation
 
 To install the `flet-audio` package and add it to your project dependencies:
 
@@ -45,6 +47,6 @@ To install the `flet-audio` package and add it to your project dependencies:
     poetry add flet-audio
     ```
 
-## Examples
+### Examples
 
-For examples, see [this](./examples)
+For examples, see [these](./examples).

{flet_audio-0.2.0.dev58 → flet_audio-0.2.0.dev67}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "flet-audio"
-version = "0.2.0.dev58"
+version = "0.2.0.dev67"
 description = "Eases audio integration and playback in Flet apps."
 readme = "README.md"
 authors = [{ name = "Flet contributors", email = "hello@flet.dev" }]
@@ -52,6 +52,7 @@ docs = [
     "markdown-exec[ansi] >=1.11.0",
     "pydocstyle >=6.3.0",
     "linkcheckmd >=1.4.0",
+    "mkdocs-external-images",
     { include-group = 'docs-coverage' },
 ]
 all = [
@@ -59,6 +60,9 @@ all = [
     { include-group = 'docs' },
 ]
 
+[tool.uv.sources]
+mkdocs-external-images = { git = "https://github.com/flet-dev/mkdocs-external-images", tag = "v0.2.0" }
+
 [build-system]
 requires = ["setuptools"]
 build-backend = "setuptools.build_meta"

{flet_audio-0.2.0.dev58 → flet_audio-0.2.0.dev67}/src/flet_audio/__init__.py

@@ -1,5 +1,5 @@
-from .audio import Audio
-from .types import (
+from flet_audio.audio import Audio
+from flet_audio.types import (
     AudioDurationChangeEvent,
     AudioPositionChangeEvent,
     AudioState,

{flet_audio-0.2.0.dev58 → flet_audio-0.2.0.dev67}/src/flet_audio/audio.py

@@ -1,9 +1,8 @@
-import asyncio
 from typing import Optional
 
 import flet as ft
 
-from .types import (
+from flet_audio.types import (
     AudioDurationChangeEvent,
     AudioPositionChangeEvent,
     AudioStateChangeEvent,
@@ -42,8 +41,8 @@ class Audio(ft.Service):
     Defines the contents of audio file encoded in base-64 format.
 
     Note:
-        - At least one of [`src`][flet_audio.Audio.src] or `src_base64` must be provided,
-            with `src_base64` having priority if both are provided.
+        - At least one of [`src`][flet_audio.Audio.src] or `src_base64` must be
+            provided, with `src_base64` having priority if both are provided.
         - [Here](https://github.com/bluefireteam/audioplayers/blob/main/troubleshooting.md#supported-formats--encodings)
             is a list of supported audio formats.
     """
@@ -124,9 +123,7 @@ class Audio(ft.Service):
         super().before_update()
         assert self.src or self.src_base64, "either src or src_base64 must be provided"
 
-    async def play_async(
-        self, position: ft.DurationValue = ft.Duration(), timeout: Optional[float] = 10
-    ):
+    async def play(self, position: ft.DurationValue = 0, timeout: Optional[float] = 10):
         """
         Starts playing audio from the specified `position`.
 
@@ -137,66 +134,22 @@ class Audio(ft.Service):
         Raises:
             TimeoutError: If the request times out.
         """
-        await self._invoke_method_async(
+        await self._invoke_method(
             method_name="play",
             arguments={"position": position},
             timeout=timeout,
         )
 
-    def play(
-        self, position: ft.DurationValue = ft.Duration(), timeout: Optional[float] = 10
-    ):
-        """
-        Starts playing audio from the specified `position`.
-
-        Args:
-            position: The position to start playback from.
-            timeout: The maximum amount of time (in seconds) to wait for a response.
-
-        Raises:
-            TimeoutError: If the request times out.
-        """
-        asyncio.create_task(self.play_async(position, timeout=timeout))
-
-    async def pause_async(self, timeout: Optional[float] = 10):
-        """
-        Pauses the audio that is currently playing.
-
-        If you call [`resume()`][flet_audio.Audio.resume] or
-        [`resume_async()`][flet_audio.Audio.resume_async] later,
-        the audio will resume from the point that it has been paused.
-        """
-        await self._invoke_method_async("pause", timeout=timeout)
-
-    def pause(self, timeout: Optional[float] = 10):
+    async def pause(self, timeout: Optional[float] = 10):
         """
         Pauses the audio that is currently playing.
 
-        If you call [`resume()`][flet_audio.Audio.resume] or
-        [`resume_async()`][flet_audio.Audio.resume_async] later,
+        If you call [`resume()`][flet_audio.Audio.resume] later,
         the audio will resume from the point that it has been paused.
-
-        Args:
-            timeout: The maximum amount of time (in seconds) to wait for a response.
-
-        Raises:
-            TimeoutError: If the request times out.
-        """
-        asyncio.create_task(self.pause_async(timeout=timeout))
-
-    async def resume_async(self, timeout: Optional[float] = 10):
-        """
-        Resumes the audio that has been paused or stopped.
-
-        Args:
-            timeout: The maximum amount of time (in seconds) to wait for a response.
-
-        Raises:
-            TimeoutError: If the request times out.
         """
-        await self._invoke_method_async("resume", timeout=timeout)
+        await self._invoke_method("pause", timeout=timeout)
 
-    def resume(self, timeout: Optional[float] = 10):
+    async def resume(self, timeout: Optional[float] = 10):
         """
         Resumes the audio that has been paused or stopped.
 
@@ -206,29 +159,13 @@ class Audio(ft.Service):
         Raises:
             TimeoutError: If the request times out.
         """
-        asyncio.create_task(self.resume_async(timeout=timeout))
-
-    async def release_async(self, timeout: Optional[float] = 10):
-        """
-        Releases the resources associated with this media player.
-        These are going to be fetched or buffered again as soon as
-        you change the source or call [`resume()`][flet_audio.Audio.resume] or
-        [`resume_async()`][flet_audio.Audio.resume_async].
-
-        Args:
-            timeout: The maximum amount of time (in seconds) to wait for a response.
-
-        Raises:
-            TimeoutError: If the request times out.
-        """
-        await self._invoke_method_async("release", timeout=timeout)
+        await self._invoke_method("resume", timeout=timeout)
 
-    def release(self, timeout: Optional[float] = 10):
+    async def release(self, timeout: Optional[float] = 10):
         """
         Releases the resources associated with this media player.
         These are going to be fetched or buffered again as soon as
-        you change the source or call [`resume()`][flet_audio.Audio.resume] or
-        [`resume_async()`][flet_audio.Audio.resume_async].
+        you change the source or call [`resume()`][flet_audio.Audio.resume].
 
         Args:
             timeout: The maximum amount of time (in seconds) to wait for a response.
@@ -236,11 +173,9 @@ class Audio(ft.Service):
         Raises:
             TimeoutError: If the request times out.
         """
-        asyncio.create_task(self.release_async(timeout=timeout))
+        await self._invoke_method("release", timeout=timeout)
 
-    async def seek_async(
-        self, position: ft.DurationValue, timeout: Optional[float] = 10
-    ):
+    async def seek(self, position: ft.DurationValue, timeout: Optional[float] = 10):
         """
         Moves the cursor to the desired position.
 
@@ -251,26 +186,13 @@ class Audio(ft.Service):
         Raises:
             TimeoutError: If the request times out.
         """
-        await self._invoke_method_async(
+        await self._invoke_method(
             method_name="seek",
             arguments={"position": position},
             timeout=timeout,
         )
 
-    def seek(self, position: ft.DurationValue, timeout: Optional[float] = 10):
-        """
-        Moves the cursor to the desired position.
-
-        Args:
-            position: The position to seek/move to.
-            timeout: The maximum amount of time (in seconds) to wait for a response.
-
-        Raises:
-            TimeoutError: If the request times out.
-        """
-        asyncio.create_task(self.seek_async(position, timeout=timeout))
-
-    async def get_duration_async(
+    async def get_duration(
         self, timeout: Optional[float] = 10
     ) -> Optional[ft.Duration]:
         """
@@ -288,12 +210,12 @@ class Audio(ft.Service):
         Raises:
             TimeoutError: If the request times out.
         """
-        return await self._invoke_method_async(
+        return await self._invoke_method(
             method_name="get_duration",
             timeout=timeout,
         )
 
-    async def get_current_position_async(
+    async def get_current_position(
         self, timeout: Optional[float] = 10
     ) -> Optional[ft.Duration]:
         """
@@ -305,7 +227,7 @@ class Audio(ft.Service):
         Returns:
             The current position of the audio playback.
         """
-        return await self._invoke_method_async(
+        return await self._invoke_method(
             method_name="get_current_position",
             timeout=timeout,
         )

{flet_audio-0.2.0.dev58 → flet_audio-0.2.0.dev67}/src/flet_audio/types.py

@@ -5,7 +5,7 @@ from typing import TYPE_CHECKING
 import flet as ft
 
 if TYPE_CHECKING:
-    from .audio import Audio  # noqa
+    from flet_audio.audio import Audio  # noqa
 
 __all__ = [
     "AudioDurationChangeEvent",
@@ -27,8 +27,8 @@ class ReleaseMode(Enum):
         - On Android, the media player is quite resource-intensive, and this will
             let it go. Data will be buffered again when needed (if it's a remote file,
             it will be downloaded again).
-        - On iOS and macOS, works just like [`Audio.release()`][flet_audio.Audio.release]
-            method.
+        - On iOS and macOS, works just like
+            [`Audio.release()`][flet_audio.Audio.release] method.
     """
 
     LOOP = "loop"

{flet_audio-0.2.0.dev58 → flet_audio-0.2.0.dev67/src/flet_audio.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flet-audio
-Version: 0.2.0.dev58
+Version: 0.2.0.dev67
 Summary: Eases audio integration and playback in Flet apps.
 Author-email: Flet contributors <hello@flet.dev>
 License-Expression: Apache-2.0
@@ -41,7 +41,9 @@ This package supports the following platforms:
 | Android  |     ✅     |
 | Web      |     ✅     |
 
-## Installation
+## Usage
+
+### Installation
 
 To install the `flet-audio` package and add it to your project dependencies:
 
@@ -61,6 +63,6 @@ To install the `flet-audio` package and add it to your project dependencies:
     poetry add flet-audio
     ```
 
-## Examples
+### Examples
 
-For examples, see [this](./examples)
+For examples, see [these](./examples).

{flet_audio-0.2.0.dev58 → flet_audio-0.2.0.dev67}/src/flutter/flet_audio/pubspec.lock

@@ -13,10 +13,10 @@ packages:
     dependency: transitive
     description:
       name: async
-      sha256: d2872f9c19731c2e5f10444b14686eb7cc85c76274bd6c16e1816bff9a3bab63
+      sha256: "758e6d74e971c3e5aceb4110bfd6698efc7f501675bcfe0c775459a8140750eb"
       url: "https://pub.dev"
     source: hosted
-    version: "2.12.0"
+    version: "2.13.0"
   audioplayers:
     dependency: "direct main"
     description:
@@ -121,6 +121,14 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "3.0.6"
+  dbus:
+    dependency: transitive
+    description:
+      name: dbus
+      sha256: "79e0c23480ff85dc68de79e2cd6334add97e48f7f4865d17686dd6ea81a47e8c"
+      url: "https://pub.dev"
+    source: hosted
+    version: "0.7.11"
   device_info_plus:
     dependency: transitive
     description:
@@ -149,10 +157,10 @@ packages:
     dependency: transitive
     description:
       name: fake_async
-      sha256: "6a95e56b2449df2273fd8c45a662d6947ce1ebb7aafe80e550a3f68297f3cacc"
+      sha256: "5368f224a74523e8d2e7399ea1638b37aecfca824a3cc4dfdf77bf1fa905ac44"
       url: "https://pub.dev"
     source: hosted
-    version: "1.3.2"
+    version: "1.3.3"
   ffi:
     dependency: transitive
     description:
@@ -173,10 +181,10 @@ packages:
     dependency: transitive
     description:
       name: file_picker
-      sha256: ef9908739bdd9c476353d6adff72e88fd00c625f5b959ae23f7567bd5137db0a
+      sha256: ef7d2a085c1b1d69d17b6842d0734aad90156de08df6bd3c12496d0bd6ddf8e2
       url: "https://pub.dev"
     source: hosted
-    version: "10.2.0"
+    version: "10.3.1"
   fixnum:
     dependency: transitive
     description:
@@ -190,7 +198,7 @@ packages:
     description:
       path: "packages/flet"
       ref: main
-      resolved-ref: cf8823c5d766ea7866480986aa3ee871f4091e78
+      resolved-ref: "4ea9558543657d31dba3b11d6017beed2e16d447"
       url: "https://github.com/flet-dev/flet.git"
     source: git
     version: "0.70.0"
@@ -232,10 +240,10 @@ packages:
     dependency: transitive
     description:
       name: flutter_plugin_android_lifecycle
-      sha256: f948e346c12f8d5480d2825e03de228d0eb8c3a737e4cdaa122267b89c022b5e
+      sha256: "6382ce712ff69b0f719640ce957559dde459e55ecd433c767e06d139ddf16cab"
       url: "https://pub.dev"
     source: hosted
-    version: "2.0.28"
+    version: "2.0.29"
   flutter_svg:
     dependency: transitive
     description:
@@ -282,10 +290,10 @@ packages:
     dependency: transitive
     description:
       name: intl
-      sha256: d6f56758b7d3014a48af9701c085700aac781a92a87a62b1333b46d8879661cf
+      sha256: "3df61194eb431efc39c4ceba583b95633a403f46c9fd341e550ce0bfa50e9aa5"
       url: "https://pub.dev"
     source: hosted
-    version: "0.19.0"
+    version: "0.20.2"
   json_annotation:
     dependency: transitive
     description:
@@ -298,10 +306,10 @@ packages:
     dependency: transitive
     description:
       name: leak_tracker
-      sha256: c35baad643ba394b40aac41080300150a4f08fd0fd6a10378f8f7c6bc161acec
+      sha256: "6bb818ecbdffe216e81182c2f0714a2e62b593f4a4f13098713ff1685dfb6ab0"
       url: "https://pub.dev"
     source: hosted
-    version: "10.0.8"
+    version: "10.0.9"
   leak_tracker_flutter_testing:
     dependency: transitive
     description:
@@ -418,10 +426,10 @@ packages:
     dependency: transitive
     description:
       name: path_provider_foundation
-      sha256: "4843174df4d288f5e29185bd6e72a6fbdf5a4a4602717eed565497429f179942"
+      sha256: "16eef174aacb07e09c351502740fa6254c165757638eba1e9116b0a781201bbd"
       url: "https://pub.dev"
     source: hosted
-    version: "2.4.1"
+    version: "2.4.2"
   path_provider_linux:
     dependency: transitive
     description:
@@ -518,14 +526,22 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "0.2.0"
+  screenshot:
+    dependency: transitive
+    description:
+      name: screenshot
+      sha256: "63817697a7835e6ce82add4228e15d233b74d42975c143ad8cfe07009fab866b"
+      url: "https://pub.dev"
+    source: hosted
+    version: "3.0.0"
   sensors_plus:
     dependency: transitive
     description:
       name: sensors_plus
-      sha256: "905282c917c6bb731c242f928665c2ea15445aa491249dea9d98d7c79dc8fd39"
+      sha256: "89e2bfc3d883743539ce5774a2b93df61effde40ff958ecad78cd66b1a8b8d52"
       url: "https://pub.dev"
     source: hosted
-    version: "6.1.1"
+    version: "6.1.2"
   sensors_plus_platform_interface:
     dependency: transitive
     description:
@@ -546,10 +562,10 @@ packages:
     dependency: transitive
     description:
       name: shared_preferences_android
-      sha256: "20cbd561f743a342c76c151d6ddb93a9ce6005751e7aa458baad3858bfbfb6ac"
+      sha256: "5bcf0772a761b04f8c6bf814721713de6f3e5d9d89caf8d3fe031b02a342379e"
       url: "https://pub.dev"
     source: hosted
-    version: "2.4.10"
+    version: "2.4.11"
   shared_preferences_foundation:
     dependency: transitive
     description:
@@ -639,10 +655,10 @@ packages:
     dependency: transitive
     description:
       name: synchronized
-      sha256: "0669c70faae6270521ee4f05bffd2919892d42d1276e6c495be80174b6bc0ef6"
+      sha256: c254ade258ec8282947a0acbbc90b9575b4f19673533ee46f2f6e9b3aeefd7c0
       url: "https://pub.dev"
     source: hosted
-    version: "3.3.1"
+    version: "3.4.0"
   term_glyph:
     dependency: transitive
     description:
@@ -679,18 +695,18 @@ packages:
     dependency: transitive
     description:
       name: url_launcher_android
-      sha256: "8582d7f6fe14d2652b4c45c9b6c14c0b678c2af2d083a11b604caeba51930d79"
+      sha256: "0aedad096a85b49df2e4725fa32118f9fa580f3b14af7a2d2221896a02cd5656"
       url: "https://pub.dev"
     source: hosted
-    version: "6.3.16"
+    version: "6.3.17"
   url_launcher_ios:
     dependency: transitive
     description:
       name: url_launcher_ios
-      sha256: "7f2022359d4c099eea7df3fdf739f7d3d3b9faf3166fb1dd390775176e0b76cb"
+      sha256: d80b3f567a617cb923546034cc94bfe44eb15f989fe670b37f26abdb9d939cb7
       url: "https://pub.dev"
     source: hosted
-    version: "6.3.3"
+    version: "6.3.4"
   url_launcher_linux:
     dependency: transitive
     description:
@@ -703,10 +719,10 @@ packages:
     dependency: transitive
     description:
       name: url_launcher_macos
-      sha256: "17ba2000b847f334f16626a574c702b196723af2a289e7a93ffcb79acff855c2"
+      sha256: c043a77d6600ac9c38300567f33ef12b0ef4f4783a2c1f00231d2b1941fea13f
       url: "https://pub.dev"
     source: hosted
-    version: "3.2.2"
+    version: "3.2.3"
   url_launcher_platform_interface:
     dependency: transitive
     description:
@@ -759,10 +775,10 @@ packages:
     dependency: transitive
     description:
       name: vector_graphics_compiler
-      sha256: "557a315b7d2a6dbb0aaaff84d857967ce6bdc96a63dc6ee2a57ce5a6ee5d3331"
+      sha256: ca81fdfaf62a5ab45d7296614aea108d2c7d0efca8393e96174bf4d51e6725b0
       url: "https://pub.dev"
     source: hosted
-    version: "1.1.17"
+    version: "1.1.18"
   vector_math:
     dependency: transitive
     description:
@@ -775,10 +791,10 @@ packages:
     dependency: transitive
     description:
       name: vm_service
-      sha256: "0968250880a6c5fe7edc067ed0a13d4bae1577fe2771dcf3010d52c4a9d3ca14"
+      sha256: ddfa8d30d89985b96407efce8acbdd124701f96741f2d981ca860662f1c0dc02
       url: "https://pub.dev"
     source: hosted
-    version: "14.3.1"
+    version: "15.0.0"
   web:
     dependency: transitive
     description:
@@ -807,10 +823,10 @@ packages:
     dependency: transitive
     description:
       name: win32
-      sha256: "329edf97fdd893e0f1e3b9e88d6a0e627128cc17cc316a8d67fda8f1451178ba"
+      sha256: "66814138c3562338d05613a6e368ed8cfb237ad6d64a9e9334be3f309acfca03"
       url: "https://pub.dev"
     source: hosted
-    version: "5.13.0"
+    version: "5.14.0"
   win32_registry:
     dependency: transitive
     description:
@@ -852,5 +868,5 @@ packages:
     source: hosted
     version: "6.5.0"
 sdks:
-  dart: ">=3.7.0 <4.0.0"
+  dart: ">=3.8.0 <4.0.0"
   flutter: ">=3.29.0"