flet-charts 0.2.0.dev35__py3-none-any.whl → 0.70.0.dev6551__py3-none-any.whl

flet_charts/candlestick_chart_spot.py

@@ -0,0 +1,98 @@
+from dataclasses import dataclass, field
+from typing import Optional, Union
+
+import flet as ft
+from flet_charts.types import ChartDataPointTooltip
+
+__all__ = ["CandlestickChartSpot", "CandlestickChartSpotTooltip"]
+
+
+@dataclass
+class CandlestickChartSpotTooltip(ChartDataPointTooltip):
+    """Tooltip configuration for the [`CandlestickChartSpot`][(p).]."""
+
+    bottom_margin: ft.Number = 8
+    """
+    Space between the tooltip bubble and the candlestick.
+    """
+
+    def copy(
+        self,
+        *,
+        text: Optional[str] = None,
+        text_style: Optional[ft.TextStyle] = None,
+        text_align: Optional[ft.TextAlign] = None,
+        text_spans: Optional[list[ft.TextSpan]] = None,
+        rtl: Optional[bool] = None,
+        bottom_margin: Optional[ft.Number] = None,
+    ) -> "CandlestickChartSpotTooltip":
+        """
+        Returns a copy of this object with the specified properties overridden.
+        """
+        return CandlestickChartSpotTooltip(
+            text=text if text is not None else self.text,
+            text_style=text_style if text_style is not None else self.text_style,
+            text_align=text_align if text_align is not None else self.text_align,
+            text_spans=text_spans.copy()
+            if text_spans is not None
+            else (self.text_spans.copy() if self.text_spans is not None else None),
+            rtl=rtl if rtl is not None else self.rtl,
+            bottom_margin=bottom_margin
+            if bottom_margin is not None
+            else self.bottom_margin,
+        )
+
+
+@ft.control("CandlestickChartSpot")
+class CandlestickChartSpot(ft.BaseControl):
+    """Represents a candlestick rendered on a [`CandlestickChart`][(p).]."""
+
+    x: ft.Number
+    """
+    The position of the candlestick on the X axis.
+    """
+
+    open: ft.Number
+    """
+    The open value of the candlestick.
+    """
+
+    high: ft.Number
+    """
+    The high value of the candlestick.
+    """
+
+    low: ft.Number
+    """
+    The low value of the candlestick.
+    """
+
+    close: ft.Number
+    """
+    The close value of the candlestick.
+    """
+
+    selected: bool = False
+    """
+    Whether to treat this candlestick as selected.
+    """
+
+    tooltip: Union[CandlestickChartSpotTooltip, str] = field(
+        default_factory=lambda: CandlestickChartSpotTooltip()
+    )
+    """
+    Tooltip configuration for this candlestick.
+    """
+
+    show_tooltip: bool = True
+    """
+    Whether the tooltip should be shown when this candlestick is highlighted.
+    """
+
+    def before_update(self):
+        super().before_update()
+        self._internals["tooltip"] = (
+            CandlestickChartSpotTooltip(text=self.tooltip)
+            if isinstance(self.tooltip, str)
+            else self.tooltip
+        )

flet_charts/chart_axis.py

@@ -1,5 +1,5 @@
 from dataclasses import field
-from typing import Optional, Union
+from typing import Optional
 
 import flet as ft
 
@@ -17,11 +17,9 @@ class ChartAxisLabel(ft.BaseControl):
     A value to draw label for.
     """
 
-    label: Optional[Union[ft.Control, str]] = None
+    label: Optional[ft.StrOrControl] = None
     """
-    The label to display for the specified `value`.
-    
-    Can be a string or a `Control`.
+    The label to display for the specified [`value`][(c).].
     """
 
 
@@ -38,12 +36,12 @@ class ChartAxis(ft.BaseControl):
 
     title_size: ft.Number = 16
     """
-    Width or height of title area.
+    The size of title area.
     """
 
     show_labels: bool = True
     """
