ErisPulse 1.1.13__tar.gz → 1.1.14.dev1__tar.gz

erispulse-1.1.14.dev1/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,36 @@
+---
+name: Bug report
+about: 提升问题反馈质量
+title: ''
+labels: bug
+assignees: runoneall, wsu2059q
+
+---
+
+## SDK 版本
+SDK Vision: [ ]
+
+## 附加信息
+- Python 版本：
+- 操作系统：
+- 是否使用虚拟环境？[是 / 否]
+- 其他相关依赖版本：
+
+## 描述问题
+请简要描述你遇到的问题
+
+## 复现步骤
+1. 
+2. 
+3.
+
+## 预期行为
+期望的结果是什么？
+
+## 实际行为
+实际发生了什么？是否抛出错误？如果有，请粘贴完整 traceback：
+
+
+## 日志输出
+（可选）请提供关键日志输出或截图：
+

erispulse-1.1.14.dev1/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,42 @@
+---
+name: Feature request
+about: 提出你的完美想法
+title: ''
+labels: ''
+assignees: ''
+
+---
+## 功能名称
+请填写你想建议的新功能名称
+
+## 功能描述
+请详细描述你希望新增的功能及其用途
+
+## 使用场景
+请说明你打算在哪些场景下使用这个功能
+
+## 当前限制
+目前是否有替代方案？为什么它不能满足你的需求？
+
+## 建议实现方式
+（可选）你希望如何实现这个功能？可以包括接口设计、调用方式等
+
+## 影响范围
+这个功能是否会影响现有模块？例如性能、兼容性、API 变更等
+
+## 示例代码
+（可选）如果适用，请提供示例调用方式或伪代码：
+```python
+# 示例代码
+```
+
+---
+
+### 文件位置结构建议
+```
+.github/
+└── ISSUE_TEMPLATE/
+    ├── bug_report.md
+    └── feature_request.md
+```
+

erispulse-1.1.14.dev1/.github/config/notify.json

@@ -0,0 +1,11 @@
+{
+    "emails": [
+        "wsu2059@qq.com",
+        "suyu@anran.xyz",
+        "dev@oneall.eu.org",
+        "yuzi6666@outlook.com",
+        "ybrinpds@icloud.com",
+        "ybrinpds@gmail.com",
+        "yyyyt@yyyyt.top"
+    ]
+}

erispulse-1.1.14.dev1/.github/tools/update-api-docs.py

@@ -0,0 +1,76 @@
+import re
+import os
+from pathlib import Path
+
+def extract_module_docs(file_path):
+    with open(file_path, 'r', encoding='utf-8') as f:
+        content = f.read()
+    
+    match = re.search(r'^\"\"\"(.*?)\"\"\"', content, re.DOTALL)
+    if not match:
+        return None
+    
+    docstring = match.group(1).strip()
+    return docstring
+
+def update_reference_docs(module_name, docs, reference_path, module_path):
+    if not docs:
+        return
+    
+    reference_path.parent.mkdir(exist_ok=True)
+    
+    if not reference_path.exists():
+        with open(reference_path, 'w', encoding='utf-8') as f:
+            f.write("# API Reference Documentation\n\n")
+    
+    with open(reference_path, 'r', encoding='utf-8') as f:
+        content = f.read()
+    
+    github_base_url = "https://raw.githubusercontent.com/ErisPulse/ErisPulse/refs/heads/main/"
+    github_source_url = github_base_url + module_path.replace('\\', '/')
+    
+    section_header = f"## {module_name} (source: [{module_path}]({github_source_url}))"
+    
+    section_pattern = re.escape(section_header)
+    match = re.search(section_pattern, content, re.IGNORECASE)
+    
+    if match:
+        section_start = match.start()
+        next_section = re.search(r'## ', content[section_start + 1:])
+        section_end = section_start + next_section.start() if next_section else len(content)
+        
+        if docs.strip() in content[section_start:section_end]:
+            print(f"Docs for {module_name} already up to date")
+            return
+            
+        updated_content = (
+            content[:section_start] +
+            section_header + '\n\n' +
+            docs + '\n\n' +
+            content[section_end:]
+        )
+    else:
+        updated_content = content + section_header + '\n\n' + docs + '\n\n'
+    
+    with open(reference_path, 'w', encoding='utf-8') as f:
+        f.write(updated_content)
+    print(f"Updated docs for {module_name} in REFERENCE.md")
+
+def main():
+    module_dir = Path('ErisPulse')
+    reference_path = Path('docs/REFERENCE.md')
+    
+    modules = ['__init__', '__main__', 'adapter', 'db', 'logger', 'mods', 'raiserr', 'util']
+    
+    for module in modules:
+        py_file = module_dir / f'{module}.py'
+        if not py_file.exists():
+            print(f"Warning: {py_file} not found")
+            continue
+            
+        docs = extract_module_docs(py_file)
+        if docs:
+            update_reference_docs(module, docs, reference_path, f"ErisPulse/{module}.py")
+
+if __name__ == '__main__':
+    main()

