vbp-bid-common 0.1.5

Common async Redis and MongoDB clients for VBP bid services.

vbp-bid-common

vbp-bid-common 是 VBP Bid Copilot 的公共基础包，当前提供异步 Redis 与 MongoDB 客户端封装，便于多个服务复用同一套缓存、队列、分布式锁和基础 CRUD 能力。

安装

pip install vbp-bid-common

本地开发时可在仓库根目录执行：

pip install -e ./vbp-bid-common[dev]

使用示例

from vbp_bid_common import get_mongodb_client, get_redis_client


async def main() -> None:
    redis_client = get_redis_client()
    await redis_client.set("demo:key", "value", ex=60)
    value = await redis_client.get("demo:key")

    mongo_client = get_mongodb_client(default_collection="demo")
    inserted_id = await mongo_client.insert_one({"value": value})
    doc = await mongo_client.find_one({"_id": inserted_id})

也可以按模块导入：

from vbp_bid_common.services.mongodb import MongoDBClient
from vbp_bid_common.services.redis import RedisClient

环境变量

Redis 客户端支持以下环境变量：

• REDIS_HOST，默认 127.0.0.1
• REDIS_PORT，默认 6379
• REDIS_DB，默认 0
• REDIS_USERNAME
• REDIS_PASSWORD
• REDIS_DECODE_RESPONSES，默认 true
• REDIS_MAX_CONNECTIONS，默认 100
• REDIS_CONNECTION_POOL_TIMEOUT，默认 10
• REDIS_SOCKET_TIMEOUT
• REDIS_SOCKET_CONNECT_TIMEOUT

MongoDB 客户端支持以下环境变量：

• MONGODB_URI，默认 mongodb://127.0.0.1:27017
• MONGODB_DATABASE，默认 test-technical
• MONGODB_COLLECTION_NAME
• MONGODB_MAX_POOL_SIZE
• MONGODB_MIN_POOL_SIZE
• MONGODB_SERVER_SELECTION_TIMEOUT_MS

发布到 PyPI

首次发布前需要注册并配置 PyPI API Token：

python -m pip install --upgrade build twine
python -m build
python -m twine check dist/*
python -m twine upload dist/*

发布测试包可先使用 TestPyPI：

python -m twine upload --repository testpypi dist/*

每次发布前请更新 pyproject.toml 中的 version，并确认 README.md、LICENSE 与依赖声明已同步。

开源协议

本项目使用 Apache License 2.0。详见 LICENSE。