flet-ads 0.2.0.dev38__tar.gz → 0.2.0.dev505__tar.gz

{flet_ads-0.2.0.dev38/src/flet_ads.egg-info → flet_ads-0.2.0.dev505}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flet-ads
-Version: 0.2.0.dev38
+Version: 0.2.0.dev505
 Summary: Display Google Ads in Flet apps.
 Author-email: Flet contributors <hello@flet.dev>
 License-Expression: Apache-2.0
@@ -41,7 +41,9 @@ This package supports the following platforms:
 | Android  |     ✅     |
 | Web      |     ❌     |
 
-## Installation
+## Usage
+
+### Installation
 
 To install the `flet-ads` package and add it to your project dependencies:
 
@@ -61,6 +63,6 @@ To install the `flet-ads` package and add it to your project dependencies:
     poetry add flet-ads
     ```
 
-## Examples
+### Examples
 
-For examples, see [this](./examples)
+For examples, see [these](./examples).

{flet_ads-0.2.0.dev38 → flet_ads-0.2.0.dev505}/README.md

@@ -25,7 +25,9 @@ This package supports the following platforms:
 | Android  |     ✅     |
 | Web      |     ❌     |
 
-## Installation
+## Usage
+
+### Installation
 
 To install the `flet-ads` package and add it to your project dependencies:
 
@@ -45,6 +47,6 @@ To install the `flet-ads` package and add it to your project dependencies:
     poetry add flet-ads
     ```
 
-## Examples
+### Examples
 
-For examples, see [this](./examples)
+For examples, see [these](./examples).

flet_ads-0.2.0.dev505/pyproject.toml