-    Whether to display the `labels` along the axis. 
+    Whether to display the [`labels`][(c).] along the axis.
     If `labels` is empty then automatic labels are displayed.
     """
 
@@ -55,10 +53,32 @@ class ChartAxis(ft.BaseControl):
 
     label_spacing: Optional[ft.Number] = None
     """
-    The interval between automatic labels.
+    The spacing/interval between labels.
+
+    If a value is not set, a suitable value
+    will be automatically calculated and used.
     """
 
     label_size: ft.Number = 22
     """
-    Width or height of labels area.
+    The maximum space for each label in [`labels`][(c).].
+
+    Each label will stretch to fit this space.
+    """
+
+    show_min: bool = True
+    """
+    Whether to display a label for the minimum value
+    independent of the sampling interval.
     """
+
+    show_max: bool = True
+    """
+    Whether to display a label for the maximum value
+    independent of the sampling interval.
+    """
+
+    def before_update(self):
+        super().before_update()
+        if self.label_spacing == 0:
+            raise ValueError("label_spacing cannot be 0")

flet_charts/line_chart.py

@@ -2,10 +2,9 @@ from dataclasses import dataclass, field
 from typing import Any, Optional
 
 import flet as ft
-
-from .chart_axis import ChartAxis
-from .line_chart_data import LineChartData
-from .types import ChartEventType, ChartGridLines
+from flet_charts.chart_axis import ChartAxis
+from flet_charts.line_chart_data import LineChartData
+from flet_charts.types import ChartEventType, ChartGridLines, HorizontalAlignment
 
 __all__ = [
     "LineChart",
@@ -27,6 +26,20 @@ class LineChartEventSpot:
     The line's point index or `-1` if no point was hovered.
     """
 
+    def copy(
+        self,
+        *,
+        bar_index: Optional[int] = None,
+        spot_index: Optional[int] = None,
+    ) -> "LineChartEventSpot":
+        """
+        Returns a copy of this object with the specified properties overridden.
+        """
+        return LineChartEventSpot(
+            bar_index=bar_index if bar_index is not None else self.bar_index,
+            spot_index=spot_index if spot_index is not None else self.spot_index,
+        )
+
 
 @dataclass
 class LineChartEvent(ft.Event["LineChart"]):
@@ -72,7 +85,7 @@ class LineChartTooltip:
     Restricts the tooltip's width.
     """
 
-    rotate_angle: ft.Number = 0.0
+    rotation: ft.Number = 0.0
     """
     The tooltip's rotation angle in degrees.
     """
@@ -84,7 +97,7 @@ class LineChartTooltip:
 
     border_side: ft.BorderSide = field(default_factory=lambda: ft.BorderSide.none())
     """
-    The tooltip's border side.
+    Defines the borders of this tooltip.
     """
 
     fit_inside_horizontally: bool = False
@@ -102,13 +115,58 @@ class LineChartTooltip:
     Whether to force the tooltip container to top of the line.
     """
 
+    horizontal_alignment: HorizontalAlignment = HorizontalAlignment.CENTER
+    """
+    The horizontal alignment of this tooltip.
+    """
+
+    def copy(
+        self,
+        *,
+        bgcolor: Optional[ft.ColorValue] = None,
+        border_radius: Optional[ft.BorderRadiusValue] = None,
+        margin: Optional[ft.Number] = None,
+        padding: Optional[ft.PaddingValue] = None,
+        max_width: Optional[ft.Number] = None,
+        rotation: Optional[ft.Number] = None,
+        horizontal_offset: Optional[ft.Number] = None,
+        border_side: Optional[ft.BorderSide] = None,
+        fit_inside_horizontally: Optional[bool] = None,
+        fit_inside_vertically: Optional[bool] = None,
+        show_on_top_of_chart_box_area: Optional[bool] = None,
+    ) -> "LineChartTooltip":
+        """
+        Returns a copy of this object with the specified properties overridden.
+        """
+        return LineChartTooltip(
+            bgcolor=bgcolor if bgcolor is not None else self.bgcolor,
+            border_radius=border_radius
+            if border_radius is not None
+            else self.border_radius,
+            margin=margin if margin is not None else self.margin,
+            padding=padding if padding is not None else self.padding,
+            max_width=max_width if max_width is not None else self.max_width,
+            rotation=rotation if rotation is not None else self.rotation,
+            horizontal_offset=horizontal_offset
+            if horizontal_offset is not None
+            else self.horizontal_offset,
+            border_side=border_side if border_side is not None else self.border_side,
+            fit_inside_horizontally=fit_inside_horizontally
+            if fit_inside_horizontally is not None
+            else self.fit_inside_horizontally,
+            fit_inside_vertically=fit_inside_vertically
+            if fit_inside_vertically is not None
+            else self.fit_inside_vertically,
+            show_on_top_of_chart_box_area=show_on_top_of_chart_box_area
+            if show_on_top_of_chart_box_area is not None
+            else self.show_on_top_of_chart_box_area,
+        )
+
 
 @ft.control("LineChart")
