TradeChart 2.2.1__tar.gz → 2.4.0__tar.gz

{tradechart-2.2.1 → tradechart-2.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: TradeChart
-Version: 2.2.1
+Version: 2.4.0
 Summary: Production-quality financial chart generator — candlestick, line, area, OHLC, Heikin-Ashi, performance heatmaps, and sector group charts.
 Author-email: "TRADELY.DEV" <dev@tradely.dev>
 License: Apache-2.0
@@ -45,7 +45,7 @@ Requires-Dist: build>=1.0; extra == "dev"
 Requires-Dist: twine>=5.0; extra == "dev"
 Dynamic: license-file
 
-# TradeChart — Library Edition v2.2.1
+# TradeChart — Library Edition v2.4.0
 
 **Python → Financial Charts**  
 Generate production-quality candlestick, line, area, OHLC, Heikin-Ashi, and performance heatmap charts from code.  
@@ -450,8 +450,8 @@ tc.config(
 | `theme` | `str` | `"dark"` | `"dark"`, `"light"`, `"classic"` | Chart colour theme. See [Themes](#themes). |
 | `watermark` | `bool` | `True` | `True`, `False` | Show or hide the TRADELY logo in the bottom-left corner of charts. |
 | `overwrite` | `bool` | `False` | `True`, `False` | `False` — append `_1`, `_2`, … to the filename if it already exists. `True` — overwrite the existing file silently. |
-| `dpi` | `int` | `150` | `50`–`600` | Output resolution in dots per inch. Higher values produce larger, sharper files. |
-| `fig_size` | `tuple[int, int]` | `(14, 7)` | Any valid `(width, height)` in inches | Matplotlib figure size. Increase for wide monitors or presentations. |
+| `dpi` | `int` | `100` | `50`–`600` | Output resolution in dots per inch. Higher values produce larger, sharper files. |
+| `fig_size` | `tuple[int, int]` | `(12, 6)` | Any valid `(width, height)` in inches | Matplotlib figure size. Increase for wide monitors or presentations. |
 | `cache_ttl` | `int` | `300` | Any positive integer (seconds) | How long fetched data is kept in memory. `0` effectively disables caching. |
 
 ---
@@ -602,7 +602,7 @@ The `"heikin_ashi"` chart type converts standard OHLC data to Heikin-Ashi candle
 When `mplfinance` is installed (`pip install TradeChart[mplfinance]`), candlestick and Heikin-Ashi charts use it for higher-quality rendering. Otherwise a pure-matplotlib fallback is used automatically — no configuration required.
 
 **Output resolution**  
-Default DPI is 150, producing a ~2100 × 1050 px image at the default figure size. Increase with `tc.config(dpi=300)` for print-quality output.
+Default DPI is 100, producing a ~1200 × 600 px image at the default figure size — well under 300 KB for all supported formats. Increase with `tc.config(dpi=200)` for sharper output, or `tc.config(dpi=300)` for print quality.
 
 ---
 

{tradechart-2.2.1 → tradechart-2.4.0}/README.md

@@ -1,4 +1,4 @@
-# TradeChart — Library Edition v2.2.1
+# TradeChart — Library Edition v2.4.0
 
 **Python → Financial Charts**  
 Generate production-quality candlestick, line, area, OHLC, Heikin-Ashi, and performance heatmap charts from code.  
@@ -403,8 +403,8 @@ tc.config(
 | `theme` | `str` | `"dark"` | `"dark"`, `"light"`, `"classic"` | Chart colour theme. See [Themes](#themes). |
 | `watermark` | `bool` | `True` | `True`, `False` | Show or hide the TRADELY logo in the bottom-left corner of charts. |
 | `overwrite` | `bool` | `False` | `True`, `False` | `False` — append `_1`, `_2`, … to the filename if it already exists. `True` — overwrite the existing file silently. |
-| `dpi` | `int` | `150` | `50`–`600` | Output resolution in dots per inch. Higher values produce larger, sharper files. |
-| `fig_size` | `tuple[int, int]` | `(14, 7)` | Any valid `(width, height)` in inches | Matplotlib figure size. Increase for wide monitors or presentations. |
+| `dpi` | `int` | `100` | `50`–`600` | Output resolution in dots per inch. Higher values produce larger, sharper files. |
+| `fig_size` | `tuple[int, int]` | `(12, 6)` | Any valid `(width, height)` in inches | Matplotlib figure size. Increase for wide monitors or presentations. |
 | `cache_ttl` | `int` | `300` | Any positive integer (seconds) | How long fetched data is kept in memory. `0` effectively disables caching. |
 
 ---
@@ -555,7 +555,7 @@ The `"heikin_ashi"` chart type converts standard OHLC data to Heikin-Ashi candle
 When `mplfinance` is installed (`pip install TradeChart[mplfinance]`), candlestick and Heikin-Ashi charts use it for higher-quality rendering. Otherwise a pure-matplotlib fallback is used automatically — no configuration required.
 
 **Output resolution**  
-Default DPI is 150, producing a ~2100 × 1050 px image at the default figure size. Increase with `tc.config(dpi=300)` for print-quality output.
+Default DPI is 100, producing a ~1200 × 600 px image at the default figure size — well under 300 KB for all supported formats. Increase with `tc.config(dpi=200)` for sharper output, or `tc.config(dpi=300)` for print quality.
 
 ---
 

{tradechart-2.2.1 → tradechart-2.4.0}/TradeChart.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: TradeChart
-Version: 2.2.1
+Version: 2.4.0
 Summary: Production-quality financial chart generator — candlestick, line, area, OHLC, Heikin-Ashi, performance heatmaps, and sector group charts.
 Author-email: "TRADELY.DEV" <dev@tradely.dev>
 License: Apache-2.0
@@ -45,7 +45,7 @@ Requires-Dist: build>=1.0; extra == "dev"
 Requires-Dist: twine>=5.0; extra == "dev"
 Dynamic: license-file
 
-# TradeChart — Library Edition v2.2.1
+# TradeChart — Library Edition v2.4.0
 
 **Python → Financial Charts**  
 Generate production-quality candlestick, line, area, OHLC, Heikin-Ashi, and performance heatmap charts from code.  
@@ -450,8 +450,8 @@ tc.config(
 | `theme` | `str` | `"dark"` | `"dark"`, `"light"`, `"classic"` | Chart colour theme. See [Themes](#themes). |
 | `watermark` | `bool` | `True` | `True`, `False` | Show or hide the TRADELY logo in the bottom-left corner of charts. |
 | `overwrite` | `bool` | `False` | `True`, `False` | `False` — append `_1`, `_2`, … to the filename if it already exists. `True` — overwrite the existing file silently. |
-| `dpi` | `int` | `150` | `50`–`600` | Output resolution in dots per inch. Higher values produce larger, sharper files. |
-| `fig_size` | `tuple[int, int]` | `(14, 7)` | Any valid `(width, height)` in inches | Matplotlib figure size. Increase for wide monitors or presentations. |
+| `dpi` | `int` | `100` | `50`–`600` | Output resolution in dots per inch. Higher values produce larger, sharper files. |
+| `fig_size` | `tuple[int, int]` | `(12, 6)` | Any valid `(width, height)` in inches | Matplotlib figure size. Increase for wide monitors or presentations. |
 | `cache_ttl` | `int` | `300` | Any positive integer (seconds) | How long fetched data is kept in memory. `0` effectively disables caching. |
 
 ---
@@ -602,7 +602,7 @@ The `"heikin_ashi"` chart type converts standard OHLC data to Heikin-Ashi candle
 When `mplfinance` is installed (`pip install TradeChart[mplfinance]`), candlestick and Heikin-Ashi charts use it for higher-quality rendering. Otherwise a pure-matplotlib fallback is used automatically — no configuration required.
 
 **Output resolution**  
-Default DPI is 150, producing a ~2100 × 1050 px image at the default figure size. Increase with `tc.config(dpi=300)` for print-quality output.
+Default DPI is 100, producing a ~1200 × 600 px image at the default figure size — well under 300 KB for all supported formats. Increase with `tc.config(dpi=200)` for sharper output, or `tc.config(dpi=300)` for print quality.
 
 ---
 

{tradechart-2.2.1 → tradechart-2.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "TradeChart"
-version = "2.2.1"
+version = "2.4.0"
 description = "Production-quality financial chart generator — candlestick, line, area, OHLC, Heikin-Ashi, performance heatmaps, and sector group charts."
 readme = "README.md"
 license = {text = "Apache-2.0"}

{tradechart-2.2.1 → tradechart-2.4.0}/tradechart/__init__.py

@@ -87,7 +87,7 @@ from tradechart.utils.exceptions import (
 )
 from tradechart.utils.validation import VALID_DURATIONS
 
-__version__ = "2.2.1"
+__version__ = "2.4.0"
 __all__ = [
     "terminal", "theme", "watermark", "config",
     "chart", "compare", "heatmap", "data", "export", "clear_cache",

{tradechart-2.2.1 → tradechart-2.4.0}/tradechart/charts/heatmap.py

@@ -345,8 +345,15 @@ class HeatmapRenderer:
             stamp_logo(fig, provider=provider)
 
         out_file = output_path.with_suffix(f".{fmt}")
-        fig.savefig(out_file, dpi=settings.dpi,
-                    facecolor=fig.get_facecolor(), bbox_inches="tight")
+        pil_kwargs: dict = {}
+        if fmt == "png":
+            pil_kwargs = {"compress_level": 6, "optimize": True}
+        elif fmt in ("jpg", "jpeg", "webp"):
+            pil_kwargs = {"quality": 82, "optimize": True}
+        save_kwargs: dict = {"dpi": settings.dpi, "facecolor": fig.get_facecolor(), "bbox_inches": "tight"}
+        if pil_kwargs:
+            save_kwargs["pil_kwargs"] = pil_kwargs
+        fig.savefig(out_file, **save_kwargs)
         plt.close(fig)
         log.detail("Saved heatmap → %s", out_file)
         return out_file

{tradechart-2.2.1 → tradechart-2.4.0}/tradechart/charts/renderer.py

@@ -131,9 +131,9 @@ class ChartRenderer:
 
         # Wicks — two batch vlines calls instead of N individual plot() calls
         ax_price.vlines(x_arr[up_mask],   lows[up_mask],   highs[up_mask],
-                        colors=theme.up_color,   linewidth=0.6)
+                        colors=theme.up_color,   linewidth=0.5)
         ax_price.vlines(x_arr[~up_mask],  lows[~up_mask],  highs[~up_mask],
-                        colors=theme.down_color, linewidth=0.6)
+                        colors=theme.down_color, linewidth=0.5)
 
         # Bodies — two batch bar calls instead of N individual bar() calls
         body_w = max(0.4, min(0.8, 60 / max(len(df), 1)))
@@ -186,8 +186,7 @@ class ChartRenderer:
             stamp_logo(fig, provider=meta.provider)
 
         out_file = out.with_suffix(f".{fmt}")
-        fig.savefig(out_file, dpi=get_settings().dpi,
-                    facecolor=fig.get_facecolor(), bbox_inches="tight")
+        self._savefig(fig, out_file, fmt, get_settings().dpi)
         plt.close(fig)
         log.detail("Saved candlestick chart → %s", out_file)
         return out_file
@@ -255,8 +254,7 @@ class ChartRenderer:
             stamp_logo(fig, provider=meta.provider)
 
         out_file = out.with_suffix(f".{fmt}")
-        fig.savefig(str(out_file), dpi=settings.dpi,
-                    bbox_inches="tight", facecolor=fig.get_facecolor())
+        self._savefig(fig, out_file, fmt, settings.dpi)
         plt.close(fig)
         get_logger().detail("Saved mplfinance chart → %s", out_file)
         return out_file
@@ -321,8 +319,7 @@ class ChartRenderer:
             stamp_logo(fig, provider=meta.provider)
 
         out_file = out.with_suffix(f".{fmt}")
-        fig.savefig(out_file, dpi=settings.dpi,
-                    facecolor=fig.get_facecolor(), bbox_inches="tight")
+        self._savefig(fig, out_file, fmt, settings.dpi)
         plt.close(fig)
         get_logger().detail("Saved OHLC chart → %s", out_file)
         return out_file
@@ -352,8 +349,7 @@ class ChartRenderer:
             stamp_logo(fig, provider=meta.provider)
 
         out_file = out.with_suffix(f".{fmt}")
-        fig.savefig(out_file, dpi=settings.dpi,
-                    facecolor=fig.get_facecolor(), bbox_inches="tight")
+        self._savefig(fig, out_file, fmt, settings.dpi)
         plt.close(fig)
         get_logger().detail("Saved line chart → %s", out_file)
         return out_file
@@ -384,8 +380,7 @@ class ChartRenderer:
             stamp_logo(fig, provider=meta.provider)
 
         out_file = out.with_suffix(f".{fmt}")
-        fig.savefig(out_file, dpi=settings.dpi,
-                    facecolor=fig.get_facecolor(), bbox_inches="tight")
+        self._savefig(fig, out_file, fmt, settings.dpi)
         plt.close(fig)
         get_logger().detail("Saved area chart → %s", out_file)
         return out_file
@@ -439,6 +434,19 @@ class ChartRenderer:
             for spine in ax.spines.values():
                 spine.set_visible(False)
 
+    @staticmethod
+    def _savefig(fig: plt.Figure, out_file: Path, fmt: str, dpi: int) -> None:
+        """Save *fig* with format-specific compression to keep file sizes small."""
+        pil_kwargs: dict = {}
+        if fmt == "png":
+            pil_kwargs = {"compress_level": 6, "optimize": True}
+        elif fmt in ("jpg", "jpeg", "webp"):
+            pil_kwargs = {"quality": 82, "optimize": True}
+        kwargs: dict = {"dpi": dpi, "facecolor": fig.get_facecolor(), "bbox_inches": "tight"}
+        if pil_kwargs:
+            kwargs["pil_kwargs"] = pil_kwargs
+        fig.savefig(out_file, **kwargs)
+
     @staticmethod
     def _set_date_labels(ax: plt.Axes, df: pd.DataFrame, theme: Theme) -> None:
         n = len(df)

{tradechart-2.2.1 → tradechart-2.4.0}/tradechart/config/settings.py

@@ -32,9 +32,9 @@ class Settings:
                     inst._theme: ThemeName = "dark"
                     inst._watermark_enabled: bool = True
                     inst._overwrite: bool = False
-                    inst._dpi: int = 150
-                    inst._fig_width: int = 14
-                    inst._fig_height: int = 7
+                    inst._dpi: int = 100
+                    inst._fig_width: int = 12
+                    inst._fig_height: int = 6
                     inst._cache_ttl: int = 300
                     inst._disk_store: DiskStore | None = None
                     cls._instance = inst

{tradechart-2.2.1 → tradechart-2.4.0}/tradechart/data/fetcher.py

@@ -14,6 +14,14 @@ from tradechart.data.provider_base import BaseProvider
 from tradechart.utils.exceptions import DataFetchError
 
 
+def _to_utc(df: pd.DataFrame) -> pd.DataFrame:
+    if df.index.tz is None:
+        df.index = df.index.tz_localize("UTC")
+    else:
+        df.index = df.index.tz_convert("UTC")
+    return df
+
+
 def _merge(stored: pd.DataFrame, fresh: pd.DataFrame) -> pd.DataFrame:
     """Merge stored history with freshly-fetched rows.
 
@@ -22,7 +30,7 @@ def _merge(stored: pd.DataFrame, fresh: pd.DataFrame) -> pd.DataFrame:
     (handles end-of-day corrections / partial bars).  Rows that exist only
     in *fresh* (new bars) are appended.  The result is sorted by date.
     """
-    combined = pd.concat([stored, fresh])
+    combined = pd.concat([_to_utc(stored), _to_utc(fresh)])
     combined = combined[~combined.index.duplicated(keep="last")]
     return combined.sort_index()
 

{tradechart-2.2.1 → tradechart-2.4.0}/tradechart/data/provider_base.py

@@ -4,9 +4,20 @@ from __future__ import annotations
 
 from abc import ABC, abstractmethod
 
+import pandas as pd
+
 from tradechart.data.models import MarketData
 
 
+def to_utc_index(df: pd.DataFrame) -> pd.DataFrame:
+    """Normalise a DataFrame's DatetimeIndex to UTC-aware in-place and return it."""
+    if df.index.tz is None:
+        df.index = df.index.tz_localize("UTC")
+    else:
+        df.index = df.index.tz_convert("UTC")
+    return df
+
+
 class BaseProvider(ABC):
     """Every data provider must implement this interface."""
 

{tradechart-2.2.1 → tradechart-2.4.0}/tradechart/providers/stooq_provider.py

@@ -8,7 +8,7 @@ from io import StringIO
 import pandas as pd
 
 from tradechart.data.models import MarketData
-from tradechart.data.provider_base import BaseProvider
+from tradechart.data.provider_base import BaseProvider, to_utc_index
 from tradechart.config.logger import get_logger
 
 _DAYS_MAP: dict[str, int] = {
@@ -56,7 +56,6 @@ class StooqProvider(BaseProvider):
         keep = ["Open", "High", "Low", "Close", "Volume"]
         df = df[[c for c in keep if c in df.columns]]
 
-        if df.index.tz is not None:
-            df.index = df.index.tz_localize(None)
+        to_utc_index(df)
 
         return MarketData(ticker=ticker, duration=duration, provider=self.name, df=df)

{tradechart-2.2.1 → tradechart-2.4.0}/tradechart/providers/tradingview_provider.py

@@ -5,7 +5,7 @@ from __future__ import annotations
 import pandas as pd
 
 from tradechart.data.models import MarketData
-from tradechart.data.provider_base import BaseProvider
+from tradechart.data.provider_base import BaseProvider, to_utc_index
 from tradechart.config.logger import get_logger
 
 _DURATION_MAP: dict[str, tuple[int, str]] = {
@@ -62,7 +62,6 @@ class TradingViewProvider(BaseProvider):
         keep = [c for c in ["Open", "High", "Low", "Close", "Volume"] if c in df.columns]
         df = df[keep]
 
-        if df.index.tz is not None:
-            df.index = df.index.tz_localize(None)
+        to_utc_index(df)
 
         return MarketData(ticker=ticker, duration=duration, provider=self.name, df=df)

{tradechart-2.2.1 → tradechart-2.4.0}/tradechart/providers/yfinance_provider.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 
 from tradechart.data.models import MarketData, DURATION_RESOLUTION_MAP
-from tradechart.data.provider_base import BaseProvider
+from tradechart.data.provider_base import BaseProvider, to_utc_index
 from tradechart.config.logger import get_logger
 
 
@@ -31,7 +31,6 @@ class YFinanceProvider(BaseProvider):
         col_map = {"Open": "Open", "High": "High", "Low": "Low", "Close": "Close", "Volume": "Volume"}
         df = df.rename(columns=col_map)[list(col_map.values())]
 
-        if df.index.tz is not None:
-            df.index = df.index.tz_localize(None)
+        to_utc_index(df)
 
         return MarketData(ticker=ticker, duration=duration, provider=self.name, df=df)