pfund-plot 0.0.1__py3-none-any.whl

pfund_plot/widgets/ticker_widget.py

@@ -0,0 +1,82 @@
+# VIBE-CODED
+# pyright: reportUnknownMemberType=false, reportUnknownVariableType=false, reportUnknownArgumentType=false
+from __future__ import annotations
+
+from collections.abc import Callable
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from pfund_plot.plots.plot import MessageKey, StreamingDfs
+
+import panel as pn
+
+from pfund_plot.widgets.base import BaseStreamingWidget
+
+
+class TickerSelectWidget(BaseStreamingWidget):
+    """Dropdown for switching between streaming tickers (products).
+
+    Auto-created when a streaming feed has multiple products.
+    Switches the active msg_key on the plot so the pane displays
+    a different product's data.  All streams continue in the
+    background; this widget only controls which one is shown.
+    """
+
+    def __init__(
+        self,
+        streaming_dfs: StreamingDfs,
+        active_key: MessageKey,
+        update_callback: Callable[[MessageKey], None],
+    ):
+        super().__init__(streaming_dfs, active_key, update_callback)
+        msg_keys = list(streaming_dfs.keys())
+        self._select = pn.widgets.Select(
+            name="Ticker",
+            options=self._build_options(msg_keys),
+            value=active_key,
+        )
+        self._watcher = self._select.param.watch(self._on_select, "value")
+
+    @staticmethod
+    def _build_options(msg_keys: list[MessageKey]) -> dict[str, MessageKey]:
+        """Build {display_label: msg_key} dict for the Select widget."""
+        resolutions = {res for _, res in msg_keys}
+        if len(resolutions) == 1:
+            # All same resolution — just show the product name
+            return {product: (product, res) for product, res in msg_keys}
+        # Mixed resolutions — disambiguate with "(resolution)"
+        return {f"{product} ({res})": (product, res) for product, res in msg_keys}
+
+    def _fan_out_to_overlays(self, msg_key: MessageKey) -> None:
+        """Switch each overlay widget's active stream to the same msg_key.
+        Must be called BEFORE the parent's _update_callback so the DynamicMap re-render
+        picks up the updated overlay dfs.
+        """
+        for overlay_widget in self._overlays:
+            overlay_widget._update_callback(msg_key)
+
+    def _on_select(self, event: Any) -> None:
+        self._fan_out_to_overlays(event.new)
+        self._update_callback(event.new)
+
+    def update_streaming_state(self, streaming_dfs: StreamingDfs) -> None:
+        """Update dropdown options when new products start streaming."""
+        msg_keys = list(streaming_dfs.keys())
+        current_keys = (
+            set(self._select.options.values())
+            if isinstance(self._select.options, dict)
+            else set()
+        )
+        if set(msg_keys) == current_keys:
+            return
+        current_value = self._select.value
+        self._select.param.unwatch(self._watcher)
+        try:
+            self._select.options = self._build_options(msg_keys)
+            if current_value in self._select.options.values():
+                self._select.value = current_value
+        finally:
+            self._watcher = self._select.param.watch(self._on_select, "value")
+
+    def get_panel_objects(self) -> list[pn.widgets.Widget]:
+        return [self._select]

pfund_plot-0.0.1.dist-info/METADATA

