flet-map 0.70.0.dev6326__py3-none-any.whl → 0.70.0.dev6555__py3-none-any.whl

flet_map/circle_layer.py

@@ -12,9 +12,6 @@ class CircleMarker(ft.Control):
     """
     A circular marker displayed on the Map at the specified
     location through the [`CircleLayer`][(p).].
-
-    Raises:
-        AssertionError: If the [`border_stroke_width`][(c).] is negative.
     """
 
     radius: ft.Number
@@ -30,8 +27,8 @@ class CircleMarker(ft.Control):
     """
     The color of the circle border line.
 
-    Note:
-        [`border_stroke_width`][..] must to be greater than
+    Tip:
+        [`border_stroke_width`][(c).] must be greater than
         `0.0` in order for this color to be visible.
     """
 
@@ -39,21 +36,22 @@ class CircleMarker(ft.Control):
     """
     The stroke width for the circle border.
 
-    Note:
-        Must be non-negative.
+    Raises:
+        ValueError: If it is less than `0.0`.
     """
 
     use_radius_in_meter: bool = False
     """
-    Whether the [`radius`][..] should use the unit meters.
+    Whether the [`radius`][(c).] should use the unit meters.
     """
 
     def before_update(self):
         super().before_update()
-        assert self.border_stroke_width >= 0, (
-            f"border_stroke_width must be greater than or equal to 0, "
-            f"got {self.border_stroke_width}"
-        )
+        if self.border_stroke_width < 0:
+            raise ValueError(
+                "border_stroke_width must be greater than or equal to 0, "
+                f"got {self.border_stroke_width}"
+            )
 
 
 @ft.control("CircleLayer")

flet_map/map.py

@@ -100,7 +100,7 @@ class Map(ft.LayoutControl):
     initial_camera_fit: Optional[CameraFit] = None
     """
     Defines the visible bounds when the map is first loaded.
-    Takes precedence over [`initial_center`][..]/[`initial_zoom`][..].
+    Takes precedence over [`initial_center`][(c).]/[`initial_zoom`][(c).].
     """
 
     on_init: Optional[ft.ControlEventHandler["Map"]] = None
@@ -244,7 +244,7 @@ class Map(ft.LayoutControl):
         Zooms out by one zoom-level from the current one.
 
         Args:
-            animation_curve: The curve of the animation. If None (the default),
+            animation_curve: The curve of the animation. If `None` (the default),
                 [`Map.animation_curve`][(p).] will be used.
             animation_duration: The duration of the animation.
                 If None (the default), [`Map.animation_duration`][(p).] will be used.
@@ -272,7 +272,7 @@ class Map(ft.LayoutControl):
 
         Args:
             zoom: The zoom level to zoom to.
-            animation_curve: The curve of the animation. If None (the default),
+            animation_curve: The curve of the animation. If `None` (the default),
                 [`Map.animation_curve`][(p).] will be used.
             animation_duration: The duration of the animation.
                 If None (the default), [`Map.animation_duration`][(p).] will be used.
@@ -316,11 +316,10 @@ class Map(ft.LayoutControl):
                 ongoing map-animations before starting this new one.
 
         Raises:
-            AssertionError: If `zoom` is not `None` and is negative.
+            ValueError: If `zoom` is not `None` and is negative.
         """
-        assert zoom is None or zoom >= 0, (
-            f"zoom must be greater than or equal to zero, got {zoom}"
-        )
+        if zoom is not None and zoom < 0:
+            raise ValueError(f"zoom must be greater than or equal to zero, got {zoom}")
         await self._invoke_method(
             method_name="move_to",
             arguments={

flet_map/marker_layer.py

@@ -13,18 +13,14 @@ class Marker(ft.Control):
     """
     A marker displayed on the Map at the specified location
     through the [`MarkerLayer`][(p).].
