fastapi-process-restarter 0.1.0__tar.gz

fastapi_process_restarter-0.1.0/PKG-INFO

@@ -0,0 +1,105 @@
+Metadata-Version: 2.4
+Name: fastapi-process-restarter
+Version: 0.1.0
+Summary: A FastAPI based wrapper to auto-run and API-restart any terminal command.
+Author-email: Developer <dev@example.com>
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: fastapi>=0.90.0
+Requires-Dist: uvicorn>=0.20.0
+
+# FastAPI Process Restarter
+
+一个基于 FastAPI 的通用进程管理和重启工具，支持跨平台（Linux/macOS/Windows）。
+
+## 功能特性
+
+- 🚀 **一键重启**: 通过 HTTP API 重启任何命令/脚本
+- 🖥️ **跨平台支持**: 原生兼容 Linux、macOS 和 Windows
+- 📊 **状态监控**: 实时查看进程运行状态和 PID
+- 🧩 **易于集成**: 可作为子应用挂载到现有 FastAPI 项目
+- 🔧 **CLI 工具**: 提供命令行工具，开箱即用
+
+## 安装
+
+```bash
+pip install fastapi-process-restarter
+```
+
+## 使用方法
+
+### 方式一：命令行工具 (CLI)
+
+安装后，直接在终端使用 `restarter` 命令：
+
+```bash
+# 基本用法
+restarter --cmd "python main.py"
+
+# 指定端口
+restarter --cmd "python main.py" --port 9000
+
+# 指定监听地址
+restarter --cmd "node server.js" --host 127.0.0.1 --port 8080
+```
+
+API 端点：
+- `POST /restart` - 重启进程
+- `GET /status` - 获取进程状态
+
+示例：
+```bash
+# 重启进程
+curl -X POST http://localhost:8080/restart
+
+# 查看状态
+curl http://localhost:8080/status
+```
+
+### 方式二：Python API 集成
+
+在现有 FastAPI 项目中作为子应用挂载：
+
+```python
+from fastapi import FastAPI
+from process_restarter import create_app
+
+# 你的主应用
+main_app = FastAPI()
+
+@main_app.get("/")
+def home():
+    return {"message": "Hello World"}
+
+# 挂载进程重启器
+cmd_app = create_app(cmd="node server.js")
+main_app.mount("/subsystem", cmd_app)
+
+# 现在可以通过 POST /subsystem/restart 重启 node server.js
+```
+
+也可以直接使用 `ProcessManager`：
+
+```python
+from process_restarter import ProcessManager
+
+manager = ProcessManager(cmd="python worker.py")
+manager.start()      # 启动进程
+manager.restart()    # 重启进程
+manager.stop()       # 停止进程
+```
+
+## 技术细节
+
+- **跨平台进程管理**: 
+  - Linux/macOS: 使用 `os.setsid` 创建进程组
+  - Windows: 使用 `CREATE_NEW_PROCESS_GROUP` 创建进程组
+- **生命周期管理**: 使用 FastAPI `@asynccontextmanager` 确保程序退出时子进程被清理
+- **日志桥接**: 子进程输出实时转发到主进程 stdout
+
+## 许可证
+
+MIT License

fastapi_process_restarter-0.1.0/README.md

@@ -0,0 +1,92 @@
+# FastAPI Process Restarter
+
+一个基于 FastAPI 的通用进程管理和重启工具，支持跨平台（Linux/macOS/Windows）。
+
+## 功能特性
+
+- 🚀 **一键重启**: 通过 HTTP API 重启任何命令/脚本
+- 🖥️ **跨平台支持**: 原生兼容 Linux、macOS 和 Windows
+- 📊 **状态监控**: 实时查看进程运行状态和 PID
+- 🧩 **易于集成**: 可作为子应用挂载到现有 FastAPI 项目
+- 🔧 **CLI 工具**: 提供命令行工具，开箱即用
+
+## 安装
+
+```bash
+pip install fastapi-process-restarter
+```
+
+## 使用方法
+
+### 方式一：命令行工具 (CLI)
+
+安装后，直接在终端使用 `restarter` 命令：
+
+```bash
+# 基本用法
+restarter --cmd "python main.py"
+
+# 指定端口
+restarter --cmd "python main.py" --port 9000
+
+# 指定监听地址
+restarter --cmd "node server.js" --host 127.0.0.1 --port 8080
+```
+
+API 端点：
+- `POST /restart` - 重启进程
+- `GET /status` - 获取进程状态
+
+示例：
+```bash
+# 重启进程
+curl -X POST http://localhost:8080/restart
+
+# 查看状态
+curl http://localhost:8080/status
+```
+
+### 方式二：Python API 集成
+
+在现有 FastAPI 项目中作为子应用挂载：
+
+```python
+from fastapi import FastAPI
+from process_restarter import create_app
+
+# 你的主应用
+main_app = FastAPI()
+
+@main_app.get("/")
+def home():
+    return {"message": "Hello World"}
+
+# 挂载进程重启器
+cmd_app = create_app(cmd="node server.js")
+main_app.mount("/subsystem", cmd_app)
+
+# 现在可以通过 POST /subsystem/restart 重启 node server.js
+```
+
+也可以直接使用 `ProcessManager`：
+
+```python
+from process_restarter import ProcessManager
+
+manager = ProcessManager(cmd="python worker.py")
+manager.start()      # 启动进程
+manager.restart()    # 重启进程
+manager.stop()       # 停止进程
+```
+
+## 技术细节
+
+- **跨平台进程管理**: 
+  - Linux/macOS: 使用 `os.setsid` 创建进程组
+  - Windows: 使用 `CREATE_NEW_PROCESS_GROUP` 创建进程组
+- **生命周期管理**: 使用 FastAPI `@asynccontextmanager` 确保程序退出时子进程被清理
+- **日志桥接**: 子进程输出实时转发到主进程 stdout
+
+## 许可证
+
+MIT License

