Canvas, Charts controls docstrings

sdk/python/packages/flet/src/flet/controls/adaptive_control.py

@@ -8,4 +8,46 @@
 
 @control(kw_only=True)
 class AdaptiveControl(Control):
+    """
+    Adaptive controls are either Material design controls that have their Cupertino 
+    analogs or container controls. 
+    """
     adaptive: Optional[bool] = None
+    """
+    `adaptive` property can be specified for a control in the following cases:
+
+    * A control has matching Cupertino control with similar functionality/presentation 
+    and graphics as expected on iOS/macOS. In this case, if `adaptive` is `True`, 
+    either Material or Cupertino control will be created depending on the target 
+    platform.  
+
+    These controls have their Cupertino analogs and `adaptive` property:    
+        * [`AlertDialog`](https://flet.dev/docs/controls/alertdialog)
+        * [`AppBar`](https://flet.dev/docs/controls/appbar)
+        * [`Checkbox`](https://flet.dev/docs/controls/checkbox)
+        * [`ListTile`](https://flet.dev/docs/controls/listtile)
+        * [`NavigationBar`](https://flet.dev/docs/controls/navigationbar)
+        * [`Radio`](https://flet.dev/docs/controls/radio)
+        * [`Slider`](https://flet.dev/docs/controls/slider)
+        * [`Switch`](https://flet.dev/docs/controls/switch)
+
+    * A control has child controls. In this case `adaptive` property value is passed on 
+    to its children that don't have their `adaptive` property set. 
+
+    The following container controls have `adaptive` property: 
+        * [`Card`](https://flet.dev/docs/controls/card)
+        * [`Column`](https://flet.dev/docs/controls/column)
+        * [`Container`](https://flet.dev/docs/controls/container)
+        * [`Dismissible`](https://flet.dev/docs/controls/dismissible)
+        * [`ExpansionPanel`](https://flet.dev/docs/controls/expansionpanel)
+        * [`FletApp`](https://flet.dev/docs/controls/fletapp)
+        * [`GestureDetector`](https://flet.dev/docs/controls/gesturedetector)
+        * [`GridView`](https://flet.dev/docs/controls/gridview)
+        * [`ListView`](https://flet.dev/docs/controls/listview)
+        * [`Page`](https://flet.dev/docs/controls/page)
+        * [`Row`](https://flet.dev/docs/controls/row)
+        * [`SafeArea`](https://flet.dev/docs/controls/safearea)
+        * [`Stack`](https://flet.dev/docs/controls/stack)
+        * [`Tabs`](https://flet.dev/docs/controls/tabs)
+        * [`View`](https://flet.dev/docs/controls/view)
+    """

sdk/python/packages/flet/src/flet/controls/alignment.py

@@ -1,4 +1,4 @@
-from dataclasses import dataclass, field
+from dataclasses import dataclass
 from enum import Enum
 from typing import Optional
 
@@ -19,56 +19,85 @@ class Axis(Enum):
 
 @dataclass
 class Alignment:
+    """
+    Used to define an alignment relative to the center.
+    """
+
     x: Number
+    """
+    Represents the horizontal distance from the center. It's value ranges between
+    `-1.0` and `1.0`.
+    """
+
     y: Number
+    """
+    Represents the vertical distance from the center. It's value ranges between
+    `-1.0` and `1.0`.
+    """
 
     @classmethod
     def bottom_center(cls) -> "Alignment":
+        """
+        Represents the bottom center and is equivalent to `Alignment(0.0, 1.0)`.
+        """
         return Alignment(0, 1)
 
     @classmethod
     def bottom_left(cls) -> "Alignment":
+        """
+        Represents the bottom left corner and is equivalent to `Alignment(-1.0, 1.0)`.
+        """
         return Alignment(-1, 1)
 
     @classmethod
     def bottom_right(cls) -> "Alignment":
+        """
+        Represents the bottom right corner and is equivalent to `Alignment(1.0, 1.0)`.
+        """
         return Alignment(1, 1)
 
     @classmethod
     def center(cls) -> "Alignment":
+        """
+        Represents the center and is equivalent to `Alignment(0.0, 0.0)`.
+        """
         return Alignment(0, 0)
 
     @classmethod
     def center_left(cls) -> "Alignment":