-
-    Raises:
-        AssertionError: If the [`content`][(c).] is not visible, or
-            if [`height`][(c).] or [`width`][(c).] are negative.
     """
 
     content: ft.Control
     """
-    The content to be displayed at [`coordinates`][..].
+    The content to be displayed at [`coordinates`][(c).].
 
-    Note:
-        Must be provided and visible.
+    Raises:
+        ValueError: If it is not [`visible`][(c).].
     """
 
     coordinates: MapLatitudeLongitude
@@ -32,7 +28,7 @@ class Marker(ft.Control):
     The coordinates of the marker.
 
     This will be the center of the marker,
-    if [`alignment`][..] is [`Alignment.CENTER`][flet.Alignment.CENTER].
+    if [`alignment`][(c).] is [`Alignment.CENTER`][flet.].
     """
 
     rotate: Optional[bool] = None
@@ -51,36 +47,39 @@ class Marker(ft.Control):
 
     height: ft.Number = 30.0
     """
-    The height of the [`content`][..] Control.
+    The height of the [`content`][(c).] Control.
 
-    Note:
-        Must be non-negative.
+    Raises:
+        ValueError: If it is less than `0.0`.
     """
 
     width: ft.Number = 30.0
     """
-    The width of the [`content`][..] Control.
+    The width of the [`content`][(c).] Control.
 
-    Note:
-        Must be non-negative.
+    Raises:
+        ValueError: If it is less than `0.0`.
     """
 
     alignment: Optional[ft.Alignment] = None
     """
-    Alignment of the marker relative to the normal center at [`coordinates`][..].
+    Alignment of the marker relative to the normal center at [`coordinates`][(c).].
 
     Defaults to the value of the parent [`MarkerLayer.alignment`][(p).].
     """
 
     def before_update(self):
         super().before_update()
-        assert self.content.visible, "content must be visible"
-        assert self.height >= 0, (
-            f"height must be greater than or equal to 0, got {self.height}"
-        )
-        assert self.width >= 0, (
-            f"width must be greater than or equal to 0, got {self.width}"
-        )
+        if not self.content.visible:
+            raise ValueError("content must be visible")
+        if self.height < 0:
+            raise ValueError(
+                f"height must be greater than or equal to 0, got {self.height}"
+            )
+        if self.width < 0:
+            raise ValueError(
+                f"width must be greater than or equal to 0, got {self.width}"
+            )
 
 
 @ft.control("MarkerLayer")
@@ -91,7 +90,7 @@ class MarkerLayer(MapLayer):
 
     markers: list[Marker]
     """
-    A list of [`Marker`][(m).]s to display.
+    A list of [`Marker`][(p).]s to display.
     """
 
     alignment: Optional[ft.Alignment] = field(
@@ -99,11 +98,11 @@ class MarkerLayer(MapLayer):
     )
     """
     The alignment of each marker relative to its normal center at
-    [`Marker.coordinates`][(m).].
+    [`Marker.coordinates`][(p).].
     """
 
     rotate: bool = False
     """
-    Whether to counter-rotate `markers` to the map's rotation,
+    Whether to counter-rotate [`markers`][(c).] to the map's rotation,
     to keep a fixed orientation.
     """

flet_map/polygon_layer.py

@@ -22,10 +22,11 @@ class PolygonMarker(ft.Control):
     """
     An optional label for this polygon.
 
-    Note: specifying a label will reduce performance, as the internal
-    canvas must be drawn to and 'saved' more frequently to ensure the proper
-    stacking order is maintained. This can be avoided, potentially at the
-    expense of appearance, by setting [`PolygonLayer.draw_labels_last`][(p).].
+    Note:
+        Specifying a label will reduce performance, as the internal
+        canvas must be drawn to and 'saved' more frequently to ensure the proper
+        stacking order is maintained. This can be avoided, potentially at the
+        expense of appearance, by setting [`PolygonLayer.draw_labels_last`][(p).].
     """
 
     label_text_style: Optional[ft.TextStyle] = None