@@ -0,0 +1,94 @@
+[project]
+name = "flet-ads"
+version = "0.2.0.dev505"
+description = "Display Google Ads in 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-ads"
+Repository = "https://github.com/flet-dev/flet-ads"
+Issues = "https://github.com/flet-dev/flet-ads/issues"
+
+[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_ads-0.2.0.dev505/src/flet_ads/__init__.py

@@ -0,0 +1,17 @@
+from flet_ads.banner_ad import BannerAd
+from flet_ads.base_ad import BaseAd
+from flet_ads.interstitial_ad import InterstitialAd
+from flet_ads.types import (
+    AdRequest,
+    PaidAdEvent,
+    PrecisionType,
+)
+
+__all__ = [
+    "AdRequest",
+    "BannerAd",
+    "BaseAd",
+    "InterstitialAd",
+    "PaidAdEvent",
+    "PrecisionType",
+]

{flet_ads-0.2.0.dev38 → flet_ads-0.2.0.dev505}/src/flet_ads/banner_ad.py

@@ -1,7 +1,9 @@
+from typing import Optional
+
 import flet as ft
 
-from .base_ad import BaseAd
-from .types import PaidAdEvent
+from flet_ads.base_ad import BaseAd
+from flet_ads.types import PaidAdEvent
 
 
 @ft.control("BannerAd")
@@ -10,10 +12,10 @@ class BannerAd(BaseAd):
     Displays a banner ad.
 
     Raises:
-        AssertionError: When using this control on a web and/or non-mobile platform.
+        AssertionError: When this control is used on a web and/or non-mobile platform.
     """
 
-    on_will_dismiss: ft.OptionalControlEventHandler["BannerAd"] = None
+    on_will_dismiss: Optional[ft.ControlEventHandler["BannerAd"]] = None
     """
     Called before dismissing a full screen view.
 
@@ -21,7 +23,7 @@ class BannerAd(BaseAd):
         Only available on iOS.
     """
 
-    on_paid: ft.OptionalControlEventHandler[PaidAdEvent["BannerAd"]] = None
+    on_paid: Optional[ft.ControlEventHandler[PaidAdEvent["BannerAd"]]] = None
     """
     Called when this ad is estimated to have earned money.
 

{flet_ads-0.2.0.dev38 → flet_ads-0.2.0.dev505}/src/flet_ads/base_ad.py

@@ -1,4 +1,5 @@
 from dataclasses import field
+from typing import Optional
 
 import flet as ft
 
@@ -24,44 +25,45 @@ class BaseAd(ft.Control):
     Targeting information used to fetch an Ad.
     """
 
-    on_load: ft.OptionalControlEventHandler["BaseAd"] = None
+    on_load: Optional[ft.ControlEventHandler["BaseAd"]] = None
     """
     Called when this ad is loaded successfully.
     """
 
-    on_error: ft.OptionalControlEventHandler["BaseAd"] = None
+    on_error: Optional[ft.ControlEventHandler["BaseAd"]] = None
     """
     Called when an ad request failed.
-    
-    Event handler argument `data` property contains information about the error.
+
+    Event handler argument [`data`][flet.Event.data] property
+    contains information about the error.
     """
 
-    on_open: ft.OptionalControlEventHandler["BaseAd"] = None
+    on_open: Optional[ft.ControlEventHandler["BaseAd"]] = None
     """
     Called when this ad opens up.
-    
+
     A full screen view/overlay is presented in response to the user clicking
     on an ad. You may want to pause animations and time sensitive
     interactions.
     """
 
-    on_close: ft.OptionalControlEventHandler["BaseAd"] = None
+    on_close: Optional[ft.ControlEventHandler["BaseAd"]] = None
     """
     Called when the full screen view has been closed. You should restart
-    anything paused while handling [`on_open`][..].
+    anything paused while handling [`on_open`][flet_ads.BaseAd.on_open].
     """
 
-    on_impression: ft.OptionalControlEventHandler["BaseAd"] = None
+    on_impression: Optional[ft.ControlEventHandler["BaseAd"]] = None
     """
     Called when an impression occurs on this ad.
     """
 
-    on_click: ft.OptionalControlEventHandler["BaseAd"] = None
+    on_click: Optional[ft.ControlEventHandler["BaseAd"]] = None
     """
     Called when this ad is clicked.
     """
 
     def before_update(self):
-        assert (
-            not self.page.web and self.page.platform.is_mobile()
-        ), f"{self.__class__.__name__} is only supported on Mobile (Android and iOS)"
+        assert not self.page.web and self.page.platform.is_mobile(), (
+            f"{self.__class__.__name__} is only supported on Mobile (Android and iOS)"
+        )

{flet_ads-0.2.0.dev38 → flet_ads-0.2.0.dev505}/src/flet_ads/interstitial_ad.py

@@ -1,8 +1,6 @@
-import asyncio
-
 import flet as ft
 
-from .base_ad import BaseAd
+from flet_ads.base_ad import BaseAd
 
 
 @ft.control("InterstitialAd")
@@ -14,8 +12,5 @@ class InterstitialAd(BaseAd):
         AssertionError: When using this control on a web and/or non-mobile platform.
     """
 
-    def show(self):
-        asyncio.create_task(self.show_async())
-
-    async def show_async(self):
-        await self._invoke_method_async("show")
+    async def show(self):
+        await self._invoke_method("show")

{flet_ads-0.2.0.dev38 → flet_ads-0.2.0.dev505}/src/flet_ads/native_ad.py

@@ -1,7 +1,7 @@
 import flet as ft
 
-from .banner_ad import BannerAd
-from .types import NativeAdTemplateStyle
+from flet_ads.banner_ad import BannerAd
+from flet_ads.types import NativeAdTemplateStyle
 
 __all__ = ["NativeAd"]
 
@@ -12,7 +12,8 @@ class NativeAd(BannerAd):
     Renders a native ad.
 
     Raises:
-        AssertionError: When neither [`factory_id`][..] nor [`template_style`][..] is set.
+        AssertionError: When neither [`factory_id`][(c).] nor
+            [`template_style`][(c).] is set.
     """
 
     factory_id: str = None
@@ -27,6 +28,6 @@ class NativeAd(BannerAd):
 
     def before_update(self):
         super().before_update()
-        assert (
-            self.factory_id is not None or self.template_style is not None
-        ), "factory_id or template_style must be set"
+        assert self.factory_id is not None or self.template_style is not None, (
+            "factory_id or template_style must be set"
+        )

{flet_ads-0.2.0.dev38 → flet_ads-0.2.0.dev505/src/flet_ads.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flet-ads
-Version: 0.2.0.dev38
+Version: 0.2.0.dev505
 Summary: Display Google Ads in Flet apps.
 Author-email: Flet contributors <hello@flet.dev>
 License-Expression: Apache-2.0
@@ -41,7 +41,9 @@ This package supports the following platforms:
 | Android  |     ✅     |
 | Web      |     ❌     |
 
-## Installation
+## Usage
+
+### Installation
 
 To install the `flet-ads` package and add it to your project dependencies:
 
@@ -61,6 +63,6 @@ To install the `flet-ads` package and add it to your project dependencies:
     poetry add flet-ads
     ```
 
-## Examples
+### Examples
 
-For examples, see [this](./examples)
+For examples, see [these](./examples).

flet_ads-0.2.0.dev38/pyproject.toml

@@ -1,68 +0,0 @@
-[project]
-name = "flet-ads"
-version = "0.2.0.dev38"
-description = "Display Google Ads in 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-ads"
-Repository = "https://github.com/flet-dev/flet-ads"
-Issues = "https://github.com/flet-dev/flet-ads/issues"
-
-[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_ads-0.2.0.dev38/src/flet_ads/__init__.py

@@ -1,10 +0,0 @@
-from .banner_ad import BannerAd
-from .base_ad import BaseAd
-from .interstitial_ad import InterstitialAd
-from .types import (  # NativeAdTemplateStyle,; NativeAdTemplateTextStyle,; NativeAdTemplateType,; NativeTemplateFontStyle,
-    AdRequest,
-    PaidAdEvent,
-    PrecisionType,
-)
-
-# from .native_ad import NativeAd