- 为 core 目录下主要模块 (models, context, creator, base_api, exchange, executor) 添加了详细的类和方法 Docstring。 - 新增 docs/架构改进.md 文件。
25 lines
804 B
Python
25 lines
804 B
Python
#!/usr/bin/env python
|
|
# coding=utf-8
|
|
import logging
|
|
|
|
from core.session import Session
|
|
from core import settings
|
|
|
|
class BaseApi:
|
|
"""
|
|
所有 API 类的基类。
|
|
提供基础的 Session 管理和日志记录功能,供具体的业务 API 类继承。
|
|
"""
|
|
def __init__(self, session: Session = None):
|
|
"""
|
|
初始化 BaseApi。
|
|
|
|
Args:
|
|
session: HTTP 会话对象。如果未提供,将使用默认配置创建一个新的 Session。
|
|
"""
|
|
self.session = session or Session(base_url=settings.base_url)
|
|
self.logger = logging.getLogger(self.__class__.__name__)
|
|
|
|
def _log_action(self, method_name: str, **kwargs):
|
|
"""统一的动作日志记录"""
|
|
self.logger.info(f"执行动作: {method_name} | 参数: {kwargs}") |