+        """
+        Represents the center left and is equivalent to `Alignment(-1.0, 0.0)`.
+        """
         return Alignment(-1, 0)
 
     @classmethod
     def center_right(cls) -> "Alignment":
+        """
+        Represents the center right and is equivalent to `Alignment(1.0, 0.0)`.
+        """
         return Alignment(1, 0)
 
     @classmethod
     def top_center(cls) -> "Alignment":
+        """
+        Represents the top center and is equivalent to `Alignment(0.0, -1.0)`.
+        """
         return Alignment(0, -1)
 
     @classmethod
     def top_left(cls) -> "Alignment":
+        """
+        Represents the top left corner and is equivalent to `Alignment(-1.0, -1.0)`.
+        """
         return Alignment(-1, -1)
 
     @classmethod
     def top_right(cls) -> "Alignment":
+        """
+        Represents the top right corner and is equivalent to `Alignment(1.0, -1.0)`.
+        """
         return Alignment(1, -1)
-
-
-# Constants
-# bottom_center = Alignment(0, 1)
-# bottom_left = Alignment(-1, 1)
-# bottom_right = Alignment(1, 1)
-# center = Alignment(0, 0)
-# center_left = Alignment(-1, 0)
-# center_right = Alignment(1, 0)
-# top_center = Alignment(0, -1)
-# top_left = Alignment(-1, -1)
-# top_right = Alignment(1, -1)
+
 
 # Typing
 OptionalAlignment = Optional[Alignment]

sdk/python/packages/flet/src/flet/controls/animation.py

@@ -64,16 +64,46 @@ class AnimationCurve(Enum):
 @dataclass
 class Animation:
     duration: OptionalDurationValue = None
+    """
+    The duration of the animation.
+    """
+
     curve: "OptionalAnimationCurve" = None
+    """
+    The curve to use for the animation.
+    """
 
 
 @dataclass
 class AnimationStyle:
     duration: OptionalDurationValue = None
+    """
+    The duration of the animation.
+
+    Value is of type [`DurationValue`](https://flet.dev/docs/reference/types/aliases#durationvalue).
+    """
+
     reverse_duration: OptionalDurationValue = None
+    """
+    The duration of the reverse animation.
+
+    Value is of type [`DurationValue`](https://flet.dev/docs/reference/types/aliases#durationvalue).
+    """
+
     curve: "OptionalAnimationCurve" = None
+    """
+    The curve to use for the animation.
+
+    Value is of type [`AnimationCurve`](https://flet.dev/docs/reference/types/animationcurve).
+    """
+
     reverse_curve: "OptionalAnimationCurve" = None
+    """
+    The curve to use for the reverse animation.
 
+    Value is of type [`AnimationCurve`](https://flet.dev/docs/reference/types/animationcurve).
+    """
+
 
 AnimationValue = Union[bool, int, Animation]
 OptionalAnimationValue = Optional[AnimationValue]

sdk/python/packages/flet/src/flet/controls/blur.py

@@ -1,6 +1,6 @@
 from dataclasses import dataclass
 from enum import Enum
-from typing import Optional, Tuple, Union
+from typing import Optional, Union
 
 from flet.controls.types import Number
 
@@ -23,10 +23,23 @@ class BlurTileMode(Enum):
 @dataclass
 class Blur:
     sigma_x: Number
+    """
+    Horizontal sigma.
+    """
+
     sigma_y: Number
+    """
+    Vertical sigma.
+    """
+
     tile_mode: Optional[BlurTileMode] = None
+    """
+    The tile mode for the blur.
+
+    Value is of type [`BlurTileMode`](https://flet.dev/docs/reference/types/blurtilemode).
+    """
 
 
-BlurValue = Union[Number, Tuple[Number, Number], Blur]
+BlurValue = Union[Number, tuple[Number, Number], Blur]
 OptionalBlurValue = Optional[BlurValue]
 OptionalBlurTileMode = Optional[BlurTileMode]

sdk/python/packages/flet/src/flet/controls/border.py

@@ -36,15 +36,46 @@ class BorderSide:
 
 @dataclass
 class Border:
+    """
+    A border comprised of four sides: top, right, bottom, left.
+
+    Each side of the border is described by an instance of [`BorderSide`](https://flet.dev/docs/reference/types/borderside) 
+    class.
+
+    Usage example:
+    ```python
+    container_1.border = ft.Border.all(10, ft.Colors.PINK_600)
+    container_1.border = ft.Border.only(bottom=ft.BorderSide(1, "black"))
+    ```
+    """
+
     top: "OptionalBorderSide" = None
+    """
+    Top side of the border.
+    """
+
     right: "OptionalBorderSide" = None
+    """
+    Right side of the border.
+    """
+
     bottom: "OptionalBorderSide" = None
+    """
+    Bottom side of the border.
+    """
+
     left: "OptionalBorderSide" = None
+    """
+    Left side of the border.
+    """
 
     @classmethod
     def all(
         cls, width: OptionalNumber = None, color: OptionalColorValue = None
     ) -> "Border":
+        """
+        Sets the same border for all 4 sides of the rectangle.
+        """
         bs = BorderSide(width or 1.0, color or Colors.BLACK)
         return Border(left=bs, top=bs, right=bs, bottom=bs)
 
@@ -55,6 +86,10 @@ def symmetric(
         vertical: "OptionalBorderSide" = None,
         horizontal: "OptionalBorderSide" = None,
     ) -> "Border":
+        """
+        Sets `vertical` border for top and bottom sides and `horizontal` for the left 
+        and right sides of the rectangle.
+        """
         return Border(left=horizontal, top=vertical, right=horizontal, bottom=vertical)
 
     @classmethod
@@ -66,6 +101,9 @@ def only(
         right: "OptionalBorderSide" = None,
         bottom: "OptionalBorderSide" = None,
     ) -> "Border":
+        """
+        Sets different borders for each side of the rectangle.
+        """
         return Border(left=left, top=top, right=right, bottom=bottom)
 
 
@@ -109,6 +147,9 @@ def only(
 
 # Typings
 OptionalBorder = Optional[Border]
+"""
+OptionalBorder type description
+"""
 OptionalBorderSide = Optional[BorderSide]
 OptionalBorderSideStrokeAlign = Optional[BorderSideStrokeAlign]
 BorderSideStrokeAlignValue = Union[BorderSideStrokeAlign, Number]

sdk/python/packages/flet/src/flet/controls/border_radius.py

@@ -18,24 +18,54 @@
 @dataclasses.dataclass
 class BorderRadius:
     top_left: Number
+    """
+    Radius of the top left border corner.
+    """
+
     top_right: Number
+    """
+    Radius of the top right border corner.
+    """
+
     bottom_left: Number
+    """
+    Radius of the bottom left border corner.
+    """
+
     bottom_right: Number
+    """
+    Radius of the bottom right border corner.
+    """
 
     @classmethod
     def all(cls, value: Number) -> "BorderRadius":
+        """
+        Sets the same border radius of `value` for all 4 corners of the rectangle.
+        """
         return BorderRadius(
             top_left=value, top_right=value, bottom_left=value, bottom_right=value
         )
 
     @classmethod
     def horizontal(cls, *, left: Number = 0, right: Number = 0) -> "BorderRadius":
+        """
+        Sets the border radius horizontally for the left and right corners of the 
+        rectangle.
+
+        Both `left` and `right` default to `0`.
+        """
         return BorderRadius(
             top_left=left, top_right=right, bottom_left=left, bottom_right=right
         )
 
     @classmethod
     def vertical(cls, *, top: Number = 0, bottom: Number = 0) -> "BorderRadius":
+        """
+        Sets the border radius vertically for the top and bottom corners of the 
+        rectangle.
+
+        Both `top` and `bottom` default to `0`.
+        """
         return BorderRadius(
             top_left=top, top_right=top, bottom_left=bottom, bottom_right=bottom
         )
@@ -49,6 +79,9 @@ def only(
         bottom_left: Number = 0,
         bottom_right: Number = 0,
     ) -> "BorderRadius":
+        """
+        Sets different border radius for each corner of the rectangle.
+        """
         return BorderRadius(
             top_left=top_left,
             top_right=top_right,