flet-permission-handler 0.2.0.dev34__py3-none-any.whl → 0.2.0.dev55__py3-none-any.whl

flet_permission_handler/__init__.py

@@ -1,2 +1,8 @@
 from .permission_handler import PermissionHandler
 from .types import Permission, PermissionStatus
+
+__all__ = [
+    "Permission",
+    "PermissionHandler",
+    "PermissionStatus",
+]

flet_permission_handler/permission_handler.py

@@ -12,10 +12,12 @@ class PermissionHandler(ft.Service):
     """
     Manages permissions for the application.
 
-    This control is non-visual and should be added to `Page.services` list.
+    This control is non-visual and should be added
+    to [`Page.services`][flet.Page.services] list.
 
-    Note:
+    Danger: Platform support
         Currently only supported on Android, iOS, Windows, and Web platforms.
+
     Raises:
         FletUnsupportedPlatformException: If the platform is not supported.
     """
@@ -34,7 +36,8 @@ class PermissionHandler(ft.Service):
             ]
         ):
             raise ft.FletUnsupportedPlatformException(
-                "PermissionHandler is currently only supported on Android, iOS, Windows, and Web platforms."
+                "PermissionHandler is currently only supported on Android, iOS, "
+                "Windows, and Web platforms."
             )
 
     async def get_status_async(
@@ -46,13 +49,17 @@ class PermissionHandler(ft.Service):
         Args:
             permission: The `Permission` to check the status for.
             timeout: The maximum amount of time (in seconds) to wait for a response.
+
         Returns:
             A `PermissionStatus` if the status is known, otherwise `None`.
+
         Raises:
             TimeoutError: If the request times out.
         """
         status = await self._invoke_method_async(
-            "get_status", {"permission": permission}, timeout=timeout
+            method_name="get_status",
+            arguments={"permission": permission},
+            timeout=timeout,
         )
         return PermissionStatus(status) if status is not None else None
 
@@ -60,18 +67,24 @@ class PermissionHandler(ft.Service):
         self, permission: Permission, timeout: int = 60
     ) -> Optional[PermissionStatus]:
         """
-        Request the user for access to the `permission` if access hasn't already been granted access before.
+        Request the user for access to the `permission` if access hasn't already been
+        granted access before.
 
         Args:
             permission: The `Permission` to request.
             timeout: The maximum amount of time (in seconds) to wait for a response.
+
         Returns:
-            The new `PermissionStatus` after the request, or `None` if the request was not successful.
+            The new `PermissionStatus` after the request, or `None` if the request
+                was not successful.
+
         Raises:
             TimeoutError: If the request times out.
         """
         r = await self._invoke_method_async(
-            "request", {"permission": permission}, timeout=timeout
+            method_name="request",
+            arguments={"permission": permission},
+            timeout=timeout,
         )
         return PermissionStatus(r) if r is not None else None
 
@@ -81,9 +94,14 @@ class PermissionHandler(ft.Service):
 
         Args:
             timeout: The maximum amount of time (in seconds) to wait for a response.
+
         Returns:
             `True` if the app settings page could be opened, otherwise `False`.
+
         Raises:
             TimeoutError: If the request times out.
         """
-        return await self._invoke_method_async("open_app_settings", timeout=timeout)
+        return await self._invoke_method_async(
+            method_name="open_app_settings",
+            timeout=timeout,
+        )

flet_permission_handler/types.py

@@ -1,8 +1,8 @@
 from enum import Enum
 
 __all__ = [
-    "PermissionStatus",
     "Permission",
+    "PermissionStatus",
 ]
 
 
@@ -21,22 +21,23 @@ class PermissionStatus(Enum):
 
     PERMANENTLY_DENIED = "permanentlyDenied"
     """
-    Permission to the requested feature is permanently denied, 
-    the permission dialog will not be shown when requesting this permission. 
+    Permission to the requested feature is permanently denied,
+    the permission dialog will not be shown when requesting this permission.
     The user may still change the permission status in the settings.
 
     Note:
-        - On Android: 
-            - Android 11+ (API 30+): whether the user denied the permission for a second time.
-            
-            - Below Android 11 (API 30): whether the user denied access 
+        - On Android:
+            - Android 11+ (API 30+): whether the user denied the permission
+            for a second time.
+            - Below Android 11 (API 30): whether the user denied access
             to the requested feature and selected to never again show a request.
         - On iOS: If the user has denied access to the requested feature.
     """
 
     LIMITED = "limited"
     """
-    The user has authorized this application for limited access. So far this is only relevant for the Photo Library picker.
+    The user has authorized this application for limited access.
+    So far this is only relevant for the Photo Library picker.
 
     Note:
         Only supported on iOS (iOS14+) and Android (Android 14+).
@@ -44,7 +45,8 @@ class PermissionStatus(Enum):
 
     PROVISIONAL = "provisional"
     """
-    The application is provisionally authorized to post non-interruptive user notifications.
+    The application is provisionally authorized to post non-interruptive
+    user notifications.
 
     Note:
         Only supported on iOS (iOS 12+).
@@ -52,14 +54,17 @@ class PermissionStatus(Enum):
 
     RESTRICTED = "restricted"
     """
-    The OS denied access to the requested feature. The user cannot change this app's status, possibly due to active restrictions such as parental controls being in place.
+    The OS denied access to the requested feature. The user cannot change
+    this app's status, possibly due to active restrictions such as parental
+    controls being in place.
 
     Note:
         Only supported on iOS.
     """
 
 
-# todo: show how pyproject config for each could look like for each permission (what exactly is needed in manifest, plist, etc.)
+# todo: show how pyproject config for each could look like for each permission
+#  (what exactly is needed in manifest, plist, etc.)
 
 
 class Permission(Enum):
@@ -68,7 +73,7 @@ class Permission(Enum):
     ACCESS_MEDIA_LOCATION = "accessMediaLocation"
     """
     Permission for accessing the device's media library.
-    
+
     Allows an application to access any geographic locations persisted in the
     user's shared collection.
 
@@ -79,10 +84,10 @@ class Permission(Enum):
     ACCESS_NOTIFICATION_POLICY = "accessNotificationPolicy"
     """
     Permission for accessing the device's notification policy.
-    
+
     Allows the user to access the notification policy of the phone.
     Example: Allows app to turn on and off do-not-disturb.
-    
+
     Note:
         Only supported on Android Marshmallow+ (API 23+) only.
     """
@@ -101,7 +106,7 @@ class Permission(Enum):
     Allows user to accept that your app collects data about end users and
     shares it with other companies for purposes of tracking across apps and
     websites.
-    
+
     Note:
         Only supported on iOS only.
     """
@@ -116,7 +121,7 @@ class Permission(Enum):
     AUDIO = "audio"
     """
     Permission for accessing the device's audio files from external storage.
-    
+
     Note:
         Only supported on Android 13+ (API 33+) only.
     """
@@ -124,7 +129,7 @@ class Permission(Enum):
     BACKGROUND_REFRESH = "backgroundRefresh"
     """
     Permission for reading the current background refresh status.
-    
+
     Note:
         Only supported on iOS only.
     """
@@ -134,7 +139,7 @@ class Permission(Enum):
     Permission for accessing the device's bluetooth adapter state.
 
     Depending on the platform and version, the requirements are slightly different:
-    
+
     Info:
         - Android: always allowed.
         - iOS:
@@ -155,7 +160,7 @@ class Permission(Enum):
     """
     Permission for connecting to Bluetooth devices.
     Allows the user to connect with already paired Bluetooth devices.
-    
+
     Note:
         Only supported on Android 12+ (API 31+) only.
     """
@@ -177,7 +182,8 @@ class Permission(Enum):
     """
     Permission for writing to the device's calendar.
 
-    On iOS 16 and lower, this permission is identical to `Permission.CALENDAR_FULL_ACCESS`.
+    On iOS 16 and lower, this permission is identical to
+    [`CALENDAR_FULL_ACCESS`][..].
     """
 
     CAMERA = "camera"
@@ -202,7 +208,7 @@ class Permission(Enum):
     """
     Permission for sending critical alerts.
     Allow for sending notifications that override the ringer.
-    
+
     Note:
         Only supported on iOS only.
     """
@@ -210,7 +216,7 @@ class Permission(Enum):
     IGNORE_BATTERY_OPTIMIZATIONS = "ignoreBatteryOptimizations"
     """
     Permission for accessing ignore battery optimizations.
-    
+
     Note:
         Only supported on Android only.
     """
@@ -232,8 +238,9 @@ class Permission(Enum):
 
     LOCATION_WHEN_IN_USE = "locationWhenInUse"
     """
-    Permission for accessing the device's location when the app is running in the foreground.
-    
+    Permission for accessing the device's location when the app is
+    running in the foreground.
+
     Info:
         - Android: Fine and Coarse Location
         - iOS: CoreLocation - WhenInUse
@@ -243,21 +250,24 @@ class Permission(Enum):
     """
     Permission for accessing the device's external storage.
     Allows an application a broad access to external storage in scoped storage.
-    
-    You should request this permission only when your app cannot 
+
+    You should request this permission only when your app cannot
     effectively make use of the more privacy-friendly APIs.
-    For more information: https://developer.android.com/training/data-storage/manage-all-files
-    
+    For more information:
+    https://developer.android.com/training/data-storage/manage-all-files
+
     Info:
         When the privacy-friendly APIs (i.e. [Storage Access Framework](https://developer.android.com/guide/topics/providers/document-provider)
         or the [MediaStore](https://developer.android.com/training/data-storage/shared/media) APIs)
         is all your app needs, the [PermissionGroup.storage] are the only
         permissions you need to request.
-        
-        If the usage of this permission is needed, you have to fill out 
-        the Permission Declaration Form upon submitting your app to the Google Play Store. 
-        More details: https://support.google.com/googleplay/android-developer/answer/9214102#zippy=
-    
+
+        If the usage of this permission is needed, you have to fill out
+        the Permission Declaration Form upon submitting your app to the
+        Google Play Store.
+        More details:
+        https://support.google.com/googleplay/android-developer/answer/9214102#zippy=
+
     Note:
         Only supported on Android 11+ (API 30+) only.
     """
@@ -265,7 +275,7 @@ class Permission(Enum):
     MEDIA_LIBRARY = "mediaLibrary"
     """
     Permission for accessing the device's media library.
-    
+
     Note:
         Only supported on iOS 9.3+ only
     """
@@ -291,7 +301,7 @@ class Permission(Enum):
     PHONE = "phone"
     """
     Permission for accessing the device's phone state.
-    
+
     Note:
         Only supported on Android only.
     """
@@ -300,7 +310,7 @@ class Permission(Enum):
     """
     Permission for accessing (read & write) the device's photos.
 
-    If you only want to add photos, you can use 
+    If you only want to add photos, you can use
     the `PHOTOS_ADD_ONLY` permission instead (iOS only).
     """
 
@@ -309,7 +319,7 @@ class Permission(Enum):
     Permission for adding photos to the device's photo library (iOS only).
 
     If you want to read them as well, use the `Permission.PHOTOS` permission instead.
-    
+
     Info:
         iOS: Photos (14+ read & write access level)
     """
@@ -317,7 +327,7 @@ class Permission(Enum):
     REMINDERS = "reminders"
     """
     Permission for accessing the device's reminders.
-    
+
     Note:
         Only supported on iOS only.
     """
@@ -325,7 +335,7 @@ class Permission(Enum):
     REQUEST_INSTALL_PACKAGES = "requestInstallPackages"
     """
     Permission for requesting installing packages.
-    
+
     Note:
         Only supported on Android Marshmallow+ (API 23+) only.
     """
@@ -341,7 +351,7 @@ class Permission(Enum):
     SENSORS = "sensors"
     """
     Permission for accessing the device's sensors.
-    
+
     Info:
         - Android: Body Sensors
         - iOS: CoreMotion
@@ -365,8 +375,10 @@ class Permission(Enum):
     Permission for accessing speech recognition.
 
     Info:
-        - Android: Requests access to microphone (identical to requesting `Permission.MICROPHONE`).
-        - iOS: Requests speech access (different from requesting `Permission.MICROPHONE`).
+        - Android: Requests access to microphone
+            (identical to requesting [`MICROPHONE`][..]).
+        - iOS: Requests speech access (different from requesting
+            [`MICROPHONE`][..]).
     """
 
     STORAGE = "storage"
@@ -374,14 +386,16 @@ class Permission(Enum):
     Permission for accessing external storage.
 
     Depending on the platform and version, the requirements are slightly different:
-    
+
     Info:
         - Android:
             - On Android 13 (API 33) and above, this permission is deprecated and
             always returns `PermissionStatus.denied`. Instead use `Permission.PHOTOS`,
-            `Permission.VIDEO`, `Permission.AUDIO` or `Permission.MANAGE_EXTERNAL_STORAGE`. 
-            For more information see [this](https://pub.dev/packages/permission_handler#faq).
-            
+            `Permission.VIDEO`, `Permission.AUDIO` or
+            `Permission.MANAGE_EXTERNAL_STORAGE`.
+            For more information see
+            [this](https://pub.dev/packages/permission_handler#faq).
+
             - Below Android 13 (API 33), the `READ_EXTERNAL_STORAGE` and
             `WRITE_EXTERNAL_STORAGE` permissions are requested (depending on the
             definitions in the AndroidManifest.xml) file.
@@ -392,7 +406,7 @@ class Permission(Enum):
     """
     Permission for creating system alert window.
     Allows an app to create windows shown on top of all other apps.
-    
+
     Note:
         Only supported on Android only.
     """
@@ -405,7 +419,7 @@ class Permission(Enum):
     VIDEOS = "videos"
     """
     Permission for accessing the device's video files from external storage.
-    
+
     Note:
         Only supported on Android 13+ (API 33+) only.
     """

{flet_permission_handler-0.2.0.dev34.dist-info → flet_permission_handler-0.2.0.dev55.dist-info}/METADATA

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: flet-permission-handler
-Version: 0.2.0.dev34
-Summary: PermissionHandler control for Flet
+Version: 0.2.0.dev55
+Summary: A Flet extension that simplifies working with permissions in your app.
 Author-email: Flet contributors <hello@flet.dev>
 License-Expression: Apache-2.0
 Project-URL: Homepage, https://flet.dev
@@ -11,7 +11,7 @@ Project-URL: Issues, https://github.com/flet-dev/flet-permission-handler/issues
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: flet>=0.70.0
+Requires-Dist: flet>=0.70.0.dev0
 Dynamic: license-file
 
 # flet-permission-handler

{flet_permission_handler-0.2.0.dev34.dist-info → flet_permission_handler-0.2.0.dev55.dist-info}/RECORD

@@ -1,18 +1,18 @@
-flet_permission_handler/__init__.py,sha256=2D7A5avrZ15ZR3BSq7nuhMKNUcwV8Om4DNpCXrKjrnw,98
-flet_permission_handler/permission_handler.py,sha256=kR6n42ieY3imRUVaNL9oLw9v5A-3yj07x38Bn92CqZI,3025
-flet_permission_handler/types.py,sha256=WZppWUIYGuEjdEn5XQIjQDmFm34FophsNWMJbiSfNZk,11315
-flet_permission_handler-0.2.0.dev34.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+flet_permission_handler/__init__.py,sha256=_c3viU9FrR8PIkgJVWZwf1DTdTPVqST_Snc_1-vxVgo,180
+flet_permission_handler/permission_handler.py,sha256=EwYkhl5dtK1iacJXtMott93LtfmavLEbfj5fMzUA7So,3261
+flet_permission_handler/types.py,sha256=V_6b7fm9pfL2zd43upiPPpw2fJaIkhoA_9YnNImU3oU,11273
+flet_permission_handler-0.2.0.dev55.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
 flutter/flet_permission_handler/CHANGELOG.md,sha256=66sWepPaeTc9_lzcYIGU55AlxSU5Z1XVtknXpzd_-p8,40
 flutter/flet_permission_handler/LICENSE,sha256=QwcOLU5TJoTeUhuIXzhdCEEDDvorGiC6-3YTOl4TecE,11356
 flutter/flet_permission_handler/README.md,sha256=CuYLIxfY73NeTbx8z1GgHMz-wTYmTKopoVNCAWiDj7w,84
 flutter/flet_permission_handler/analysis_options.yaml,sha256=32kjGAc-zF87inWaH5M46yGZWQDTwrwfvNLHeAocfG4,154
-flutter/flet_permission_handler/pubspec.lock,sha256=WaCrkDbfzH5Mu_q25a7Nw_RE5Z56Y8VCS03QKB5GSjo,24402
-flutter/flet_permission_handler/pubspec.yaml,sha256=sGtyAmvIMD_K4bwIN9IGO1sO52VBtUFtXah5PijhZx8,566
+flutter/flet_permission_handler/pubspec.lock,sha256=hoBzRl72kk5b_IZpeWKIY3ueRxczsHi_G7R9FVgU0dI,24400
+flutter/flet_permission_handler/pubspec.yaml,sha256=P9-bE0zzMPEj9cusSi1D2MpnlTL_u_5XysCaQ9MjR8w,568
 flutter/flet_permission_handler/lib/flet_permission_handler.dart,sha256=rrlbNta1UlnSvzwOJsAUmOHvEBjfUDvMo6jnZQIO67s,78
 flutter/flet_permission_handler/lib/src/extension.dart,sha256=FYygqTMesWQOUIIf6dLmZS98gCVE_3KmccdR2_LTDg0,336
 flutter/flet_permission_handler/lib/src/permission_handler.dart,sha256=5aBWHNUIczDmmbsbXzzzB79vIbpDVpBAxo281_ghkss,1395
 flutter/flet_permission_handler/lib/src/utils/permission_handler.dart,sha256=Krtg-LPeyK9clYqDXfynSytGsiGTFX8HEe9NmNSR0Gk,453
-flet_permission_handler-0.2.0.dev34.dist-info/METADATA,sha256=wDzX20ii7Oemvicnnhn-nkcX0d08IPrOO6FOHwe9OwM,2365
-flet_permission_handler-0.2.0.dev34.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-flet_permission_handler-0.2.0.dev34.dist-info/top_level.txt,sha256=GMsa0IlcchYQqCgGn8WkekKbU0cb5k8lCazopnbWU_s,32
-flet_permission_handler-0.2.0.dev34.dist-info/RECORD,,
+flet_permission_handler-0.2.0.dev55.dist-info/METADATA,sha256=1iQsnwG6OzMhfXlpTjny9jNysyRPCUYp7HPFg5xd7EU,2406
+flet_permission_handler-0.2.0.dev55.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+flet_permission_handler-0.2.0.dev55.dist-info/top_level.txt,sha256=GMsa0IlcchYQqCgGn8WkekKbU0cb5k8lCazopnbWU_s,32
+flet_permission_handler-0.2.0.dev55.dist-info/RECORD,,

flutter/flet_permission_handler/pubspec.lock

@@ -125,8 +125,8 @@ packages:
     dependency: "direct main"
     description:
       path: "packages/flet"
-      ref: v1
-      resolved-ref: f76d1c5dd805ec81a5a5d63300d61413a5bf27ae
+      ref: main
+      resolved-ref: cf8823c5d766ea7866480986aa3ee871f4091e78
       url: "https://github.com/flet-dev/flet.git"
     source: git
     version: "0.70.0"
@@ -147,10 +147,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
@@ -258,10 +258,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:
@@ -386,10 +386,10 @@ packages:
     dependency: "direct main"
     description:
       name: permission_handler
-      sha256: "2d070d8684b68efb580a5997eb62f675e8a885ef0be6e754fb9ef489c177470f"
+      sha256: bc917da36261b00137bbc8896bf1482169cd76f866282368948f032c8c1caae1
       url: "https://pub.dev"
     source: hosted
-    version: "12.0.0+1"
+    version: "12.0.1"
   permission_handler_android:
     dependency: transitive
     description:
@@ -783,10 +783,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:

flutter/flet_permission_handler/pubspec.yaml

@@ -16,8 +16,8 @@ dependencies:
     git:
       url: https://github.com/flet-dev/flet.git
       path: packages/flet
-      ref: v1
+      ref: main
 dev_dependencies:
   flutter_test:
     sdk: flutter
-  flutter_lints: ^2.0.0
+  flutter_lints: ^3.0.0