@@ -47,8 +48,8 @@ class PolygonMarker(ft.Control):
     """
     The width of the border outline.
 
-    Note:
-        Must be non-negative.
+    Raises:
+        ValueError: If it is less than `0.0`.
     """
 
     disable_holes_border: bool = False
@@ -74,10 +75,11 @@ class PolygonMarker(ft.Control):
 
     def before_update(self):
         super().before_update()
-        assert self.border_stroke_width >= 0, (
-            f"border_stroke_width must be greater than or equal to 0, "
-            f"got {self.border_stroke_width}"
-        )
+        if self.border_stroke_width < 0:
+            raise ValueError(
+                "border_stroke_width must be greater than or equal to 0, "
+                f"got {self.border_stroke_width}"
+            )
 
 
 @ft.control("PolygonLayer")

flet_map/polyline_layer.py

@@ -21,7 +21,7 @@ class PolylineMarker(ft.Control):
 
     colors_stop: Optional[list[ft.Number]] = None
     """
-    The stops for the [`gradient_colors`][..].
+    The stops for the [`gradient_colors`][(c).].
     """
 
     gradient_colors: Optional[list[ft.ColorValue]] = None
@@ -43,16 +43,16 @@ class PolylineMarker(ft.Control):
     """
     The width of the stroke.
 
-    Note:
-        Must be non-negative.
+    Raises:
+        ValueError: If it is less than `0.0`.
     """
 
     border_stroke_width: ft.Number = 0.0
     """
     The width of the stroke with of the line border.
 
-    Note:
-        Must be non-negative.
+    Raises:
+        ValueError: If it is less than `0.0`.
     """
 
     use_stroke_width_in_meter: bool = False
@@ -78,13 +78,16 @@ class PolylineMarker(ft.Control):
 
     def before_update(self):
         super().before_update()
-        assert self.border_stroke_width >= 0, (
-            f"border_stroke_width must be greater than or equal to 0, "
-            f"got {self.border_stroke_width}"
-        )
-        assert self.stroke_width >= 0, (
-            f"stroke_width must be greater than or equal to 0, got {self.stroke_width}"
-        )
+        if self.border_stroke_width < 0:
+            raise ValueError(
+                "border_stroke_width must be greater than or equal to 0, "
+                f"got {self.border_stroke_width}"
+            )
+        if self.stroke_width < 0:
+            raise ValueError(
+                f"stroke_width must be greater than or equal to 0, "
+                f"got {self.stroke_width}"
+            )
 
 
 @ft.control("PolylineLayer")

flet_map/simple_attribution.py

@@ -25,7 +25,7 @@ class SimpleAttribution(MapLayer):
 
     bgcolor: ft.ColorValue = ft.Colors.SURFACE
     """
-    The color of the box containing the [`text`][..].
+    The color of the box containing the [`text`][(c).].
     """
 
     on_click: Optional[ft.ControlEventHandler["SimpleAttribution"]] = None

flet_map/source_attribution.py

@@ -23,17 +23,14 @@ class ImageSourceAttribution(SourceAttribution):
     open/close icon of a [`RichAttribution`][(p).] control.
     For it to be displayed, it should be part of a
     [`RichAttribution.attributions`][(p).] list.
-
-    Raises:
-        AssertionError: If the [`image`][(c).] is not visible.
     """
 
     image: ft.Image
     """
-    The `Image` to be displayed.
+    The [`Image`][flet.] to be displayed.
 
-    Note:
-        Must be provided and visible.
+    Raises:
+        ValueError: If the image is not visible.
     """
 
     height: ft.Number = 24.0
@@ -51,7 +48,8 @@ class ImageSourceAttribution(SourceAttribution):
 
     def before_update(self):
         super().before_update()
-        assert self.image.visible, "image must be visible"
+        if not self.image.visible:
+            raise ValueError("image must be visible")
 
 
 @ft.control("TextSourceAttribution")
@@ -63,14 +61,14 @@ class TextSourceAttribution(SourceAttribution):
     """
 
     text: str