fastapi_process_restarter-0.1.0/fastapi_process_restarter.egg-info/PKG-INFO

@@ -0,0 +1,105 @@
+Metadata-Version: 2.4
+Name: fastapi-process-restarter
+Version: 0.1.0
+Summary: A FastAPI based wrapper to auto-run and API-restart any terminal command.
+Author-email: Developer <dev@example.com>
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: fastapi>=0.90.0
+Requires-Dist: uvicorn>=0.20.0
+
+# FastAPI Process Restarter
+
+一个基于 FastAPI 的通用进程管理和重启工具，支持跨平台（Linux/macOS/Windows）。
+
+## 功能特性
+
+- 🚀 **一键重启**: 通过 HTTP API 重启任何命令/脚本
+- 🖥️ **跨平台支持**: 原生兼容 Linux、macOS 和 Windows
+- 📊 **状态监控**: 实时查看进程运行状态和 PID
+- 🧩 **易于集成**: 可作为子应用挂载到现有 FastAPI 项目
+- 🔧 **CLI 工具**: 提供命令行工具，开箱即用
+
+## 安装
+
+```bash
+pip install fastapi-process-restarter
+```
+
+## 使用方法
+
+### 方式一：命令行工具 (CLI)
+
+安装后，直接在终端使用 `restarter` 命令：
+
+```bash
+# 基本用法
+restarter --cmd "python main.py"
+
+# 指定端口
+restarter --cmd "python main.py" --port 9000
+
+# 指定监听地址
+restarter --cmd "node server.js" --host 127.0.0.1 --port 8080
+```
+
+API 端点：
+- `POST /restart` - 重启进程
+- `GET /status` - 获取进程状态
+
+示例：
+```bash
+# 重启进程
+curl -X POST http://localhost:8080/restart
+
+# 查看状态
+curl http://localhost:8080/status
+```
+
+### 方式二：Python API 集成
+
+在现有 FastAPI 项目中作为子应用挂载：
+
+```python
+from fastapi import FastAPI
+from process_restarter import create_app
+
+# 你的主应用
+main_app = FastAPI()
+
+@main_app.get("/")
+def home():
+    return {"message": "Hello World"}
+
+# 挂载进程重启器
+cmd_app = create_app(cmd="node server.js")
+main_app.mount("/subsystem", cmd_app)
+
+# 现在可以通过 POST /subsystem/restart 重启 node server.js
+```
+
+也可以直接使用 `ProcessManager`：
+
+```python
+from process_restarter import ProcessManager
+
+manager = ProcessManager(cmd="python worker.py")
+manager.start()      # 启动进程
+manager.restart()    # 重启进程
+manager.stop()       # 停止进程
+```
+
+## 技术细节
+
+- **跨平台进程管理**: 
+  - Linux/macOS: 使用 `os.setsid` 创建进程组
+  - Windows: 使用 `CREATE_NEW_PROCESS_GROUP` 创建进程组
+- **生命周期管理**: 使用 FastAPI `@asynccontextmanager` 确保程序退出时子进程被清理
+- **日志桥接**: 子进程输出实时转发到主进程 stdout
+
+## 许可证
+
+MIT License

fastapi_process_restarter-0.1.0/fastapi_process_restarter.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+README.md
+pyproject.toml
+fastapi_process_restarter.egg-info/PKG-INFO
+fastapi_process_restarter.egg-info/SOURCES.txt
+fastapi_process_restarter.egg-info/dependency_links.txt
+fastapi_process_restarter.egg-info/entry_points.txt
+fastapi_process_restarter.egg-info/requires.txt
+fastapi_process_restarter.egg-info/top_level.txt
+process_restarter/__init__.py
+process_restarter/api.py
+process_restarter/cli.py
+process_restarter/manager.py

fastapi_process_restarter-0.1.0/fastapi_process_restarter.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

fastapi_process_restarter-0.1.0/fastapi_process_restarter.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+restarter = process_restarter.cli:main

