seolpyo-mplchart 0.0.2__tar.gz

seolpyo_mplchart-0.0.2/MANIFEST.in

@@ -0,0 +1 @@
+recursive-include seolpyo_mplchart/data *

seolpyo_mplchart-0.0.2/PKG-INFO

@@ -0,0 +1,37 @@
+Metadata-Version: 2.1
+Name: seolpyo-mplchart
+Version: 0.0.2
+Summary: Fast candlestick chart using Python.
+Author-email: white-seolpyo <white-seolpyo@naver.com>
+License: MIT License
+Project-URL: Homepage, https://white.seolpyo.com/
+Project-URL: Documentation(English), https://white.seolpyo.com/entry/148/
+Project-URL: Documentation(한글), https://white.seolpyo.com/entry/147/
+Project-URL: repository, https://github.com/white-seolpyo/seolpyo-mplchart
+Project-URL: Issues, https://github.com/white-seolpyo/seolpyo-mplchart/issues
+Keywords: chart,차트,stock,주식,invest,투자,finance,파이낸스,candle,캔들,candlestick,캔들스틱,matplotlib,mplfinance,pyqtgraph,finplot,virtual currency,가상화폐,coin,코인,bitcoin,비트코인,ethereum,이더리움
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Framework :: Matplotlib
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: matplotlib>=3.9.2
+Requires-Dist: pandas>=2.2.2
+
+# Donation
+Bitcoin: 1MKCHW8smDZv5DFMiVkA5G3DeXcMn871ZX
+
+Ethereum: 0x1c5fb8a5e0b1153cd4116c91736bd16fabf83520
+
+
+# Document
+[English](https://white.seolpyo.com/entry/148/)
+
+[한글](https://white.seolpyo.com/entry/147/)

seolpyo_mplchart-0.0.2/README.md

@@ -0,0 +1,10 @@
+# Donation
+Bitcoin: 1MKCHW8smDZv5DFMiVkA5G3DeXcMn871ZX
+
+Ethereum: 0x1c5fb8a5e0b1153cd4116c91736bd16fabf83520
+
+
+# Document
+[English](https://white.seolpyo.com/entry/148/)
+
+[한글](https://white.seolpyo.com/entry/147/)

seolpyo_mplchart-0.0.2/pyproject.toml

@@ -0,0 +1,54 @@
+[build-system]
+requires = [
+  "setuptools >= 65.0",
+  "matplotlib >= 3.9.2",
+  "pandas >= 2.2.2",
+]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "seolpyo-mplchart"
+version = "0.0.2"
+dependencies  = [
+  "matplotlib >= 3.9.2",
+  "pandas >= 2.2.2",
+]
+license = {text = "MIT License"}
+description = "Fast candlestick chart using Python.\nIncludes navigator, slider, navigation, and text information display functions"
+readme = "README.md"
+requires-python = ">= 3.11"
+authors = [
+  {name="white-seolpyo", email="white-seolpyo@naver.com"},
+]
+classifiers = [
+    "License :: OSI Approved :: MIT License",
+    "Development Status :: 5 - Production/Stable",
+    "Framework :: Matplotlib",
+    "Operating System :: Microsoft :: Windows",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+keywords = [
+    "chart", "차트", "stock", "주식", "invest", "투자", "finance", "파이낸스",
+    "candle", "캔들", "candlestick", "캔들스틱", "matplotlib", "mplfinance",
+    "pyqtgraph", "finplot", "virtual currency", "가상화폐", "coin", "코인",
+    "bitcoin", "비트코인", "ethereum", "이더리움",
+]
+
+[project.urls]
+Homepage = "https://white.seolpyo.com/"
+"Documentation(English)" = "https://white.seolpyo.com/entry/148/"
+"Documentation(한글)" = "https://white.seolpyo.com/entry/147/"
+repository = "https://github.com/white-seolpyo/seolpyo-mplchart"
+Issues = "https://github.com/white-seolpyo/seolpyo-mplchart/issues"
+
+[tool.setuptools]
+packages = [
+  "seolpyo_mplchart",
+  "seolpyo_mplchart.data",
+]
+

seolpyo_mplchart-0.0.2/seolpyo_mplchart/__init__.py

@@ -0,0 +1,49 @@
+"""
+This software includes Matplotlib, which is licensed under the BSD License.
+Matplotlib Copyright (c) 2012- Matplotlib Development Team.
+Full license can be found in the LICENSE file or at https://matplotlib.org/stable/users/license.html
+"""
+
+
+import json
+from pathlib import Path
+from typing import Literal
+
+import matplotlib.pyplot as plt
+import pandas as pd
+
+
+from .slider import Chart
+
+
+_name = {'samsung', 'apple'}
+def sample(name: Literal['samsung', 'apple']='samsung'):
+    if name not in _name:
+        print('name should be either samsung or apple.')
+        return
+    file = Path(__file__).parent / f'data/{name}.txt'
+    with open(file, 'r', encoding='utf-8') as txt:
+        data = json.load(txt)
+    data = data
+    df = pd.DataFrame(data)
+
+    c = Chart()
+    if name == 'apple':
+        c.unit_price = '$'
+        c.unit_volume = ' vol'
+        c.digit_price = 3
+        c.label_ma = 'ma{}'
+        c.candleformat = '{}\n\nend:     {}\nrate:    {}\ncompare: {}\nopen:    {}({})\nhigh:    {}({})\nlow:     {}({})\nvolume:  {}({})'
+        c.volumeformat = '{}\n\nvolume:      {}\nvolume rate: {}'
+    c.set_data(df)
+    show()
+
+    return
+
+
+def show():
+    return plt.show()
+
+
+if __name__ == '__main__':
+    sample('apple')

seolpyo_mplchart-0.0.2/seolpyo_mplchart/base.py

@@ -0,0 +1,111 @@
+import matplotlib.pyplot as plt
+import matplotlib.style as mplstyle
+from matplotlib.axes import Axes
+from matplotlib.backends.backend_agg import FigureCanvasAgg
+
+
+from .utils import convert_unit
+
+
+try: plt.switch_backend('TkAgg')
+except: pass
+
+# 한글 깨짐 문제 방지
+try: plt.rcParams['font.family'] ='Malgun Gothic'
+except: pass
+
+mplstyle.use('fast')
+
+
+class Base:
+    canvas: FigureCanvasAgg
+    unit_price, unit_volume = ('원', '주')
+
+    figsize = (12, 6)
+    ratio_ax_slider, ratio_ax_legend, ratio_ax_price, ratio_ax_volume = (3, 2, 18, 5)
+    adjust = dict(
+        top=0.95, bottom=0.05, left=0.01, right=0.93, # 여백
+        wspace=0, hspace=0  # 플롯간 간격
+    )
+    color_grid = '#d0d0d0'
+    color_background = '#fafafa'
+
+    slider_top = True
+    title = 'seolpyo mplchart'
+
+    def __init__(self, *args, **kwargs):
+        # 기본 툴바 비활성화
+        plt.rcParams['toolbar'] = 'None'
+
+        self._set_plot()
+        return
+
+    def _set_plot(self):
+        if self.slider_top:
+            fig, ax = plt.subplots(
+                4, # row 수
+                figsize=self.figsize, # 기본 크기
+                height_ratios=(self.ratio_ax_slider, self.ratio_ax_legend, self.ratio_ax_price, self.ratio_ax_volume) # row 크기 비율
+            )
+            ax: list[Axes]
+            ax_slider, ax_legend, ax_price, ax_volume = ax
+        else:
+            fig, ax = plt.subplots(
+                5, # row 수
+                figsize=self.figsize, # 기본 크기
+                height_ratios=(self.ratio_ax_legend, self.ratio_ax_price, self.ratio_ax_volume, self.ratio_ax_legend, self.ratio_ax_slider) # row 크기 비율
+            )
+            ax: list[Axes]
+            ax_legend, ax_price, ax_volume, ax_none, ax_slider = ax
+            # 사용하지 않는 axes 숨기기
+            ax_none.axis('off')
+        ax_legend.axis('off')
+
+        ax_slider.xaxis.set_animated(True)
+        ax_slider.yaxis.set_animated(True)
+
+        ax_price.xaxis.set_animated(True)
+        ax_price.yaxis.set_animated(True)
+
+        ax_volume.xaxis.set_animated(True)
+        ax_volume.yaxis.set_animated(True)
+
+        fig.canvas.manager.set_window_title(f'{self.title}')
+
+        # 플롯간 간격 제거(Configure subplots)
+        fig.subplots_adjust(**self.adjust)
+
+        # y ticklabel foramt 설정
+        ax_slider.yaxis.set_major_formatter(lambda x, _: convert_unit(x, word=self.unit_price))
+        ax_price.yaxis.set_major_formatter(lambda x, _: convert_unit(x, word=self.unit_price))
+        ax_volume.yaxis.set_major_formatter(lambda x, _: convert_unit(x, word=self.unit_volume))
+
+        # 공통 설정
+        for a in [ax_slider, ax_price, ax_volume]:
+            # y tick 우측으로 이동
+            a.tick_params(left=False, right=True, labelleft=False, labelright=True)
+            # 차트 영역 배경 색상
+            a.set_facecolor(self.color_background)
+            # grid(구분선, 격자) 그리기
+            a.grid(True, color=self.color_grid, linewidth=1)
+            # x tick 제거
+            a.set_xticklabels([])
+
+        self.fig, self.canvas = (fig, fig.canvas)
+        self.ax_slider, self.ax_legend, self.ax_price, self.ax_volume = (ax_slider, ax_legend, ax_price, ax_volume)
+
+        return self.set_plot()
+
+    def set_plot(self):
+        "This function works after set plot process is done."
+        return
+
+
+class Chart(Base):
+    pass
+
+
+if __name__ == '__main__':
+    Base()
+    
+    plt.show()