-    """The text to display as attribution, styled with [`text_style`][..]."""
+    """The text to display as attribution, styled with [`text_style`][(c).]."""
 
     text_style: Optional[ft.TextStyle] = None
-    """Style used to display the [`text`][..]."""
+    """Style used to display the [`text`][(c).]."""
 
     prepend_copyright: bool = True
     """
-    Whether to add the '©' character to the start of [`text`][..] automatically.
+    Whether to add the '©' character to the start of [`text`][(c).] automatically.
     """
 
     on_click: Optional[ft.ControlEventHandler["TextSourceAttribution"]] = None

flet_map/tile_layer.py

@@ -22,12 +22,6 @@ class TileLayer(MapLayer):
     Typically the first layer to be added to a [`Map`][(p).],
     as it provides the tiles on which
     other layers are displayed.
-
-    Raises:
-        AssertionError: If one or more of the following is negative:
-            [`tile_size`][(c).], [`min_native_zoom`][(c).],
-            [`max_native_zoom`][(c).], [`zoom_offset`][(c).],
-            [`max_zoom`][(c).], [`min_zoom`][(c).]
     """
 
     url_template: str
@@ -39,21 +33,21 @@ class TileLayer(MapLayer):
     fallback_url: Optional[str] = None
     """
     Fallback URL template, used if an error occurs when fetching tiles from
-    the [`url_template`][..].
+    the [`url_template`][(c).].
 
     Note that specifying this (non-none) will result in tiles not being cached
-    in memory. This is to avoid issues where the [`url_template`][..] is flaky, to
+    in memory. This is to avoid issues where the [`url_template`][(c).] is flaky, to
     prevent different tilesets being displayed at the same time.
 
     It is expected that this follows the same retina support behaviour
-    as [`url_template`][..].
+    as [`url_template`][(c).].
     """
 
     subdomains: list[str] = field(default_factory=lambda: ["a", "b", "c"])
     """
     List of subdomains used in the URL template.
 
-    For example, if [`subdomains`][..] is set to `["a", "b", "c"]` and the
+    For example, if [`subdomains`][(c).] is set to `["a", "b", "c"]` and the
     `url_template` is `"https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png"`,
     the resulting tile URLs will be:
 
@@ -73,8 +67,8 @@ class TileLayer(MapLayer):
     The size in pixels of each tile image.
     Should be a positive power of 2.
 
-    Note:
-        Must be greater than or equal to `0.0`.
+    Raises:
+        ValueError: If it is less than `0.0`.
     """
 
     min_native_zoom: int = 0
@@ -87,8 +81,8 @@ class TileLayer(MapLayer):
     This should usually be 0 (as default), as most tile sources will support
     zoom levels onwards from this.
 
-    Note:
-        Must be greater than or equal to `0.0`.
+    Raises:
+        ValueError: If it is less than `0.0`.
     """
 
     max_native_zoom: int = 19
@@ -101,8 +95,8 @@ class TileLayer(MapLayer):
     Most tile servers support up to zoom level `19`, which is the default.
     Otherwise, this should be specified.
 
-    Note:
-        Must be greater than or equal to `0.0`.
+    Raises:
+        ValueError: If it is less than `0.0`.
     """
 
     zoom_reverse: bool = False
@@ -115,8 +109,8 @@ class TileLayer(MapLayer):
     """
     The zoom number used in tile URLs will be offset with this value.
 
-    Note:
-        Must be greater than or equal to `0.0`.
+    Raises:
+        ValueError: If it is less than `0.0`.
     """
 
     keep_buffer: int = 2
@@ -148,7 +142,7 @@ class TileLayer(MapLayer):
 
     additional_options: dict[str, str] = field(default_factory=dict)
     """