fastapi_process_restarter-0.1.0/fastapi_process_restarter.egg-info/requires.txt

@@ -0,0 +1,2 @@
+fastapi>=0.90.0
+uvicorn>=0.20.0

fastapi_process_restarter-0.1.0/fastapi_process_restarter.egg-info/top_level.txt

@@ -0,0 +1 @@
+process_restarter

fastapi_process_restarter-0.1.0/process_restarter/__init__.py

@@ -0,0 +1,4 @@
+from .manager import ProcessManager
+from .api import create_app
+
+__version__ = "0.1.0"

fastapi_process_restarter-0.1.0/process_restarter/api.py

@@ -0,0 +1,29 @@
+from contextlib import asynccontextmanager
+from fastapi import FastAPI
+from .manager import ProcessManager
+
+
+def create_app(cmd: str) -> FastAPI:
+    manager = ProcessManager(cmd)
+
+    # FastAPI 现代生命周期管理
+    @asynccontextmanager
+    async def lifespan(app: FastAPI):
+        manager.start()  # 启动时运行
+        yield
+        manager.stop()  # 退出时清理
+
+    app = FastAPI(title="Process Restarter API", lifespan=lifespan)
+
+    @app.post("/restart")
+    async def restart():
+        manager.restart()
+        return {"status": "restarting", "cmd": cmd, "new_pid": manager.proc.pid}
+
+    @app.get("/status")
+    async def status():
+        is_running = manager.proc is not None and manager.proc.poll() is None
+        pid = manager.proc.pid if is_running else None
+        return {"running": is_running, "pid": pid}
+
+    return app

fastapi_process_restarter-0.1.0/process_restarter/cli.py

@@ -0,0 +1,27 @@
+import argparse
+import uvicorn
+from .api import create_app
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Run a command with a FastAPI restart endpoint."
+    )
+    parser.add_argument(
+        "-c", "--cmd", required=True, help="The command to run (e.g., 'python main.py')"
+    )
+    parser.add_argument(
+        "--host", default="0.0.0.0", help="API Host (default: 0.0.0.0)"
+    )
+    parser.add_argument(
+        "-p", "--port", type=int, default=8080, help="API Port (default: 8080)"
+    )
+
+    args = parser.parse_args()
+
+    app = create_app(args.cmd)
+    uvicorn.run(app, host=args.host, port=args.port)
+
+
+if __name__ == "__main__":
+    main()

fastapi_process_restarter-0.1.0/process_restarter/manager.py

@@ -0,0 +1,62 @@
+import os
+import subprocess
+import sys
+import threading
+import signal
+import platform
+
+
+class ProcessManager:
+    def __init__(self, cmd: str):
+        self.cmd = cmd
+        self.proc = None
+
+    def log_bridge(self, pipe):
+        """实时将子进程日志写到主进程的 stdout"""
+        if not pipe:
+            return
+        for line in iter(pipe.readline, b""):
+            sys.stdout.buffer.write(line)
+            sys.stdout.buffer.flush()
+
+    def start(self):
+        print(f"[@] Starting command: {self.cmd}")
+        kwargs = {
+            "shell": True,
+            "stdout": subprocess.PIPE,
+            "stderr": subprocess.STDOUT,
+        }
+
+        # 跨平台进程组处理
+        if platform.system() != "Windows":
+            kwargs["preexec_fn"] = os.setsid
+        else:
+            kwargs["creationflags"] = subprocess.CREATE_NEW_PROCESS_GROUP
+
+        self.proc = subprocess.Popen(self.cmd, **kwargs)
+
+        # 异步读取日志
+        threading.Thread(
+            target=self.log_bridge, args=(self.proc.stdout,), daemon=True
+        ).start()
+
+    def stop(self):
+        if self.proc:
+            print("[!] Stopping process...")
+            try:
+                if platform.system() != "Windows":
+                    os.killpg(os.getpgid(self.proc.pid), signal.SIGKILL)
+                else:
+                    # Windows 下彻底杀死进程树
+                    subprocess.run(
+                        ["taskkill", "/F", "/T", "/PID", str(self.proc.pid)],
+                        stdout=subprocess.DEVNULL,
+                        stderr=subprocess.DEVNULL,
+                    )
+            except Exception as e:
+                print(f"[x] Error stopping process: {e}")
+            self.proc = None
+
+    def restart(self):
+        self.stop()
+        self.start()

fastapi_process_restarter-0.1.0/pyproject.toml

@@ -0,0 +1,25 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "fastapi-process-restarter"
+version = "0.1.0"
+authors = [
+  { name="Developer", email="dev@example.com" },
+]
+description = "A FastAPI based wrapper to auto-run and API-restart any terminal command."
+readme = "README.md"
+requires-python = ">=3.7"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "fastapi>=0.90.0",
+    "uvicorn>=0.20.0"
+]
+
+[project.scripts]
+restarter = "process_restarter.cli:main"

fastapi_process_restarter-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+