celestialflow 3.0.1__tar.gz → 3.0.2__tar.gz

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

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: celestialflow
-Version: 3.0.1
-Summary: A flexible DAG-based task orchestration framework.
+Version: 3.0.2
+Summary: A flexible GRAPH-based task orchestration framework.
 Author-email: Mr-xiaotian <mingxiaomingtian@gmail.com>
 License: MIT License
         
@@ -68,36 +68,32 @@ TaskGraph 能构建完整的 **有向图结构（Directed Graph）**，不仅支
 
 本节将引导你快速安装并运行 **TaskGraph**，通过示例体验其任务图调度机制。
 
+### 🚀 安装 CelestialFlow
 
-### 克隆项目并创建虚拟环境
-
-首先从 GitHub 拉取代码仓库，并创建隔离环境以防依赖冲突。
+CelestialFlow 已发布至 [PyPI](https://pypi.org/project/celestialflow/)，
+可以直接通过 `pip` 安装，无需克隆源码。
 
 ```bash
-# 克隆项目
-git clone https://github.com/yourname/TaskGraph.git
-cd TaskGraph
-
-# (可选) 用mamba创建虚拟环境
-mamba create -n celestialflow_env python=3.10
-mamba activate celestialflow_env
+# 直接安装最新版
+pip install celestialflow
 ```
 
-如果你了解python的包管理工具Anaconda，那么mamba就是将其用C++实现的版本，相比原版有明显的速度提升。你可以在这里获取它的最新版:
-
-👉 [miniforge/Releases](https://github.com/conda-forge/miniforge/releases)
+### 🧩 （可选）创建独立虚拟环境
 
-### 安装依赖与环境初始化
+建议在独立环境中使用，以避免与其他项目依赖冲突。
 
 ```bash
-pip install .
+# 使用 mamba 创建环境
+mamba create -n celestialflow_env python=3.10
+mamba activate celestialflow_env
+
+# 然后安装
+pip install celestialflow
 ```
 
-或开发模式安装（如果你打算修改代码并实时看到结果）：
+如果你了解python的包管理工具Anaconda，那么mamba就是将其用C++实现的版本，相比原版有明显的速度提升。你可以在这里获取它的最新版:
 
-```bash
-pip install -e .
-```
+👉 [miniforge/Releases](https://github.com/conda-forge/miniforge/releases)
 
 ### 启动 Web 可视化（可选）
 
@@ -165,6 +161,7 @@ pip install pytest pytest-asyncio
 ### 我还想了解更多
 
 你可以继续运行更多的测试代码，这里有介绍每个测试文件与里面的测试函数:
+
 [Test RREADME.md](tests/README.md)
 
 你也可以了解具体的项目文件，以下文档会帮助你:
@@ -200,18 +197,21 @@ 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 客户端库，用于任务状态上报与远程调用 |
+| **httpx**        | 异步 HTTP 客户端，支持更高性能的并发请求 |
+| **networkx**     | 任务图（TaskGraph）结构与依赖分析 |
+| **redis**        | 可选组件，用于分布式任务通信（`TaskRedisTransfer` 模块） |
+| **jinja2**       | FastAPI 模板引擎，用于 Web 可视化界面渲染 |
 
 ## 项目结构（Project Structure）
 

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

@@ -26,36 +26,32 @@ TaskGraph 能构建完整的 **有向图结构（Directed Graph）**，不仅支
 
 本节将引导你快速安装并运行 **TaskGraph**，通过示例体验其任务图调度机制。
 
+### 🚀 安装 CelestialFlow
 
-### 克隆项目并创建虚拟环境
-
-首先从 GitHub 拉取代码仓库，并创建隔离环境以防依赖冲突。
+CelestialFlow 已发布至 [PyPI](https://pypi.org/project/celestialflow/)，
+可以直接通过 `pip` 安装，无需克隆源码。
 
 ```bash
-# 克隆项目
-git clone https://github.com/yourname/TaskGraph.git
-cd TaskGraph
-
-# (可选) 用mamba创建虚拟环境
-mamba create -n celestialflow_env python=3.10
-mamba activate celestialflow_env
+# 直接安装最新版
+pip install celestialflow
 ```
 
-如果你了解python的包管理工具Anaconda，那么mamba就是将其用C++实现的版本，相比原版有明显的速度提升。你可以在这里获取它的最新版:
-
-👉 [miniforge/Releases](https://github.com/conda-forge/miniforge/releases)
+### 🧩 （可选）创建独立虚拟环境
 
-### 安装依赖与环境初始化
+建议在独立环境中使用，以避免与其他项目依赖冲突。
 
 ```bash
-pip install .
+# 使用 mamba 创建环境
+mamba create -n celestialflow_env python=3.10
+mamba activate celestialflow_env
+
+# 然后安装
+pip install celestialflow
 ```
 
-或开发模式安装（如果你打算修改代码并实时看到结果）：
+如果你了解python的包管理工具Anaconda，那么mamba就是将其用C++实现的版本，相比原版有明显的速度提升。你可以在这里获取它的最新版:
 
-```bash
-pip install -e .
-```
+👉 [miniforge/Releases](https://github.com/conda-forge/miniforge/releases)
 
 ### 启动 Web 可视化（可选）
 
@@ -123,6 +119,7 @@ pip install pytest pytest-asyncio
 ### 我还想了解更多
 
 你可以继续运行更多的测试代码，这里有介绍每个测试文件与里面的测试函数:
+
 [Test RREADME.md](tests/README.md)
 
 你也可以了解具体的项目文件，以下文档会帮助你:
@@ -158,18 +155,21 @@ 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 客户端库，用于任务状态上报与远程调用 |
+| **httpx**        | 异步 HTTP 客户端，支持更高性能的并发请求 |
+| **networkx**     | 任务图（TaskGraph）结构与依赖分析 |
+| **redis**        | 可选组件，用于分布式任务通信（`TaskRedisTransfer` 模块） |
+| **jinja2**       | FastAPI 模板引擎，用于 Web 可视化界面渲染 |
 
 ## 项目结构（Project Structure）
 

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

@@ -4,8 +4,8 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "celestialflow"                   
-version = "3.0.1"                         
-description = "A flexible DAG-based task orchestration framework."
+version = "3.0.2"                         
+description = "A flexible GRAPH-based task orchestration framework."
 readme = "README.md"               
 license = { file = "LICENSE" }    
 authors = [{ name = "Mr-xiaotian", email = "mingxiaomingtian@gmail.com " }]
@@ -28,5 +28,11 @@ dependencies = [
 "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.2}/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

celestialflow-3.0.2/src/celestialflow/static/css/base.css

@@ -0,0 +1,293 @@
+/* ================================
+  🌟 变量定义（全局色彩、间距等）
+================================ */
+:root {
+  --primary-color: #3b82f6;
+  --success-color: #10b981;
+  --warning-color: #f59e0b;
+  --danger-color: #ef4444;
+  --gray-light: #f3f4f6;
+  --gray-medium: #9ca3af;
+  --gray-dark: #4b5563;
+}
+
+/* ================================
+  🌟 全局重置 & 通用字体
+================================ */
+* {
+  margin: 0;
+  padding: 0;
+  box-sizing: border-box;
+  font-family: "Segoe UI", Tahoma, Geneva, Verdana, sans-serif;
+}
+
+body {
+  background-color: #f9fafb;
+  line-height: 1.5;
+}
+
+.container {
+  max-width: 1200px;
+  margin: 0 auto;
+  padding: 0 1rem;
+}
+
+/* ================================
+  🌟 头部样式
+================================ */
+header {
+  background-color: var(--primary-color);
+  color: white;
+  padding: 1rem 0;
+  box-shadow: 0 2px 10px rgba(0, 0, 0, 0.1);
+}
+
+.header-content {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  flex-wrap: wrap; /* 小屏自动换行 */
+  gap: 0.5rem; /* 可选：元素间距 */
+}
+
+
+/* ================================
+  🌟 标题 & 文本
+================================ */
+h1 {
+  font-size: 1.5rem;
+  font-weight: 700;
+  text-align: center;
+  color: #fff;
+  margin-bottom: 30px;
+}
+
+/* ================================
+  🌟 标题 & 文本
+================================ */
+.control-panel {
+  display: flex;
+  align-items: center;
+  gap: 1rem;
+}
+.refresh-container {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+}
+
+/* ================================
+  🌟 按钮 & 选择器
+================================ */
+button,
+select {
+  cursor: pointer;
+  padding: 0.25rem 0.75rem;
+  border-radius: 0.25rem;
+  border: 1px solid var(--gray-medium);
+}
+
+button {
+  color: white;
+  font-size: 0.875rem;
+  transition: background-color 0.2s;
+}
+
+select {
+  background-color: white;
+  height: 30px;
+}
+
+/* 按钮样式 */
+.btn-stop { background-color: var(--danger-color); color: white; height: 30px; }
+.btn-stop:hover { background-color: #dc2626; }
+
+/* 主题切换按钮 */
+#theme-toggle {
+  position: absolute;
+  right: 20px;
+  background-color: #374151;
+  color: white;
+  border: none;
+  border-radius: 20px;
+  padding: 5px 15px;
+  cursor: pointer;
+  transition: all 0.3s ease;
+}
+
+#theme-toggle:hover {
+  background-color: #3b6fd9;
+}
+
+/* ================================
+  🌟 Tabs & 选项卡样式
+================================ */
+.tabs {
+  display: flex;
+  border-bottom: 1px solid #e5e7eb;
+  margin: 1rem 0;
+}
+
+.tab-btn {
+  background: transparent;
+  border: none;
+  color: var(--gray-dark);
+  padding: 0.5rem 1rem;
+  border-bottom: 2px solid transparent;
+  margin-bottom: -1px;
+}
+
+.tab-btn.active {
+  color: var(--primary-color);
+  border-bottom-color: var(--primary-color);
+}
+
+.tab-btn:hover {
+  background-color: #f9fafb;
+}
+
+/* ================================
+  🌟 卡片布局样式
+================================ */
+.card {
+  background-color: white;
+  border-radius: 1rem;
+  box-shadow: 0 1px 3px rgba(0, 0, 0, 0.1);
+  padding: 24px;
+  transition: transform 0.2s ease;
+}
+
+.card:hover {
+  transform: translateY(-2px);
+  box-shadow: 0 6px 15px rgba(0, 0, 0, 0.1);
+}
+
+.card-header {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  margin-bottom: 0.75rem;
+}
+
+.card-title {
+  font-size: 1.25rem;
+  font-weight: 600;
+  padding-bottom: 1rem;
+}
+
+/* ================================
+  🌟 状态徽章
+================================ */
+.badge {
+  padding: 0.25rem 0.5rem;
+  border-radius: 0.25rem;
+  font-size: 0.75rem;
+  color: white;
+}
+
+.badge-inactive { background-color: var(--gray-medium); }
+.badge-running { background-color: var(--success-color); }
+.badge-completed { background-color: var(--gray-medium); }
+
+/* ================================
+  🌟 文字颜色辅助类
+================================ */
+.text-red { color: var(--danger-color); }
+.text-blue { color: var(--primary-color); }
+.text-green { color: var(--success-color); }
+.text-yellow { color: var(--warning-color); }
+.text-sm { font-size: 0.875rem; }
+.text-gray { color: var(--gray-medium); }
+
+/* ================================
+  🌟 响应式调整（移动设备）
+================================ */
+@media (max-width: 2048px) {
+  h1 {
+    width: 100%;
+    text-align: center; /* 或 center */
+  }
+  #theme-toggle {
+    position: static; /* 取消绝对定位 */
+    order: 3; /* 小屏下放到最后 */
+  }
+}
+
+/* ================================
+  🌟 暗黑模式
+================================ */
+.dark-theme {
+  background-color: #1a1a1a;
+  color: #e0e0e0;
+}
+
+.dark-theme body,
+.dark-theme .container {
+  background-color: #1a1a1a;
+  color: #e0e0e0;
+}
+
+.dark-theme header {
+  background-color: #1a1a1a; /* 深蓝灰 */
+  color: #f3f4f6;
+}
+
+.dark-theme h1 {
+  color: #f3f4f6;
+}
+
+.dark-theme .control-panel select,
+.dark-theme .control-panel button {
+  background-color: #374151;
+  color: #f3f4f6;
+  border: 1px solid #4b5563;
+}
+
+.dark-theme .btn-stop:hover { background-color: #4b5563; }
+
+.dark-theme #theme-toggle {
+  background-color: #3b6fd9;
+  color: #f3f4f6;
+  border: 1px solid #4b5563;
+}
+
+.dark-theme #theme-toggle:hover {
+  background-color: #4b5563;
+}
+
+.dark-theme .tabs {
+  border-bottom: 2px solid #374151;
+}
+
+.dark-theme .tab-btn {
+  color: #cbd5e1;
+}
+
+.dark-theme .tab-btn.active {
+  color: #3b82f6;
+  border-bottom: none;
+}
+
+.dark-theme .tab-btn:hover {
+  background-color: #2a2a2a;
+}
+
+.dark-theme .card {
+  background-color: #2a2a2a;
+  color: #e0e0e0;
+  box-shadow: 0 1px 4px rgba(0, 0, 0, 0.4);
+}
+
+.dark-theme .card-title {
+  color: #f3f4f6;
+}
+
+.dark-theme .badge-running { background-color: #16a34a; }
+.dark-theme .badge-inactive { background-color: #6b7280; }
+
+.dark-theme .text-gray { color: #9ca3af; }
+
+/* ================================
+  🌟 可选：全局辅助样式
+================================ */
+/* 用于辅助布局的工具类可以在此扩展，比如 flex、grid、gap 等 */