-    Static information that should replace placeholders in the [`url_template`][..].
+    Static information that should replace placeholders in the [`url_template`][(c).].
     Applying API keys, for example, is a good usecase of this parameter.
 
     Example:
@@ -159,7 +153,7 @@ class TileLayer(MapLayer):
                 'accessToken': '<ACCESS_TOKEN_HERE>',
                 'id': 'mapbox.streets',
             },
-        ),
+        )
         ```
     """
 
@@ -169,29 +163,30 @@ class TileLayer(MapLayer):
     The main usage for this property is to display a different `TileLayer`
     when zoomed far in.
 
-    Prefer [`max_native_zoom`][..] for setting the maximum zoom level supported by the
+    Prefer [`max_native_zoom`][(c).] for setting the maximum zoom level supported by the
     tile source.
 
     Typically set to infinity so that there are tiles always displayed.
 
-    Note:
-        Must be greater than or equal to `0.0`.
+    Raises:
+        ValueError: If it is less than `0.0`.
     """
 
     min_zoom: ft.Number = 0.0
     """
     The minimum zoom level at which this layer is displayed (inclusive).
+
     Typically `0.0`.
 
-    Note:
-        Must be greater than or equal to `0.0`.
+    Raises:
+        ValueError: If it is less than `0.0`.
     """
 
     error_image_src: Optional[str] = None
     """
     The source of the tile image to show in place of the tile that failed to load.
 
-    See [`on_image_error`][..] property for details on the error.
+    See [`on_image_error`][(c).] property for details on the error.
     """
 
     evict_error_tile_strategy: Optional[TileLayerEvictErrorTileStrategy] = (
@@ -217,29 +212,36 @@ class TileLayer(MapLayer):
     """
     Fires if an error occurs when fetching the tiles.
 
-    Event handler argument [`data`][flet.Event.data] property contains
+    Event handler argument [`data`][flet.Event.] property contains
     information about the error.
     """
 
     def before_update(self):
         super().before_update()
-        assert self.tile_size >= 0, (
-            f"tile_size must be greater than or equal to 0, got {self.tile_size}"
-        )
-        assert self.min_native_zoom >= 0, (
-            f"min_native_zoom must be greater than or equal to 0, "
-            f"got {self.min_native_zoom}"
-        )
-        assert self.max_native_zoom >= 0, (
-            f"max_native_zoom must be greater than or equal to 0, "
-            f"got {self.max_native_zoom}"
-        )
-        assert self.zoom_offset >= 0, (
-            f"zoom_offset must be greater than or equal to 0, got {self.zoom_offset}"
-        )
-        assert self.max_zoom >= 0, (
-            f"max_zoom must be greater than or equal to 0, got {self.max_zoom}"
-        )
-        assert self.min_zoom >= 0, (
-            f"min_zoom must be greater than or equal to 0, got {self.min_zoom}"
-        )
+        if self.tile_size < 0:
+            raise ValueError(
+                f"tile_size must be greater than or equal to 0, got {self.tile_size}"
+            )
+        if self.min_native_zoom < 0:
+            raise ValueError(
+                "min_native_zoom must be greater than or equal to 0, "
+                f"got {self.min_native_zoom}"
+            )
+        if self.max_native_zoom < 0:
+            raise ValueError(
+                "max_native_zoom must be greater than or equal to 0, "
+                f"got {self.max_native_zoom}"
+            )
+        if self.zoom_offset < 0:
+            raise ValueError(
+                f"zoom_offset must be greater than or equal to 0, "
+                f"got {self.zoom_offset}"
+            )
+        if self.max_zoom < 0:
+            raise ValueError(
+                f"max_zoom must be greater than or equal to 0, got {self.max_zoom}"
+            )
+        if self.min_zoom < 0:
+            raise ValueError(
+                f"min_zoom must be greater than or equal to 0, got {self.min_zoom}"
+            )