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

{flet_audio-0.2.0.dev51/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.dev51
+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.dev51 → 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.dev67/pyproject.toml

@@ -0,0 +1,97 @@
+[project]
+name = "flet-audio"
+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" }]
+license = "Apache-2.0"
+requires-python = ">=3.10"
+dependencies = [
+    "flet >=0.70.0.dev0",
+]
+
+[project.urls]
+Homepage = "https://flet.dev"
+Documentation = "https://flet-dev.github.io/flet-audio"
+Repository = "https://github.com/flet-dev/flet-audio"
+Issues = "https://github.com/flet-dev/flet-audio/issues"
+
+[tool.setuptools.package-data]
+"flutter.flet_audio" = ["**/*"]
+
+[dependency-groups]
+test = [
+    "pytest >=7.2.0",
+]
+lint = [
+    "ruff >=0.11.7",
+]
+dev = [
+    "pre-commit >=4.2.0",
+    { include-group = 'lint' },
+    { include-group = 'test' },
+]
+docs-coverage = [
+    "docstr-coverage >=2.3.2",
+]
+docs = [
+    "mkdocs >=1.6.1",
+    "mkdocs-material >=9.6.15",
+    "mkdocstrings-python >=1.16.12",
+    "mkdocstrings-python-xref >=1.16.3",
+    "mike >=2.1.3",
+    "markdown >=3.6",
+    "pymdown-extensions >=10.16",
+    "mkdocs-exclude >=1.0.2",
+    "mkdocs-glightbox >=0.4.0",
+    "mkdocs-open-in-new-tab >=1.0.8",
+    "mkdocs-section-index >=0.3.10",
+    "griffe-modernized-annotations >=1.0.8",
+    "griffe-warnings-deprecated >=1.1.0",
+    "pygments >=2.16",
+    "markdown-exec[ansi] >=1.11.0",
+    "pydocstyle >=6.3.0",
+    "linkcheckmd >=1.4.0",
+    "mkdocs-external-images",
+    { include-group = 'docs-coverage' },
+]
+all = [
+    { include-group = 'dev' },
+    { 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"
+
+[tool.ruff]
+line-length = 88
+target-version = "py39"
+fix = true
+show-fixes = true
+
+[tool.ruff.lint]
+select = [
+    # pycodestyle
+    "E",
+    # Pyflakes
+    "F",
+    # pyupgrade
+    "UP",
+    # flake8-bugbear
+    "B",
+    # flake8-simplify
+    "SIM",
+    # isort
+    "I"
+]
+preview = true
+pydocstyle = { convention = 'google' }
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+line-ending = "auto"

flet_audio-0.2.0.dev67/src/flet_audio/__init__.py

@@ -0,0 +1,17 @@
+from flet_audio.audio import Audio
+from flet_audio.types import (
+    AudioDurationChangeEvent,
+    AudioPositionChangeEvent,
+    AudioState,
+    AudioStateChangeEvent,
+    ReleaseMode,
+)
+
+__all__ = [
+    "Audio",
+    "AudioDurationChangeEvent",
+    "AudioPositionChangeEvent",
+    "AudioState",
+    "AudioStateChangeEvent",
+    "ReleaseMode",
+]

flet_audio-0.2.0.dev67/src/flet_audio/audio.py

@@ -0,0 +1,233 @@
+from typing import Optional
+
+import flet as ft
+
+from flet_audio.types import (
+    AudioDurationChangeEvent,
+    AudioPositionChangeEvent,
+    AudioStateChangeEvent,
+    ReleaseMode,
+)
+
+
+@ft.control("Audio")
+class Audio(ft.Service):
+    """
+    A control to simultaneously play multiple audio sources.
+
+    Raises:
+        AssertionError: If both [`src`][(c).] and [`src_base64`][(c).] are `None`.
+
+    Note:
+        This control is non-visual and should be added to
+        [`Page.services`][flet.Page.services]
+        list before it can be used.
+    """
+
+    src: Optional[str] = None
+    """
+    The audio source.
+    Can be a URL or a local [asset file](https://docs.flet.dev/cookbook/assets).
+
+    Note:
+        - At least one of `src` or [`src_base64`][flet_audio.Audio.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.
+    """
+
+    src_base64: Optional[str] = None
+    """
+    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.
+        - [Here](https://github.com/bluefireteam/audioplayers/blob/main/troubleshooting.md#supported-formats--encodings)
+            is a list of supported audio formats.
+    """
+
+    autoplay: bool = False
+    """
+    Starts playing audio as soon as audio control is added to a page.
+
+    Note:
+        Autoplay works in desktop, mobile apps and Safari browser,
+        but doesn't work in Chrome/Edge.
+    """
+
+    volume: ft.Number = 1.0
+    """
+    Sets the volume (amplitude).
+    It's value ranges between `0.0` (mute) and `1.0` (maximum volume).
+    Intermediate values are linearly interpolated.
+    """
+
+    balance: ft.Number = 0.0
+    """
+    Defines the stereo balance.
+
+    * `-1` - The left channel is at full volume; the right channel is silent.
+    * `1` - The right channel is at full volume; the left channel is silent.
+    * `0` - Both channels are at the same volume.
+    """
+
+    playback_rate: ft.Number = 1.0
+    """
+    Defines the playback rate.
+
+    Should ideally be set when creating the constructor.
+
+    Note:
+        - iOS and macOS have limits between `0.5x` and `2x`.
+        - Android SDK version should be 23 or higher.
+    """
+
+    release_mode: ReleaseMode = ReleaseMode.RELEASE
+    """
+    Defines the release mode.
+    """
+
+    on_loaded: Optional[ft.ControlEventHandler["Audio"]] = None
+    """
+    Fires when an audio is loaded/buffered.
+    """
+
+    on_duration_change: Optional[ft.EventHandler[AudioDurationChangeEvent]] = None
+    """
+    Fires as soon as audio duration is available
+    (it might take a while to download or buffer it).
+    """
+
+    on_state_change: Optional[ft.EventHandler[AudioStateChangeEvent]] = None
+    """
+    Fires when audio player state changes.
+    """
+
+    on_position_change: Optional[ft.EventHandler[AudioPositionChangeEvent]] = None
+    """
+    Fires when audio position is changed.
+    Will continuously update the position of the playback
+    every 1 second if the status is playing.
+
+    Can be used for a progress bar.
+    """
+
+    on_seek_complete: Optional[ft.ControlEventHandler["Audio"]] = None
+    """
+    Fires on seek completions.
+    An event is going to be sent as soon as the audio seek is finished.
+    """
+
+    def before_update(self):
+        super().before_update()
+        assert self.src or self.src_base64, "either src or src_base64 must be provided"
+
+    async def play(self, position: ft.DurationValue = 0, 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.
+        """
+        await self._invoke_method(
+            method_name="play",
+            arguments={"position": position},
+            timeout=timeout,
+        )
+
+    async def pause(self, timeout: Optional[float] = 10):
+        """
+        Pauses the audio that is currently playing.
+
+        If you call [`resume()`][flet_audio.Audio.resume] later,
+        the audio will resume from the point that it has been paused.
+        """
+        await self._invoke_method("pause", timeout=timeout)
+
+    async def resume(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("resume", timeout=timeout)
+
+    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].
+
+        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("release", timeout=timeout)
+
+    async 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.
+        """
+        await self._invoke_method(
+            method_name="seek",
+            arguments={"position": position},
+            timeout=timeout,
+        )
+
+    async def get_duration(
+        self, timeout: Optional[float] = 10
+    ) -> Optional[ft.Duration]:
+        """
+        Get audio duration of the audio playback.
+
+        It will be available as soon as the audio duration is available
+        (it might take a while to download or buffer it if file is not local).
+
+        Args:
+            timeout: The maximum amount of time (in seconds) to wait for a response.
+
+        Returns:
+            The duration of audio playback.
+
+        Raises:
+            TimeoutError: If the request times out.
+        """
+        return await self._invoke_method(
+            method_name="get_duration",
+            timeout=timeout,
+        )
+
+    async def get_current_position(
+        self, timeout: Optional[float] = 10
+    ) -> Optional[ft.Duration]:
+        """
+        Get the current position of the audio playback.
+
+        Args:
+            timeout: The maximum amount of time (in seconds) to wait for a response.
+
+        Returns:
+            The current position of the audio playback.
+        """
+        return await self._invoke_method(
+            method_name="get_current_position",
+            timeout=timeout,
+        )

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

@@ -1,13 +1,17 @@
-from dataclasses import dataclass, field
+from dataclasses import dataclass
 from enum import Enum
+from typing import TYPE_CHECKING
 
 import flet as ft
 
+if TYPE_CHECKING:
+    from flet_audio.audio import Audio  # noqa
+
 __all__ = [
+    "AudioDurationChangeEvent",
+    "AudioPositionChangeEvent",
     "AudioState",
     "AudioStateChangeEvent",
-    "AudioPositionChangeEvent",
-    "AudioDurationChangeEvent",
     "ReleaseMode",
 ]
 
@@ -21,9 +25,10 @@ class ReleaseMode(Enum):
 
     Info:
         - 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()`][(p).Audio.release] method.
+            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.
     """
 
     LOOP = "loop"
@@ -60,7 +65,7 @@ class AudioState(Enum):
 
 
 @dataclass
-class AudioStateChangeEvent(ft.Event[ft.EventControlType]):
+class AudioStateChangeEvent(ft.Event["Audio"]):
     """
     Event triggered when the audio playback state changes.
     """
@@ -70,7 +75,7 @@ class AudioStateChangeEvent(ft.Event[ft.EventControlType]):
 
 
 @dataclass
-class AudioPositionChangeEvent(ft.Event[ft.EventControlType]):
+class AudioPositionChangeEvent(ft.Event["Audio"]):
     """
     Event triggered when the audio playback position changes.
     """
@@ -80,7 +85,7 @@ class AudioPositionChangeEvent(ft.Event[ft.EventControlType]):
 
 
 @dataclass
-class AudioDurationChangeEvent(ft.Event[ft.EventControlType]):
+class AudioDurationChangeEvent(ft.Event["Audio"]):
     """
     Event triggered when the audio duration changes.
     """

{flet_audio-0.2.0.dev51 → 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.dev51
+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.dev51 → 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: b996d06ff462b88f5b31d6cceafac34ea6f57968
+      resolved-ref: "4ea9558543657d31dba3b11d6017beed2e16d447"
       url: "https://github.com/flet-dev/flet.git"
     source: git
     version: "0.70.0"
@@ -211,10 +219,10 @@ packages:
     dependency: "direct dev"
     description:
       name: flutter_lints
-      sha256: a25a15ebbdfc33ab1cd26c63a6ee519df92338a9c10f122adda92938253bef04
+      sha256: "9e8c3858111da373efc5aa341de011d9bd23e2c5c5e0c62bccf32438e192d7b1"
       url: "https://pub.dev"
     source: hosted
-    version: "2.0.3"
+    version: "3.0.2"
   flutter_localizations:
     dependency: transitive
     description: flutter
@@ -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:
@@ -322,10 +330,10 @@ packages:
     dependency: transitive
     description:
       name: lints
-      sha256: "0a217c6c989d21039f1498c3ed9f3ed71b354e69873f13a8dfc3c9fe76f1b452"
+      sha256: cbf8d4b858bb0134ef3ef87841abdf8d63bfc255c266b7bf6b39daa1085c4290
       url: "https://pub.dev"
     source: hosted
-    version: "2.1.1"
+    version: "3.0.0"
   logging:
     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:
@@ -823,10 +839,10 @@ packages:
     dependency: transitive
     description:
       name: window_manager
-      sha256: "51d50168ab267d344b975b15390426b1243600d436770d3f13de67e55b05ec16"
+      sha256: "7eb6d6c4164ec08e1bf978d6e733f3cebe792e2a23fb07cbca25c2872bfdbdcd"
       url: "https://pub.dev"
     source: hosted
-    version: "0.5.0"
+    version: "0.5.1"
   window_to_front:
     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"

{flet_audio-0.2.0.dev51 → flet_audio-0.2.0.dev67}/src/flutter/flet_audio/pubspec.yaml

@@ -20,4 +20,4 @@ dependencies:
 dev_dependencies:
   flutter_test:
     sdk: flutter
-  flutter_lints: ^2.0.0
+  flutter_lints: ^3.0.0

flet_audio-0.2.0.dev51/pyproject.toml

@@ -1,71 +0,0 @@
-[project]
-name = "flet-audio"
-version = "0.2.0.dev51"
-description = "Eases audio integration and playback in Flet apps."
-readme = "README.md"
-authors = [{ name = "Flet contributors", email = "hello@flet.dev" }]
-license = "Apache-2.0"
-requires-python = ">=3.10"
-dependencies = [
-    "flet >=0.70.0.dev0",
-]
-
-[project.urls]
-Homepage = "https://flet.dev"
-Documentation = "https://flet-dev.github.io/flet-audio"
-Repository = "https://github.com/flet-dev/flet-audio"
-Issues = "https://github.com/flet-dev/flet-audio/issues"
-
-[tool.setuptools.package-data]
-"flutter.flet_audio" = ["**/*"]
-
-[dependency-groups]
-dev = [
-    "pre-commit>=4.2.0",
-    "ruff>=0.11.7",
-]
-docs = [
-    "mkdocs",
-    "mkdocs-material",
-    "mkdocstrings[python]",
-    "mkdocstrings-python-xref",
-    "mike",
-    "markdown>=3.6",
-    "pymdown-extensions",
-    "mkdocs-glightbox",
-    "mkdocs-section-index",
-    "griffe-modernized-annotations",
-    "pygments>=2.16",
-]
-
-[build-system]
-requires = ["setuptools"]
-build-backend = "setuptools.build_meta"
-
-[tool.ruff]
-line-length = 88
-target-version = "py39"
-fix = true
-show-fixes = true
-
-[tool.ruff.lint]
-select = [
-    # pycodestyle
-    "E",
-    # Pyflakes
-    "F",
-    # pyupgrade
-    "UP",
-    # flake8-bugbear
-    "B",
-    # flake8-simplify
-    "SIM",
-    # isort
-    "I"
-]
-preview = true
-
-[tool.ruff.format]
-quote-style = "double"
-indent-style = "space"
-line-ending = "auto"

flet_audio-0.2.0.dev51/src/flet_audio/__init__.py

@@ -1,7 +0,0 @@
-from .audio import Audio
-from .types import (
-    AudioDurationChangeEvent,
-    AudioPositionChangeEvent,
-    AudioState,
-    AudioStateChangeEvent,
-)

flet_audio-0.2.0.dev51/src/flet_audio/audio.py

@@ -1,278 +0,0 @@
-import asyncio
-from typing import Optional
-
-import flet as ft
-
-from .types import (
-    AudioDurationChangeEvent,
-    AudioPositionChangeEvent,
-    AudioStateChangeEvent,
-    ReleaseMode,
-)
-
-
-@ft.control("Audio")
-class Audio(ft.Service):
-    """
-    A control to simultaneously play multiple audio sources.
-
-    Raises:
-        AssertionError: If both [`src`][(c).] and [`src_base64`][(c).] are `None`.
-
-    Note:
-        This control is non-visual and should be added to [`Page.services`][flet.Page.services]
-        list before it can be used.
-    """
-
-    src: Optional[str] = None
-    """
-    The audio source. Can be a URL or a local [asset file](https://flet.dev/docs/cookbook/assets).
-
-    Note:
-        - At least one of `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.
-    """
-
-    src_base64: Optional[str] = None
-    """
-    Defines the contents of audio file encoded in base-64 format.
-    
-    Note:
-        - At least one of [`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.
-    """
-
-    autoplay: bool = False
-    """
-    Starts playing audio as soon as audio control is added to a page.
-    
-    Note:
-        Autoplay works in desktop, mobile apps and Safari browser, but doesn't work in Chrome/Edge.
-    """
-
-    volume: ft.Number = 1.0
-    """
-    Sets the volume (amplitude).
-    It's value ranges between `0.0` (mute) and `1.0` (maximum volume). 
-    Intermediate values are linearly interpolated.
-    """
-
-    balance: ft.Number = 0.0
-    """
-    Defines the stereo balance.
-
-
-    * `-1` - The left channel is at full volume; the right channel is silent. 
-    * `1` - The right channel is at full volume; the left channel is silent. 
-    * `0` - Both channels are at the same volume.
-    """
-
-    playback_rate: ft.Number = 1.0
-    """
-    Defines the playback rate. 
-    
-    Should ideally be set when creating the constructor.
-    
-    Note: 
-        - iOS and macOS have limits between `0.5x` and `2x`. 
-        - Android SDK version should be 23 or higher.
-    """
-
-    release_mode: ReleaseMode = ReleaseMode.RELEASE
-    """
-    Defines the release mode.
-    """
-
-    on_loaded: Optional[ft.ControlEventHandler["Audio"]] = None
-    """
-    Fires when an audio is loaded/buffered.
-    """
-
-    on_duration_change: Optional[ft.EventHandler[AudioDurationChangeEvent["Audio"]]] = None
-    """
-    Fires as soon as audio duration is available (it might take a while to download or buffer it).
-    """
-
-    on_state_change: Optional[ft.EventHandler[AudioStateChangeEvent["Audio"]]] = None
-    """
-    Fires when audio player state changes.
-    """
-
-    on_position_change: Optional[ft.EventHandler[AudioPositionChangeEvent["Audio"]]] = None
-    """
-    Fires when audio position is changed. 
-    Will continuously update the position of the playback every 1 second if the status is playing. 
-    
-    Can be used for a progress bar.
-    """
-
-    on_seek_complete: Optional[ft.ControlEventHandler["Audio"]] = None
-    """
-    Fires on seek completions. 
-    An event is going to be sent as soon as the audio seek is finished.
-    """
-
-    def before_update(self):
-        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):
-        """
-        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.
-        """
-        await self._invoke_method_async("play", {"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()`][(c).resume] or [`resume_async()`][(c).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):
-        """
-        Pauses the audio that is currently playing.
-
-        If you call [`resume()`][(c).resume] or [`resume_async()`][(c).resume_async] 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)
-
-    def resume(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.
-        """
-        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()`][(c).resume] or [`resume_async()`][(c).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)
-
-    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()`][(c).resume] or [`resume_async()`][(c).resume_async].
-
-        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.release_async(timeout=timeout))
-
-    async def seek_async(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.
-        """
-        await self._invoke_method_async("seek", {"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(self, timeout: Optional[float] = 10) -> Optional[ft.Duration]:
-        """
-        Get audio duration of the audio playback.
-
-        It will be available as soon as the audio duration is available
-        (it might take a while to download or buffer it if file is not local).
-
-        Args:
-            timeout: The maximum amount of time (in seconds) to wait for a response.
-
-        Returns:
-            The duration of audio playback.
-
-        Raises:
-            TimeoutError: If the request times out.
-        """
-        return await self._invoke_method_async("get_duration", timeout=timeout)
-
-    async def get_current_position_async(self, timeout: Optional[float] = 10) -> Optional[ft.Duration]:
-        """
-        Get the current position of the audio playback.
-
-        Args:
-            timeout: The maximum amount of time (in seconds) to wait for a response.
-        Returns:
-            The current position of the audio playback.
-        """
-        return await self._invoke_method_async("get_current_position", timeout=timeout)