hyperquant 0.1.1__tar.gz

hyperquant-0.1.1/.gitignore

@@ -0,0 +1,41 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyPI credentials
+.pypirc
+
+# Environment
+.env
+.venv
+env/
+venv/
+ENV/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db

hyperquant-0.1.1/.python-version

@@ -0,0 +1 @@
+3.12.3

hyperquant-0.1.1/PKG-INFO

@@ -0,0 +1,153 @@
+Metadata-Version: 2.4
+Name: hyperquant
+Version: 0.1.1
+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.8
+Requires-Dist: colorama>=0.4.6
+Requires-Dist: pandas>=2.2.3
+Requires-Dist: pyecharts>=2.0.8
+Description-Content-Type: text/markdown
+
+# minquant
+
+minquant is a minimalistic framework for quantitative trading strategies. It allows users to quickly validate their strategy ideas with ease and efficiency.
+
+## Core APIs
+
+### `core.py`
+主要功能包括：
+- `ExchangeBase` 和 `Exchange` 类：实现基础的交易功能
+  - 资产管理（初始资金、已实现/未实现盈亏等）
+  - 下单交易（买入、卖出、平仓等）
+  - 仓位管理和风控
+  - 账户状态更新和记录
+- `gen_back_time` 函数：回测时间周期管理，支持训练和测试时间区间的生成
+
+### `draw.py`
+主要功能包括：
+- 支持多种图表类型：K线、曲线、柱状图等
+- 提供丰富的交互功能：
+  - 时间轴缩放和跳转
+  - 自动播放功能
+  - 多图表联动显示
+  - 指标叠加功能
+- 提供详细的数据标注：
+  - 交易信号标记
+  - 数据显示和提示
+  - 自定义颜色和样式
+
+### `logkit.py`
+主要功能包括：
+- 自定义日志级别和格式化：
+  - DEBUG: 调试信息
+  - INFO: 普通信息（蓝色）
+  - OK: 成功信息（绿色）
+  - WARNING: 警告信息（黄色）
+  - ERROR: 错误信息（红色）
+  - CRITICAL: 严重错误（深红色）
+- 支持多种日志输出：
+  - 控制台彩色输出
+  - 文件日志记录
+- 提供便捷的日志分割线和时间戳功能
+- 支持异常信息的格式化输出
+- 可配置时区和时间显示
+
+## 使用方法
+
+### 1. 初始化交易环境
+```python
+from core import Exchange
+# 创建交易实例，设置初始资金和交易品种
+exchange = Exchange(
+    trade_symbols=['BTCUSDT'],  # 交易品种
+    initial_balance=10000,      # 初始资金
+    fee=0.0002,                # 手续费率
+    recorded=True              # 是否记录交易历史
+)
+```
+
+### 2. 执行交易操作
+```python
+# 买入操作
+exchange.Buy('BTCUSDT', price=30000, amount=0.1, time='2024-01-01')
+
+# 卖出操作
+exchange.Sell('BTCUSDT', price=31000, amount=0.1, time='2024-01-02')
+
+# 获取账户状态
+print(exchange.stats)
+```
+
+### 3. 绘制分析图表
+```python
+from draw import draw
+import pandas as pd
+
+# 准备数据
+data_df = pd.DataFrame({
+    'date': [...],      # 时间列
+    'open': [...],      # 开盘价
+    'close': [...],     # 收盘价
+    'high': [...],      # 最高价
+    'low': [...],       # 最低价
+    'volume': [...]     # 成交量
+})
+
+# 配置图表
+data_dict = [
+    {
+        'series_name': 'K线图',
+        'draw_type': 'Kline',
+        'height': 60,
+        'col': ['open', 'close', 'low', 'high']
+    },
+    {
+        'series_name': '成交量',
+        'draw_type': 'Bar',
+        'height': 20,
+        'col': 'volume'
+    }
+]
+
+# 绘制图表
+draw(
+    df=data_df,
+    data_dict=data_dict,
+    date_col='date',
+    title='BTC/USDT'
+)
+```
+
+### 4. 日志记录
+```python
+from logkit import get_logger
+
+# 创建日志实例
+logger = get_logger(
+    name='strategy',                  # 日志名称
+    file_path='logs/strategy.log',    # 日志文件路径
+    show_time=True,                   # 显示时间戳
+    use_color=True                    # 使用彩色输出
+)
+
+# 记录不同级别的日志
+logger.debug("调试信息")
+logger.info("普通信息")
+logger.ok("成功信息")
+logger.warning("警告信息")
+logger.error("错误信息")
+logger.critical("严重错误")
+
+# 使用分割线
+logger.divider("回测开始", sep='=', display_time=True)
+```