erispulse-1.1.14.dev1/.github/workflows/notifications.yml

@@ -0,0 +1,80 @@
+name: 🎀 艾莉丝的统一通知服务 ~
+
+on:
+  issues:
+    types: [opened]
+  pull_request:
+    types: [opened]
+  push:
+    branches: [main]
+
+jobs:
+  notify:
+    runs-on: ubuntu-latest
+    steps:
+      - name: 检出代码
+        uses: actions/checkout@v4
+
+      - name: 获取事件信息
+        id: event_info
+        run: |
+          if [ "${{ github.event_name }}" = "issues" ]; then
+            title="${{ github.event.issue.title }}"
+            body="${{ github.event.issue.body }}"
+            url="${{ github.event.issue.html_url }}"
+            type="issue"
+          elif [ "${{ github.event_name }}" = "pull_request" ]; then
+            title="${{ github.event.pull_request.title }}"
+            body="${{ github.event.pull_request.body }}"
+            url="${{ github.event.pull_request.html_url }}"
+            type="PR"
+          else
+            title="${{ github.event.pusher.name }} 提交到 ${{ github.ref_name }}"
+            body=$(git log -1 --pretty=%B)
+            url="https://github.com/${{ github.repository }}/compare/${{ github.event.before }}...${{ github.event.after }}?expand=1"
+            type="push"
+          fi
+          echo "title=$title" >> $GITHUB_OUTPUT
+          echo "body=$body" >> $GITHUB_OUTPUT
+          echo "url=$url" >> $GITHUB_OUTPUT
+          echo "type=$type" >> $GITHUB_OUTPUT
+
+      - name: 读取收件人列表
+        id: get_emails
+        run: |
+          emails=$(cat .github/config/notify.json | jq -c '.emails')
+          echo "emails=$emails" >> $GITHUB_OUTPUT
+
+      - name: 发送邮件通知
+        uses: ./.github/workflows/send-email
+        with:
+          subject: |
+            ${{ 
+              github.event_name == 'issues' && '[艾莉丝快报] 有新issue被创建!' ||
+              github.event_name == 'pull_request' && '[艾莉丝快报] 有新PR被创建!' ||
+              '[艾莉丝快报] 开发分支有更新'
+            }}
+          content: |
+            <div style="font-family: 'Segoe UI', sans-serif; background-color: #2a2a3c; color: #f5f5f5; padding: 20px; border-radius: 8px;">
+              <h2 style="color: #ff6ec7;">
+                ${{ 
+                  github.event_name == 'issues' && '新Issue' ||
+                  github.event_name == 'pull_request' && '新PR' ||
+                  '开发分支更新'
+                }}: ${{ steps.event_info.outputs.title }}
+              </h2>
+              <p><strong>提交者:</strong> ${{ 
+                github.event_name == 'push' && github.event.pusher.name || 
+                github.event.issue.user.login || 
+                github.event.pull_request.user.login 
+              }}</p>
+              <p><strong>内容:</strong></p>
+              <pre style="background-color: #3b3b4f; padding: 10px; border-radius: 4px; white-space: pre-wrap;">${{ steps.event_info.outputs.body }}</pre>
+              <p><strong>地址:</strong><br/>
+              <a href="${{ steps.event_info.outputs.url }}" style="color: #7acbf7; text-decoration: none;">
+                查看详情
+              </a></p>
+            </div>
+          recipients: ${{ steps.get_emails.outputs.emails }}
+          resend_api_key: ${{ secrets.RESEND_API_KEY }}
+          feishu_smtp_password: ${{ secrets.FEISHU_SMTP_PASSWORD }}

erispulse-1.1.14.dev1/.github/workflows/pypi-publish.yml

