xparse-client 0.2.12__tar.gz → 0.3.0b6__tar.gz

xparse_client-0.3.0b6/CHANGELOG.md

@@ -0,0 +1,77 @@
+# Changelog
+
+所有重要变更都会记录在这个文件中。
+
+格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/)，
+版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
+
+## [0.3.0] - 2026-01-27
+
+### 💥 破坏性变更
+
+- **完全移除 Pipeline 类**: Pipeline 类及相关代码已从代码库中删除
+  - 原因: 已完全迁移到新版 `XParseClient.local.run_workflow()` API
+  - 影响: 使用 `Pipeline` 的代码将无法运行
+  - 迁移指南: [docs/MIGRATION_FROM_PIPELINE.md](docs/MIGRATION_FROM_PIPELINE.md)
+
+### 新增
+
+- **新版 SDK 设计**: 统一到 `XParseClient` 入口点
+- **本地批处理 API**: `client.local.run_workflow()` 支持本地同步批处理
+- **Workflows API**: `client.workflows` 远程工作流管理（骨架）
+- **懒加载机制**: API 模块按需导入，提升启动速度
+- **服务端异步任务**: `create_async_job()`、`get_result()`、`wait_for_result()`
+- **进度回调**: 本地批处理支持 `progress_callback` 参数
+- **错误处理策略**: 支持 `stop/continue/retry` 三种策略
+- **类型安全的 Stage 配置**: 使用 Pydantic discriminated unions 实现类型安全
+
+### 变更
+
+- **移除客户端 async/await**: 删除 `partition_async`、`extract_async`、`execute_async`
+  - 原因: 服务端异步任务更强大，客户端 async 使用场景有限
+- **Connectors 模块化**: Source/Destination 移至 `xparse_client.connectors`
+- **重命名**: `Stage` → `PipelineStage`
+
+### 移除
+
+- **Pipeline 类**: 完全移除，使用 `XParseClient.local.run_workflow()` 替代
+- **create_pipeline_from_config**: 移除，手动构建对象或使用新版 API
+- **Stage 类**: 移除，使用类型安全的 `ParseStage`、`ChunkStage` 等
+- **从根模块导出的旧版 API**: 移除 Source/Destination 从 `xparse_client` 的导出
+
+### 修复
+
+- 无（此版本为架构重构）
+
+### 文档
+
+- 新增完整迁移指南: `docs/MIGRATION_FROM_PIPELINE.md`（详细的迁移步骤和示例）
+- 新增简明迁移指南: `docs/migration-guide.md`
+- 更新 README 示例使用新 API
+- 更新 CLAUDE.md 项目指南
+- 重写 `example/run_pipeline.py` 使用新 API
+
+### 兼容性
+
+- **⚠️ 不向后兼容**: Pipeline 类已完全移除
+- **迁移方式**:
+  - 安装 v0.2.20 继续使用旧版：`pip install xparse-client==0.2.20`
+  - 迁移到新版 API：查看 [完整迁移指南](docs/MIGRATION_FROM_PIPELINE.md)
+- **Python 版本**: 保持 >= 3.8
+- **依赖变更**: 无
+
+---
+
+## [0.2.20] - 2026-01-XX
+
+### 新增
+
+- 初始版本的 Pipeline API
+- 支持 Parse、Chunk、Embed 阶段
+- 支持 LocalSource、S3Source 等数据源
+- 支持 MilvusDestination、QdrantDestination 等目的地
+
+---
+
+[0.3.0]: https://github.com/textin/xparse-client/compare/v0.2.20...v0.3.0
+[0.2.20]: https://github.com/textin/xparse-client/releases/tag/v0.2.20

{xparse_client-0.2.12 → xparse_client-0.3.0b6}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 ACG Xparse Authors
+Copyright (c) 2025 INTSIG-TEXTIN
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

xparse_client-0.3.0b6/MANIFEST.in

@@ -0,0 +1,18 @@
+# 包含额外的文档文件
+include README.md
+include LICENSE
+include CHANGELOG.md
+
+# 包含示例代码
+recursive-include example *.py *.json *.md
+
+# 包含类型提示文件（如果有）
+recursive-include xparse_client py.typed *.pyi
+
+# 排除编译和临时文件
+global-exclude *.pyc
+global-exclude *.pyo
+global-exclude *.pyd
+global-exclude __pycache__
+global-exclude .DS_Store
+global-exclude *.so