Metadata-Version: 2.4
Name: flet-permission-handler
Version: 1.0.2
Summary: Manage runtime permissions in Flet apps.
Author-email: Flet contributors <hello@flet.dev>
License-Expression: Apache-2.0
Project-URL: Homepage, https://flet.dev
Project-URL: Documentation, https://flet.dev/docs/services/permissionhandler
Project-URL: Repository, https://github.com/flet-dev/flet/tree/main/sdk/python/packages/flet-permission-handler
Project-URL: Issues, https://github.com/flet-dev/flet/issues
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: flet==1.0.2
Dynamic: license-file

# flet-permission-handler

[![pypi](https://img.shields.io/pypi/v/flet-permission-handler.svg)](https://pypi.python.org/pypi/flet-permission-handler)
[![downloads](https://static.pepy.tech/badge/flet-permission-handler/month)](https://pepy.tech/project/flet-permission-handler)
[![python](https://img.shields.io/badge/python-%3E%3D3.10-%2334D058)](https://pypi.org/project/flet-permission-handler)
[![docstring coverage](https://flet.dev/docs/assets/badges/docs-coverage/flet-permission-handler.svg)](https://flet.dev/docs/assets/badges/docs-coverage/flet-permission-handler.svg)
[![license](https://img.shields.io/badge/License-Apache_2.0-green.svg)](https://github.com/flet-dev/flet/blob/main/sdk/python/packages/flet-permission-handler/LICENSE)

A [Flet](https://flet.dev) extension that simplifies working with device permissions.

> **[Try flet-permission-handler in Flet Studio](https://studio.flet.dev/gallery/utility/permissionhandler/example/extensions/permission_handler/permission_handler)**
>
> Prototype your Flet app interface in the browser, then configure and test device permissions in your local project. Write your own Python code or get help from the AI agent.

It is based on the [permission_handler](https://pub.dev/packages/permission_handler) Flutter package
and brings similar functionality to Flet, including:

- Requesting permissions at runtime
- Checking the current permission status (e.g., granted, denied)
- Redirecting users to system settings to manually grant permissions

## Documentation

Detailed documentation to this package can be found [here](https://flet.dev/docs/services/permissionhandler/).

## Platform Support

| Platform | Windows | macOS | Linux | iOS | Android | Web |
|----------|---------|-------|-------|-----|---------|-----|
| Supported|    ✅    |   ❌   |   ❌   |  ✅  |    ✅    |  ✅  |

## Usage

### Installation

To install the `flet-permission-handler` package and add it to your project dependencies:

- Using `uv`:
    ```bash
    uv add flet-permission-handler
    ```

- Using `pip`:
    ```bash
    pip install flet-permission-handler
    ```
    After this, you will have to manually add this package to your `requirements.txt` or `pyproject.toml`.

### Examples

For examples, see [these](https://github.com/flet-dev/flet/tree/main/sdk/python/examples/extensions/permission_handler).