@@ -0,0 +1,114 @@
+name: 🎀 艾莉丝的PyPI包裹快递服务 ~
+
+# 艾莉丝今天也要努力发包呢!
+on:
+  workflow_dispatch: {} # 手动触发
+
+permissions:
+  contents: read
+
+jobs:
+  release-build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: 检出代码
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: 版本检查
+        id: version
+        run: |
+          CURRENT_TAG=${GITHUB_REF#refs/tags/}
+          echo "✨ 当前版本: $CURRENT_TAG"
+
+          if [[ $CURRENT_TAG =~ \.dev|\.alpha|\.beta ]]; then
+            BASE_VERSION=$(echo $CURRENT_TAG | sed -E 's/([0-9]+)$//')
+            PREV_TAG=$(git tag --sort=-v:refname | grep "^$BASE_VERSION" | grep -v "$CURRENT_TAG" | head -n 1)
+
+            if [ -z "$PREV_TAG" ]; then
+              echo "💢 找不到上一个版本!"
+              exit 1
+            fi
+            echo "🎀 发现上一个试验版本: $PREV_TAG"
+            git checkout $PREV_TAG
+            echo "use_current=false" >> $GITHUB_OUTPUT
+          else
+            echo "🌟 正式版本~"
+            echo "use_current=true" >> $GITHUB_OUTPUT
+          fi
+
+      - name: 环境准备
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.x"
+
+      - name: 打包构建
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install build
+          python -m build
+
+      - name: 暂存包裹
+        uses: actions/upload-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+  pypi-publish:
+    runs-on: ubuntu-latest
+    needs: [release-build]
+    permissions:
+      id-token: write
+
+    environment:
+      name: pypi
+      url: https://pypi.org/p/erispulse
+
+    steps:
+      # 👇 新增这一步：检出代码，使 send-email 可用
+      - name: 检出代码
+        uses: actions/checkout@v4
+
+      - name: 获取包裹
+        uses: actions/download-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+      - name: 发布上传
+        id: publish
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/
+          verbose: true
+
+      - name: 读取收件人列表
+        id: get_emails
+        run: |
+          emails=$(cat .github/config/notify.json | jq -c '.emails')
+          echo "emails=$emails" >> $GITHUB_OUTPUT
+
+      - name: 发送邮件通知
+        uses: ./.github/workflows/send-email
+        with:
+          subject: "[艾莉丝快报] 新版本 ${{ steps.version.outputs.CURRENT_TAG }} 已发布至 PyPI！✨"
+          content: |
+            🎀 您好主人~
+
+            我是艾莉丝，负责为您播报最新消息！
+            今天我们的项目又更新啦~快去看看吧！
+
+            🔖 版本号：${{ steps.version.outputs.CURRENT_TAG }}
+            📦 包地址：
+            https://pypi.org/project/erispulse/${{ steps.version.outputs.CURRENT_TAG }}
+
+            📝 更新内容：
+            ${{ steps.version.outputs.CURRENT_TAG }}
+
+            祝您每天都有好心情~ 💖
+            —— 艾莉丝
+          recipients: ${{ steps.get_emails.outputs.emails }}
+          resend_api_key: ${{ secrets.RESEND_API_KEY }}
+          feishu_smtp_password: ${{ secrets.FEISHU_SMTP_PASSWORD }}

erispulse-1.1.14.dev1/.github/workflows/send-email/action.yml

@@ -0,0 +1,41 @@
+name: "🎀 艾莉丝的魔法邮件服务 ~"
+description: "通过 Resend 发送魔法电子邮件通知"
+inputs:
+  subject:
+    type: string
+    default: "[艾莉丝快报] 默认主题"
+    description: "邮件主题"
+  content:
+    type: string
+    required: true
+    description: "邮件正文内容"
+  recipients:
+    type: json
+    required: true
+    description: "收件人列表 JSON 数组"
+  resend_api_key:
+    type: string
+    required: true
+    description: "Resend API 密钥"
+  feishu_smtp_password:
+    type: string
+    required: true
+    description: "飞书 SMTP 密码"
+
+runs:
+  using: "composite"
+  steps:
+    - name: 安装依赖
+      run: python -m pip install requests
+      shell: bash
+
+    - name: 发送邮件
+      env:
+        RECIPIENTS_JSON: ${{ inputs.recipients }}
+        SUBJECT: ${{ inputs.subject }}
+        CONTENT: ${{ inputs.content }}
+        RESEND_API_KEY: ${{ inputs.resend_api_key }}
+        FEISHU_SMTP_PASSWORD: ${{ inputs.feishu_smtp_password }}
+      run: |
+        python ${{ github.action_path }}/send_mail.py
+      shell: bash

erispulse-1.1.14.dev1/.github/workflows/send-email/send_mail.py

@@ -0,0 +1,64 @@
+import json
+import os
+import smtplib
+from email.mime.text import MIMEText
+from email.mime.multipart import MIMEMultipart
+from email.header import Header
+from email.utils import formataddr, formatdate
+
+# 邮箱配置信息
+EMAIL_HOST = "smtp.feishu.cn"  # SMTP服务器地址
+EMAIL_PORT_SSL = 465  # SSL加密端口
+USERNAME = "noreply@ns1.loc.cc"  # 邮箱地址
+PASSWORD = os.getenv("FEISHU_SMTP_PASSWORD")  # IMAP/SMTP密码
+
+
+def send_email(
+    subject, content, receivers, content_type="html", sender_name="ErisPulse通知"
+):
+    """
+    发送邮件到多个收件人，支持HTML格式
+
+    参数:
+    :param subject: 邮件主题
+    :param content: 邮件内容(HTML或纯文本)
+    :param receivers: 收件人列表，如 ["user1@example.com", "user2@example.com"]
+    :param content_type: 邮件类型，"html" 或 "plain"
+    :param sender_name: 发件人显示名称
+    """
+    # 创建邮件对象
+    msg = MIMEMultipart()
+    msg["Subject"] = Header(subject, "utf-8")
+    msg["From"] = formataddr((str(Header(sender_name, "utf-8")), USERNAME))
+    msg["To"] = ", ".join(receivers)  # 多个收件人用逗号分隔
+    msg["Date"] = formatdate(localtime=True)
+
+    # 添加邮件正文
+    if content_type == "html":
+        body = MIMEText(content, "html", "utf-8")
+    else:
+        body = MIMEText(content, "plain", "utf-8")
+    msg.attach(body)
+
+    try:
+        # 创建SSL加密连接
+        with smtplib.SMTP_SSL(EMAIL_HOST, EMAIL_PORT_SSL) as server:
+            server.login(USERNAME, PASSWORD)
+            server.sendmail(USERNAME, receivers, msg.as_string())
+            print(f"邮件成功发送给 {len(receivers)} 位收件人")
+            return True
+    except Exception as e:
+        print(f"邮件发送失败: {str(e)}")
+        return False
+
+
+if __name__ == "__main__":
+    receivers = json.loads(os.getenv("RECIPIENTS_JSON"))
+    print(f"收件人列表: {receivers}")
+
+    send_email(
+        subject=os.getenv("SUBJECT"),
+        content=os.getenv("CONTENT"),
+        receivers=receivers,
+        content_type="html",
+    )

erispulse-1.1.14.dev1/.github/workflows/send-email/send_mail_old.py

@@ -0,0 +1,29 @@
+import requests
+import os
+import json
+
+recipients = json.loads(os.getenv("RECIPIENTS_JSON"))
+resend_api_key = os.getenv("RESEND_API_KEY")
+feishu_smtp_password = os.getenv("FEISHU_SMTP_PASSWORD")
+subject = os.getenv("SUBJECT")
+content = os.getenv("CONTENT")
+print(f"📬 收件人列表: {recipients}")
+response = requests.post(
+    "https://api.resend.com/emails",
+    headers={
+        "Authorization": f"Bearer {resend_api_key}",
+        "Content-Type": "application/json",
+    },
+    json={
+        "from": "ErisPulse <noreply@anran.xyz>",
+        "to": recipients,
+        "subject": subject,
+        "html": content,
+    },
+)
+
+if response.status_code == 200:
+    print("💌 魔法信件已成功寄出！")
+else:
+    print(f"❌ 发送失败: {response.text}")
+    exit(1)

erispulse-1.1.14.dev1/.gitignore

@@ -0,0 +1,199 @@
+# dev gnore ignore file for Python projects
+env.py
+uv.lock
+snapshots/
+config.db*
+.website
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+.vscode/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/latest/usage/project/#working-with-version-control
+.pdm.toml
+.pdm-python
+.pdm-build/
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# Visual Studio Code
+#  Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
+#  that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#  and can be added to the global gitignore or merged into this file. However, if you prefer, 
+#  you could uncomment the following to ignore the enitre vscode folder
+# .vscode/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Cursor
+#  Cursor is an AI-powered code editor. `.cursorignore` specifies files/directories to
+#  exclude from AI features like autocomplete and code analysis. Recommended for sensitive data
+#  refer to https://docs.cursor.com/context/ignore-files
+.cursorignore
+.cursorindexingignore
+
+# osx
+.DS_Store

erispulse-1.1.14.dev1/.python-version

@@ -0,0 +1 @@
+3.13