hyperquant 1.48__py3-none-any.whl

hyperquant/logkit.py

@@ -0,0 +1,205 @@
+import logging
+import sys
+import unicodedata
+from datetime import datetime
+from zoneinfo import ZoneInfo
+from colorama import Fore, Style, init
+import os
+import traceback
+
+init(autoreset=True)
+
+# ====================================================================================================
+# ** 添加ok的日志级别 **
+# 给默认的logging模块，添加一个用于表达成功的级别
+# ====================================================================================================
+OK_LEVEL = 25
+logging.addLevelName(OK_LEVEL, "OK")
+
+def ok(self, message, *args, **kwargs):
+    if self.isEnabledFor(OK_LEVEL):
+        self._log(OK_LEVEL, message, args, **kwargs)
+
+logging.Logger.ok = ok
+
+# ====================================================================================================
+# ** 辅助函数 **
+# - get_display_width(): 获取文本的显示宽度，中文字符算作1.685个宽度单位，以尽量保持显示居中
+# ====================================================================================================
+def get_display_width(text: str) -> int:
+    width = 0
+    for char in text:
+        if unicodedata.east_asian_width(char) in ('F', 'W', 'A'):
+            width += 1.685
+        else:
+            width += 1
+    return int(width)
+
+# ====================================================================================================
+# ** 自定义Logger类封装所有功能 **
+# ====================================================================================================
+class Logger:
+    OK_LEVEL = 25
+    FORMATS = {
+        logging.DEBUG: ('', ''),
+        logging.INFO: (Fore.BLUE, "🔵 "),
+        logging.WARNING: (Fore.YELLOW, "🔔 "),
+        logging.ERROR: (Fore.RED, "❌ "),
+        logging.CRITICAL: (Fore.RED + Style.BRIGHT, "⭕ "),
+        OK_LEVEL: (Fore.GREEN, "✅ "),
+    }
+
+    def __init__(self, name='Log', show_time=False, use_color=True, timezone="Asia/Shanghai"):
+        # 设置日志级别
+        self.logger = logging.getLogger(name)
+        self.logger.setLevel(logging.DEBUG)
+        self.show_time = show_time
+        self.timezone = timezone  # 新增时区配置
+
+        # 如果已存在 handlers，先清理
+        if self.logger.hasHandlers():
+            self.logger.handlers.clear()
+
+        # 控制台输出 handler
+        console_handler = MinConsoleHandler(sys.stdout)
+        console_handler.setFormatter(MinFormatter(use_color=use_color, show_time=show_time, timezone=timezone))
+        self.logger.addHandler(console_handler)
+
+        # 禁用传播到根日志记录器
+        self.logger.propagate = False
+
+    def divider(self, name='', sep='=', display_time=True):
+        """打印带时间戳的分割线"""
+        seperator_len = 72
+        now = datetime.now().strftime('%Y-%m-%d %H:%M:%S')
+        middle = f' {name} {now} ' if display_time else f' {name} '
+        middle_width = get_display_width(middle)
+        decoration_count = max(4, (seperator_len - middle_width) // 2)
+        line = sep * decoration_count + middle + sep * decoration_count
+
+        if get_display_width(line) < seperator_len:
+            line += sep
+
+        self.logger.debug(line)
+
+    def get_logger(self):
+        """返回 logger 实例"""
+        return self.logger
+
+    # 为各个日志级别创建方法，便于编辑器提示
+    def ok(self, message, *args, **kwargs):
+        return self.logger.ok(message, *args, **kwargs)
+
+    def info(self, message, *args, **kwargs):
+        return self.logger.info(message, *args, **kwargs)
+
+    def debug(self, message, *args, **kwargs):
+        return self.logger.debug(message, *args, **kwargs)
+
+    def warning(self, message, *args, **kwargs):
+        return self.logger.warning(message, *args, **kwargs)
+
+    def error(self, message, *args, **kwargs):
+        return self.logger.error(message, *args, **kwargs)
+
+    def critical(self, message, *args, **kwargs):
+        return self.logger.critical(message, *args, **kwargs)
+    
+    def exception(self, message, *args, **kwargs):
+        return self.logger.exception(message, *args, **kwargs)
+
+class MinFormatter(logging.Formatter):
+    def __init__(self, use_color=True, show_time=False, timezone="Asia/Shanghai"):
+        super().__init__("%(message)s")
+        self.use_color = use_color
+        self.show_time = show_time
+        self.timezone = timezone  # 新增时区配置
+
+    def format(self, record):
+        original_message = record.getMessage()
+
+        # 使用配置的时区
+        local_tz = ZoneInfo(self.timezone)
+        timestamp = f"[{datetime.now(local_tz).strftime('%Y-%m-%d %H:%M:%S')}] " if self.show_time else ""
+
+        if self.use_color:
+            color, prefix = Logger.FORMATS.get(record.levelno, ('', ''))
+            formatted_message = f"{timestamp}{color}{prefix}{original_message}{Style.RESET_ALL}"
+        else:
+            _, prefix = Logger.FORMATS.get(record.levelno, ('', ''))
+            formatted_message = f"{timestamp}{prefix}{original_message}"
+
+        # 添加异常信息
+        if record.exc_info:
+            exc_text = ''.join(traceback.format_exception(*record.exc_info))
+            formatted_message += f"\n{Fore.RED}{exc_text}{Style.RESET_ALL}" if self.use_color else f"\n{exc_text}"
+
+        return formatted_message
+
+class MinConsoleHandler(logging.StreamHandler):
+    def emit(self, record):
+        if record.levelno == logging.DEBUG:
+            print(self.format(record), flush=True)
+        elif record.levelno == Logger.OK_LEVEL:
+            super().emit(record)
+            print()
+        else:
+            super().emit(record)
+
+# ====================================================================================================
+# ** NullLogger 类，用于禁用日志 **
+# ====================================================================================================
+class NullLogger:
+    def debug(self, *a, **k): pass
+    def info(self, *a, **k): pass
+    def ok(self, *a, **k): pass
+    def warning(self, *a, **k): pass
+    def error(self, *a, **k): pass
+    def critical(self, *a, **k): pass
+    def exception(self, *a, **k): pass
+    def divider(self, *a, **k): pass
+
+# ====================================================================================================
+# ** 功能函数 **
+# ====================================================================================================
+def get_logger(name=None, file_path=None, show_time=False, use_color=True, timezone="Asia/Shanghai", level: object = None, enable_console: bool = True, enabled: bool = True):
+    if not enabled:
+        return NullLogger()
+    if name is None:
+        name = '_'
+    logger_instance = Logger(name, show_time, use_color, timezone)  # 传递时区参数
+    if file_path:
+        # 如果目录不存在，创建目录
+        os.makedirs(os.path.dirname(file_path), exist_ok=True)
+        add_file_handler(logger_instance.get_logger(), file_path, show_time, timezone)
+    return logger_instance
+
+def add_file_handler(logger: logging.Logger, path: str, show_time=False, timezone="Asia/Shanghai"):
+    # 添加文件日志输出，启用时间戳
+    file_handler = logging.FileHandler(path)
+    file_handler.setFormatter(MinFormatter(use_color=False, show_time=show_time, timezone=timezone))  # 传递时区参数
+    logger.addHandler(file_handler)
+
+# ====================================================================================================
+# ** 示例使用 **
+# ====================================================================================================
+if __name__ == '__main__':
+    # 获取日志对象
+    logger = get_logger('xx', 'logs/application.log', show_time=True, use_color=True)  # This will use Logger
+
+    # 输出日志信息
+    logger.debug("调试信息，没有标记和颜色，等同于print")
+    logger.info("提示信息，蓝色的，可以记录一些中间结果")
+    logger.ok("完成提示，绿色的，通常表示成功和完成")
+    logger.warning("警告信息，黄色的，通常表示警告")
+    logger.error("错误信息，红色的，通常是报错的相关提示")
+    logger.critical("重要提示，深红色。通常是非常关键的信息")
+
+    # 使用 divider 方法
+    logger.divider("这是一个分割线", sep='*', display_time=True)
+
+    # 触发一个异常
+    try:
+        1 / 0
+    except Exception:
+        logger.exception("捕获到一个异常，程序将继续运行。")

hyperquant/notikit.py

@@ -0,0 +1,124 @@
+"""
+通知类的功能简单封装，非必要别修改 :)
+只要知道怎么使用以下函数：
+- send_wecom_msg
+- send_wecom_img
+
+Binance期现套利 | 邢不行 | 2024分享会
+author: 邢不行
+微信: xbx6660
+"""
+import base64
+import hashlib
+import os.path
+import json
+import traceback
+import aiohttp
+import asyncio
+from datetime import datetime
+
+from hyperquant.logkit import get_logger
+logger = get_logger('notikit', './data/logs/notikit.log', show_time=True)
+
+
+
+proxy = {}
+
+
+def handle_exception(e: Exception, msg: str = '') -> None:
+    logger.error(f"{msg}:{e}")
+    logger.error(e)
+    logger.error(traceback.format_exc())
+
+
+# 企业微信通知
+async def send_wecom_msg(content: str, webhook_url: str) -> None:
+    if not webhook_url:
+        logger.warning('未配置wecom_webhook_url，不发送信息')
+        return
+    if not content:
+        logger.warning('未配置content，不发送信息')
+        return
+    
+    try:
+        data = {
+            "msgtype": "text",
+            "text": {
+                "content": content + '\n' + datetime.now().strftime("%Y-%m-%d %H:%M:%S")
+            }
+        }
+        
+        async with aiohttp.ClientSession() as session:
+            async with session.post(
+                webhook_url,
+                json=data,
+                proxy=proxy.get('http') if proxy else None,
+                timeout=aiohttp.ClientTimeout(total=10)
+            ) as response:
+                result = await response.text()
+                logger.info(f'调用企业微信接口返回： {result}')
+                logger.ok('成功发送企业微信')
+    except Exception as e:
+        handle_exception(e, '发送企业微信失败')
+
+
+# 上传图片，解析bytes
+class MyEncoder(json.JSONEncoder):
+    def default(self, obj):
+        """
+        只要检查到了是bytes类型的数据就把它转为str类型
+        :param obj:
+        :return:
+        """
+        if isinstance(obj, bytes):
+            return str(obj, encoding='utf-8')
+        return json.JSONEncoder.default(self, obj)
+
+
+# 企业微信发送图片
+async def send_wecom_img(file_path: str, webhook_url: str) -> None:
+    """
+    企业微信发送图片
+    :param file_path: 图片地址
+    :param webhook_url: 企业微信webhook网址
+    :return:
+    """
+    if not os.path.exists(file_path):
+        logger.warning('找不到图片')
+        return
+    if not webhook_url:
+        logger.warning('未配置wecom_webhook_url，不发送信息')
+        return
+    
+    try:
+        with open(file_path, 'rb') as f:
+            image_content = f.read()
+        
+        image_base64 = base64.b64encode(image_content).decode('utf-8')
+        md5 = hashlib.md5()
+        md5.update(image_content)
+        image_md5 = md5.hexdigest()
+        
+        data = {
+            'msgtype': 'image',
+            'image': {
+                'base64': image_base64,
+                'md5': image_md5
+            }
+        }
+        
+        async with aiohttp.ClientSession() as session:
+            async with session.post(
+                webhook_url,
+                json=data,
+                proxy=proxy.get('http') if proxy else None,
+                timeout=aiohttp.ClientTimeout(total=10)
+            ) as response:
+                result = await response.text()
+                logger.info(f'调用企业微信接口返回： {result}')
+                logger.ok('成功发送企业微信图片')
+    except Exception as e:
+        handle_exception(e, '发送企业微信图片失败')
+    finally:
+        if os.path.exists(file_path):
+            os.remove(file_path)

hyperquant-1.48.dist-info/METADATA

@@ -0,0 +1,32 @@
+Metadata-Version: 2.4
+Name: hyperquant
+Version: 1.48
+Summary: A minimal yet hyper-efficient backtesting framework for quantitative trading
+Project-URL: Homepage, https://github.com/yourusername/hyperquant
+Project-URL: Issues, https://github.com/yourusername/hyperquant/issues
+Author-email: MissinA <1421329142@qq.com>
+License: MIT
+Keywords: backtesting,hyperquant,quant,trading
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Requires-Python: >=3.13
+Requires-Dist: aiohttp>=3.13
+Requires-Dist: coincurve>=21.0.0
+Requires-Dist: colorama>=0.4.6
+Requires-Dist: cryptography>=44.0.2
+Requires-Dist: duckdb>=1.2.2
+Requires-Dist: eth-account>=0.10.0
+Requires-Dist: numpy>=1.21.0
+Requires-Dist: pandas>=2.2.3
+Requires-Dist: pybotters>=1.10
+Requires-Dist: pyecharts>=2.0.8
+Requires-Dist: python-dotenv>=1.2.1
+Requires-Dist: web3>=7.14.0
+Description-Content-Type: text/markdown
+
+# hyperquant
+
+hyperquant is a minimalistic framework for quantitative trading strategies. It allows users to quickly validate their strategy ideas with ease and efficiency.

hyperquant-1.48.dist-info/RECORD

@@ -0,0 +1,42 @@
+hyperquant/__init__.py,sha256=UpjiX4LS5jmrBc2kE8RiLR02eCfD8JDQrR1q8zkLNcQ,161
+hyperquant/core.py,sha256=RzRFbyImqzBiaA-9lQzvxPfxwcOvScdABZviS4y0kqM,20783
+hyperquant/db.py,sha256=i2TjkCbmH4Uxo7UTDvOYBfy973gLcGexdzuT_YcSeIE,6678
+hyperquant/draw.py,sha256=up_lQ3pHeVLoNOyh9vPjgNwjD0M-6_IetSGviQUgjhY,54624
+hyperquant/logkit.py,sha256=nUo7nx5eONvK39GOhWwS41zNRL756P2J7-5xGzwXnTY,8462
+hyperquant/notikit.py,sha256=x5yAZ_tAvLQRXcRbcg-VabCaN45LUhvlTZnUqkIqfAA,3596
+hyperquant/broker/auth.py,sha256=JVv04m-Z2fnM0Fds-nRjbVEXMnf-JrK7sk2URvUMsC4,37102
+hyperquant/broker/bitget.py,sha256=X_S0LKZ7FZAEb6oEMr1vdGP1fondzK74BhmNTpRDSEA,9488
+hyperquant/broker/bitmart.py,sha256=7j_8TU3Dxjj5HCNX7CbSO3nPZcQH1t31A9UOv5tTbg0,25974
+hyperquant/broker/coinw.py,sha256=SnJU0vASh77rfcpMGWaIfTblQSjQk3vjlW_4juYdbcs,17214
+hyperquant/broker/deepcoin.py,sha256=DdXQRuL1m0FeFRmGVC3hvQLXXXaDOsXK-p2zZoFWODE,22997
+hyperquant/broker/edgex.py,sha256=TqUO2KRPLN_UaxvtLL6HnA9dAQXC1sGxOfqTHd6W5k8,18378
+hyperquant/broker/hyperliquid.py,sha256=7MxbI9OyIBcImDelPJu-8Nd53WXjxPB5TwE6gsjHbto,23252
+hyperquant/broker/lbank.py,sha256=98M5wmSoeHwbBYMA3rh25zqLb6fQKVaEmwqALF5nOvY,22181
+hyperquant/broker/lighter.py,sha256=xyF967a-AwzecJ9qRPatxEzqis-J8dKQB6Xh1deR9Vc,25611
+hyperquant/broker/ourbit.py,sha256=NUcDSIttf-HGWzoW1uBTrGLPHlkuemMjYCm91MigTno,18228
+hyperquant/broker/polymarket.py,sha256=Js6_joi00144uS9J7uz44S4PpETyH7a85Dm9rNf-YmU,90516
+hyperquant/broker/ws.py,sha256=3r8PGxR_1IflcY8fXc4EWwG7LWo_ylVXFFDZIPrXllM,4704
+hyperquant/broker/lib/edgex_sign.py,sha256=lLUCmY8HHRLfLKyGrlTJYaBlSHPsIMWg3EZnQJKcmyk,95785
+hyperquant/broker/lib/hpstore.py,sha256=LnLK2zmnwVvhEbLzYI-jz_SfYpO1Dv2u2cJaRAb84D8,8296
+hyperquant/broker/lib/hyper_types.py,sha256=HqjjzjUekldjEeVn6hxiWA8nevAViC2xHADOzDz9qyw,991
+hyperquant/broker/lib/util.py,sha256=iMU1qF0CHj5zzlIMEQGwjz-qtEVosEe7slXOCuB7Rcw,566
+hyperquant/broker/lib/polymarket/ctfAbi.py,sha256=E6cdz5tQpfoz8qmLZ4_nmzqsodiPzLZ45RDpMw_PmqU,15004
+hyperquant/broker/lib/polymarket/safeAbi.py,sha256=oenPmWl8rK_153ItkNAPmPhlKwivCAGL-cmUQVD7HDc,24373
+hyperquant/broker/models/apexpro.py,sha256=fJvMTXHJFQqhDtQ4qWi3WKYexCWIYRRKy-tEtvkl2vY,4197
+hyperquant/broker/models/bitget.py,sha256=0RwDY75KrJb-c-oYoMxbqxWfsILe-n_Npojz4UFUq7c,11389
+hyperquant/broker/models/bitmart.py,sha256=O9RnU-XBeR9SzicG15jzuzK5oy2kMrRJAyZSqC8DXUw,21938
+hyperquant/broker/models/coinw.py,sha256=LvLMVP7i-qkkTK1ubw8eBkMK2RQmFoKPxdKqmC4IToY,22157
+hyperquant/broker/models/deepcoin.py,sha256=6JlCWpK9UOYlfyinR5REpWqFqJCzydnD7pS8nRjy06s,25692
+hyperquant/broker/models/edgex.py,sha256=vPAkceal44cjTYKQ_0BoNAskOpmkno_Yo1KxgMLPc6Y,33954
+hyperquant/broker/models/hyperliquid.py,sha256=c4r5739ibZfnk69RxPjQl902AVuUOwT8RNvKsMtwXBY,9459
+hyperquant/broker/models/lbank.py,sha256=vHkNKxIMzpoC_EwcZnEOPOupizF92yGWi9GKxvYYFUQ,19181
+hyperquant/broker/models/lighter.py,sha256=I6hjM0of8NLtjSmI6OlbJlvpYDDswLn9yyQLz0I1Mes,30495
+hyperquant/broker/models/ourbit.py,sha256=xMcbuCEXd3XOpPBq0RYF2zpTFNnxPtuNJZCexMZVZ1k,41965
+hyperquant/broker/models/polymarket.py,sha256=d3XD1RUeiMjV8ru0wCY1Uv6JIjmnfTG_mqeXapGpJ2g,38372
+hyperquant/datavison/_util.py,sha256=92qk4vO856RqycO0YqEIHJlEg-W9XKapDVqAMxe6rbw,533
+hyperquant/datavison/binance.py,sha256=3yNKTqvt_vUQcxzeX4ocMsI5k6Q6gLZrvgXxAEad6Kc,5001
+hyperquant/datavison/coinglass.py,sha256=PEjdjISP9QUKD_xzXNzhJ9WFDTlkBrRQlVL-5pxD5mo,10482
+hyperquant/datavison/okx.py,sha256=yg8WrdQ7wgWHNAInIgsWPM47N3Wkfr253169IPAycAY,6898
+hyperquant-1.48.dist-info/METADATA,sha256=xYfb3OlarL3T3kh7rlNVcztVmrdpcqFtKN5Xz7mPNW4,1245
+hyperquant-1.48.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+hyperquant-1.48.dist-info/RECORD,,

hyperquant-1.48.dist-info/WHEEL

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