qdata-adapter-kd-cosmic 0.1.0__tar.gz

qdata_adapter_kd_cosmic-0.1.0/.env.example

@@ -0,0 +1,47 @@
+# kd-cosmic 适配器测试环境变量
+# 复制此文件为 .env 并填入真实值以进行集成测试
+# 注意：.env 文件不应提交到 Git！
+
+# =============================================================================
+# 基础配置
+# =============================================================================
+
+# API 基础地址
+KD_COSMIC_BASE_URL=https://api.example.com
+
+# 环境标识 (production/sandbox/development)
+KD_COSMIC_ENVIRONMENT=sandbox
+
+# =============================================================================
+# 认证配置 - standard 接口
+# =============================================================================
+
+# OAuth2 / API Key 认证
+KD_COSMIC_CLIENT_ID=your-client-id
+KD_COSMIC_CLIENT_SECRET=your-client-secret
+KD_COSMIC_TOKEN_URL=https://api.example.com/oauth/token
+
+# =============================================================================
+# 认证配置 - enterprise 接口（如启用双接口）
+# =============================================================================
+
+# HMAC / 签名认证
+KD_COSMIC_APP_KEY=your-app-key
+KD_COSMIC_APP_SECRET=your-app-secret
+KD_COSMIC_CUSTOMER_ID=your-customer-id
+
+# =============================================================================
+# 测试配置
+# =============================================================================
+
+# 是否录制请求/响应 (true/false)
+RECORD_HTTP_TRAFFIC=true
+
+# 测试数据目录
+TEST_DATA_DIR=tests/data
+
+# 请求超时时间（秒）
+REQUEST_TIMEOUT=30
+
+# 是否使用真实 API 进行测试 (true=真实API, false=Mock)
+USE_REAL_API=false

