pyqqq 0.12.197__py3-none-any.whl → 0.12.198__py3-none-any.whl

pyqqq/backtest/broker.py

@@ -1,6 +1,6 @@
 import datetime as dtm
-import os
 import fcntl
+import os
 from abc import ABC, abstractmethod
 from dataclasses import asdict
 from decimal import Decimal
@@ -9,6 +9,7 @@ from typing import List, Literal, Optional, Union
 
 import numpy as np
 import pandas as pd
+from cachetools.func import ttl_cache
 
 from pyqqq.backtest.logger import Logger, get_logger
 from pyqqq.backtest.positionprovider import BasePositionProvider
@@ -20,11 +21,14 @@ from pyqqq.data.domestic import get_market_cap_by_codes
 from pyqqq.data.domestic import get_ticker_info as get_kr_ticker_info
 from pyqqq.data.minutes import get_all_day_data as get_kr_minute_data
 from pyqqq.data.us_stocks import get_all_day_data as get_us_minute_data
-from pyqqq.data.us_stocks import get_ohlcv_by_codes_for_period as get_us_daily_data
+from pyqqq.data.us_stocks import \
+    get_ohlcv_by_codes_for_period as get_us_daily_data
 from pyqqq.data.us_stocks import get_ticker_info as get_us_ticker_info
 from pyqqq.datatypes import *
 from pyqqq.utils.casting import casting
-from pyqqq.utils.market_schedule import get_last_trading_day, get_market_schedule, get_trading_day_with_offset
+from pyqqq.utils.market_schedule import (get_last_trading_day,
+                                         get_market_schedule,
+                                         get_trading_day_with_offset)
 from pyqqq.utils.position_classifier import PositionClassifier
 
 MarketType = Literal["kr_stock", "us_stock"]
@@ -781,6 +785,7 @@ class MockBroker(BaseBroker):
 
         return df
 