@@ -0,0 +1,148 @@
+Metadata-Version: 2.4
+Name: pfund-plot
+Version: 0.0.1
+Summary: A library for financial data visualization, dashboard creation, and template sharing.
+Keywords: financial data,plotting,dashboards,charts,data visualization,graphs,plots
+Author: Stephen Yau
+Author-email: Stephen Yau <softwareentrepreneer+pfund-plot@gmail.com>
+License-Expression: Apache-2.0
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: Intended Audience :: Information Technology
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Typing :: Typed
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Dist: pfeed>=0.0.15
+Requires-Dist: panel>=1.9.3
+Requires-Dist: hvplot>=0.12.2
+Requires-Dist: dayplot>=0.5.1
+Requires-Dist: anywidget>=0.11.0 ; sys_platform != 'emscripten'
+Requires-Dist: ipywidgets-bokeh>=1.7.0 ; sys_platform != 'emscripten'
+Requires-Dist: pywebview>=6.2.1 ; sys_platform != 'emscripten'
+Requires-Dist: datashader>=0.19.1 ; sys_platform != 'emscripten'
+Requires-Dist: altair>=6.1.0 ; extra == 'altair'
+Requires-Dist: vegafusion>=2.0.3 ; extra == 'altair'
+Requires-Dist: vl-convert-python>=1.9.0.post1 ; extra == 'altair'
+Requires-Dist: jupyter-bokeh>=4.0.5 ; extra == 'jupyter'
+Requires-Dist: notebook>=7.5.7 ; extra == 'jupyter'
+Requires-Dist: papermill>=2.7.0 ; extra == 'jupyter'
+Requires-Dist: voila>=0.5.12 ; extra == 'jupyter'
+Requires-Dist: marimo[recommended,lsp]>=0.23.9 ; extra == 'marimo'
+Requires-Dist: matplotlib>=3.10.9 ; extra == 'matplotlib'
+Requires-Dist: plotly>=6.8.0 ; extra == 'plotly'
+Requires-Python: >=3.11
+Project-URL: homepage, https://pfund-plot.pfund.ai
+Project-URL: repository, https://github.com/PFund-Software-Ltd/pfund-plot
+Project-URL: documentation, https://pfund-plot.pfund.ai/doc
+Provides-Extra: altair
+Provides-Extra: jupyter
+Provides-Extra: marimo
+Provides-Extra: matplotlib
+Provides-Extra: plotly
+Description-Content-Type: text/markdown
+
+# PFund-Plot: Financial Charts in One Line of Code
+
+[![Discord](https://img.shields.io/badge/Discord-%235865F2.svg?logo=discord&logoColor=white)](https://discord.gg/vqpS94tpdp)
+[![X](https://img.shields.io/twitter/follow/pfund_ai?style=social)](https://x.com/pfund_ai)
+[![Downloads](https://static.pepy.tech/badge/pfund-plot/month)](https://pepy.tech/project/pfund-plot)
+[![PyPI](https://img.shields.io/pypi/v/pfund-plot.svg?cacheSeconds=300)](https://pypi.org/project/pfund-plot)
+![PyPI - Support Python Versions](https://img.shields.io/pypi/pyversions/pfund-plot?cacheSeconds=300)
+[![afterpython](https://afterpython.org/shield.svg)](https://afterpython.org)
+[![Discussions](https://img.shields.io/badge/Discussions-Let's%20Chat-green)](https://github.com/PFund-Software-Ltd/pfund-plot/discussions)
+[![Jupyter Notebook](https://img.shields.io/badge/jupyter-notebook-orange?logo=jupyter)](https://jupyter.org)
+[![Marimo](https://marimo.io/shield.svg)](https://marimo.io)
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/PFund-Software-Ltd/pfund-plot)
+[![View Code Wiki](https://assets.codewiki.google/readme-badge/static.svg)](https://codewiki.google/github.com/pfund-software-ltd/pfund-plot?utm_source=badge&utm_medium=github&utm_campaign=github.com/pfund-software-ltd/pfund-plot)
+<!-- ![PyPI downloads](https://img.shields.io/pypi/dm/pfund-plot?label=downloads&cacheSeconds=86400) -->
+<!-- ![GitHub stars](https://img.shields.io/github/stars/PFund-Software-Ltd/pfund-plot?style=social) -->
+
+
+> **This library is NOT ready for use, please wait for 0.1.0 release.**
+
+## TL;DR: pfund-plot handles the plotting libraries, so traders just get charts that work
+
+## Problem
+Traders often need to quickly visualize their data without investing time in learning new tools.
+For example, plotting a candlestick should be as simple as writing a single line of code.
+
+## Solution
+We created a high-level financial visualization layer that combines the best features from existing plotting libraries into an easy-to-use interface.
+
+---
+<img src="afterpython/static/candlestick.gif" alt="pfund-plot candlestick streaming example" width="450">
+
+---
+
+`pfund-plot` is a financial visualization layer on top of existing plotting libraries, giving traders a simple, domain-specific interface for plotting and streaming market data.
+
+## Core Features
+- [x] Multi-Display Mode: support displaying plots in a *Jupyter notebook*, *Marimo notebook*, *browser* and *desktop window*
+- [x] Intuitive & Chainable API: `plt.ohlc(df).style(...).control(...).mode(...).show()`
+- [x] Streaming Plots: support streaming data in real-time
+- [x] DataFrame Agnostic: support pandas, polars, and dask
+- [x] Financial Plots: plot financial data by just one function call
+- [x] Combine multiple plots into a dashboard quickly for visualization
+
+
+## Installation
+```bash
+pip install pfund-plot
+```
+
+## Quickstart
+### 1. Plotting in a Jupyter or Marimo Notebook
+> To use data sources other than Bybit, please go to [pfeed](https://github.com/PFund-Software-Ltd/pfeed) and install the corresponding extras. For example: `pip install "pfeed[data_source1, data_source2]"`
+```python
+import pfeed as pe
+import pfund_plot as plt
+
+feed = pe.Bybit().market_feed
+result = feed.download(product='BTC_USDT_PERP', resolution='1h', rollback_period='1d')
+df = result.data.collect()
+
+# Notebook mode:
+plt.ohlc(df)
+```
+
+### 2. Plotting in a Python Script
+```python
+# Browser mode:
+plt.ohlc(df).mode('browser').show()
+
+# Desktop mode:
+if __name__ == "__main__":  # Required because desktop mode uses multiprocessing.
+    plt.ohlc(df).mode('desktop').show()
+```
+
+### 3. Streaming a Plot
+```python
+# Streaming requires pipeline_mode=True.
+feed = pe.Bybit(pipeline_mode=True).market_feed
+feed.stream(product='BTC_USDT_PERP', resolution='1s')
+
+# In a Python script:
+plt.ohlc(feed).control(update_interval=1000).mode('browser')  # or mode('desktop') under if __name__ == "__main__"
+
+# In a notebook environment (not recommended to start streaming in a notebook unless you know what you're doing):
+# await plt.ohlc(feed).control(update_interval=1000).show_async()
+```
+
+---
+
+## Tapping into the JavaScript World
+Python developers sometimes envy the JavaScript visualization ecosystem for its rich set of interactive charts and dashboards. With `pfund-plot`, they can still enjoy the benefits of the JavaScript world while keeping the same Python-first API. For example:
+```python
+plt.ohlc(df).backend('svelte')
+```
+This renders the following chart using TradingView's [Lightweight Charts](https://github.com/tradingview/lightweight-charts):
+
+<img src="afterpython/static/tradingview.png" alt="pfund-plot TradingView Lightweight Charts example" width="450">
+
+> This is meant as a showcase rather than a core direction: `pfund-plot` remains Python-first, and JavaScript-backed charts are supported where they fit naturally. If you want to bring more useful JavaScript visualizations into `pfund-plot`, contributions are welcome.

pfund_plot-0.0.1.dist-info/RECORD

@@ -0,0 +1,57 @@
+pfund_plot/__init__.py,sha256=On1DfzajMgq1TArL-v6GiPaYWKQ_88elwsxcMLAwVzg,4957
+pfund_plot/__main__.py,sha256=VAtd0NeGkClK2TPPn2aHpBFfhS_UP5VTz_iFSlzZqCM,178
+pfund_plot/cli/__init__.py,sha256=gQsdBdJT07D6qyG0nfzuqAjpi8-08tRfXBeNlgLtbGQ,81
+pfund_plot/cli/commands/gallery/__init__.py,sha256=7P2ge98c4jAaiNw3FWq6F1kHNew6IYVY1J59WdnubcM,370
+pfund_plot/cli/commands/gallery/gallery_marimo.py,sha256=BTzCScvJtv06QenWRi7YDQ-wE0xPqS6u-QG50QjQSsU,9793
+pfund_plot/cli/commands/serve.py,sha256=Kuc7huA5t7dOLGFmi3FjR4LlhKJgmMUv8f6LktgOUQM,427
+pfund_plot/cli/main.py,sha256=_0HF3GWc2GcsGugfvmhrRuIoLqtKZEsaiih_EBbVpEo,639
+pfund_plot/config.py,sha256=pWsufaqMbGHKz0bbHYRB5Ir-p5wxHi08UIoP5Xzm9fw,3355
+pfund_plot/enums/__init__.py,sha256=eOauJK7Tc8y2ci3IXCNYUpia8UiNVfkRJgAOD4tIKjM,480
+pfund_plot/enums/dataframe_backend.py,sha256=iTgYoF3Q3byfqvG-Vcb9xwIT2XkOnzmfd8-SONp3XuQ,120
+pfund_plot/enums/display_mode.py,sha256=1PnXq754nzK5m6TvO39T9ViUbNxyBVYEmnwZy7FLtOc,129
+pfund_plot/enums/panel_design.py,sha256=cJugsV6K6FHLdhylp9-mKZFnXgFoR23Qte5GNjkZ-2I,149
+pfund_plot/enums/panel_theme.py,sha256=bLFMIrmSJYSL22OQjLERAu6B5BUxZRVwNCrrHREU4SU,104
+pfund_plot/enums/plotting_backend.py,sha256=m8vmHPHmtMQgvnm12CHecrMZZR3Xlvi1bRCjai2iYvY,416
+pfund_plot/js_tap/components/candlestick.js,sha256=ek8c_-Xo5cSXwuUX30aGXtPg3dcpaGz7lyIs_spMitM,266608
+pfund_plot/mixins/streaming_market_feed_mixin.py,sha256=XdA_s1BoJodyTPV7J82bMxbJeXQKgzFC2sefIHuiMOA,7198
+pfund_plot/plots/altair.py,sha256=KHP-j2Oe_rvL6Y4npeP-ZO3TgfU3VWF3zw297EOcssk,1061
+pfund_plot/plots/area/__init__.py,sha256=bnqGWZHgGGvZnf7ffVi5gzWJjlqg7RJgJnIv8RiOSSY,3219
+pfund_plot/plots/area/bokeh.py,sha256=oKcVuTg3T0pb1UqhYSHSAle9xepKV9fmnIsDWmgbAo8,5115
+pfund_plot/plots/bar/__init__.py,sha256=D1aY8Cmkqe9p9LdwInMA-NvuzR8BSY_4qLsFxgC8shk,3091
+pfund_plot/plots/bar/bokeh.py,sha256=IK3GsMjfcchc0GCvDtX-Z7KyCI6y_0hl5dQWqloXb3w,4171
+pfund_plot/plots/bokeh.py,sha256=sZLb6l354JaYzKZSAjVWXEcH51mjyTygOJoOs6oczMI,1059
+pfund_plot/plots/candlestick/__init__.py,sha256=VOXykzBN3LB_4zl2_VSyCMUSeiCBQIkfQUWXL9JIxVM,3315
+pfund_plot/plots/candlestick/bokeh.py,sha256=NNanskAhZoYweaY8QxLWra4KAJYaeYjpCT3lgWK9Ccw,4342
+pfund_plot/plots/candlestick/svelte.py,sha256=_-y06cPdYXnwX_xLh2SlOPGCzVQzMQvTFh1zMYgcrIs,6613
+pfund_plot/plots/holoviews.py,sha256=Flz59vHuyu6zh9MCYyhKKMBky5AR9YPx_JGG6P0gnSo,1082
+pfund_plot/plots/label/__init__.py,sha256=SeX85UErHpOk0kfZPEuR_8gdi0U6Wht9MS6bueyDxsk,1227
+pfund_plot/plots/label/bokeh.py,sha256=LLnTKhm1EDfCkD8HMLKsv_R5eCiYkTZ5VErSq82wEmM,2295
+pfund_plot/plots/layout/__init__.py,sha256=1uxGTMILHUhlPq4rdLcUJAJSSVLb8p0y3tmP-SVDZ4s,3856
+pfund_plot/plots/layout/layout.py,sha256=6pCEdbRQV56wE1j__jMvsdXujAbN3Yd1IECISBSnsfk,4421
+pfund_plot/plots/layout/panel.py,sha256=pcJoIzigrlF09XyEitPtg_FV4ihD-HboDeFjVk7yJYk,1372
+pfund_plot/plots/layout/tabs/__init__.py,sha256=jVBQsPSzKYrRW5sCaB2_m9tQUkNEE5sEMvbDILMVJjE,965
+pfund_plot/plots/layout/tabs/panel.py,sha256=-GrhwAqvmMTaGFH9ztjvUBTKYx_ry1rtatSZFfopkDU,1284
+pfund_plot/plots/lazy.py,sha256=mej-aNLwc5Nw10IbNk0gACd-vSuJj4orYvf5BTPsZPU,13602
+pfund_plot/plots/line/__init__.py,sha256=li-tVoCDnxlFrQqKrjASbaAOgkSVE_HfoCM2TKuS9qE,1248
+pfund_plot/plots/line/bokeh.py,sha256=Xx_F0c9T8h6gHxaTC_zOvUaaeoCfyu6F-AmhEfG3Jvo,4381
+pfund_plot/plots/matplotlib.py,sha256=91PnrlY6S_Fdww5HSWokFzEp7SVWgzODnaCkXmNWSE4,1110
+pfund_plot/plots/plot.py,sha256=G-yT4H-7bl2crje1azEv6s9ChzAFh-QiFD_zvbcIuSg,46459
+pfund_plot/plots/plotly.py,sha256=nJI-9XauOIeWK711DfMhuiKP_0KVW00fVyPqBdPWvZI,1081
+pfund_plot/plots/scatter/__init__.py,sha256=g8qGh8Sik8GL5gYMKi63yzOlTFboIu9KX2TNZcs4qLI,2084
+pfund_plot/plots/scatter/bokeh.py,sha256=FSwasRlN_EICACmYLmyxHMnXCyq0ePx6xuca4RaxZPs,4540
+pfund_plot/plots/scatter/marker.py,sha256=mCyV7xoHnf8ejH6rVmJeUZ-OkLaQQ0txU4DAlzA2ZYE,3619
+pfund_plot/plots/ta.py,sha256=rYtjCLl27Q5kc8ezrzQGI0px2ZHHlbSUjjx7eMZxemo,200
+pfund_plot/renderers/base.py,sha256=bpqTI2tGJHonl8JRWlKFfs2Q_7yOi762cY8ythua9HA,2668
+pfund_plot/renderers/browser.py,sha256=RKFO2aQmC4brWucG6mWaT9LWnEOuP5lDgBrTwoojURg,960
+pfund_plot/renderers/desktop.py,sha256=8qQGjKk58_tJPqpV8ZzxhkFQ41shkZIC0_pG9ZkBFoM,3444
+pfund_plot/renderers/notebook.py,sha256=PeihwoiwbC146SCOgefiHTZTwPY8Z8tuI9bqaP-Sjkc,3871
+pfund_plot/typing.py,sha256=7ZHKx7kKURZahGeRxbDMPjDYHCl9KCxkkAI96PX3i4U,1315
+pfund_plot/utils/__init__.py,sha256=MztA91kb24iI3qMh3CUGsI4Rso6xdcImEK4QQXpWYHM,5259
+pfund_plot/utils/bokeh.py,sha256=OE4XpNA2zMUKMScyOzYROySz1LpkGqEa3BaC9kVc8oc,6252
+pfund_plot/widgets/base.py,sha256=UQ4PtLylgbmrfmJpCPx4X9nEfBQ1Kdcz8m6FzAFNRRg,2586
+pfund_plot/widgets/datetime_widget.py,sha256=YHj1A4gzX-kukPiEK79l7nCWl5WsyyVLILeX_l5pCM4,9520
+pfund_plot/widgets/ticker_widget.py,sha256=ODwLgjiDatQrevqORnlkJVTLE8U7MMjdC3XKDwtHHcs,3223
+pfund_plot-0.0.1.dist-info/WHEEL,sha256=wXwAVsgVaOZ_pwDFqQm5Rd6PID-Fc74nkLc8X8gHiDo,81
+pfund_plot-0.0.1.dist-info/entry_points.txt,sha256=5eMaY95w6_xcnxsQbbd3vSzYqMzyeKtrW1WOwAOyzJ8,115
+pfund_plot-0.0.1.dist-info/METADATA,sha256=w5lF-bWiudbfkGkSQCsL2nVNu3x8xW29sxYofD0WmCc,7267
+pfund_plot-0.0.1.dist-info/RECORD,,

pfund_plot-0.0.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.11.19
+Root-Is-Purelib: true
+Tag: py3-none-any

pfund_plot-0.0.1.dist-info/entry_points.txt

@@ -0,0 +1,6 @@
+[console_scripts]
+plt = pfund_plot.__main__:run_cli
+
+[pfund_shell.commands]
+plt = pfund_plot.cli:pfund_plot_group
+