qqAys@Jinx jinx
0 Followers · 0 Following
Repositories
4
 Projects Packages Code Public Activity Watched Repositories

pda-python-sdk (0.1.6)

Published 2025-08-01 14:57:32 +08:00 by jinx

Installation

pip install --index-url  pda-python-sdk

About this package

PDA Python SDK for accessing business data from pda_business

pda_python_sdk

优雅的、快速的、安全的、高扩展能力的外勤助手数据获取方式

pda_python_sdk 是一个用于访问外勤助手业务数据的 Python 工具包。它封装了对数据库的常见查询操作，支持区域、仓库、产品、单据、用户、拜访等模块的数据获取，并提供统一的接口调用方式。

📦 安装

通过pip安装（推荐）

qqAys pypi源

pip install pda-python-sdk --extra-index-url https://git.qqays.xyz/api/packages/jinx/pypi/simple/

Linno pypi源 (因URL问题暂不可用)

需要生成个人访问令牌，详见：http://workspace.linno.cn:4282/-/user_settings/personal_access_tokens

pip install pda-python-sdk --extra-index-url http://<your_personal_token_name>:<your_personal_token>@workspace.linno.cn:4282/api/v4/projects/57/packages/pypi/simple

通过源码安装

git clone http://workspace.linno.cn:4282/linno/python_pda_sdk.git
cd python-pda-sdk
pip install -e .

⚙️ 配置

使用.env文件

在项目根创建一个 .env 文件，并添加以下内容：

PDA_DB_HOST=localhost
PDA_DB_USERNAME=your_db_username
PDA_DB_PASSWD=your_db_password

或使用环境变量

export PDA_DB_HOST=localhost
export PDA_DB_USERNAME=your_db_username
export PDA_DB_PASSWD=your_db_password

🚀 使用

方式一：上下文管理器连接（推荐）

from pda_python_sdk.utils.db_connection import DB

# 使用with管理连接
with DB() as db:
    # 获取数据
    pass

方式二：实例化连接

from pda_python_sdk.utils.db_connection import DB

# 实例化连接
db = DB()

# 获取数据
pass

# 手动关闭连接
db.close()

🔧 自定义连接

# 以DI库为例，使用实例化连接，上下文管理器同理。
from pda_python_sdk.utils.db_connection import DB

# 建立连接
di_db = DB(
    db_host="192.168.18.244",
    db_port=3306,
    db_user="sdk_test",
    db_password="xHnx83rw3KyTVgPRj0ey",
    db_name="data_insight",
)

# 手动关闭连接
di_db.close()

🔍 查询数据

详见examples目录下的示例代码。

⚙️ 环境变量控制

环境变量 描述 默认值
PDA_PYTHON_SDK_LOG_LEVEL 日志级别，可选值有DEBUG, INFO, WARNING, ERROR, CRITICAL INFO
PDA_DB_HOST PDA数据库主机地址 localhost
PDA_DB_PORT PDA端口 3306
PDA_DB_USERNAME PDA数据库用户名 -
PDA_DB_PASSWD PDA数据库密码 -
PDA_VISIT_MEDIA_URL_PREFIX 拜访记录媒体文件URL前缀 http://resource.linno.cn/

🛠️ 故障排查

  • 数据库连接失败：请检查.env或环境变量中的PDA_DB_HOST, PDA_DB_USERNAME, PDA_DB_PASSWD是否正确且生效。
  • 查询结果为空：检查传入的参数是否正确，或者数据库中不存在该数据。
  • 日志输出：设置PDA_PYTHON_SDK_DEV_MODE=True与PDA_PYTHON_SDK_LOG_LEVEL=DEBUG可查看详细执行细节。

📄 许可

本项目遵循 MIT 许可协议，详见 LICENSE 。

Requirements

Requires Python: >=3.12
Details
PyPI
2025-08-01 14:57:32 +08:00
2
45 KiB
Assets (2)
pda_python_sdk-0.1.6-py3-none-any.whl 26 KiB
pda_python_sdk-0.1.6.tar.gz 18 KiB
Versions (7) View all
0.1.6 2025-08-01
0.1.5 2025-08-01
0.1.4 2025-08-01
0.1.3 2025-08-01
0.1.2 2025-08-01