PermissionHandler

PermissionHandler #

Bases: Service

Manages permissions for the application.

This control is non-visual and should be added to Page.services list.

Platform support

Currently only supported on Android, iOS, Windows, and Web platforms.

RAISES	DESCRIPTION
`FletUnsupportedPlatformException`	If the platform is not supported.

data: Any = skip_field()

Arbitrary data of any type.

key: KeyValue | None = None

page: Page | BasePage | None

The page to which this control belongs to.

parent: BaseControl | None

The direct ancestor(parent) of this control.

It defaults to None and will only have a value when this control is mounted (added to the page tree).

The Page control (which is the root of the tree) is an exception - it always has parent=None.

before_event(e: ControlEvent)

before_update()

build()

Called once during control initialization to define its child controls. self.page is available in this method.

did_mount()

get_status(
    permission: Permission, timeout: int = 10
) -> PermissionStatus | None

Gets the current status of the given permission.

PARAMETER	DESCRIPTION
`permission`	The `Permission` to check the status for. TYPE: `Permission`
`timeout`	The maximum amount of time (in seconds) to wait for a response. TYPE: `int` DEFAULT: `10`

RETURNS	DESCRIPTION
`PermissionStatus \| None`	A `PermissionStatus` if the status is known, otherwise `None`.

RAISES	DESCRIPTION
`TimeoutError`	If the request times out.

init()

is_isolated()

open_app_settings(timeout: int = 10) -> bool

Opens the app settings page.

PARAMETER	DESCRIPTION
`timeout`	The maximum amount of time (in seconds) to wait for a response. TYPE: `int` DEFAULT: `10`

RETURNS	DESCRIPTION
`bool`	`True` if the app settings page could be opened, otherwise `False`.

RAISES	DESCRIPTION
`TimeoutError`	If the request times out.

request(
    permission: Permission, timeout: int = 60
) -> PermissionStatus | None

Request the user for access to the permission if access hasn't already been granted access before.

PARAMETER	DESCRIPTION
`permission`	The `Permission` to request. TYPE: `Permission`
`timeout`	The maximum amount of time (in seconds) to wait for a response. TYPE: `int` DEFAULT: `60`

RETURNS	DESCRIPTION
`PermissionStatus \| None`	The new `PermissionStatus` after the request, or `None` if the request was not successful.

RAISES	DESCRIPTION
`TimeoutError`	If the request times out.

update() -> None

will_unmount()