celestialflow 3.0.1__tar.gz → 3.0.3__tar.gz

{celestialflow-3.0.1/src/celestialflow.egg-info → celestialflow-3.0.3}/PKG-INFO

@@ -1,33 +1,17 @@
 Metadata-Version: 2.4
 Name: celestialflow
-Version: 3.0.1
-Summary: A flexible DAG-based task orchestration framework.
+Version: 3.0.3
+Summary: A flexible GRAPH-based task orchestration framework.
 Author-email: Mr-xiaotian <mingxiaomingtian@gmail.com>
-License: MIT License
-        
-        Copyright (c) 2025 Mr-xiaotian
-        
-        Permission is hereby granted, free of charge, to any person obtaining a copy
-        of this software and associated documentation files (the "Software"), to deal
-        in the Software without restriction, including without limitation the rights
-        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-        copies of the Software, and to permit persons to whom the Software is
-        furnished to do so, subject to the following conditions:
-        
-        The above copyright notice and this permission notice shall be included in all
-        copies or substantial portions of the Software.
-        
-        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-        SOFTWARE.
-        
+License: MIT
 Project-URL: Homepage, https://github.com/Mr-xiaotian/CelestialFlow
 Project-URL: Bug Tracker, https://github.com/Mr-xiaotian/CelestialFlow/issues
 Keywords: workflow,task,graph,async,CelestialFlow
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Framework :: FastAPI
+Classifier: Topic :: Software Development :: Libraries
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 Requires-Dist: tqdm
@@ -37,12 +21,20 @@ Requires-Dist: uvicorn
 Requires-Dist: requests
 Requires-Dist: networkx
 Requires-Dist: redis
-Requires-Dist: httpx
 Requires-Dist: jinja2
 
 # CelestialFlow ——一个轻量级、可并行、基于图结构的 Python 任务调度框架
 
-![](img/startup.png)
+<p align="center">
+  <img src="img/startup.png" width="1080" alt="CelestialFlow Logo">
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/celestialflow/"><img src="https://badge.fury.io/py/celestialflow.svg"></a>
+  <a href="https://pepy.tech/projects/celestialflow"><img src="https://static.pepy.tech/personalized-badge/celestialflow?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=GREEN&left_text=downloads"></a>
+  <!-- <a href="https://pypi.org/project/celestialflow/"><img src="https://img.shields.io/pypi/l/celestialflow.svg"></a>
+  <a href="https://pypi.org/project/celestialflow/"><img src="https://img.shields.io/pypi/pyversions/celestialflow.svg"></a> -->
+</p>
 
 **CelestialFlow**是一个基于节点拼接的任务流调度框架。
 
@@ -68,17 +60,12 @@ TaskGraph 能构建完整的 **有向图结构（Directed Graph）**，不仅支
 
 本节将引导你快速安装并运行 **TaskGraph**，通过示例体验其任务图调度机制。
 
+### （可选）创建独立虚拟环境
 
-### 克隆项目并创建虚拟环境
-
-首先从 GitHub 拉取代码仓库，并创建隔离环境以防依赖冲突。
+建议在独立环境中使用，以避免与其他项目依赖冲突。
 
 ```bash
-# 克隆项目
-git clone https://github.com/yourname/TaskGraph.git
-cd TaskGraph
-
-# (可选) 用mamba创建虚拟环境
+# 使用 mamba 创建环境
 mamba create -n celestialflow_env python=3.10
 mamba activate celestialflow_env
 ```