-class LineChart(ft.ConstrainedControl):
+class LineChart(ft.LayoutControl):
     """
     Draws a line chart.
-
-    ![Overview](assets/line-chart/diagram.svg)
     """
 
     data_series: list[LineChartData] = field(default_factory=list)
@@ -165,22 +223,22 @@ class LineChart(ft.ConstrainedControl):
     Controls drawing of chart's vertical lines.
     """
 
-    left_axis: ChartAxis = field(default_factory=lambda: ChartAxis(label_size=44))
+    left_axis: Optional[ChartAxis] = None
     """
     Defines the appearance of the left axis, its title and labels.
     """
 
-    top_axis: ChartAxis = field(default_factory=lambda: ChartAxis(label_size=30))
+    top_axis: Optional[ChartAxis] = None
     """
     Defines the appearance of the top axis, its title and labels.
     """
 
-    right_axis: ChartAxis = field(default_factory=lambda: ChartAxis(label_size=44))
+    right_axis: Optional[ChartAxis] = None
     """
     Defines the appearance of the right axis, its title and labels.
     """
 
-    bottom_axis: ChartAxis = field(default_factory=lambda: ChartAxis(label_size=30))
+    bottom_axis: Optional[ChartAxis] = None
     """
     Defines the appearance of the bottom axis, its title and labels.
     """
@@ -215,9 +273,13 @@ class LineChart(ft.ConstrainedControl):
     Defines the maximum displayed value for Y axis.
     """
 
-    tooltip: LineChartTooltip = field(default_factory=lambda: LineChartTooltip())
+    tooltip: Optional[LineChartTooltip] = field(
+        default_factory=lambda: LineChartTooltip()
+    )
     """
     The tooltip configuration for this chart.
+
+    If set to `None`, no tooltips will be shown throughout this chart.
     """
 
     on_event: Optional[ft.EventHandler[LineChartEvent]] = None

flet_charts/line_chart_data.py

@@ -2,9 +2,8 @@ from dataclasses import field
 from typing import Optional, Union
 
 import flet as ft
-
-from .line_chart_data_point import LineChartDataPoint
-from .types import ChartPointLine, ChartPointShape
+from flet_charts.line_chart_data_point import LineChartDataPoint
+from flet_charts.types import ChartPointLine, ChartPointShape
 
 __all__ = ["LineChartData"]
 
@@ -19,7 +18,7 @@ class LineChartData(ft.BaseControl):
 
     curved: bool = False
     """
-    Set to `True` to draw chart line as a curve.
+    Whether to draw this chart line as a curve.
     """
 
     color: ft.ColorValue = ft.Colors.CYAN
@@ -49,7 +48,7 @@ class LineChartData(ft.BaseControl):
 
     prevent_curve_over_shooting_threshold: ft.Number = 10.0
     """
-    Threshold to prevent overshooting algorithm.
+    Threshold for [`prevent_curve_over_shooting`][(c).] algorithm.
     """
 
     dash_pattern: Optional[list[int]] = None
@@ -128,3 +127,29 @@ class LineChartData(ft.BaseControl):
     """
     Defines the appearance and shape of a selected line point.
     """
