maidr 1.3.0__py3-none-any.whl → 1.4.0__py3-none-any.whl

maidr/util/plot_detection.py

@@ -0,0 +1,136 @@
+"""
+Utility functions for detecting plot types and determining appropriate plot classes.
+"""
+
+from matplotlib.axes import Axes
+from matplotlib.lines import Line2D
+from typing import Dict, Any, List, Union
+
+
+class PlotDetectionUtils:
+    """
+    Utility class for detecting plot characteristics and determining appropriate plot classes.
+    """
+
+    @staticmethod
+    def is_mplfinance_bar_plot(**kwargs) -> bool:
+        """
+        Detect if this is an mplfinance bar plot based on kwargs.
+
+        Parameters
+        ----------
+        **kwargs : dict
+            Keyword arguments passed to the plot factory
+
+        Returns
+        -------
+        bool
+            True if this is an mplfinance bar plot
+        """
+        return "_maidr_patches" in kwargs or "_maidr_date_nums" in kwargs
+
+    @staticmethod
+    def is_mplfinance_line_plot(ax: Axes, **kwargs) -> bool:
+        """
+        Detect if this is an mplfinance line plot based on kwargs or Line2D attributes.
+
+        Parameters
+        ----------
+        ax : Axes
+            The matplotlib axes object
+        **kwargs : dict
+            Keyword arguments passed to the plot factory
+
+        Returns
+        -------
+        bool
+            True if this is an mplfinance line plot
+        """
+        # Check kwargs first (more efficient)
+        if "_maidr_date_nums" in kwargs:
+            return True
+
+        # Check Line2D objects for mplfinance attributes
+        try:
+            for line in ax.get_lines():
+                if isinstance(line, Line2D) and hasattr(line, "_maidr_date_nums"):
+                    return True
+        except (AttributeError, TypeError):
+            # Handle cases where ax doesn't have get_lines() method (e.g., Mock objects)
+            pass
+
+        return False
+
+    @staticmethod
+    def is_mplfinance_candlestick_plot(**kwargs) -> bool:
+        """
+        Detect if this is an mplfinance candlestick plot based on kwargs.
+
+        Parameters
+        ----------
+        **kwargs : dict
+            Keyword arguments passed to the plot factory
+
+        Returns
+        -------
+        bool
+            True if this is an mplfinance candlestick plot
+        """
+        return any(key.startswith("_maidr_") for key in kwargs.keys())
+
+    @staticmethod
+    def should_use_candlestick_plot(
+        ax: Union[Axes, List[Axes], List[List[Axes]]], **kwargs
+    ) -> bool:
+        """
+        Determine if a candlestick plot should be used based on axes structure.
+
+        Parameters
+        ----------
+        ax : Union[Axes, List[Axes], List[List[Axes]]]
+            The matplotlib axes object(s)
+        **kwargs : dict
+            Keyword arguments passed to the plot factory
+
+        Returns
+        -------
+        bool
+            True if candlestick plot should be used
+        """
+        # Check if we have mplfinance-specific kwargs
+        if PlotDetectionUtils.is_mplfinance_candlestick_plot(**kwargs):
+            return True
+
+        # Check if we have a list of axes (typical for candlestick plots)
+        if isinstance(ax, list):
+            return True
+
+        return False
+
+    @staticmethod
+    def get_candlestick_axes(
+        ax: Union[Axes, List[Axes], List[List[Axes]]]
+    ) -> List[Axes]:
+        """
+        Extract and normalize axes for candlestick plots.
+
+        Parameters
+        ----------
+        ax : Union[Axes, List[Axes], List[List[Axes]]]
+            The matplotlib axes object(s)
+
+        Returns
+        -------
+        List[Axes]
+            Normalized list of axes for candlestick plotting
+        """
+        if isinstance(ax, list):
+            if ax and isinstance(ax[0], list):
+                # Handle nested list case: [[ax1, ax2]]
+                return ax[0]
+            else:
+                # Handle simple list case: [ax1, ax2]
+                return ax
+        else:
+            # Handle single axis case
+            return [ax]

