cim-sdk 0.1.0

Unofficial Python SDK for the CameronSino CIM Admin API.

cim-sdk

非官方的 CameronSino CIM Admin API Python SDK。支持通过 pip install . 安装，提供订单与交易记录的便捷访问，并附带基于 cs_user_info 的 token 复用工厂。

安装

在项目根目录执行：

python -m pip install .

快速开始

from cim_sdk import CIMClient

# 方式 1：提供账号直接登录
client = CIMClient.from_credentials("username", "password")

# 方式 2：已有 token 直接复用
another = CIMClient(token="EXISTING_ACCESS_TOKEN")

# Dropship 订单详情
detail = client.orders.get_detail("US-3729797")
print(detail)

# 最近三天的交易记录
records = client.transactions.get_recent_records(page_size=100)
print(records)

Token 持久化与自动登录（业务侧）

SDK 内置了工厂 cim_sdk.token_manager.get_cim_client_for_username，按照 cs_user_info 表结构（见 AGENTS.md）工作：

from cim_sdk.token_manager import get_cim_client_for_username

# db_conn 需实现标准 DB-API（cursor/execute/commit），如 PyMySQL 的连接对象
client = get_cim_client_for_username(db_conn, "andy")

# 如果数据库里 token 未过期，将直接 set_token；否则自动调用 /auth/login 并写回新 token。
orders = client.orders.list_page(page_no=1, page_size=20)

开发与测试

• 运行基础单测（需安装 pytest）：python -m pytest
• 本地打包验证安装：python -m pip install .

目录结构

• cim_sdk/：SDK 代码与 token 工厂
• tests/：简单的导入测试与使用示例
• pyproject.toml：打包配置