hyperquant-0.1.1/README.md

@@ -0,0 +1,133 @@
+# minquant
+
+minquant is a minimalistic framework for quantitative trading strategies. It allows users to quickly validate their strategy ideas with ease and efficiency.
+
+## Core APIs
+
+### `core.py`
+主要功能包括：
+- `ExchangeBase` 和 `Exchange` 类：实现基础的交易功能
+  - 资产管理（初始资金、已实现/未实现盈亏等）
+  - 下单交易（买入、卖出、平仓等）
+  - 仓位管理和风控
+  - 账户状态更新和记录
+- `gen_back_time` 函数：回测时间周期管理，支持训练和测试时间区间的生成
+
+### `draw.py`
+主要功能包括：
+- 支持多种图表类型：K线、曲线、柱状图等
+- 提供丰富的交互功能：
+  - 时间轴缩放和跳转
+  - 自动播放功能
+  - 多图表联动显示
+  - 指标叠加功能
+- 提供详细的数据标注：
+  - 交易信号标记
+  - 数据显示和提示
+  - 自定义颜色和样式
+
+### `logkit.py`
+主要功能包括：
+- 自定义日志级别和格式化：
+  - DEBUG: 调试信息
+  - INFO: 普通信息（蓝色）
+  - OK: 成功信息（绿色）
+  - WARNING: 警告信息（黄色）
+  - ERROR: 错误信息（红色）
+  - CRITICAL: 严重错误（深红色）
+- 支持多种日志输出：
+  - 控制台彩色输出
+  - 文件日志记录
+- 提供便捷的日志分割线和时间戳功能
+- 支持异常信息的格式化输出
+- 可配置时区和时间显示
+
+## 使用方法
+
+### 1. 初始化交易环境
+```python
+from core import Exchange
+# 创建交易实例，设置初始资金和交易品种
+exchange = Exchange(
+    trade_symbols=['BTCUSDT'],  # 交易品种
+    initial_balance=10000,      # 初始资金
+    fee=0.0002,                # 手续费率
+    recorded=True              # 是否记录交易历史
+)
+```
+
+### 2. 执行交易操作
+```python
+# 买入操作
+exchange.Buy('BTCUSDT', price=30000, amount=0.1, time='2024-01-01')
+
+# 卖出操作
+exchange.Sell('BTCUSDT', price=31000, amount=0.1, time='2024-01-02')
+
+# 获取账户状态
+print(exchange.stats)
+```
+
+### 3. 绘制分析图表
+```python
+from draw import draw
+import pandas as pd
+
+# 准备数据
+data_df = pd.DataFrame({
+    'date': [...],      # 时间列
+    'open': [...],      # 开盘价
+    'close': [...],     # 收盘价
+    'high': [...],      # 最高价
+    'low': [...],       # 最低价
+    'volume': [...]     # 成交量
+})
+
+# 配置图表
+data_dict = [
+    {
+        'series_name': 'K线图',
+        'draw_type': 'Kline',
+        'height': 60,
+        'col': ['open', 'close', 'low', 'high']
+    },
+    {
+        'series_name': '成交量',
+        'draw_type': 'Bar',
+        'height': 20,
+        'col': 'volume'
+    }
+]
+
+# 绘制图表
+draw(
+    df=data_df,
+    data_dict=data_dict,
+    date_col='date',
+    title='BTC/USDT'
+)
+```
+
+### 4. 日志记录
+```python
+from logkit import get_logger
+
+# 创建日志实例
+logger = get_logger(
+    name='strategy',                  # 日志名称
+    file_path='logs/strategy.log',    # 日志文件路径
+    show_time=True,                   # 显示时间戳
+    use_color=True                    # 使用彩色输出
+)
+
+# 记录不同级别的日志
+logger.debug("调试信息")
+logger.info("普通信息")
+logger.ok("成功信息")
+logger.warning("警告信息")
+logger.error("错误信息")
+logger.critical("严重错误")
+
+# 使用分割线
+logger.divider("回测开始", sep='=', display_time=True)
+```

hyperquant-0.1.1/pub.sh