qdata_adapter_kd_cosmic-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,103 @@
+name: CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+jobs:
+  test:
+    name: "Test Python ${{ matrix.python-version }} on ${{ matrix.os }}"
+    runs-on: "${{ matrix.os }}"
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: ["3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: "Set up Python ${{ matrix.python-version }}"
+        uses: actions/setup-python@v5
+        with:
+          python-version: "${{ matrix.python-version }}"
+          cache: 'pip'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Run tests with coverage
+        run: |
+          pytest --cov=qdata_adapter_kd_cosmic --cov-report=xml --cov-report=term
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v3
+        if: "matrix.os == 'ubuntu-latest' && matrix.python-version == '3.11'"
+        with:
+          file: ./coverage.xml
+          fail_ci_if_error: false
+
+  lint:
+    name: Lint and Type Check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+          cache: 'pip'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Run ruff
+        run: ruff check src tests
+
+      - name: Run black
+        run: black --check src tests
+
+      - name: Run isort
+        run: isort --check-only src tests
+
+      - name: Run mypy
+        run: mypy src
+
+      - name: Run bandit security check
+        run: bandit -r src -ll
+
+  build:
+    name: Build Distribution
+    runs-on: ubuntu-latest
+    needs: [test, lint]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install build dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install build twine
+
+      - name: Build package
+        run: python -m build
+
+      - name: Check package
+        run: twine check dist/*
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/

qdata_adapter_kd_cosmic-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,61 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install build dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install build twine
+
+      - name: Build package
+        run: python -m build
+
+      - name: Check package
+        run: twine check dist/*
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/qdata-adapter-kd-cosmic
+    permissions:
+      id-token: write  # IMPORTANT: mandatory for trusted publishing
+
+    steps:
+      - name: Download artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          skip-existing: true
+          verbose: true

qdata_adapter_kd_cosmic-0.1.0/.gitignore

@@ -0,0 +1,159 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.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/
+
+# 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
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+Pipfile.lock
+
+# PEP 582
+__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/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Project specific
+*.local
+*.local.json
+*.local.yaml
+*.local.yml
+secrets/
+*.key
+*.pem
+
+# Test data and recordings (may contain sensitive info)
+tests/data/recordings/
+tests/data/*.log
+tests/data/temp/
+
+# Environment files with real credentials
+.env
+.env.local
+.env.*.local
+!.env.example
+
+# API docs scraped content (may be large)
+api-docs/scraped/*.html
+api-docs/scraped/*.pdf
+api-docs/scraped/**/*_files/

qdata_adapter_kd_cosmic-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,38 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.5.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-added-large-files
+        args: ['--maxkb=1000']
+      - id: check-json
+      - id: check-toml
+      - id: check-merge-conflict
+      - id: debug-statements
+
+  - repo: https://github.com/psf/black
+    rev: 23.12.1
+    hooks:
+      - id: black
+        language_version: python3.11
+
+  - repo: https://github.com/pycqa/isort
+    rev: 5.13.2
+    hooks:
+      - id: isort
+        args: ["--profile", "black"]
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.1.9
+    hooks:
+      - id: ruff
+        args: [--fix, --exit-non-zero-on-fix]
+
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.8.0
+    hooks:
+      - id: mypy
+        additional_dependencies: [types-all]
+        args: [--ignore-missing-imports]

qdata_adapter_kd_cosmic-0.1.0/CHANGELOG.md

@@ -0,0 +1,24 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+
+- Initial release of qdata-adapter-kd-cosmic
+- Basic adapter structure with KdCosmicAdapter
+- Authentication implementation
+- Core data operations (list, get, create)
+- Complete test suite with pytest
+
+## [0.1.0] - 2026-06-04
+
+### Initial Release
+
+- Project scaffold generated
+- Base adapter implementation
+- CI/CD configuration

qdata_adapter_kd_cosmic-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,104 @@
+# 贡献指南
+
+感谢您对 qdata-adapter-kd-cosmic 项目的关注！我们欢迎各种形式的贡献。
+
+## 如何贡献
+
+### 报告问题
+
+如果您发现了 bug 或有功能建议，请在 [GitHub Issues](https://github.com/qeasy/qdata-adapter-kd-cosmic/issues) 中提交。
+
+提交问题时，请包含：
+
+- 问题的详细描述
+- 复现步骤
+- 期望行为与实际行为
+- 您的环境信息（Python 版本、操作系统等）
+
+### 提交代码
+
+1. **Fork 仓库**
+
+   ```bash
+   git clone https://github.com/qeasy/qdata-adapter-kd-cosmic.git
+   cd qdata-adapter-kd-cosmic
+   ```
+
+2. **创建分支**
+
+   ```bash
+   git checkout -b feature/your-feature-name
+   ```
+
+3. **设置开发环境**
+
+   ```bash
+   python -m venv venv
+   source venv/bin/activate  # Windows: venv\Scripts\activate
+   pip install -e ".[dev]"
+   pre-commit install
+   ```
+
+4. **编写代码**
+
+   - 遵循项目代码风格
+   - 添加必要的测试
+   - 更新相关文档
+
+5. **运行测试**
+
+   ```bash
+   pytest
+   ```
+
+6. **代码检查**
+
+   ```bash
+   make check
+   ```
+
+7. **提交更改**
+
+   ```bash
+   git add .
+   git commit -m "feat: 添加新功能描述"
+   ```
+
+8. **推送并创建 Pull Request**
+
+   ```bash
+   git push origin feature/your-feature-name
+   ```
+
+## 代码规范
+
+- 使用 [Black](https://github.com/psf/black) 进行代码格式化
+- 使用 [isort](https://github.com/PyCQA/isort) 进行导入排序
+- 遵循 [PEP 8](https://pep8.org/) 代码风格
+- 添加类型提示
+- 编写清晰的文档字符串
+
+## Commit 规范
+
+使用 [Conventional Commits](https://www.conventionalcommits.org/) 规范：
+
+- `feat:` 新功能
+- `fix:` 修复 bug
+- `docs:` 文档更新
+- `style:` 代码风格调整（不影响功能）
+- `refactor:` 代码重构
+- `test:` 测试相关
+- `chore:` 构建/工具相关
+
+## 许可证
+
+您的贡献将遵循项目的 MIT 许可证。
+
+## 联系我们
+
+如有任何问题，欢迎通过以下方式联系：
+
+- GitHub Issues: https://github.com/qeasy/qdata-adapter-kd-cosmic/issues
+- 邮箱: opensource@qeasy.cloud
+
+感谢您的贡献！ 🎉