+
+    curve_smoothness: ft.Number = 0.35
+    """
+    Defines the smoothness of a curve line,
+    when [`curved`][(c).] is set to `True`.
+    """
+
+    rounded_stroke_join: bool = False
+    """
+    Whether to draw rounded line joins.
+    """
+
+    step_direction: Optional[ft.Number] = None
+    """
+    Determines the direction of each step.
+
+    If not `None`, this chart will be drawn as a
+    [Step Line Chart](https://docs.anychart.com/Basic_Charts/Step_Line_Chart).
+
+    Below are some typical values:
+
+    - `0.0`: Go to the next spot directly, with the current point's y value.
+    - `0.5`: Go to the half with the current spot y, and with the next spot y
+        for the rest.
+    - `1.0`: Go to the next spot y and direct line to the next spot.
+    """

flet_charts/line_chart_data_point.py

@@ -2,8 +2,7 @@ from dataclasses import dataclass, field
 from typing import Optional, Union
 
 import flet as ft
-
-from .types import ChartDataPointTooltip, ChartPointLine, ChartPointShape
+from flet_charts.types import ChartDataPointTooltip, ChartPointLine, ChartPointShape
 
 __all__ = ["LineChartDataPoint", "LineChartDataPointTooltip"]
 
@@ -19,6 +18,28 @@ class LineChartDataPointTooltip(ChartDataPointTooltip):
     When `None`, defaults to [`LineChartDataPoint.y`][(p).].
     """
 
+    def copy(
+        self,
+        *,
+        text: Optional[str] = None,
+        text_style: Optional[ft.TextStyle] = None,
+        text_align: Optional[ft.TextAlign] = None,
+        text_spans: Optional[list[ft.TextSpan]] = None,
+        rtl: Optional[bool] = None,
+    ) -> "LineChartDataPointTooltip":
+        """
+        Returns a copy of this object with the specified properties overridden.
+        """
+        return LineChartDataPointTooltip(
+            text=text if text is not None else self.text,
+            text_style=text_style if text_style is not None else self.text_style,
+            text_align=text_align if text_align is not None else self.text_align,
+            text_spans=text_spans.copy()
+            if text_spans is not None
+            else (self.text_spans.copy() if self.text_spans is not None else None),
+            rtl=rtl if rtl is not None else self.rtl,
+        )
+
 
 @ft.control("LineChartDataPoint")
 class LineChartDataPoint(ft.BaseControl):
@@ -69,7 +90,7 @@ class LineChartDataPoint(ft.BaseControl):
     specify line style to draw.
     """
 
-    tooltip: LineChartDataPointTooltip = field(
+    tooltip: Union[LineChartDataPointTooltip, str] = field(
         default_factory=lambda: LineChartDataPointTooltip()
     )
     """
@@ -78,5 +99,13 @@ class LineChartDataPoint(ft.BaseControl):
 
     show_tooltip: bool = True
     """
-    Whether the [`tooltip`][..] should be shown when this data point is hovered over.
+    Whether the [`tooltip`][(c).] should be shown when this data point is hovered over.
     """
+
+    def before_update(self):
+        super().before_update()
+        self._internals["tooltip"] = (
+            LineChartDataPointTooltip(text=self.tooltip)
+            if isinstance(self.tooltip, str)
+            else self.tooltip
+        )

flet_charts/matplotlib_backends/backend_flet_agg.py

@@ -0,0 +1,16 @@
+from matplotlib import _api
+from matplotlib.backends import backend_webagg_core
+
+
+class FigureCanvasFletAgg(backend_webagg_core.FigureCanvasWebAggCore):
+    manager_class = _api.classproperty(lambda cls: FigureManagerFletAgg)
+    supports_blit = False
+
+
+class FigureManagerFletAgg(backend_webagg_core.FigureManagerWebAgg):
+    _toolbar2_class = backend_webagg_core.NavigationToolbar2WebAgg
+
+
+FigureCanvas = FigureCanvasFletAgg
+FigureManager = FigureManagerFletAgg
+interactive = True