@@ -0,0 +1,13 @@
+#!/bin/bash
+echo "清理旧的构建文件..."
+rm -rf dist/* build/*
+
+echo "重新构建包..."
+rye build
+
+echo "发布到 PyPI..."
+# 从 .pypirc 文件读取 token
+TOKEN=$(grep "password" .pypirc | cut -d "=" -f2 | tr -d ' ')
+
+# 使用 token 发布
+TWINE_USERNAME=__token__ TWINE_PASSWORD=$TOKEN rye run twine upload dist/*

hyperquant-0.1.1/pyproject.toml

@@ -0,0 +1,41 @@
+[project]
+name = "hyperquant"
+version = "0.1.1"
+description = "A minimal yet hyper-efficient backtesting framework for quantitative trading"
+authors = [
+    { name = "MissinA", email = "1421329142@qq.com" }
+]
+dependencies = [
+    "pyecharts>=2.0.8",
+    "pandas>=2.2.3",
+    "colorama>=0.4.6",
+]
+readme = "README.md"
+requires-python = ">= 3.8"
+keywords = ["quant", "backtesting", "trading", "hyperquant"]
+license = {text = "MIT"}
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Topic :: Office/Business :: Financial :: Investment",
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+]
+
+[project.urls]
+Homepage = "https://github.com/yourusername/hyperquant"
+Issues = "https://github.com/yourusername/hyperquant/issues"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.rye]
+managed = true
+dev-dependencies = ["twine>=6.1.0"]
+
+[tool.hatch.metadata]
+allow-direct-references = true
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/hyperquant"]

hyperquant-0.1.1/requirements-dev.lock

@@ -0,0 +1,86 @@
+# generated by rye
+# use `rye lock` or `rye sync` to update this lockfile
+#
+# last locked with the following flags:
+#   pre: false
+#   features: []
+#   all-features: false
+#   with-sources: false
+#   generate-hashes: false
+#   universal: false
+
+-e file:.
+certifi==2025.1.31
+    # via requests
+charset-normalizer==3.4.1
+    # via requests
+colorama==0.4.6
+    # via minbacktest
+docutils==0.21.2
+    # via readme-renderer
+id==1.5.0
+    # via twine
+idna==3.10
+    # via requests
+jaraco-classes==3.4.0
+    # via keyring
+jaraco-context==6.0.1
+    # via keyring
+jaraco-functools==4.1.0
+    # via keyring
+jinja2==3.1.6
+    # via pyecharts
+keyring==25.6.0
+    # via twine
+markdown-it-py==3.0.0
+    # via rich
+markupsafe==3.0.2
+    # via jinja2
+mdurl==0.1.2
+    # via markdown-it-py
+more-itertools==10.6.0
+    # via jaraco-classes
+    # via jaraco-functools
+nh3==0.2.21
+    # via readme-renderer
+numpy==2.2.4
+    # via pandas
+packaging==24.2
+    # via twine
+pandas==2.2.3
+    # via minbacktest
+prettytable==3.15.1
+    # via pyecharts
+pyecharts==2.0.8
+    # via minbacktest
+pygments==2.19.1
+    # via readme-renderer
+    # via rich
+python-dateutil==2.9.0.post0
+    # via pandas
+pytz==2025.1
+    # via pandas
+readme-renderer==44.0
+    # via twine
+requests==2.32.3
+    # via id
+    # via requests-toolbelt
+    # via twine
+requests-toolbelt==1.0.0
+    # via twine
+rfc3986==2.0.0
+    # via twine
+rich==13.9.4
+    # via twine
+simplejson==3.20.1
+    # via pyecharts
+six==1.17.0
+    # via python-dateutil
+twine==6.1.0
+tzdata==2025.1
+    # via pandas
+urllib3==2.3.0
+    # via requests
+    # via twine
+wcwidth==0.2.13
+    # via prettytable

hyperquant-0.1.1/requirements.lock

@@ -0,0 +1,38 @@
+# generated by rye
+# use `rye lock` or `rye sync` to update this lockfile
+#
+# last locked with the following flags:
+#   pre: false
+#   features: []
+#   all-features: false
+#   with-sources: false
+#   generate-hashes: false
+#   universal: false
+
+-e file:.
+colorama==0.4.6
+    # via minbacktest
+jinja2==3.1.6
+    # via pyecharts
+markupsafe==3.0.2
+    # via jinja2
+numpy==2.2.4
+    # via pandas
+pandas==2.2.3
+    # via minbacktest
+prettytable==3.15.1
+    # via pyecharts
+pyecharts==2.0.8
+    # via minbacktest
+python-dateutil==2.9.0.post0
+    # via pandas
+pytz==2025.1
+    # via pandas
+simplejson==3.20.1
+    # via pyecharts
+six==1.17.0
+    # via python-dateutil
+tzdata==2025.1
+    # via pandas
+wcwidth==0.2.13
+    # via prettytable

hyperquant-0.1.1/src/hyperquant/__init__.py

@@ -0,0 +1,5 @@
+from .core import *
+from .draw import *
+from .logkit import *
+
+__version__ = "0.1.0"