qdata-adapter-jky 0.1.0__tar.gz

qdata_adapter_jky-0.1.0/.env.example

@@ -0,0 +1,42 @@
+# jky 适配器环境变量配置
+# 复制此文件为 .env 并填入真实值
+# 注意：.env 文件不应提交到 Git！
+
+# =============================================================================
+# 基础配置
+# =============================================================================
+
+# 接口类型 (standard/qimen)
+JKY_DEFAULT_INTERFACE=standard
+
+# 环境标识 (production/sandbox/development)
+JKY_ENVIRONMENT=sandbox
+
+# =============================================================================
+# Standard 接口配置（主接口）
+# 文档：https://open.jackyun.com/
+# =============================================================================
+
+# API 基础地址
+JKY_STANDARD_HOST=https://open.jackyun.com/open/openapi/do
+
+# 认证参数
+JKY_APP_KEY=your-app-key
+JKY_APP_SECRET=your-app-secret
+JKY_TOKEN=your-token
+JKY_VERSION=1.0
+
+# =============================================================================
+# Qimen 接口配置（奇门网关，备用接口）
+# =============================================================================
+
+# API 基础地址
+JKY_QIMEN_HOST=https://zci2vl4joy.api.taobao.com/router/qm
+
+# 认证参数
+JKY_QIMEN_APP_KEY=your-app-key
+JKY_QIMEN_APP_SECRET=your-app-secret
+JKY_QIMEN_TARGET_APP_KEY=your-target-app-key
+JKY_QIMEN_JKY_APP_KEY=your-jky-app-key
+JKY_QIMEN_JKY_APP_SECRET=your-jky-app-secret
+JKY_QIMEN_CUSTOMER_ID=your-customer-id

qdata_adapter_jky-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_jky --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_jky-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-jky
+    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_jky-0.1.0/.gitignore

@@ -0,0 +1,161 @@
+# 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/
+
+.old-php/

qdata_adapter_jky-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_jky-0.1.0/CHANGELOG.md

@@ -0,0 +1,22 @@
+# 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-jky
+- Basic adapter structure with JkyAdapter
+- Authentication implementation
+- Core data operations (list, get, create)
+- Complete test suite with pytest
+
+## [0.1.0] - 2026-04-04
+
+### Initial Release
+- Project scaffold generated
+- Base adapter implementation
+- CI/CD configuration

qdata_adapter_jky-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,104 @@
+# 贡献指南
+
+感谢您对 qdata-adapter-jky 项目的关注！我们欢迎各种形式的贡献。
+
+## 如何贡献
+
+### 报告问题
+
+如果您发现了 bug 或有功能建议，请在 [GitHub Issues](https://github.com/qeasy/qdata-adapter-jky/issues) 中提交。
+
+提交问题时，请包含：
+
+- 问题的详细描述
+- 复现步骤
+- 期望行为与实际行为
+- 您的环境信息（Python 版本、操作系统等）
+
+### 提交代码
+
+1. **Fork 仓库**
+
+   ```bash
+   git clone https://github.com/qeasy/qdata-adapter-jky.git
+   cd qdata-adapter-jky
+   ```
+
+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:` 构建/工具相关
+
+## 许可证
+
+您的贡献将遵循项目的 AGPL-3.0 许可证。
+
+## 联系我们
+
+如有任何问题，欢迎通过以下方式联系：
+
+- GitHub Issues: https://github.com/qeasy/qdata-adapter-jky/issues
+- 邮箱: opensource@qeasy.cloud
+
+感谢您的贡献！ 🎉

qdata_adapter_jky-0.1.0/LICENSE

@@ -0,0 +1,39 @@
+
+GNU AFFERO GENERAL PUBLIC LICENSE
+Version 3, 19 November 2007
+
+Copyright (c) 2024-2026 广东轻亿云软件科技有限公司
+
+本程序为自由软件：你可以按照自由软件基金会发布的 GNU Affero 通用公共许可证
+（第 3 版或之后的版本）的条款重新分发或修改它。
+
+本程序的发布是希望它能有用，但不提供任何保证，甚至不提供针对特定用途的
+适销性或适用性的暗示保证。详见 GNU Affero 通用公共许可证。
+
+你应该已经随本程序收到了一份 GNU Affero 通用公共许可证的副本。
+如果没有，请访问 <https://www.gnu.org/licenses/>。
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+重要声明：商业用途双重许可
+
+本软件采用双重许可模式：
+
+1. 开源许可证（个人/学习/研究用途）
+   - 协议：GNU Affero General Public License v3.0 (AGPL-3.0)
+   - 适用对象：个人开发者、学术研究、非商业项目
+   - 要求：如果你修改本软件并提供网络服务，必须开源你的修改代码
+
+2. 商业许可证（商业/企业用途）
+   - 任何以盈利为目的的使用、托管、二次分发、SaaS 对外服务
+   - 任何在生产环境部署用于商业目的的行为
+   - 详见 COMMERCIAL-LICENSE.txt 文件
+   - 联系方式：opensource@qeasy.cloud
+
+未获得书面商业许可前，禁止任何商业实体在生产环境部署本软件。
+违反上述条款即构成版权侵权，作者有权依法追责并索赔。
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+完整的 AGPL-3.0 许可证文本：
+https://www.gnu.org/licenses/agpl-3.0.txt