@@ -87,23 +74,34 @@ mamba activate celestialflow_env
 
 👉 [miniforge/Releases](https://github.com/conda-forge/miniforge/releases)
 
-### 安装依赖与环境初始化
+### 安装 CelestialFlow
+
+CelestialFlow 已发布至 [PyPI](https://pypi.org/project/celestialflow/)，
+可以直接通过 `pip` 安装，无需克隆源码。
 
 ```bash
-pip install .
+# 直接安装最新版
+pip install celestialflow
 ```
 
-或开发模式安装（如果你打算修改代码并实时看到结果）：
+不过如果你想要运行之后的测试代码，亦或者想使用基于Go语言的go_worker程序，那么还是需要clone项目
 
 ```bash
-pip install -e .
+# 克隆项目
+git clone https://github.com/yourname/TaskGraph.git
+cd TaskGraph
+pip install .
 ```
 
 ### 启动 Web 可视化（可选）
 
-Web监视界面并不是必须的，但页面设计还不错，推荐使用:
+Web监视界面并不是必须的，但可以通过网页获得任务运行的更多信息，推荐使用:
 
 ```bash
+# 如果你pip了项目，可以在当前虚拟环境下可以直接使用命令celestialflow-web
+celestialflow-web 5005
+
+# 如果你直接clone并cd进入项目目录，那么需要运行py文件
 python src/celestialflow/task_web.py 5005 
 ```
 
@@ -130,12 +128,6 @@ pytest tests/test_nodes.py::test_splitter_1
 pip install pytest pytest-asyncio
 ```
 
-- test_nodes_1() 在一个简单的树状任务模型下，对比了四种运行组合（节点模式：serial / process × 执行模式：serial / thread），以测试不同调度策略下的整体性能差异。图结构如下:
-    ```
-    +----------------------------------------------------------------------+
-    | Stage_A (stage_mode: serial, func: sleep_random_A)                   |
-    | ╘-->Stage_B (stage_mode: serial, func: sleep_random_B)               |
-
 - test_graph_1() 在一个简单的树状任务模型下，对比了四种运行组合（节点模式：serial / process × 执行模式：serial / thread），以测试不同调度策略下的整体性能差异。图结构如下:
     ```
     +----------------------------------------------------------------------+
@@ -165,11 +157,12 @@ pip install pytest pytest-asyncio
 ### 我还想了解更多
 
 你可以继续运行更多的测试代码，这里有介绍每个测试文件与里面的测试函数:
-[Test RREADME.md](tests/README.md)
+
+[Test RREADME.md(完善中)](tests/README.md)
 
 你也可以了解具体的项目文件，以下文档会帮助你:
 
-[Src README.md](src\celestialflow/README.md)
+[Src README.md(完善中)](src\celestialflow/README.md)
 
 如果你想得到一个最简单的可运行代码:
 
@@ -200,23 +193,23 @@ if __name__ == "__main__":
 
 ## 环境要求（Requirements）
 
-**CelestialFlow** 依赖以下主要组件，请确保你的环境满足最低版本要求。
-
-| 依赖包              | 说明                                  |
-| ---------------- | ----------------------------------- |
-| **Python ≥ 3.8** | 运行环境                                |
-| **fastapi**      | Web 服务接口框架                          |
-| **uvicorn**      | FastAPI 的高性能 ASGI 服务器               |
-| **redis**        | 可选组件，用于分布式任务通信（TaskRedisTransfer） |
-| **pytest**       | 单元测试框架                              |
-| **multiprocess** | 多进程支持库                              |
-| **rich**         | 终端输出与日志美化                           |
-| **jinja2**       | FastAPI 模板引擎                        |
+**CelestialFlow** 基于 Python 3.8+，并依赖以下核心组件。  
+请确保你的环境能够正常安装这些依赖（`pip install celestialflow` 会自动安装）。
+
+| 依赖包           | 说明 |
+| ---------------- | ---- |
+| **Python ≥ 3.8** | 运行环境，建议使用 3.10 及以上版本 |
+| **tqdm**         | 控制台进度条显示，用于任务执行可视化 |
+| **loguru**       | 高性能日志系统，支持多进程安全输出 |
+| **fastapi**      | Web 服务接口框架（用于任务可视化与远程控制） |
+| **uvicorn**      | FastAPI 的高性能 ASGI 服务器 |
+| **requests**     | HTTP 客户端库，用于任务状态上报与远程调用 |
+| **networkx**     | 任务图（TaskGraph）结构与依赖分析 |
+| **redis**        | 可选组件，用于分布式任务通信（`TaskRedisTransfer` 模块） |
+| **jinja2**       | FastAPI 模板引擎，用于 Web 可视化界面渲染 |
 
 ## 项目结构（Project Structure）
 
-以下视图由我的另一个项目[CelestialVault](https://github.com/Mr-xiaotian/CelestialVault)中inst_file生成。
-
 ```
 📁 CelestialFlow	(24MB 349KB 185B)
     📁 experiment   	(9KB 455B)
@@ -278,6 +271,8 @@ if __name__ == "__main__":
     🐍 setup.py  	(550B)
 ```
 
+(该视图由我的另一个项目[CelestialVault](https://github.com/Mr-xiaotian/CelestialVault)中inst_file生成。)
+
 ## 更新日志（Change Log）
 
 - [2021] 建立一个支持多线程与单线程处理函数的类
@@ -292,10 +287,14 @@ if __name__ == "__main__":
 - [6/14/2025] 支持forest结构, 即可有多个根节点
 - [6/16/2025] 多轮评测后, 当前框架已支持完整有向图结构, 故将TaskTree改名为TaskGraph
 
+## Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=Mr-xiaotian/CelestialFlow&type=Date)](https://star-history.com/#Mr-xiaotian/CelestialFlow&Date)
+
 ## License
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
 
-## 作者
+## 作者(Author)
 Author: Mr-xiaotian 
 Email: mingxiaomingtian@gmail.com  
 Project Link: [https://github.com/Mr-xiaotian/CelestialFlow](https://github.com/Mr-xiaotian/CelestialFlow)

{celestialflow-3.0.1 → celestialflow-3.0.3}/README.md

@@ -1,6 +1,15 @@
 # CelestialFlow ——一个轻量级、可并行、基于图结构的 Python 任务调度框架
 
-![](img/startup.png)
+<p align="center">
+  <img src="img/startup.png" width="1080" alt="CelestialFlow Logo">
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/celestialflow/"><img src="https://badge.fury.io/py/celestialflow.svg"></a>
+  <a href="https://pepy.tech/projects/celestialflow"><img src="https://static.pepy.tech/personalized-badge/celestialflow?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=GREEN&left_text=downloads"></a>
+  <!-- <a href="https://pypi.org/project/celestialflow/"><img src="https://img.shields.io/pypi/l/celestialflow.svg"></a>
+  <a href="https://pypi.org/project/celestialflow/"><img src="https://img.shields.io/pypi/pyversions/celestialflow.svg"></a> -->
+</p>
 
 **CelestialFlow**是一个基于节点拼接的任务流调度框架。
 
@@ -26,17 +35,12 @@ TaskGraph 能构建完整的 **有向图结构（Directed Graph）**，不仅支
 
 本节将引导你快速安装并运行 **TaskGraph**，通过示例体验其任务图调度机制。
 
+### （可选）创建独立虚拟环境
 
-### 克隆项目并创建虚拟环境
-
-首先从 GitHub 拉取代码仓库，并创建隔离环境以防依赖冲突。
+建议在独立环境中使用，以避免与其他项目依赖冲突。
 
 ```bash
-# 克隆项目
-git clone https://github.com/yourname/TaskGraph.git
-cd TaskGraph
-
-# (可选) 用mamba创建虚拟环境
+# 使用 mamba 创建环境
 mamba create -n celestialflow_env python=3.10
 mamba activate celestialflow_env
 ```
@@ -45,23 +49,34 @@ mamba activate celestialflow_env
 
 👉 [miniforge/Releases](https://github.com/conda-forge/miniforge/releases)
 
-### 安装依赖与环境初始化
+### 安装 CelestialFlow
+
+CelestialFlow 已发布至 [PyPI](https://pypi.org/project/celestialflow/)，
+可以直接通过 `pip` 安装，无需克隆源码。
 
 ```bash
-pip install .
+# 直接安装最新版
+pip install celestialflow
 ```
 
-或开发模式安装（如果你打算修改代码并实时看到结果）：
+不过如果你想要运行之后的测试代码，亦或者想使用基于Go语言的go_worker程序，那么还是需要clone项目
 
 ```bash
-pip install -e .
+# 克隆项目
+git clone https://github.com/yourname/TaskGraph.git
+cd TaskGraph
+pip install .
 ```
 
 ### 启动 Web 可视化（可选）
 
-Web监视界面并不是必须的，但页面设计还不错，推荐使用:
+Web监视界面并不是必须的，但可以通过网页获得任务运行的更多信息，推荐使用:
 
 ```bash
+# 如果你pip了项目，可以在当前虚拟环境下可以直接使用命令celestialflow-web
+celestialflow-web 5005
+
+# 如果你直接clone并cd进入项目目录，那么需要运行py文件
 python src/celestialflow/task_web.py 5005 
 ```
 
@@ -88,12 +103,6 @@ pytest tests/test_nodes.py::test_splitter_1
 pip install pytest pytest-asyncio
 ```
 
-- test_nodes_1() 在一个简单的树状任务模型下，对比了四种运行组合（节点模式：serial / process × 执行模式：serial / thread），以测试不同调度策略下的整体性能差异。图结构如下:
-    ```
-    +----------------------------------------------------------------------+
-    | Stage_A (stage_mode: serial, func: sleep_random_A)                   |
-    | ╘-->Stage_B (stage_mode: serial, func: sleep_random_B)               |
-
 - test_graph_1() 在一个简单的树状任务模型下，对比了四种运行组合（节点模式：serial / process × 执行模式：serial / thread），以测试不同调度策略下的整体性能差异。图结构如下:
     ```
     +----------------------------------------------------------------------+
@@ -123,11 +132,12 @@ pip install pytest pytest-asyncio
 ### 我还想了解更多
 
 你可以继续运行更多的测试代码，这里有介绍每个测试文件与里面的测试函数:
-[Test RREADME.md](tests/README.md)
+
+[Test RREADME.md(完善中)](tests/README.md)
 
 你也可以了解具体的项目文件，以下文档会帮助你:
 
-[Src README.md](src\celestialflow/README.md)
+[Src README.md(完善中)](src\celestialflow/README.md)
 
 如果你想得到一个最简单的可运行代码:
 
@@ -158,23 +168,23 @@ if __name__ == "__main__":
 
 ## 环境要求（Requirements）
 
-**CelestialFlow** 依赖以下主要组件，请确保你的环境满足最低版本要求。
-
-| 依赖包              | 说明                                  |
-| ---------------- | ----------------------------------- |
-| **Python ≥ 3.8** | 运行环境                                |
-| **fastapi**      | Web 服务接口框架                          |
-| **uvicorn**      | FastAPI 的高性能 ASGI 服务器               |
-| **redis**        | 可选组件，用于分布式任务通信（TaskRedisTransfer） |
-| **pytest**       | 单元测试框架                              |
-| **multiprocess** | 多进程支持库                              |
-| **rich**         | 终端输出与日志美化                           |
-| **jinja2**       | FastAPI 模板引擎                        |
+**CelestialFlow** 基于 Python 3.8+，并依赖以下核心组件。  
+请确保你的环境能够正常安装这些依赖（`pip install celestialflow` 会自动安装）。
+
+| 依赖包           | 说明 |
+| ---------------- | ---- |
+| **Python ≥ 3.8** | 运行环境，建议使用 3.10 及以上版本 |
+| **tqdm**         | 控制台进度条显示，用于任务执行可视化 |
+| **loguru**       | 高性能日志系统，支持多进程安全输出 |
+| **fastapi**      | Web 服务接口框架（用于任务可视化与远程控制） |
+| **uvicorn**      | FastAPI 的高性能 ASGI 服务器 |
+| **requests**     | HTTP 客户端库，用于任务状态上报与远程调用 |
+| **networkx**     | 任务图（TaskGraph）结构与依赖分析 |
+| **redis**        | 可选组件，用于分布式任务通信（`TaskRedisTransfer` 模块） |
+| **jinja2**       | FastAPI 模板引擎，用于 Web 可视化界面渲染 |
 
 ## 项目结构（Project Structure）
 
-以下视图由我的另一个项目[CelestialVault](https://github.com/Mr-xiaotian/CelestialVault)中inst_file生成。
-
 ```
 📁 CelestialFlow	(24MB 349KB 185B)
     📁 experiment   	(9KB 455B)
@@ -236,6 +246,8 @@ if __name__ == "__main__":
     🐍 setup.py  	(550B)
 ```
 
+(该视图由我的另一个项目[CelestialVault](https://github.com/Mr-xiaotian/CelestialVault)中inst_file生成。)
+
 ## 更新日志（Change Log）
 
 - [2021] 建立一个支持多线程与单线程处理函数的类
@@ -250,10 +262,14 @@ if __name__ == "__main__":
 - [6/14/2025] 支持forest结构, 即可有多个根节点
 - [6/16/2025] 多轮评测后, 当前框架已支持完整有向图结构, 故将TaskTree改名为TaskGraph
 
+## Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=Mr-xiaotian/CelestialFlow&type=Date)](https://star-history.com/#Mr-xiaotian/CelestialFlow&Date)
+
 ## License
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
 
-## 作者
+## 作者(Author)
 Author: Mr-xiaotian 
 Email: mingxiaomingtian@gmail.com  
 Project Link: [https://github.com/Mr-xiaotian/CelestialFlow](https://github.com/Mr-xiaotian/CelestialFlow)

{celestialflow-3.0.1 → celestialflow-3.0.3}/pyproject.toml

@@ -4,11 +4,11 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "celestialflow"                   
-version = "3.0.1"                         
-description = "A flexible DAG-based task orchestration framework."
+version = "3.0.3"                         
+description = "A flexible GRAPH-based task orchestration framework."
 readme = "README.md"               
-license = { file = "LICENSE" }    
-authors = [{ name = "Mr-xiaotian", email = "mingxiaomingtian@gmail.com " }]
+license = { text = "MIT" }    
+authors = [{ name = "Mr-xiaotian", email = "mingxiaomingtian@gmail.com" }]
 keywords = ["workflow", "task", "graph", "async", "CelestialFlow"]
 requires-python = ">=3.8"
 
@@ -20,13 +20,26 @@ dependencies = [
     "requests",
     "networkx",
     "redis",
-    "httpx",
     "jinja2",
 ]
 
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Framework :: FastAPI",
+    "Topic :: Software Development :: Libraries",
+]
+
 [project.urls]
 "Homepage" = "https://github.com/Mr-xiaotian/CelestialFlow"
 "Bug Tracker" = "https://github.com/Mr-xiaotian/CelestialFlow/issues"
 
+[project.scripts]
+celestialflow-web = "celestialflow.task_web:main_entry"
+
 [tool.setuptools]
-license-files = []
+license-files = []
+
+[tool.setuptools.package-data]
+"celestialflow" = ["templates/*.html", "static/**/*"]

{celestialflow-3.0.1 → celestialflow-3.0.3}/src/celestialflow/__init__.py

@@ -1,9 +1,3 @@
-# -*- coding: utf-8 -*-
-# 版本 3.01
-# 作者：Mr-xiaotian, GPT-4o, GPT-5
-# 时间：11/5/2025
-# Github: https://github.com/Mr-xiaotian/CelestialFlow
-
 from .task_graph import TaskGraph
 from .task_manage import TaskManager
 from .task_nodes import TaskSplitter, TaskRedisTransfer