flet-charts 0.2.0.dev534__tar.gz → 0.70.0.dev6293__tar.gz

{flet_charts-0.2.0.dev534/src/flet_charts.egg-info → flet_charts-0.70.0.dev6293}/PKG-INFO

@@ -1,24 +1,24 @@
 Metadata-Version: 2.4
 Name: flet-charts
-Version: 0.2.0.dev534
-Summary: A Flet extension for creating interactive charts and graphs.
+Version: 0.70.0.dev6293
+Summary: Interactive chart controls for Flet apps.
 Author-email: Flet contributors <hello@flet.dev>
 License-Expression: Apache-2.0
 Project-URL: Homepage, https://flet.dev
-Project-URL: Documentation, https://flet-dev.github.io/flet-charts
-Project-URL: Repository, https://github.com/flet-dev/flet-charts
-Project-URL: Issues, https://github.com/flet-dev/flet-charts/issues
+Project-URL: Documentation, https://docs.flet.dev/charts
+Project-URL: Repository, https://github.com/flet-dev/flet/tree/main/sdk/python/packages/flet-charts
+Project-URL: Issues, https://github.com/flet-dev/flet/issues
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: flet
+Requires-Dist: flet==0.70.0.dev6293
 Dynamic: license-file
 
 # flet-charts
 
 [![pypi](https://img.shields.io/pypi/v/flet-charts.svg)](https://pypi.python.org/pypi/flet-charts)
 [![downloads](https://static.pepy.tech/badge/flet-charts/month)](https://pepy.tech/project/flet-charts)
-[![license](https://img.shields.io/github/license/flet-dev/flet-charts.svg)](https://github.com/flet-dev/flet-charts/blob/main/LICENSE)
+[![license](https://img.shields.io/github/license/flet-dev/flet.svg)](https://github.com/flet-dev/flet/blob/main/sdk/python/packages/flet-charts/LICENSE)
 
 A [Flet](https://flet.dev) extension for creating interactive charts and graphs.
 
@@ -26,12 +26,10 @@ It is based on the [fl_chart](https://pub.dev/packages/fl_chart) Flutter package
 
 ## Documentation
 
-Detailed documentation to this package can be found [here](https://flet-charts.docs.flet.dev/).
+Detailed documentation to this package can be found [here](https://docs.flet.dev/charts/).
 
 ## Platform Support
 
-This package supports the following platforms:
-
 | Platform | Windows | macOS | Linux | iOS | Android | Web |
 |----------|---------|-------|-------|-----|---------|-----|
 | Supported|    ✅    |   ✅   |   ✅   |  ✅  |    ✅    |  ✅  |
@@ -55,4 +53,14 @@ To install the `flet-charts` package and add it to your project dependencies:
 
 ### Examples
 
-For examples, see [these](./examples).
+For examples, see [these](https://github.com/flet-dev/flet/tree/main/sdk/python/examples/controls/charts).
+
+### Available charts
+
+- `BarChart`
+- `CandlestickChart`
+- `LineChart`
+- `MatplotlibChart`
+- `PieChart`
+- `PlotlyChart`
+- `ScatterChart`

{flet_charts-0.2.0.dev534 → flet_charts-0.70.0.dev6293}/README.md

@@ -2,7 +2,7 @@
 
 [![pypi](https://img.shields.io/pypi/v/flet-charts.svg)](https://pypi.python.org/pypi/flet-charts)
 [![downloads](https://static.pepy.tech/badge/flet-charts/month)](https://pepy.tech/project/flet-charts)
-[![license](https://img.shields.io/github/license/flet-dev/flet-charts.svg)](https://github.com/flet-dev/flet-charts/blob/main/LICENSE)
+[![license](https://img.shields.io/github/license/flet-dev/flet.svg)](https://github.com/flet-dev/flet/blob/main/sdk/python/packages/flet-charts/LICENSE)
 
 A [Flet](https://flet.dev) extension for creating interactive charts and graphs.
 
@@ -10,12 +10,10 @@ It is based on the [fl_chart](https://pub.dev/packages/fl_chart) Flutter package
 
 ## Documentation
 
-Detailed documentation to this package can be found [here](https://flet-charts.docs.flet.dev/).
+Detailed documentation to this package can be found [here](https://docs.flet.dev/charts/).
 
 ## Platform Support
 
-This package supports the following platforms:
-
 | Platform | Windows | macOS | Linux | iOS | Android | Web |
 |----------|---------|-------|-------|-----|---------|-----|
 | Supported|    ✅    |   ✅   |   ✅   |  ✅  |    ✅    |  ✅  |
@@ -39,4 +37,14 @@ To install the `flet-charts` package and add it to your project dependencies:
 
 ### Examples
 
-For examples, see [these](./examples).
+For examples, see [these](https://github.com/flet-dev/flet/tree/main/sdk/python/examples/controls/charts).
+
+### Available charts
+
+- `BarChart`
+- `CandlestickChart`
+- `LineChart`
+- `MatplotlibChart`
+- `PieChart`
+- `PlotlyChart`
+- `ScatterChart`

flet_charts-0.70.0.dev6293/pyproject.toml

@@ -0,0 +1,24 @@
+[project]
+name = "flet-charts"
+version = "0.70.0.dev6293"
+description = "Interactive chart controls for 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.dev6293",
+]
+
+[project.urls]
+Homepage = "https://flet.dev"
+Documentation = "https://docs.flet.dev/charts"
+Repository = "https://github.com/flet-dev/flet/tree/main/sdk/python/packages/flet-charts"
+Issues = "https://github.com/flet-dev/flet/issues"
+
+[tool.setuptools.package-data]
+"flutter.flet_charts" = ["**/*"]
+
+[build-system]
+requires = ["setuptools"]
+build-backend = "setuptools.build_meta"

{flet_charts-0.2.0.dev534 → flet_charts-0.70.0.dev6293}/src/flet_charts/__init__.py

@@ -7,6 +7,15 @@ from flet_charts.bar_chart import (
 from flet_charts.bar_chart_group import BarChartGroup
 from flet_charts.bar_chart_rod import BarChartRod, BarChartRodTooltip
 from flet_charts.bar_chart_rod_stack_item import BarChartRodStackItem
+from flet_charts.candlestick_chart import (
+    CandlestickChart,
+    CandlestickChartEvent,
+    CandlestickChartTooltip,
+)
+from flet_charts.candlestick_chart_spot import (
+    CandlestickChartSpot,
+    CandlestickChartSpotTooltip,
+)
 from flet_charts.chart_axis import ChartAxis, ChartAxisLabel
 from flet_charts.line_chart import (
     LineChart,
@@ -55,6 +64,11 @@ __all__ = [
     "BarChartRodTooltip",
     "BarChartTooltip",
     "BarChartTooltipDirection",
+    "CandlestickChart",
+    "CandlestickChartEvent",
+    "CandlestickChartSpot",
+    "CandlestickChartSpotTooltip",
+    "CandlestickChartTooltip",
     "ChartAxis",
     "ChartAxisLabel",
     "ChartCirclePoint",
@@ -74,6 +88,9 @@ __all__ = [
     "LineChartEventSpot",
     "LineChartTooltip",
     "MatplotlibChart",
+    "MatplotlibChartMessageEvent",
+    "MatplotlibChartToolbarButtonsUpdateEvent",
+    "MatplotlibChartWithToolbar",
     "PieChart",
     "PieChartEvent",
     "PieChartSection",
@@ -83,7 +100,4 @@ __all__ = [
     "ScatterChartSpot",
     "ScatterChartSpotTooltip",
     "ScatterChartTooltip",
-    "MatplotlibChartMessageEvent",
-    "MatplotlibChartToolbarButtonsUpdateEvent",
-    "MatplotlibChartWithToolbar",
 ]

{flet_charts-0.2.0.dev534 → flet_charts-0.70.0.dev6293}/src/flet_charts/bar_chart.py

@@ -3,7 +3,6 @@ from enum import Enum
 from typing import Any, Optional
 
 import flet as ft
-
 from flet_charts.bar_chart_group import BarChartGroup
 from flet_charts.chart_axis import ChartAxis
 from flet_charts.types import ChartEventType, ChartGridLines, HorizontalAlignment
@@ -221,22 +220,22 @@ class BarChart(ft.LayoutControl):
     Controls drawing of chart's vertical lines.
     """
 
-    left_axis: ChartAxis = field(default_factory=lambda: ChartAxis(label_size=44))
+    left_axis: Optional[ChartAxis] = None
     """
     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
     """
     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
     """
     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
     """
     The appearance of the bottom axis, its title and labels.
     """

{flet_charts-0.2.0.dev534 → flet_charts-0.70.0.dev6293}/src/flet_charts/bar_chart_group.py

@@ -2,7 +2,6 @@ from dataclasses import field
 from typing import Optional
 
 import flet as ft
-
 from flet_charts.bar_chart_rod import BarChartRod
 
 __all__ = ["BarChartGroup"]

{flet_charts-0.2.0.dev534 → flet_charts-0.70.0.dev6293}/src/flet_charts/bar_chart_rod.py

@@ -2,7 +2,6 @@ from dataclasses import dataclass, field
 from typing import Optional, Union
 
 import flet as ft
-
 from flet_charts.bar_chart_rod_stack_item import BarChartRodStackItem
 from flet_charts.types import ChartDataPointTooltip
 

flet_charts-0.70.0.dev6293/src/flet_charts/candlestick_chart.py

@@ -0,0 +1,266 @@
+from dataclasses import dataclass, field
+from typing import Any, Optional
+
+import flet as ft
+from flet_charts.candlestick_chart_spot import CandlestickChartSpot
+from flet_charts.chart_axis import ChartAxis
+from flet_charts.types import ChartEventType, ChartGridLines, HorizontalAlignment
+
+__all__ = [
+    "CandlestickChart",
+    "CandlestickChartEvent",
+    "CandlestickChartTooltip",
+]
+
+
+@dataclass
+class CandlestickChartTooltip:
+    """Configuration of the tooltip for [`CandlestickChart`][(p).]s."""
+
+    bgcolor: ft.ColorValue = "#FF607D8B"
+    """
+    Background color applied to the tooltip bubble.
+    """
+
+    border_radius: Optional[ft.BorderRadiusValue] = None
+    """
+    Corner radius of the tooltip bubble.
+    """
+
+    padding: ft.PaddingValue = field(
+        default_factory=lambda: ft.Padding.symmetric(vertical=8, horizontal=16)
+    )
+    """
+    Padding inside the tooltip bubble.
+    """
+
+    max_width: ft.Number = 120
+    """
+    Maximum width of the tooltip bubble.
+    """
+
+    rotation: ft.Number = 0.0
+    """
+    Rotation angle (in degrees) applied to the tooltip bubble.
+    """
+
+    horizontal_offset: ft.Number = 0
+    """
+    Horizontal offset applied to the tooltip bubble.
+    """
+
+    horizontal_alignment: HorizontalAlignment = HorizontalAlignment.CENTER
+    """
+    Horizontal alignment of the tooltip relative to the tapped candlestick.
+    """
+
+    border_side: ft.BorderSide = field(default_factory=lambda: ft.BorderSide.none())
+    """
+    The tooltip bubble border.
+    """
+
+    fit_inside_horizontally: bool = False
+    """
+    Forces the tooltip bubble to remain inside the chart horizontally.
+    """
+
+    fit_inside_vertically: bool = False
+    """
+    Forces the tooltip bubble to remain inside the chart vertically.
+    """
+
+    show_on_top_of_chart_box_area: bool = False
+    """
+    When set to `True`, the tooltip is drawn at the top of the chart box.
+    """
+
+    def copy(
+        self,
+        *,
+        bgcolor: Optional[ft.ColorValue] = None,
+        border_radius: Optional[ft.BorderRadiusValue] = None,
+        padding: Optional[ft.PaddingValue] = None,
+        max_width: Optional[ft.Number] = None,
+        rotation: Optional[ft.Number] = None,
+        horizontal_offset: Optional[ft.Number] = None,
+        horizontal_alignment: Optional[HorizontalAlignment] = 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,
+    ) -> "CandlestickChartTooltip":
+        """
+        Returns a copy of this object with the specified properties overridden.
+        """
+        return CandlestickChartTooltip(
+            bgcolor=bgcolor if bgcolor is not None else self.bgcolor,
+            border_radius=border_radius
+            if border_radius is not None
+            else self.border_radius,
+            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,
+            horizontal_alignment=horizontal_alignment
+            if horizontal_alignment is not None
+            else self.horizontal_alignment,
+            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,
+        )
+
+
+@dataclass
+class CandlestickChartEvent(ft.Event["CandlestickChart"]):
+    """Event raised for interactions with a [`CandlestickChart`][(p).]."""
+
+    type: ChartEventType
+    """
+    Type of pointer gesture that triggered the event.
+    """
+
+    spot_index: Optional[int] = None
+    """
+    Index of the candlestick that was interacted with; `None` if none.
+    """
+
+
+@ft.control("CandlestickChart")
+class CandlestickChart(ft.LayoutControl):
+    """
+    Draws a candlestick chart representing OHLC values.
+    """
+
+    spots: list[CandlestickChartSpot] = field(default_factory=list)
+    """
+    Candlesticks to display on the chart.
+    """
+
+    animation: ft.AnimationValue = field(
+        default_factory=lambda: ft.Animation(
+            duration=ft.Duration(milliseconds=150), curve=ft.AnimationCurve.LINEAR
+        )
+    )
+    """
+    Controls chart implicit animations.
+    """
+
+    interactive: bool = True
+    """
+    Enables automatic tooltips and highlighting when hovering the chart.
+    """
+
+    handle_built_in_touches: bool = True
+    """
+    Allows the chart to manage tooltip visibility automatically.
+    """
+
+    long_press_duration: Optional[ft.DurationValue] = None
+    """
+    The duration of a long press on the chart.
+    """
+
+    touch_spot_threshold: Optional[ft.Number] = None
+    """
+    The distance threshold to consider a touch near a candlestick.
+    """
+
+    bgcolor: Optional[ft.ColorValue] = None
+    """
+    Background color of the chart.
+    """
+
+    border: Optional[ft.Border] = None
+    """
+    Border drawn around the chart.
+    """
+
+    horizontal_grid_lines: Optional[ChartGridLines] = None
+    """
+    Horizontal grid lines configuration.
+    """
+
+    vertical_grid_lines: Optional[ChartGridLines] = None
+    """
+    Vertical grid lines configuration.
+    """
+
+    left_axis: Optional[ChartAxis] = None
+    """
+    Appearance of the left axis, its title and labels.
+    """
+
+    top_axis: Optional[ChartAxis] = None
+    """
+    Appearance of the top axis, its title and labels.
+    """
+
+    right_axis: Optional[ChartAxis] = None
+    """
+    Appearance of the right axis, its title and labels.
+    """
+
+    bottom_axis: Optional[ChartAxis] = None
+    """
+    Appearance of the bottom axis, its title and labels.
+    """
+
+    baseline_x: Optional[ft.Number] = None
+    """
+    Baseline value on the X axis.
+    """
+
+    min_x: Optional[ft.Number] = None
+    """
+    Minimum value displayed on the X axis.
+    """
+
+    max_x: Optional[ft.Number] = None
+    """
+    Maximum value displayed on the X axis.
+    """
+
+    baseline_y: Optional[ft.Number] = None
+    """
+    Baseline value on the Y axis.
+    """
+
+    min_y: Optional[ft.Number] = None
+    """
+    Minimum value displayed on the Y axis.
+    """
+
+    max_y: Optional[ft.Number] = None
+    """
+    Maximum value displayed on the Y axis.
+    """
+
+    rotation_quarter_turns: ft.Number = 0
+    """
+    Number of quarter turns (90-degree increments) to rotate the chart.
+    """
+
+    tooltip: Optional[CandlestickChartTooltip] = field(
+        default_factory=lambda: CandlestickChartTooltip()
+    )
+    """
+    Tooltip configuration for the chart.
+    """
+
+    on_event: Optional[ft.EventHandler[CandlestickChartEvent]] = None
+    """
+    Called when an event occurs on this chart.
+    """
+
+    def __post_init__(self, ref: Optional[ft.Ref[Any]]):
+        super().__post_init__(ref)
+        self._internals["skip_properties"] = ["tooltip"]

flet_charts-0.70.0.dev6293/src/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-0.2.0.dev534 → flet_charts-0.70.0.dev6293}/src/flet_charts/line_chart.py

@@ -2,7 +2,6 @@ from dataclasses import dataclass, field
 from typing import Any, Optional
 
 import flet as ft
-
 from flet_charts.chart_axis import ChartAxis
 from flet_charts.line_chart_data import LineChartData
 from flet_charts.types import ChartEventType, ChartGridLines, HorizontalAlignment
@@ -224,22 +223,22 @@ class LineChart(ft.LayoutControl):
     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.
     """

{flet_charts-0.2.0.dev534 → flet_charts-0.70.0.dev6293}/src/flet_charts/line_chart_data.py

@@ -2,7 +2,6 @@ from dataclasses import field
 from typing import Optional, Union
 
 import flet as ft
-
 from flet_charts.line_chart_data_point import LineChartDataPoint
 from flet_charts.types import ChartPointLine, ChartPointShape
 

{flet_charts-0.2.0.dev534 → flet_charts-0.70.0.dev6293}/src/flet_charts/line_chart_data_point.py

@@ -2,7 +2,6 @@ from dataclasses import dataclass, field
 from typing import Optional, Union
 
 import flet as ft
-
 from flet_charts.types import ChartDataPointTooltip, ChartPointLine, ChartPointShape
 
 __all__ = ["LineChartDataPoint", "LineChartDataPointTooltip"]

{flet_charts-0.2.0.dev534 → flet_charts-0.70.0.dev6293}/src/flet_charts/pie_chart.py

@@ -2,7 +2,6 @@ from dataclasses import dataclass, field
 from typing import Optional
 
 import flet as ft
-
 from flet_charts.pie_chart_section import PieChartSection
 from flet_charts.types import ChartEventType
 

{flet_charts-0.2.0.dev534 → flet_charts-0.70.0.dev6293}/src/flet_charts/plotly_chart.py

@@ -29,7 +29,7 @@ class PlotlyChart(ft.Container):
     figure: Figure = field(metadata={"skip": True})
     """
     Plotly figure to draw.
-    
+
     The value is an instance of [`plotly.graph_objects.Figure`](https://plotly.com/python-api-reference/generated/plotly.graph_objects.Figure.html).
     """