暂存

Author: jayscoder

.github/workflows/python-package.yml

@@ -0,0 +1,45 @@
+name: Python Package
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.7", "3.8", "3.9", "3.10"]
+
+    steps:
+    - uses: actions/checkout@v3
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v4
+      with:
+        python-version: ${{ matrix.python-version }}
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        python -m pip install pytest pytest-cov black isort
+        if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
+        pip install -e .
+    - name: Lint with black
+      run: |
+        black --check .
+    - name: Lint with isort
+      run: |
+        isort --check-only --profile black .
+    - name: Test with pytest
+      run: |
+        pytest --cov=pydify tests/
+    - name: Build package
+      run: |
+        pip install build
+        python -m build
+    - name: Check package
+      run: |
+        pip install twine
+        twine check dist/* 

.github/workflows/python-publish.yml

@@ -0,0 +1,26 @@
+name: Upload Python Package
+
+on:
+  release:
+    types: [created]
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: "3.x"
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install build twine
+      - name: Build and publish
+        env:
+          TWINE_USERNAME: ${{ secrets.PYPI_USERNAME }}
+          TWINE_PASSWORD: ${{ secrets.PYPI_PASSWORD }}
+        run: |
+          python -m build
+          twine upload dist/*

.gitignore

@@ -35,4 +35,6 @@ htmlcov/
 *.swo
 *~ 
 
-test.py
+test.py
+
+./examples/test_examples.py

CHANGELOG.md

@@ -0,0 +1,18 @@
+# 变更日志
+
+所有对 Pydify 的重要更改都将记录在此文件中。
+
+## [0.1.0] - 2023-03-16
+
+### 添加
+
+- 初始版本发布
+- 支持 Chatbot 应用类型
+- 支持 Text Generation 应用类型
+- 支持 Agent 应用类型
+- 支持 Workflow 应用类型
+- 支持 Chatflow 应用类型
+- 添加流式响应处理
+- 添加文件上传功能
+- 添加会话管理功能
+- 添加文本到音频转换功能

MANIFEST.in

@@ -0,0 +1,12 @@
+include LICENSE
+include README.md
+include README.rst
+include pyproject.toml
+include CHANGELOG.md
+include RELEASE.md
+include PUBLISH_GUIDE.md
+include test_install.py
+
+recursive-include examples *.py
+recursive-exclude examples *.pyc
+recursive-exclude tests *.py *.pyc 

PUBLISH_GUIDE.md

@@ -0,0 +1,95 @@
+# Pydify 发布指南
+
+## 已完成的工作
+
+1. **项目结构设置**
+
+   - 创建了正确的包目录结构 (`pydify/`)
+   - 添加了必要的包元数据文件 (`setup.py`, `pyproject.toml`, `MANIFEST.in`)
+   - 创建了测试目录结构 (`tests/`)
+   - 添加了版本信息 (`__version__`)
+
+2. **文档**
+
+   - 创建了详细的 `README.md` 和 `README.rst`
+   - 添加了 `CHANGELOG.md` 记录版本变更
+   - 添加了 `RELEASE.md` 提供发布流程指南
+   - 创建了安装测试脚本 `test_install.py`
+
+3. **CI/CD 配置**
+
+   - 添加了 GitHub Actions 工作流配置
+   - 创建了构建和测试脚本 `build_and_test.sh`
+
+4. **包构建和测试**
+   - 成功构建了源代码分发包和轮子分发包
+   - 通过了 `twine check` 检查
+   - 在开发模式下安装并测试了包
+
+## 发布到 PyPI 的步骤
+
+1. **准备发布**
+
+   - 确保所有测试通过：`pytest`
+   - 确认版本号正确：
+     - `pydify/__init__.py` 中的 `__version__`
+     - `setup.py` 中的 `version`
+   - 更新 `CHANGELOG.md`
+
+2. **构建包**
+
+   ```bash
+   # 清理旧的构建文件
+   rm -rf build/ dist/ *.egg-info/
+
+   # 构建包
+   python -m build
+   ```
+
+3. **检查包**
+
+   ```bash
+   twine check dist/*
+   ```
+
+4. **发布到 TestPyPI（推荐先测试）**
+
+   ```bash
+   # 上传到 TestPyPI
+   twine upload --repository-url https://test.pypi.org/legacy/ dist/*
+
+   # 从 TestPyPI 安装测试
+   pip install --index-url https://test.pypi.org/simple/ pydify
+   ```
+
+5. **发布到 PyPI**
+
+   ```bash
+   # 上传到 PyPI
+   twine upload dist/*
+   ```
+
+6. **创建 GitHub 发布**
+   - 在 GitHub 上创建一个新的发布
+   - 标记版本号（例如 v0.1.0）
+   - 添加发布说明
+   - 发布
+
+## 发布后检查
+
+1. **安装和验证**
+
+   ```bash
+   pip install pydify
+   python test_install.py
+   ```
+
+2. **更新文档**
+   - 确保文档与最新版本一致
+
+## 注意事项
+
+- 首次发布到 PyPI 需要注册账号
+- 确保包名 `pydify` 在 PyPI 上未被占用
+- 如果需要更新包，请增加版本号后重新构建和上传
+- 发布前确保所有敏感信息（如 API 密钥）已从代码中移除

README.rst

@@ -0,0 +1,71 @@
+======
+Pydify
+======
+
+Pydify是一个Python SDK，用于与Dify API进行交互。它提供了一组简单易用的客户端类，让您能够轻松地使用Dify的各种功能。
+
+===========
+功能特点
+===========
+
+* **多种应用类型支持**：支持Chatbot、Agent、Text Generation、Workflow和Chatflow应用类型
+* **流式响应处理**：支持处理流式（streaming）返回的消息
+* **文件上传**：支持上传图像等文件进行多模态理解
+* **会话管理**：提供会话历史记录管理功能
+* **文本到音频转换**：支持将文本转换为音频
+
+====
+安装
+====
+
+.. code-block:: bash
+
+    pip install pydify
+
+==========
+快速开始
+==========
+
+以下是一个基本的聊天机器人示例：
+
+.. code-block:: python
+
+    from pydify import ChatbotClient
+    
+    # 初始化客户端
+    client = ChatbotClient(
+        api_key="your_api_key",
+        app_id="your_app_id"
+    )
+    
+    # 发送消息
+    response = client.send_message("Hello, how are you?")
+    print(response)
+    
+    # 流式响应处理
+    def handle_message(message):
+        print(f"接收到消息: {message}")
+    
+    def handle_end():
+        print("消息结束")
+    
+    client.send_message(
+        "Tell me a story",
+        streaming=True,
+        message_handler=handle_message,
+        message_end_handler=handle_end
+    )
+
+更多示例请查看项目的examples目录。
+
+=======
+许可证
+=======
+
+MIT
+
+==========
+更多信息
+==========
+
+完整文档请参考项目的README.md文件或访问GitHub仓库。 

RELEASE.md

@@ -0,0 +1,77 @@
+# 发布指南
+
+本文档提供了如何发布 Pydify 包到 PyPI 的指南。
+
+## 准备发布
+
+1. 确保所有测试通过：
+
+   ```bash
+   pytest
+   ```
+
+2. 更新版本号：
+
+   - 在`pydify/__init__.py`中更新`__version__`
+   - 在`setup.py`中更新`version`
+
+3. 更新 CHANGELOG.md（如果有）
+
+## 构建包
+
+```bash
+# 安装构建工具
+pip install --upgrade build
+
+# 构建包
+python -m build
+```
+
+这将在`dist/`目录下创建源代码分发包（.tar.gz）和轮子分发包（.whl）。
+
+## 检查包
+
+```bash
+# 安装twine
+pip install --upgrade twine
+
+# 检查包
+twine check dist/*
+```
+
+## 测试发布到 TestPyPI（可选）
+
+```bash
+# 上传到TestPyPI
+twine upload --repository-url https://test.pypi.org/legacy/ dist/*
+
+# 从TestPyPI安装测试
+pip install --index-url https://test.pypi.org/simple/ pydify
+```
+
+## 发布到 PyPI
+
+```bash
+# 上传到PyPI
+twine upload dist/*
+```
+
+## 创建 GitHub 发布
+
+1. 在 GitHub 上创建一个新的发布
+2. 标记版本号（例如 v0.1.0）
+3. 添加发布说明
+4. 发布
+
+## 发布后
+
+1. 安装发布的包并进行验证：
+
+   ```bash
+   pip install pydify
+   python test_install.py
+   ```
+
+2. 更新文档（如果有）
+
+3. 通知用户新版本发布

build_and_test.sh

@@ -0,0 +1,31 @@
+#!/bin/bash
+# 构建和测试Pydify包的脚本
+
+set -e  # 遇到错误立即退出
+
+echo "=== 清理旧的构建文件 ==="
+rm -rf build/ dist/ *.egg-info/
+
+echo "=== 安装开发依赖 ==="
+pip install -e ".[dev]"
+
+echo "=== 运行代码格式化 ==="
+black .
+isort .
+
+echo "=== 运行测试 ==="
+pytest
+
+echo "=== 构建包 ==="
+pip install build
+python -m build
+
+echo "=== 检查包 ==="
+pip install twine
+twine check dist/*
+
+echo "=== 完成! ==="
+echo "如果要发布到PyPI，请运行:"
+echo "twine upload dist/*"
+echo "或者测试发布到TestPyPI:"
+echo "twine upload --repository-url https://test.pypi.org/legacy/ dist/*"