+    @ttl_cache(maxsize=100, ttl=300)
     def get_daily_price(self, code: str, from_date: Optional[dtm.date] = None, end_date: Optional[dtm.date] = None):
         """
         지정된 기간 동안의 정규장 시작부터 현재 시각 (이전) 까지의 일봉 데이터를 조회합니다.

pyqqq/brokerage/kis/domestic_stock.py

@@ -805,33 +805,33 @@ class KISDomesticStock:
             - msg1 (str): 메시지1
             - output1 (object): 응답상세1
 
-                - BSTP_NMIX_PRDY_VRSS: 업종 지수 전일 대비 - 업종 지수 전일 대비
-                - PRDY_VRSS_SIGN: 전일 대비 부호 - 전일 대비 부호
-                - BSTP_NMIX_PRDY_CTRT: 업종 지수 전일 대비율 - 업종 지수 전일 대비율
-                - PRDY_NMIX: 전일 지수 - 전일 지수
-                - ACML_VOL: 누적 거래량 - 누적 거래량
-                - ACML_TR_PBMN: 누적 거래 대금 - 누적 거래 대금
-                - HTS_KOR_ISNM: HTS 한글 종목명 - HTS 한글 종목명
-                - BSTP_NMIX_PRPR: 업종 지수 현재가 - 업종 지수 현재가
-                - BSTP_CLS_CODE: 업종 구분 코드 - 업종 구분 코드
-                - PRDY_VOL: 전일 거래량 - 전일 거래량
-                - BSTP_NMIX_OPRC: 업종 지수 시가 - 업종 지수 시가
-                - BSTP_NMIX_HGPR: 업종 지수 최고가 - 업종 지수 최고가
-                - BSTP_NMIX_LWPR: 업종 지수 최저가 - 업종 지수 최저가
-                - FUTS_PRDY_OPRC: 업종 전일 시가 - 업종 전일 시가
-                - FUTS_PRDY_HGPR: 업종 전일 최고가 - 업종 전일 최고가
-                - FUTS_PRDY_LWPR: 업종 전일 최저가 - 업종 전일 최저가
+                - bstp_nmix_prdy_vrss: 업종 지수 전일 대비
+                - prdy_vrss_sign: 전일 대비 부호
+                - bstp_nmix_prdy_ctrt: 업종 지수 전일 대비율
+                - prdy_nmix: 전일 지수
+                - acml_vol: 누적 거래량
+                - acml_tr_pbmn: 누적 거래 대금
+                - hts_kor_isnm: hts 한글 종목명
+                - bstp_nmix_prpr: 업종 지수 현재가
+                - bstp_cls_code: 업종 구분 코드
+                - prdy_vol: 전일 거래량
+                - bstp_nmix_oprc: 업종 지수 시가
+                - bstp_nmix_hgpr: 업종 지수 최고가
+                - bstp_nmix_lwpr: 업종 지수 최저가
+                - futs_prdy_oprc: 업종 전일 시가
+                - futs_prdy_hgpr: 업종 전일 최고가
+                - futs_prdy_lwpr: 업종 전일 최저가
 
             - output2 (list): 응답상세2
 
-                - STCK_BSOP_DATE: 영업 일자 - 영업 일자
-                - BSTP_NMIX_PRPR: 업종 지수 현재가 - 업종 지수 현재가
-                - BSTP_NMIX_OPRC: 업종 지수 시가 - 업종 지수 시가
-                - BSTP_NMIX_HGPR: 업종 지수 최고가 - 업종 지수 최고가
-                - BSTP_NMIX_LWPR: 업종 지수 최저가 - 업종 지수 최저가
-                - ACML_VOL: 누적 거래량 - 누적 거래량
-                - ACML_TR_PBMN: 누적 거래 대금 - 누적 거래 대금
-                - MOD_YN: 변경 여부 - 변경 여부
+                - stck_bsop_date: 영업 일자
+                - bstp_nmix_prpr: 업종 지수 현재가
+                - bstp_nmix_oprc: 업종 지수 시가
+                - bstp_nmix_hgpr: 업종 지수 최고가
+                - bstp_nmix_lwpr: 업종 지수 최저가
+                - acml_vol: 누적 거래량
+                - acml_tr_pbmn: 누적 거래 대금
+                - mod_yn: 변경 여부
 
         Raise:
             ValueError: API 에러 발생시

pyqqq/utils/backoff.py

@@ -0,0 +1,32 @@
+import random
+
+
+def exponential_backoff_with_jitter(
+    attempt: int,
+    base_wait_time: float = 1.0,
+    max_wait_time: float = 30.0,
+    jitter: bool = True,
+) -> float:
+    """
+    지터와 최대 대기 시간을 포함한 지수 백오프 시간을 계산합니다.
+
+    Args:
+        attempt (int): 현재 재시도 횟수 (1부터 시작).
+        base_wait_time (float): 기본 대기 시간 (초).
+        max_wait_time (float): 최대 대기 시간 (초).
+        jitter (bool): 무작위 지터 추가 여부.
+
+    Returns:
+        float: 최종 백오프 대기 시간 (초).
+    """
+    # 기본 백오프 시간 계산
+    backoff_time = base_wait_time * (2 ** (attempt - 1))
+
+    # 지터 추가 (full jitter)
+    if jitter:
+        backoff_time = random.uniform(0, backoff_time)
+
+    # 최대 대기 시간 적용
+    final_wait_time = min(backoff_time, max_wait_time)
+
+    return final_wait_time

pyqqq/utils/market_schedule.py

@@ -348,7 +348,7 @@ def get_trading_day_with_offset(from_date: Optional[datetime.date] = None, offse
         return offset_date
 
 
-@ttl_cache(maxsize=10, ttl=3600)
+@ttl_cache(maxsize=1000, ttl=3600)
 def _fetch_market_scheldue(date: datetime.date, exchange: str) -> requests.Response | None:
     url = f"{c.PYQQQ_API_URL}/domestic-stock/market-schedules/{exchange}"
     params = {"date": date}

{pyqqq-0.12.197.dist-info → pyqqq-0.12.198.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pyqqq
-Version: 0.12.197
+Version: 0.12.198
 Summary: Package for quantitative strategy development on the PyQQQ platform
 License: MIT
 Author: PyQQQ team

{pyqqq-0.12.197.dist-info → pyqqq-0.12.198.dist-info}/RECORD

@@ -1,6 +1,6 @@
 pyqqq/__init__.py,sha256=s-r2WUo0H9OzuPiHSGtCjJMyEXfx8Cpt0hri8amUU2Y,1607
 pyqqq/backtest/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-pyqqq/backtest/broker.py,sha256=ctChBDuvjuRc54ACjH-2r4akAYKHuO9__-Axt3YT8Qw,73821
+pyqqq/backtest/broker.py,sha256=erLt83WG9zDzFZ9UoGk0sgllCzw3k5znngNjj09keiA,73986
 pyqqq/backtest/environment.py,sha256=cAvXKtRR4xBLFzUo-6xkuihlqRE_Jd0ZYAQ29K5qirg,10229
 pyqqq/backtest/logger.py,sha256=BmoEMjUU76z8rZtMCYCwbspD3AVaHJrdbbT1EAFgrAE,3294
 pyqqq/backtest/positionprovider.py,sha256=wrR7Bntg28Q5_vGQV6XNzxe-SYoO9_GLcV9gDVEDAN4,4164
@@ -15,7 +15,7 @@ pyqqq/brokerage/ebest/simple.py,sha256=Ade3m18yhGt1fyn7ZbN-LmyNKiFP2ahUMSLLqMXWc
 pyqqq/brokerage/ebest/tr_client.py,sha256=6vtod4xXr35yMAIji5qXUr_C3Bf4C_1NDLgELohDuks,7914
 pyqqq/brokerage/helper.py,sha256=6pDiHo2eqsppC5ObIUMJibeMZ7cq8V9pVzNLTsdAy1w,6675
 pyqqq/brokerage/kis/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-pyqqq/brokerage/kis/domestic_stock.py,sha256=VgeSyFTtwL1bsOlOqHZPOXKbf9ICbxqQpVjqZH-jj5k,233886
+pyqqq/brokerage/kis/domestic_stock.py,sha256=8ENXqEj66I0qUrXobw26_Vjc-zEy8444AGNqKBW9_UI,233326
 pyqqq/brokerage/kis/oauth.py,sha256=jA7QydFEe5NN8t0QSwEhFoFtQiwTP4fr2segcibOXVU,7805
 pyqqq/brokerage/kis/overseas_stock.py,sha256=9QUkEX13Lev5BcXMfK2GLve4xwFptOd1vXh4lDbrpYw,90096
 pyqqq/brokerage/kis/simple.py,sha256=u0XdYtOL18urqQp9l4ekSDHDZBe-VRiO_cNcFdNu96c,43014
@@ -39,6 +39,7 @@ pyqqq/executors/hook.py,sha256=xV9SVUpUwGm8AgEuz8aD7U4ema47lRoKn4KFthuLJwQ,36985
 pyqqq/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pyqqq/utils/api_client.py,sha256=WLcvZ9sZp2b9YrTauZt2VkcikfByOhHxPHCvGXmgEzw,585
 pyqqq/utils/array.py,sha256=8E8JW-P1GWzluiqIDuKdUEALZ30AkKRtfxgdrWmu__Q,1747
+pyqqq/utils/backoff.py,sha256=75xpSQM4faLQW4o7TWPlAAw23zifYosepqMVrOK3uRU,916
 pyqqq/utils/casting.py,sha256=nCHnJQ_F88R22xfnBg58fiJXwHYYnsnk3qSDw_rVIY8,135
 pyqqq/utils/compute.py,sha256=dk515lUvmYXbp9v6btpLSDnpc-zX0moD7EcJ4l4HCqU,5665
 pyqqq/utils/copycat.py,sha256=1cMuQKteOuzBbH3aAdsDCH7ZTxTyM6OyJ5Wii7gmBpk,10837
@@ -49,11 +50,11 @@ pyqqq/utils/kvstore.py,sha256=aAWQrs2IugHBPTRUkbYNxCKF9NZe2MCMD5nSj_lVbVw,4586
 pyqqq/utils/limiter.py,sha256=0zTJitT-14Ve5aeT0zcNEWQGPyY_3FENorF3HS7WPyQ,2643
 pyqqq/utils/local_cache.py,sha256=HvCyD1whixQWdVMxny5EPZwxKWQm-_Q34fKLXRvc3eU,2312
 pyqqq/utils/logger.py,sha256=GZzefjhdL8ms-5nPwJFuMtuHsuTuoPMADUhqcz93N4s,4843
-pyqqq/utils/market_schedule.py,sha256=NAzRmAc1Bnj5M99Ho7UN8JlVDW-16kgvPGrMNmydaBY,12899
+pyqqq/utils/market_schedule.py,sha256=3y6uI172Kx1Jcj9nbAuqBHZruKp4_hm_1nAaQ1BgIEg,12901
 pyqqq/utils/mock_api.py,sha256=7EsaVQ9mOVZQAqtQW24isPnk9QTbJII7x3guhFyEMAE,10569
 pyqqq/utils/position_classifier.py,sha256=tIbZMm_baru0F0qv6QDc5b2-oJYNvmn9HyrRr3xaAXU,14975
 pyqqq/utils/retry.py,sha256=ENNvjRyswn6nwue5JSqyC82QlBJSAMlJYj_gj0kqutY,2187
 pyqqq/utils/singleton.py,sha256=m6NZ8fwVDpI6U-gUUihMPgVK_NkDh-Z1NSAtjisrpjY,810
-pyqqq-0.12.197.dist-info/METADATA,sha256=8XB8L9rMekKWzuvXR_f_8Sjvd1HB2FfEky4JWtEfiQw,1664
-pyqqq-0.12.197.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-pyqqq-0.12.197.dist-info/RECORD,,
+pyqqq-0.12.198.dist-info/METADATA,sha256=j9U0pZ00OmXRiVdFRe5yLVZwOA9QLFrgzmYxIgrwuB4,1664
+pyqqq-0.12.198.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+pyqqq-0.12.198.dist-info/RECORD,,