flet-geolocator 0.2.0.dev35__tar.gz → 0.2.0.dev52__tar.gz

{flet_geolocator-0.2.0.dev35/src/flet_geolocator.egg-info → flet_geolocator-0.2.0.dev52}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flet-geolocator
-Version: 0.2.0.dev35
+Version: 0.2.0.dev52
 Summary: Adds geolocation capabilities to your Flet apps.
 Author-email: Flet contributors <hello@flet.dev>
 License-Expression: Apache-2.0
@@ -20,7 +20,7 @@ Dynamic: license-file
 [![downloads](https://static.pepy.tech/badge/flet-geolocator/month)](https://pepy.tech/project/flet-geolocator)
 [![license](https://img.shields.io/github/license/flet-dev/flet-geolocator.svg)](https://github.com/flet-dev/flet-geolocator/blob/main/LICENSE)
 
-Adds geolocation capabilities to your [Flet](https://flet.dev) apps. 
+Adds geolocation capabilities to your [Flet](https://flet.dev) apps.
 
 Features include:
 - Get the last known location;
@@ -47,7 +47,9 @@ This package supports the following platforms:
 | Android  |     ✅     |
 | Web      |     ✅     |
 
-## Installation
+## Usage
+
+### Installation
 
 To install the `flet-geolocator` package and add it to your project dependencies:
 
@@ -67,6 +69,6 @@ To install the `flet-geolocator` package and add it to your project dependencies
     poetry add flet-geolocator
     ```
 
-## Examples
+### Examples
 
-For examples, see [this](./examples)
+For examples, see [these](./examples).

{flet_geolocator-0.2.0.dev35 → flet_geolocator-0.2.0.dev52}/README.md

@@ -4,7 +4,7 @@
 [![downloads](https://static.pepy.tech/badge/flet-geolocator/month)](https://pepy.tech/project/flet-geolocator)
 [![license](https://img.shields.io/github/license/flet-dev/flet-geolocator.svg)](https://github.com/flet-dev/flet-geolocator/blob/main/LICENSE)
 
-Adds geolocation capabilities to your [Flet](https://flet.dev) apps. 
+Adds geolocation capabilities to your [Flet](https://flet.dev) apps.
 
 Features include:
 - Get the last known location;
@@ -31,7 +31,9 @@ This package supports the following platforms:
 | Android  |     ✅     |
 | Web      |     ✅     |
 
-## Installation
+## Usage
+
+### Installation
 
 To install the `flet-geolocator` package and add it to your project dependencies:
 
@@ -51,6 +53,6 @@ To install the `flet-geolocator` package and add it to your project dependencies
     poetry add flet-geolocator
     ```
 
-## Examples
+### Examples
 
-For examples, see [this](./examples)
+For examples, see [these](./examples).

flet_geolocator-0.2.0.dev52/pyproject.toml

@@ -0,0 +1,97 @@
+[project]
+name = "flet-geolocator"
+version = "0.2.0.dev52"
+description = "Adds geolocation capabilities to your 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-geolocator"
+Issues = "https://github.com/flet-dev/flet-geolocator/issues"
+
+[tool.setuptools.package-data]
+"flutter.flet_geolocator" = ["**/*"]
+
+[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_geolocator-0.2.0.dev52/src/flet_geolocator/__init__.py

@@ -0,0 +1,27 @@
+from flet_geolocator.geolocator import Geolocator
+from flet_geolocator.types import (
+    ForegroundNotificationConfiguration,
+    GeolocatorAndroidConfiguration,
+    GeolocatorConfiguration,
+    GeolocatorIosActivityType,
+    GeolocatorIosConfiguration,
+    GeolocatorPermissionStatus,
+    GeolocatorPosition,
+    GeolocatorPositionAccuracy,
+    GeolocatorPositionChangeEvent,
+    GeolocatorWebConfiguration,
+)
+
+__all__ = [
+    "ForegroundNotificationConfiguration",
+    "Geolocator",
+    "GeolocatorAndroidConfiguration",
+    "GeolocatorConfiguration",
+    "GeolocatorIosActivityType",
+    "GeolocatorIosConfiguration",
+    "GeolocatorPermissionStatus",
+    "GeolocatorPosition",
+    "GeolocatorPositionAccuracy",
+    "GeolocatorPositionChangeEvent",
+    "GeolocatorWebConfiguration",
+]

{flet_geolocator-0.2.0.dev35 → flet_geolocator-0.2.0.dev52}/src/flet_geolocator/geolocator.py

@@ -1,10 +1,9 @@
-import asyncio
 from dataclasses import field
 from typing import Optional
 
 import flet as ft
 
-from .types import (
+from flet_geolocator.types import (
     GeolocatorConfiguration,
     GeolocatorPermissionStatus,
     GeolocatorPosition,
@@ -19,7 +18,8 @@ class Geolocator(ft.Service):
     """
     A control that allows you to fetch GPS data from your device.
 
-    This control is non-visual and should be added to `page.overlay` list.
+    This control is non-visual and should be added to
+    [`Page.overlay`][flet.] list.
     """
 
     configuration: Optional[GeolocatorConfiguration] = None
@@ -27,30 +27,29 @@ class Geolocator(ft.Service):
     Some additional configuration.
     """
 
-    on_position_change: ft.OptionalEventHandler[
-        GeolocatorPositionChangeEvent["Geolocator"]
-    ] = None
+    on_position_change: Optional[ft.EventHandler[GeolocatorPositionChangeEvent]] = None
     """
     Fires when the position of the device changes.
-
-    Event handler argument is of type [`GeolocatorPositionChangeEvent`][(p).].
     """
 
-    on_error: ft.OptionalControlEventHandler["Geolocator"] = None
+    on_error: Optional[ft.ControlEventHandler["Geolocator"]] = None
     """
     Fires when an error occurs.
-    
-    The `data` property of the event handler argument contains information on the error. 
+
+    The [`data`][flet.Event.data] property of the event
+    handler argument contains information on the error.
     """
 
-    position: Optional[GeolocatorPosition] = field(default=None, init=False)  # todo: make this property readonly
+    position: Optional[GeolocatorPosition] = field(
+        default=None, init=False
+    )  # TODO: make this property readonly
     """
     The current position of the device. (read-only)
 
     Starts as `None` and will be updated when the position changes.
     """
 
-    async def get_current_position_async(
+    async def get_current_position(
         self,
         configuration: Optional[GeolocatorConfiguration] = None,
         timeout: float = 30,
@@ -58,50 +57,59 @@ class Geolocator(ft.Service):
         """
         Gets the current position of the device with the desired accuracy and settings.
 
+        Note:
+            Depending on the availability of different location services,
+            this can take several seconds. It is recommended to call the
+            [`get_last_known_position`][..] method first to receive a
+            known/cached position and update it with the result of the
+            [`get_current_position`][..] method.
+
         Args:
             configuration: Additional configuration for the location request.
-                If not specified, then the [`Geolocator.configuration`][(p).] property is used.
+                If not specified, then the [`Geolocator.configuration`][(p).]
+                property is used.
             timeout: The maximum amount of time (in seconds) to wait for a response.
+
         Returns:
             The current position of the device as a [`GeolocatorPosition`][(p).].
+
         Raises:
             TimeoutError: If the request times out.
-
-        Note:
-            Depending on the availability of different location services, this can take several seconds.
-            It is recommended to call the [`get_last_known_position`][..] method first to receive a
-            known/cached position and update it with the result of the [`get_current_position`][..] method.
         """
-        r = await self._invoke_method_async(
+        r = await self._invoke_method(
             method_name="get_current_position",
             arguments={"configuration": configuration or self.configuration},
             timeout=timeout,
         )
         return GeolocatorPosition(**r)
 
-    async def get_last_known_position_async(
-        self, timeout: float = 10
-    ) -> GeolocatorPosition:
+    async def get_last_known_position(self, timeout: float = 10) -> GeolocatorPosition:
         """
         Gets the last known position stored on the user's device.
-        The accuracy can be defined using the [`Geolocator.configuration`][(p).] property.
+        The accuracy can be defined using the
+        [`Geolocator.configuration`][(p).] property.
 
         Note:
             This method is not supported on web plaform.
 
         Args:
             timeout: The maximum amount of time (in seconds) to wait for a response.
+
         Returns:
-            `True` if the app's settings were opened successfully, `False` otherwise.
+            The last known position of the device as a [`GeolocatorPosition`][(p).].
+
         Raises:
             AssertionError: If invoked on a web platform.
             TimeoutError: If the request times out.
         """
         assert not self.page.web, "get_last_known_position is not supported on web"
-        r = await self._invoke_method_async("get_last_known_position", timeout=timeout)
+        r = await self._invoke_method(
+            "get_last_known_position",
+            timeout=timeout,
+        )
         return GeolocatorPosition(**r)
 
-    async def get_permission_status_async(
+    async def get_permission_status(
         self, timeout: float = 10
     ) -> GeolocatorPermissionStatus:
         """
@@ -109,46 +117,54 @@ class Geolocator(ft.Service):
 
         Args:
             timeout: The maximum amount of time (in seconds) to wait for a response.
+
         Returns:
             The status of the permission.
+
         Raises:
             TimeoutError: If the request times out.
         """
-        r = await self._invoke_method_async("get_permission_status", timeout=timeout)
+        r = await self._invoke_method(
+            "get_permission_status",
+            timeout=timeout,
+        )
         return GeolocatorPermissionStatus(r)
 
-    async def request_permission_async(
-        self, timeout: int = 60
-    ) -> GeolocatorPermissionStatus:
+    async def request_permission(self, timeout: int = 60) -> GeolocatorPermissionStatus:
         """
         Requests the device for access to the device's location.
 
         Args:
             timeout: The maximum amount of time (in seconds) to wait for a response.
+
         Returns:
             The status of the permission request.
+
         Raises:
             TimeoutError: If the request times out.
         """
-        r = await self._invoke_method_async("request_permission", timeout=timeout)
+        r = await self._invoke_method(
+            "request_permission",
+            timeout=timeout,
+        )
         return GeolocatorPermissionStatus(r)
 
-    async def is_location_service_enabled_async(self, timeout: float = 10) -> bool:
+    async def is_location_service_enabled(self, timeout: float = 10) -> bool:
         """
         Checks if location service is enabled.
 
         Args:
             timeout: The maximum amount of time (in seconds) to wait for a response.
+
         Returns:
             `True` if location service is enabled, `False` otherwise.
+
         Raises:
             TimeoutError: If the request times out.
         """
-        return await self._invoke_method_async(
-            "is_location_service_enabled", timeout=timeout
-        )
+        return await self._invoke_method("is_location_service_enabled", timeout=timeout)
 
-    async def open_app_settings_async(self, timeout: float = 10) -> bool:
+    async def open_app_settings(self, timeout: float = 10) -> bool:
         """
         Attempts to open the app's settings.
 
@@ -157,16 +173,21 @@ class Geolocator(ft.Service):
 
         Args:
             timeout: The maximum amount of time (in seconds) to wait for a response.
+
         Returns:
             `True` if the app's settings were opened successfully, `False` otherwise.
+
         Raises:
             AssertionError: If invoked on a web platform.
             TimeoutError: If the request times out.
         """
         assert not self.page.web, "open_app_settings is not supported on web"
-        return await self._invoke_method_async("open_app_settings", timeout=timeout)
+        return await self._invoke_method(
+            "open_app_settings",
+            timeout=timeout,
+        )
 
-    def open_location_settings(self, timeout: float = 10):
+    async def open_location_settings(self, timeout: float = 10) -> bool:
         """
         Attempts to open the device's location settings.
 
@@ -175,33 +196,21 @@ class Geolocator(ft.Service):
 
         Args:
             timeout: The maximum amount of time (in seconds) to wait for a response.
-        Returns:
-            `True` if the device's settings were opened successfully, `False` otherwise.
-        Raises:
-            AssertionError: If invoked on a web platform.
-            TimeoutError: If the request times out.
-        """
-        asyncio.create_task(self.open_location_settings_async(timeout=timeout))
 
-    async def open_location_settings_async(self, timeout: float = 10):
-        """
-        Attempts to open the device's location settings.
-
-        Note:
-            This method is not supported on web plaform.
-
-        Args:
-            timeout: The maximum amount of time (in seconds) to wait for a response.
         Returns:
             `True` if the device's settings were opened successfully, `False` otherwise.
+
         Raises:
             AssertionError: If invoked on a web platform.
             TimeoutError: If the request times out.
         """
         assert not self.page.web, "open_location_settings is not supported on web"
-        await self._invoke_method_async("open_location_settings", timeout=timeout)
+        return await self._invoke_method(
+            "open_location_settings",
+            timeout=timeout,
+        )
 
-    async def distance_between_async(
+    async def distance_between(
         self,
         start_latitude: ft.Number,
         start_longitude: ft.Number,
@@ -221,12 +230,14 @@ class Geolocator(ft.Service):
             end_latitude: The latitude of the ending point, in degrees.
             end_longitude: The longitude of the ending point, in degrees.
             timeout: The maximum amount of time (in seconds) to wait for a response.
+
         Returns:
             The distance between the coordinates in meters.
+
         Raises:
             TimeoutError: If the request times out.
         """
-        await self._invoke_method_async(
+        await self._invoke_method(
             method_name="distance_between",
             arguments={
                 "start_latitude": start_latitude,

{flet_geolocator-0.2.0.dev35 → flet_geolocator-0.2.0.dev52}/src/flet_geolocator/types.py

@@ -1,21 +1,24 @@
 import datetime
 from dataclasses import dataclass, field
 from enum import Enum
-from typing import Optional
+from typing import TYPE_CHECKING, Optional
 
 import flet as ft
 
+if TYPE_CHECKING:
+    from flet_geolocator.geolocator import Geolocator  # noqa
+
 __all__ = [
-    "GeolocatorPositionAccuracy",
-    "GeolocatorPermissionStatus",
-    "GeolocatorIosActivityType",
-    "GeolocatorPosition",
+    "ForegroundNotificationConfiguration",
+    "GeolocatorAndroidConfiguration",
     "GeolocatorConfiguration",
-    "GeolocatorWebConfiguration",
+    "GeolocatorIosActivityType",
     "GeolocatorIosConfiguration",
-    "GeolocatorAndroidConfiguration",
+    "GeolocatorPermissionStatus",
+    "GeolocatorPosition",
+    "GeolocatorPositionAccuracy",
     "GeolocatorPositionChangeEvent",
-    "ForegroundNotificationConfiguration",
+    "GeolocatorWebConfiguration",
 ]
 
 
@@ -89,17 +92,18 @@ class GeolocatorPermissionStatus(Enum):
 
     DENIED = "denied"
     """
-    Permission to access the device's location is denied. 
+    Permission to access the device's location is denied.
 
-    The app should try to request permission using the [`Geolocator.request_permission`][(p).] method.
+    The app should try to request permission using the
+    [`Geolocator.request_permission`][(p).] method.
     """
 
     DENIED_FOREVER = "deniedForever"
     """
     Permission to access the device's location is permanently denied.
 
-    When requesting permissions, the permission dialog will not be shown until the user updates
-    the permission in the app settings.
+    When requesting permissions, the permission dialog will not be shown until the
+    user updates the permission in the app settings.
     """
 
     WHILE_IN_USE = "whileInUse"
@@ -109,15 +113,16 @@ class GeolocatorPermissionStatus(Enum):
 
     ALWAYS = "always"
     """
-    Permission to access the device's location is allowed even when the app is running in the background.
+    Permission to access the device's location is allowed even when the app is
+    running in the background.
     """
 
     UNABLE_TO_DETERMINE = "unableToDetermine"
     """
     Permission status cannot be determined.
 
-    This status is only returned by the [`Geolocator.request_permission`][(p).] method on the web platform
-    for browsers that did not implement the Permissions API.
+    This status is only returned by the [`Geolocator.request_permission`][(p).] method
+    on the web platform for browsers that did not implement the Permissions API.
     See: https://developer.mozilla.org/en-US/docs/Web/API/Permissions_API
     """
 
@@ -175,7 +180,7 @@ class GeolocatorPosition:
     """
     The speed at which the device is traveling in meters per second over ground.
 
-    The speed is not available on all devices. 
+    The speed is not available on all devices.
     In these cases the value is `0.0`.
     """
 
@@ -183,7 +188,7 @@ class GeolocatorPosition:
     """
     The altitude of the device in meters.
 
-    The altitude is not available on all devices. 
+    The altitude is not available on all devices.
     In these cases the returned value is `0.0`.
     """
 
@@ -196,7 +201,7 @@ class GeolocatorPosition:
     """
     The estimated horizontal accuracy of the position in meters.
 
-    The accuracy is not available on all devices. 
+    The accuracy is not available on all devices.
     In these cases the value is `0.0`.
     """
 
@@ -204,7 +209,7 @@ class GeolocatorPosition:
     """
     The estimated vertical accuracy of the position in meters.
 
-    The accuracy is not available on all devices. 
+    The accuracy is not available on all devices.
     In these cases the value is `0.0`.
     """
 
@@ -212,7 +217,7 @@ class GeolocatorPosition:
     """
     The heading in which the device is traveling in degrees.
 
-    The heading is not available on all devices. 
+    The heading is not available on all devices.
     In these cases the value is `0.0`.
     """
 
@@ -220,7 +225,7 @@ class GeolocatorPosition:
     """
     The estimated heading accuracy of the position in degrees.
 
-    The heading accuracy is not available on all devices. 
+    The heading accuracy is not available on all devices.
     In these cases the value is `0.0`.
     """
 
@@ -228,7 +233,7 @@ class GeolocatorPosition:
     """
     The estimated speed accuracy of this position, in meters per second.
 
-    The speed accuracy is not available on all devices. 
+    The speed accuracy is not available on all devices.
     In these cases the value is `0.0`.
     """
 
@@ -237,7 +242,8 @@ class GeolocatorPosition:
     The floor specifies the floor of the building on which the device is
     located.
 
-    The floor property is only available on iOS and only when the information is available. 
+    The floor property is only available on iOS
+    and only when the information is available.
     In all other cases this value will be `None`.
     """
 
@@ -261,7 +267,7 @@ class GeolocatorConfiguration:
     """
     The minimum distance (measured in meters) a device must move
     horizontally before an update event is generated.
-    
+
     Set to `0` when you want to be notified of all movements.
     """
 
@@ -280,8 +286,8 @@ class GeolocatorWebConfiguration(GeolocatorConfiguration):
     maximum_age: ft.DurationValue = field(default_factory=lambda: ft.Duration())
     """
     A value indicating the maximum age of a possible cached
-    position that is acceptable to return. If set to 0, it means 
-    that the device cannot use a cached position and must 
+    position that is acceptable to return. If set to 0, it means
+    that the device cannot use a cached position and must
     attempt to retrieve the real current position.
     """
 
@@ -300,7 +306,7 @@ class GeolocatorIosConfiguration(GeolocatorConfiguration):
     """
     Allows the location manager to pause updates to improve battery life
     on the target device without sacrificing location data.
-    When this property is set to `true`, the location manager pauses updates
+    When this property is set to `True`, the location manager pauses updates
     (and powers down the appropriate hardware) at times when the
     location data is unlikely to change.
     """
@@ -309,7 +315,7 @@ class GeolocatorIosConfiguration(GeolocatorConfiguration):
     """
     Flag to ask the Apple OS to show the background location indicator (iOS only)
     if app starts up and background and requests the users location.
-    
+
     For this setting to work and for the location to be retrieved the user must
     have granted "always" permissions for location retrieval.
     """
@@ -317,7 +323,7 @@ class GeolocatorIosConfiguration(GeolocatorConfiguration):
     allow_background_location_updates: bool = True
     """
     Flag to allow the app to receive location updates in the background (iOS only)
-    
+
     Note:
         For this setting to work `Info.plist` should contain the following keys:
             - UIBackgroundModes and the value should contain "location"
@@ -360,7 +366,8 @@ class ForegroundNotificationConfiguration:
     """
     When enabled, a WifiLock is acquired when background execution is started.
     This allows the application to keep the Wi-Fi radio awake, even when the
-    user has not used the device in a while (e.g. for background network communications).
+    user has not used the device in a while
+    (e.g. for background network communications).
 
     Wifi lock permissions should be obtained first by using a permissions library.
     """
@@ -389,23 +396,24 @@ class GeolocatorAndroidConfiguration(GeolocatorConfiguration):
     """
     Whether altitude should be calculated as MSL (EGM2008) from NMEA messages
     and reported as the altitude instead of using the geoidal height (WSG84). Setting
-    this property true will help to align Android altitude to that of iOS which uses MSL.
-    
-    If the NMEA message is empty then the altitude reported will still be the standard WSG84
-    altitude from the GPS receiver.
-    
+    this property true will help to align Android altitude to that of iOS which
+    uses MSL.
+
+    If the NMEA message is empty then the altitude reported will still be
+    the standard WSG84 altitude from the GPS receiver.
+
     MSL Altitude is only available starting from Android N and not all devices support
     NMEA message returning $GPGGA sequences.
-    
-    This property only works with position stream updates and has no effect when getting the
-    current position or last known position.
+
+    This property only works with position stream updates and has no effect when
+    getting the current position or last known position.
     """
 
     foreground_notification_config: Optional[ForegroundNotificationConfiguration] = None
 
 
 @dataclass
-class GeolocatorPositionChangeEvent(ft.Event[ft.EventControlType]):
+class GeolocatorPositionChangeEvent(ft.Event["Geolocator"]):
     position: GeolocatorPosition
     """
     The current/new position of the device.

{flet_geolocator-0.2.0.dev35 → flet_geolocator-0.2.0.dev52/src/flet_geolocator.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flet-geolocator
-Version: 0.2.0.dev35
+Version: 0.2.0.dev52
 Summary: Adds geolocation capabilities to your Flet apps.
 Author-email: Flet contributors <hello@flet.dev>
 License-Expression: Apache-2.0
@@ -20,7 +20,7 @@ Dynamic: license-file
 [![downloads](https://static.pepy.tech/badge/flet-geolocator/month)](https://pepy.tech/project/flet-geolocator)
 [![license](https://img.shields.io/github/license/flet-dev/flet-geolocator.svg)](https://github.com/flet-dev/flet-geolocator/blob/main/LICENSE)
 
-Adds geolocation capabilities to your [Flet](https://flet.dev) apps. 
+Adds geolocation capabilities to your [Flet](https://flet.dev) apps.
 
 Features include:
 - Get the last known location;
@@ -47,7 +47,9 @@ This package supports the following platforms:
 | Android  |     ✅     |
 | Web      |     ✅     |
 
-## Installation
+## Usage
+
+### Installation
 
 To install the `flet-geolocator` package and add it to your project dependencies:
 
@@ -67,6 +69,6 @@ To install the `flet-geolocator` package and add it to your project dependencies
     poetry add flet-geolocator
     ```
 
-## Examples
+### Examples
 
-For examples, see [this](./examples)
+For examples, see [these](./examples).

{flet_geolocator-0.2.0.dev35 → flet_geolocator-0.2.0.dev52}/src/flutter/flet_geolocator/lib/src/geolocator.dart

@@ -67,7 +67,7 @@ class GeolocatorService extends FletService {
         break;
       case "open_location_settings":
         if (!kIsWeb) {
-          await Geolocator.openLocationSettings();
+          return await Geolocator.openLocationSettings();
         }
         break;
       case "get_last_known_position":

{flet_geolocator-0.2.0.dev35 → flet_geolocator-0.2.0.dev52}/src/flutter/flet_geolocator/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"
   boolean_selector:
     dependency: transitive
     description:
@@ -101,10 +101,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:
@@ -125,10 +125,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:
@@ -142,7 +142,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"
@@ -163,10 +163,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
@@ -184,10 +184,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:
@@ -306,10 +306,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:
@@ -322,10 +322,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:
@@ -346,10 +346,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:
@@ -410,18 +410,18 @@ packages:
     dependency: transitive
     description:
       name: package_info_plus
-      sha256: "7976bfe4c583170d6cdc7077e3237560b364149fcd268b5f53d95a991963b191"
+      sha256: "16eee997588c60225bda0488b6dcfac69280a6b7a3cf02c741895dd370a02968"
       url: "https://pub.dev"
     source: hosted
-    version: "8.3.0"
+    version: "8.3.1"
   package_info_plus_platform_interface:
     dependency: transitive
     description:
       name: package_info_plus_platform_interface
-      sha256: "6c935fb612dff8e3cc9632c2b301720c77450a126114126ffaafe28d2e87956c"
+      sha256: "202a487f08836a592a6bd4f901ac69b3a8f146af552bbd14407b6b41e1c3f086"
       url: "https://pub.dev"
     source: hosted
-    version: "3.2.0"
+    version: "3.2.1"
   path:
     dependency: transitive
     description:
@@ -458,10 +458,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:
@@ -558,14 +558,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:
@@ -586,10 +594,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:
@@ -711,18 +719,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:
@@ -735,10 +743,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:
@@ -791,10 +799,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:
@@ -807,10 +815,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:
@@ -839,10 +847,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:
@@ -855,10 +863,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:
@@ -884,5 +892,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_geolocator-0.2.0.dev35 → flet_geolocator-0.2.0.dev52}/src/flutter/flet_geolocator/pubspec.yaml

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

flet_geolocator-0.2.0.dev35/pyproject.toml

@@ -1,71 +0,0 @@
-[project]
-name = "flet-geolocator"
-version = "0.2.0.dev35"
-description = "Adds geolocation capabilities to your 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-geolocator"
-Issues = "https://github.com/flet-dev/flet-geolocator/issues"
-
-[tool.setuptools.package-data]
-"flutter.flet_geolocator" = ["**/*"]
-
-[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_geolocator-0.2.0.dev35/src/flet_geolocator/__init__.py

@@ -1,13 +0,0 @@
-from .geolocator import Geolocator
-from .types import (
-    ForegroundNotificationConfiguration,
-    GeolocatorAndroidConfiguration,
-    GeolocatorConfiguration,
-    GeolocatorIosActivityType,
-    GeolocatorIosConfiguration,
-    GeolocatorPermissionStatus,
-    GeolocatorPosition,
-    GeolocatorPositionAccuracy,
-    GeolocatorPositionChangeEvent,
-    GeolocatorWebConfiguration,
-)