{maidr-1.3.0.dist-info → maidr-1.4.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: maidr
-Version: 1.3.0
+Version: 1.4.0
 Summary: Multimodal Access and Interactive Data Representations
 License: GPL-3.0-or-later
 Keywords: accessibility,visualization,sonification,braille,tactile,multimodal,data representation,blind,low vision,visual impairments

{maidr-1.3.0.dist-info → maidr-1.4.0.dist-info}/RECORD

@@ -1,4 +1,4 @@
-maidr/__init__.py,sha256=q3J6Xlb_5wM0iRIYZnMkvD0ValcEFxltt6-kbGrRKR4,399
+maidr/__init__.py,sha256=RJ2I0a9M__hF_MmMmToPHiRV0h8rZUJ_kb7AlMKx-R4,415
 maidr/api.py,sha256=F43mXWsxc7tHdlZqbRlEWkc-RjJVo_zgxCn3NiLBY58,1764
 maidr/core/__init__.py,sha256=WgxLpSEYMc4k3OyEOf1shOxfEq0ASzppEIZYmE91ThQ,25
 maidr/core/context_manager.py,sha256=6cT7ZGOApSpC-SLD2XZWWU_H08i-nfv-JUlzXOtvWYw,3374
@@ -12,18 +12,20 @@ maidr/core/maidr.py,sha256=kpN5axfJnWyaqXvyA1maioPOFh1rqod3XIvhIefcjOs,14225
 maidr/core/plot/__init__.py,sha256=xDIpRGM-4DfaSSL3nKcXrjdMecCHJ6en4K4nA_fPefQ,83
 maidr/core/plot/barplot.py,sha256=1HfoqyDGKIXkYQnCHN83Ye_faKpNQ3R4wjlbjD5jUyk,2092
 maidr/core/plot/boxplot.py,sha256=i11GdNuz_c-hilmhydu3ah-bzyVdFoBkNvRi5lpMrrY,9946
-maidr/core/plot/candlestick.py,sha256=8YKjNmxJx7TEvaH5v4lYDzA11VHpVHpZrv9EJG2Ter4,10587
+maidr/core/plot/candlestick.py,sha256=vT_QL48XAWw-rwFB635faSBfwsS3SYFr3hplndLQOpc,4584
 maidr/core/plot/grouped_barplot.py,sha256=bRcQcvwkF3Q3aZ3PlhbZ6bHI_AfcqdKUMVvlLL94wXM,2078
 maidr/core/plot/heatmap.py,sha256=yMS-31tS2GW4peds9LtZesMxmmTV_YfqYO5M_t5KasQ,2521
 maidr/core/plot/histogram.py,sha256=QV5W-6ZJQQcZsrM91JJBX-ONktJzH7yg_et5_bBPfQQ,1525
 maidr/core/plot/lineplot.py,sha256=C3xz6uWXYM_mbTq_geb5bP0JdvhcQf6cpfTs78Y6fCM,3852
-maidr/core/plot/maidr_plot.py,sha256=B6hjsu-jSWlevEqJawgwjMOJr51nBBNh7yqJdSTkNhw,3681
-maidr/core/plot/maidr_plot_factory.py,sha256=5SC8Nc3IfVYn-jQU_SD9vw7R5yhTHTBgQwGnAc7_DmA,2507
+maidr/core/plot/maidr_plot.py,sha256=DN4TTRNt_SCqGa_mbkHrnpCk-eUQm71HoFRqs3bB6xk,3868
+maidr/core/plot/maidr_plot_factory.py,sha256=NW2iFScswgXbAC9rAOo4iMkAFsjY43DAvFioGr0yzx4,2732
+maidr/core/plot/mplfinance_barplot.py,sha256=AU9Y8dzt3mFH_tWoRT9aYU1X32q0N8AvczImleUMiXY,4399
+maidr/core/plot/mplfinance_lineplot.py,sha256=D5j8EPsHojmTd1xCZG4Hy0NGBqg9zdLjKdtOdUlMk4k,5233
 maidr/core/plot/regplot.py,sha256=b7u6bGTz1IxKahplNUrfwIr_OGSwMJ2BuLgFAVjL0s0,2744
 maidr/core/plot/scatterplot.py,sha256=o0i0uS-wXK9ZrENxneoHbh3-u-2goRONp19Yu9QLsaY,1257
 maidr/exception/__init__.py,sha256=PzaXoYBhyZxMDcJkuxJugDx7jZeseI0El6LpxIwXyG4,46
 maidr/exception/extraction_error.py,sha256=rd37Oxa9gn2OWFWt9AOH5fv0hNd3sAWGvpDMFBuJY2I,607
-maidr/patch/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+maidr/patch/__init__.py,sha256=FnkoUQJC2ODhLO37GwgRVSitBCRax42Ti0e4NIAgdO0,236
 maidr/patch/barplot.py,sha256=nxgBWBMUyf3eAW56CN5EKYYy3vsTgEPRlcvNYS3-WiU,2479
 maidr/patch/boxplot.py,sha256=l7wDD4pDi4ZbsL5EX5XDhPRxgtSIFSrFguMOZ7IC2eg,2845
 maidr/patch/candlestick.py,sha256=NFkzwpxmLBpWmb5s05pjk6obNMQee-xIEZTqGkbhhqM,1776
@@ -34,19 +36,22 @@ maidr/patch/highlight.py,sha256=I1dGFHJAnVd0AHVnMJzk_TE8BC8Uv-I6fTzSrJLU5QM,1155
 maidr/patch/histogram.py,sha256=k3N0RUf1SQ2402pwbaY5QyS98KnLWvr9glCHQw9NTko,2378
 maidr/patch/kdeplot.py,sha256=qv-OKzuop2aTrkZgUe2OnLxvV-KMyeXt1Td0_uZeHzE,2338
 maidr/patch/lineplot.py,sha256=og42V0tWBKCnf6idT3pLsIj3QBvKjg8aUN-k1udPRVw,1901
+maidr/patch/mplfinance.py,sha256=GU0ynZVA1hnKMNQIGNY8yQ-gOWdt-0s98ozGT0ayLOA,7890
 maidr/patch/regplot.py,sha256=Ciz43C5XZfWK6wtVWrlV0WNz4R__rcgdqVE9OCaXXRk,3236
 maidr/patch/scatterplot.py,sha256=kln6zZwjVsdQzICalo-RnBOJrx1BnIB2xYUwItHvSNY,525
-maidr/util/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+maidr/util/__init__.py,sha256=eRJZfRpDX-n7UoV3JXw_9Lbfu_qNl_D0W1UTvLL-Iv4,81
 maidr/util/dedup_utils.py,sha256=RpgPL5p-3oULUHaTCZJaQKhPHfyPkvBLHMt8lAGpJ5A,438
 maidr/util/environment.py,sha256=-2LyZUpHojBCMEbkr_xkcC-_IDqtGDALB8683v7kTdI,5253
 maidr/util/mixin/__init__.py,sha256=aGJZNhtWh77yIVPc7ipIZm1OajigjMtCWYKPuDWTC-c,217
 maidr/util/mixin/extractor_mixin.py,sha256=oHtwpmS5kARvaLrSO3DKTPQxyFUw9nOcKN7rzTj1q4g,5192
 maidr/util/mixin/merger_mixin.py,sha256=V0qLw_6DUB7X6CQ3BCMpsCQX_ZuwAhoSTm_E4xAJFKM,712
+maidr/util/mplfinance_utils.py,sha256=AvDzvAAQbMsPZxcxWr3DwctZMp4xW5CkQEBezWTk1mY,13704
+maidr/util/plot_detection.py,sha256=bVSocZMGCLP6CduRSpOmwIzLFWEBnNdYN9T1ULfVPMw,3893
 maidr/util/regression_line_utils.py,sha256=P8RQLixTby2JLz73XZgNiu96C2Ct3pNe4ENRWOjgT8M,509
 maidr/util/svg_utils.py,sha256=2gyzBtNKFHs0utrw1iOlxTmznzivOWQMV2aW8zu2c8E,1442
 maidr/widget/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 maidr/widget/shiny.py,sha256=wrrw2KAIpE_A6CNQGBtNHauR1DjenA_n47qlFXX9_rk,745
-maidr-1.3.0.dist-info/LICENSE,sha256=IwGE9guuL-ryRPEKi6wFPI_zOhg7zDZbTYuHbSt_SAk,35823
-maidr-1.3.0.dist-info/METADATA,sha256=m0inXLNCctWjHu0KGU-tQd7q459C2xskdw3LC8-KTsw,2664
-maidr-1.3.0.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
-maidr-1.3.0.dist-info/RECORD,,
+maidr-1.4.0.dist-info/LICENSE,sha256=IwGE9guuL-ryRPEKi6wFPI_zOhg7zDZbTYuHbSt_SAk,35823
+maidr-1.4.0.dist-info/METADATA,sha256=0N1VB59PGbv3IEBZrkDBYBeNlRoWB1W3HuOdUsXxZNA,2664
+maidr-1.4.0.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+maidr-1.4.0.dist-info/RECORD,,