flet-review 0.1.1__tar.gz

flet_review-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Andreas Legner
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

flet_review-0.1.1/PKG-INFO

@@ -0,0 +1,107 @@
+Metadata-Version: 2.4
+Name: flet-review
+Version: 0.1.1
+Summary: In-app review prompt for Flet apps — wraps the Google Play / App Store review dialog
+Author-email: Andreas Legner <hi@legner.beer>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/legnerbeer/flet-review
+Project-URL: Documentation, https://legnerbeer.github.io/flet-review/
+Project-URL: Repository, https://github.com/legnerbeer/flet-review
+Project-URL: Issues, https://github.com/legnerbeer/flet-review/issues
+Keywords: flet,flutter,in-app-review,rating,android,ios
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: Android
+Classifier: Operating System :: iOS
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: flet>=1.0.0
+Dynamic: license-file
+
+# flet-review
+
+In-app review prompt for [Flet](https://flet.dev) apps.
+
+It wraps the [`in_app_review`](https://pub.dev/packages/in_app_review) Flutter
+package, which in turn wraps Google Play's In-App Review API on Android and
+`SKStoreReviewController` on iOS.
+
+## Platform Support
+
+| Platform  | iOS | Android | Web | Windows | macOS | Linux |
+|-----------|-----|---------|-----|---------|-------|-------|
+| Supported | ✅   | ✅       | ❌   | ❌       | ❌     | ❌     |
+
+On any other platform, `InAppReview` raises `FletUnsupportedPlatformException`.
+
+## Installation
+
+Add `flet-review` to the `pyproject.toml` of your Flet project:
+
+```toml
+dependencies = [
+  "flet-review",
+  "flet>=1.0.0",
+]
+```
+
+Or straight from GitHub:
+
+```toml
+dependencies = [
+  "flet-review @ git+https://github.com/legnerbeer/flet-review",
+  "flet>=1.0.0",
+]
+```
+
+## Running your app
+
+Like any Flet extension with native code, the prebuilt client that a plain
+`flet run` uses does **not** include it. Run on a device instead:
+
+```bash
+flet debug android -d <device-id>
+flet debug ios -d <device-id>
+```
+
+(`flet debug --show-devices` lists connected devices.) Or build the app with
+`flet build apk` / `flet build ipa`.
+
+## Usage
+
+```python
+import flet as ft
+from flet_review import InAppReview
+
+
+async def main(page: ft.Page):
+    review = InAppReview()
+
+    async def rate_clicked(e):
+        await review.open_store_listing(app_store_id="1234567890")
+
+    async def after_positive_moment():
+        if await review.is_available():
+            await review.request_review()
+
+    page.add(ft.Button("Rate this app", on_click=rate_clicked))
+
+
+ft.run(main)
+```
+
+### API
+
+| Method | Description |
+|--------|-------------|
+| `await is_available() -> bool` | Whether the platform review API is reachable on this device. `True` doesn't guarantee a dialog will show. |
+| `await request_review()` | Asks the platform to show its review dialog. Google and Apple apply their own quotas, so this may silently do nothing, and you can't tell whether the user rated. |
+| `await open_store_listing(app_store_id=None)` | Always opens the app's Play Store / App Store page. `app_store_id` is the numeric iOS App Store id (ignored on Android). |
+
+Call `request_review()` only after a clear positive moment (never right after
+launch, onboarding or an error), and keep `open_store_listing()` as an explicit
+"Rate us" button, since that always works.
+
+## License
+
+[MIT](LICENSE)

flet_review-0.1.1/README.md

@@ -0,0 +1,87 @@
+# flet-review
+
+In-app review prompt for [Flet](https://flet.dev) apps.
+
+It wraps the [`in_app_review`](https://pub.dev/packages/in_app_review) Flutter
+package, which in turn wraps Google Play's In-App Review API on Android and
+`SKStoreReviewController` on iOS.
+
+## Platform Support
+
+| Platform  | iOS | Android | Web | Windows | macOS | Linux |
+|-----------|-----|---------|-----|---------|-------|-------|
+| Supported | ✅   | ✅       | ❌   | ❌       | ❌     | ❌     |
+
+On any other platform, `InAppReview` raises `FletUnsupportedPlatformException`.
+
+## Installation
+
+Add `flet-review` to the `pyproject.toml` of your Flet project:
+
+```toml
+dependencies = [
+  "flet-review",
+  "flet>=1.0.0",
+]
+```
+
+Or straight from GitHub:
+
+```toml
+dependencies = [
+  "flet-review @ git+https://github.com/legnerbeer/flet-review",
+  "flet>=1.0.0",
+]
+```
+
+## Running your app
+
+Like any Flet extension with native code, the prebuilt client that a plain
+`flet run` uses does **not** include it. Run on a device instead:
+
+```bash
+flet debug android -d <device-id>
+flet debug ios -d <device-id>
+```
+
+(`flet debug --show-devices` lists connected devices.) Or build the app with
+`flet build apk` / `flet build ipa`.
+
+## Usage
+
+```python
+import flet as ft
+from flet_review import InAppReview
+
+
+async def main(page: ft.Page):
+    review = InAppReview()
+
+    async def rate_clicked(e):
+        await review.open_store_listing(app_store_id="1234567890")
+
+    async def after_positive_moment():
+        if await review.is_available():
+            await review.request_review()
+
+    page.add(ft.Button("Rate this app", on_click=rate_clicked))
+
+
+ft.run(main)
+```
+
+### API
+
+| Method | Description |
+|--------|-------------|
+| `await is_available() -> bool` | Whether the platform review API is reachable on this device. `True` doesn't guarantee a dialog will show. |
+| `await request_review()` | Asks the platform to show its review dialog. Google and Apple apply their own quotas, so this may silently do nothing, and you can't tell whether the user rated. |
+| `await open_store_listing(app_store_id=None)` | Always opens the app's Play Store / App Store page. `app_store_id` is the numeric iOS App Store id (ignored on Android). |
+
+Call `request_review()` only after a clear positive moment (never right after
+launch, onboarding or an error), and keep `open_store_listing()` as an explicit
+"Rate us" button, since that always works.
+
+## License
+
+[MIT](LICENSE)

flet_review-0.1.1/pyproject.toml

@@ -0,0 +1,39 @@
+[project]
+name = "flet-review"
+version = "0.1.1"
+description = "In-app review prompt for Flet apps — wraps the Google Play / App Store review dialog"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+    { name = "Andreas Legner", email = "hi@legner.beer" }
+]
+keywords = ["flet", "flutter", "in-app-review", "rating", "android", "ios"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: Android",
+    "Operating System :: iOS",
+]
+dependencies = [
+    "flet>=1.0.0",
+]
+
+[dependency-groups]
+dev = [
+    "zensical",
+    "mkdocstrings-python",
+]
+
+[project.urls]
+Homepage = "https://github.com/legnerbeer/flet-review"
+Documentation = "https://legnerbeer.github.io/flet-review/"
+Repository = "https://github.com/legnerbeer/flet-review"
+Issues = "https://github.com/legnerbeer/flet-review/issues"
+
+[tool.setuptools.package-data]
+"flutter.flet_review" = ["**/*"]
+
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"

flet_review-0.1.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

flet_review-0.1.1/src/flet_review/__init__.py

@@ -0,0 +1,3 @@
+from flet_review.flet_review import InAppReview
+
+__all__ = ["InAppReview"]

flet_review-0.1.1/src/flet_review/flet_review.py

@@ -0,0 +1,50 @@
+from typing import Optional
+
+import flet as ft
+
+__all__ = ["InAppReview"]
+
+
+@ft.control("InAppReview")
+class InAppReview(ft.Service):
+    """Wraps the `in_app_review` Flutter plugin — Google Play's in-app
+    review dialog on Android, `SKStoreReviewController` on iOS.
+
+    `request_review()` is quota-gated by the platform itself (Google
+    Play allows it roughly once per app per account per ~30 days, and
+    only if its own eligibility checks pass) — it never tells you
+    whether anything was actually shown, let alone whether the user
+    rated. Per Google's review guidelines, call it only after a clear
+    positive moment (never right after launch, onboarding, or a bad
+    experience), and keep `open_store_listing()` as an explicit
+    "Rate us" fallback since it always works.
+    """
+
+    def before_update(self):
+        super().before_update()
+        if self.page.platform not in (ft.PagePlatform.ANDROID, ft.PagePlatform.IOS):
+            raise ft.FletUnsupportedPlatformException(
+                "InAppReview is only wired up for Android and iOS."
+            )
+
+    async def is_available(self) -> bool:
+        """Whether the platform's review API is reachable at all on this
+        device (e.g. Play Services present) — `True` here does not mean
+        `request_review()` will actually show a dialog."""
+        return bool(await self._invoke_method(method_name="is_available"))
+
+    async def request_review(self) -> None:
+        """Asks the platform to show its in-app review dialog. May be a
+        silent no-op if the platform's own quota/eligibility checks
+        don't pass — do not follow this with any "thanks for rating"
+        UI, since you can't tell if anything happened."""
+        await self._invoke_method(method_name="request_review")
+
+    async def open_store_listing(self, app_store_id: Optional[str] = None) -> None:
+        """Opens this app's Play Store / App Store listing directly, for
+        a manual "Rate us" button. `app_store_id` is the numeric iOS App
+        Store id (ignored on Android, which uses the package name)."""
+        await self._invoke_method(
+            method_name="open_store_listing",
+            arguments={"app_store_id": app_store_id},
+        )

flet_review-0.1.1/src/flet_review.egg-info/PKG-INFO

@@ -0,0 +1,107 @@
+Metadata-Version: 2.4
+Name: flet-review
+Version: 0.1.1
+Summary: In-app review prompt for Flet apps — wraps the Google Play / App Store review dialog
+Author-email: Andreas Legner <hi@legner.beer>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/legnerbeer/flet-review
+Project-URL: Documentation, https://legnerbeer.github.io/flet-review/
+Project-URL: Repository, https://github.com/legnerbeer/flet-review
+Project-URL: Issues, https://github.com/legnerbeer/flet-review/issues
+Keywords: flet,flutter,in-app-review,rating,android,ios
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: Android
+Classifier: Operating System :: iOS
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: flet>=1.0.0
+Dynamic: license-file
+
+# flet-review
+
+In-app review prompt for [Flet](https://flet.dev) apps.
+
+It wraps the [`in_app_review`](https://pub.dev/packages/in_app_review) Flutter
+package, which in turn wraps Google Play's In-App Review API on Android and
+`SKStoreReviewController` on iOS.
+
+## Platform Support
+
+| Platform  | iOS | Android | Web | Windows | macOS | Linux |
+|-----------|-----|---------|-----|---------|-------|-------|
+| Supported | ✅   | ✅       | ❌   | ❌       | ❌     | ❌     |
+
+On any other platform, `InAppReview` raises `FletUnsupportedPlatformException`.
+
+## Installation
+
+Add `flet-review` to the `pyproject.toml` of your Flet project:
+
+```toml
+dependencies = [
+  "flet-review",
+  "flet>=1.0.0",
+]
+```
+
+Or straight from GitHub:
+
+```toml
+dependencies = [
+  "flet-review @ git+https://github.com/legnerbeer/flet-review",
+  "flet>=1.0.0",
+]
+```
+
+## Running your app
+
+Like any Flet extension with native code, the prebuilt client that a plain
+`flet run` uses does **not** include it. Run on a device instead:
+
+```bash
+flet debug android -d <device-id>
+flet debug ios -d <device-id>
+```
+
+(`flet debug --show-devices` lists connected devices.) Or build the app with
+`flet build apk` / `flet build ipa`.
+
+## Usage
+
+```python
+import flet as ft
+from flet_review import InAppReview
+
+
+async def main(page: ft.Page):
+    review = InAppReview()
+
+    async def rate_clicked(e):
+        await review.open_store_listing(app_store_id="1234567890")
+
+    async def after_positive_moment():
+        if await review.is_available():
+            await review.request_review()
+
+    page.add(ft.Button("Rate this app", on_click=rate_clicked))
+
+
+ft.run(main)
+```
+
+### API
+
+| Method | Description |
+|--------|-------------|
+| `await is_available() -> bool` | Whether the platform review API is reachable on this device. `True` doesn't guarantee a dialog will show. |
+| `await request_review()` | Asks the platform to show its review dialog. Google and Apple apply their own quotas, so this may silently do nothing, and you can't tell whether the user rated. |
+| `await open_store_listing(app_store_id=None)` | Always opens the app's Play Store / App Store page. `app_store_id` is the numeric iOS App Store id (ignored on Android). |
+
+Call `request_review()` only after a clear positive moment (never right after
+launch, onboarding or an error), and keep `open_store_listing()` as an explicit
+"Rate us" button, since that always works.
+
+## License
+
+[MIT](LICENSE)

flet_review-0.1.1/src/flet_review.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+LICENSE
+README.md
+pyproject.toml
+src/flet_review/__init__.py
+src/flet_review/flet_review.py
+src/flet_review.egg-info/PKG-INFO
+src/flet_review.egg-info/SOURCES.txt
+src/flet_review.egg-info/dependency_links.txt
+src/flet_review.egg-info/requires.txt
+src/flet_review.egg-info/top_level.txt
+src/flutter/flet_review/pubspec.yaml
+src/flutter/flet_review/lib/flet_review.dart
+src/flutter/flet_review/lib/src/extension.dart
+src/flutter/flet_review/lib/src/flet_review.dart

flet_review-0.1.1/src/flet_review.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

flet_review-0.1.1/src/flet_review.egg-info/requires.txt

@@ -0,0 +1 @@
+flet>=1.0.0

flet_review-0.1.1/src/flet_review.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+flet_review
+flutter

flet_review-0.1.1/src/flutter/flet_review/lib/flet_review.dart

@@ -0,0 +1,3 @@
+library flet_review;
+
+export "src/extension.dart" show Extension;

flet_review-0.1.1/src/flutter/flet_review/lib/src/extension.dart

@@ -0,0 +1,15 @@
+import 'package:flet/flet.dart';
+
+import 'flet_review.dart';
+
+class Extension extends FletExtension {
+  @override
+  FletService? createService(Control control) {
+    switch (control.type) {
+      case "InAppReview":
+        return InAppReviewService(control: control);
+      default:
+        return null;
+    }
+  }
+}

flet_review-0.1.1/src/flutter/flet_review/lib/src/flet_review.dart

@@ -0,0 +1,44 @@
+import 'package:flet/flet.dart';
+import 'package:flutter/widgets.dart';
+import 'package:in_app_review/in_app_review.dart';
+
+class InAppReviewService extends FletService {
+  InAppReviewService({required super.control});
+
+  @override
+  void init() {
+    super.init();
+    debugPrint("InAppReview(${control.id}).init: ${control.properties}");
+    control.addInvokeMethodListener(_invokeMethod);
+  }
+
+  Future<dynamic> _invokeMethod(String name, dynamic args) async {
+    debugPrint("InAppReview.$name($args)");
+    switch (name) {
+      case "is_available":
+        return await InAppReview.instance.isAvailable();
+
+      case "request_review":
+        // Google/Apple decide whether anything actually shows (quota,
+        // eligibility) — this never throws just because it was skipped.
+        await InAppReview.instance.requestReview();
+        return null;
+
+      case "open_store_listing":
+        await InAppReview.instance.openStoreListing(
+          appStoreId: args['app_store_id'] as String?,
+        );
+        return null;
+
+      default:
+        throw Exception("Unknown InAppReview method: $name");
+    }
+  }
+
+  @override
+  void dispose() {
+    debugPrint("InAppReview(${control.id}).dispose()");
+    control.removeInvokeMethodListener(_invokeMethod);
+    super.dispose();
+  }
+}

flet_review-0.1.1/src/flutter/flet_review/pubspec.yaml

@@ -0,0 +1,20 @@
+name: flet_review
+description: Flet extension wrapping the in_app_review plugin (Google Play / App Store review prompt).
+version: 0.1.1
+publish_to: none
+
+environment:
+  sdk: '>=3.3.0 <4.0.0'
+  flutter: ">=1.17.0"
+
+dependencies:
+  flet: ^1.0.0
+  flutter:
+    sdk: flutter
+
+  in_app_review: ^2.0.9
+
+dev_dependencies:
+  flutter_test:
+    sdk: flutter
+  flutter_lints: ^3.0.0