servly 0.1.0__tar.gz → 0.3.0__tar.gz

servly-0.3.0/PKG-INFO

@@ -0,0 +1,134 @@
+Metadata-Version: 2.4
+Name: servly
+Version: 0.3.0
+Summary: simple process manager
+Author-email: simpxx <simpxx@gmail.com>
+License: MIT
+Keywords: command-line,tool
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+Requires-Dist: pyyaml>=6.0.2
+Requires-Dist: rich>=14.0.0
+
+# SERVLY
+
+A simple process management tool for Linux, similar to PM2, designed to simplify application deployment and management.
+
+## Features
+
+- Start, stop, and restart services defined in a `servly.yml` configuration file
+- View real-time logs with service name highlighting
+- Automatic process supervision and PID management
+- Environment variable support
+- Simple YAML configuration
+
+## Installation
+
+```bash
+# Using pip
+pip install servly
+
+# From source
+git clone https://github.com/yourusername/servly.git
+cd servly
+pip install -e .
+```
+
+## Usage
+
+### Quick Start
+
+1. Create a `servly.yml` file in your project:
+
+```yaml
+# Basic format: service-name: command
+web-server: node server.js
+
+# Detailed format
+api:
+  cmd: python api.py
+  cwd: ./api
+  env:
+    NODE_ENV: production
+```
+
+2. Start your services:
+
+```bash
+servly start
+```
+
+### Core Commands
+
+- **Start Services**:
+  ```bash
+  servly start [all | service-name]
+  ```
+  Starts all services or a specific service by name.
+
+- **Stop Services**:
+  ```bash
+  servly stop [all | service-name]
+  ```
+  Stops all running services or a specific service by name.
+
+- **Restart Services**:
+  ```bash
+  servly restart [all | service-name]
+  ```
+  Restarts all services or a specific service by name.
+
+- **View Service Logs**:
+  ```bash
+  servly log [all | service-name]
+  ```
+  Shows logs in real-time (similar to `tail -f`).
+
+- **List Services**:
+  ```bash
+  servly list
+  ```
+  Shows status of all configured services.
+
+## Configuration
+
+### servly.yml
+
+The `servly.yml` file supports two formats:
+
+1. **Simple format**:
+   ```yaml
+   service-name: command to run
+   ```
+
+2. **Detailed format**:
+   ```yaml
+   service-name:
+     cmd: command to run
+     cwd: working directory (optional)
+     env:
+       ENV_VAR1: value1
+       ENV_VAR2: value2
+   ```
+
+**Note**: The name "servly" is reserved and cannot be used as a service name.
+
+### Directory Structure
+
+Servly creates a `.servly` directory to store runtime information:
+
+```
+.servly/
+├── logs/
+│   ├── [service-name]-out.log    # Standard output logs
+│   └── [service-name]-error.log  # Error logs
+├── pids/
+│   └── [service-name].pid        # Process ID files
+```
+
+## License
+
+MIT

servly-0.3.0/README.md

@@ -0,0 +1,119 @@
+# SERVLY
+
+A simple process management tool for Linux, similar to PM2, designed to simplify application deployment and management.
+
+## Features
+
+- Start, stop, and restart services defined in a `servly.yml` configuration file
+- View real-time logs with service name highlighting
+- Automatic process supervision and PID management
+- Environment variable support
+- Simple YAML configuration
+
+## Installation
+
+```bash
+# Using pip
+pip install servly
+
+# From source
+git clone https://github.com/yourusername/servly.git
+cd servly
+pip install -e .
+```
+
+## Usage
+
+### Quick Start
+
+1. Create a `servly.yml` file in your project:
+
+```yaml
+# Basic format: service-name: command
+web-server: node server.js
+
+# Detailed format
+api:
+  cmd: python api.py
+  cwd: ./api
+  env:
+    NODE_ENV: production
+```
+
+2. Start your services:
+
+```bash
+servly start
+```
+
+### Core Commands
+
+- **Start Services**:
+  ```bash
+  servly start [all | service-name]
+  ```
+  Starts all services or a specific service by name.
+
+- **Stop Services**:
+  ```bash
+  servly stop [all | service-name]
+  ```
+  Stops all running services or a specific service by name.
+
+- **Restart Services**:
+  ```bash
+  servly restart [all | service-name]
+  ```
+  Restarts all services or a specific service by name.
+
+- **View Service Logs**:
+  ```bash
+  servly log [all | service-name]
+  ```
+  Shows logs in real-time (similar to `tail -f`).
+
+- **List Services**:
+  ```bash
+  servly list
+  ```
+  Shows status of all configured services.
+
+## Configuration
+
+### servly.yml
+
+The `servly.yml` file supports two formats:
+
+1. **Simple format**:
+   ```yaml
+   service-name: command to run
+   ```
+
+2. **Detailed format**:
+   ```yaml
+   service-name:
+     cmd: command to run
+     cwd: working directory (optional)
+     env:
+       ENV_VAR1: value1
+       ENV_VAR2: value2
+   ```
+
+**Note**: The name "servly" is reserved and cannot be used as a service name.
+
+### Directory Structure
+
+Servly creates a `.servly` directory to store runtime information:
+
+```
+.servly/
+├── logs/
+│   ├── [service-name]-out.log    # Standard output logs
+│   └── [service-name]-error.log  # Error logs
+├── pids/
+│   └── [service-name].pid        # Process ID files
+```
+
+## License
+
+MIT

{servly-0.1.0 → servly-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "servly"
-version = "0.1.0"
+version = "0.3.0"
 description = "simple process manager"
 readme = "README.md"
 requires-python = ">=3.12"
@@ -18,9 +18,18 @@ classifiers = [
     "License :: OSI Approved :: MIT License",
     "Operating System :: OS Independent",
 ]
+dependencies = [
+    "pyyaml>=6.0.2",
+    "rich>=14.0.0",
+]
 
 [project.scripts]
-xm = "xm.cli:main"
+servly = "servly.cli:main"
 
 [tool.setuptools.packages.find]
-include = ["xm*"]
+include = ["servly*"]
+
+[dependency-groups]
+dev = [
+    "pytest>=8.3.5",
+]

servly-0.3.0/servly/__init__.py

@@ -0,0 +1,5 @@
+"""
+Servly - A simple process management tool.
+"""
+
+__version__ = "0.1.0"

servly-0.3.0/servly/cli.py

@@ -0,0 +1,270 @@
+#!/usr/bin/env python3
+"""
+Command-line interface for Servly process manager.
+使用Rich库进行终端输出格式化
+"""
+import os
+import sys
+import argparse
+import logging
+from pathlib import Path
+from typing import List, Dict, Optional
+
+from servly.service import ServiceManager
+from servly.logs import LogManager, Emojis
+from servly.logs import console, print_header, print_info, print_warning, print_error, print_success, print_service_table
+
+from rich.logging import RichHandler
+from rich.traceback import install
+from rich.markup import escape
+
+# 安装Rich的异常格式化器
+install()
+
+# 配置Rich日志处理
+logging.basicConfig(
+    level=logging.INFO,
+    format="%(message)s",
+    datefmt="[%X]",
+    handlers=[RichHandler(rich_tracebacks=True, markup=True)]
+)
+
+logger = logging.getLogger("servly")
+
+def setup_arg_parser() -> argparse.ArgumentParser:
+    """设置命令行参数解析器"""
+    parser = argparse.ArgumentParser(
+        description=f"{Emojis.SERVICE} Servly - Modern process manager",
+        formatter_class=argparse.RawDescriptionHelpFormatter
+    )
+    
+    # 全局参数
+    parser.add_argument('-f', '--config', 
+                      help='配置文件路径 (默认: servly.yml)',
+                      default='servly.yml')
+    
+    subparsers = parser.add_subparsers(dest='command', help='要执行的命令')
+    
+    # Start 命令
+    start_parser = subparsers.add_parser('start', help=f'{Emojis.START} 启动服务')
+    start_parser.add_argument('service', nargs='?', default='all', 
+                            help='服务名称或 "all" 启动所有服务')
+    
+    # Stop 命令
+    stop_parser = subparsers.add_parser('stop', help=f'{Emojis.STOP} 停止服务')
+    stop_parser.add_argument('service', nargs='?', default='all',
+                           help='服务名称或 "all" 停止所有服务')
+    
+    # Restart 命令
+    restart_parser = subparsers.add_parser('restart', help=f'{Emojis.RESTART} 重启服务')
+    restart_parser.add_argument('service', nargs='?', default='all',
+                              help='服务名称或 "all" 重启所有服务')
+    
+    # Log 命令
+    log_parser = subparsers.add_parser('log', help=f'{Emojis.LOG} 查看服务日志')
+    log_parser.add_argument('service', nargs='?', default='all',
+                          help='服务名称或 "all" 查看所有日志')
+    log_parser.add_argument('--no-follow', '-n', action='store_true',
+                          help='不实时跟踪日志')
+    log_parser.add_argument('--lines', '-l', type=int, default=10,
+                          help='初始显示的行数')
+    
+    # List 命令 - 保留原命令名，不改为 ps
+    list_parser = subparsers.add_parser('list', help='列出服务')
+    
+    return parser
+
+def handle_start(manager: ServiceManager, service_name: str) -> bool:
+    """处理启动命令"""
+    if service_name == 'all':
+        service_names = manager.get_service_names()
+        if not service_names:
+            print_warning("配置中没有定义任何服务。")
+            return False
+        
+        console.print(f"{Emojis.START} 正在启动所有服务...", style="running")
+        success = True
+        for name in service_names:
+            if not manager.start(name):
+                print_error(f"启动服务 '{name}' 失败")
+                success = False
+            else:
+                print_success(f"服务 '{name}' 已成功启动")
+        
+        if success:
+            print_success("所有服务已成功启动！")
+        else:
+            print_warning("有些服务启动失败，请检查日志获取详情。")
+        
+        return success
+    else:
+        result = manager.start(service_name)
+        if result:
+            print_success(f"服务 '{service_name}' 已成功启动")
+        else:
+            print_error(f"启动服务 '{service_name}' 失败")
+        return result
+
+def handle_stop(manager: ServiceManager, service_name: str) -> bool:
+    """处理停止命令"""
+    if service_name == 'all':
+        service_names = manager.get_running_services()
+        if not service_names:
+            console.print(f"{Emojis.INFO} 当前没有正在运行的服务。", style="dim")
+            return True
+        
+        console.print(f"{Emojis.STOP} 正在停止所有服务...", style="warning")
+        success = True
+        for name in service_names:
+            if not manager.stop(name):
+                print_error(f"停止服务 '{name}' 失败")
+                success = False
+            else:
+                console.print(f"{Emojis.STOPPED} 服务 '{name}' 已停止", style="stopped")
+        
+        if success:
+            console.print(f"\n{Emojis.STOPPED} 所有服务已成功停止！", style="warning")
+        else:
+            print_warning("有些服务停止失败，请检查日志获取详情。")
+        
+        return success
+    else:
+        result = manager.stop(service_name)
+        if result:
+            console.print(f"{Emojis.STOPPED} 服务 '{service_name}' 已成功停止", style="warning")
+        else:
+            print_error(f"停止服务 '{service_name}' 失败")
+        return result
+
+def handle_restart(manager: ServiceManager, service_name: str) -> bool:
+    """处理重启命令"""
+    if service_name == 'all':
+        service_names = manager.get_service_names()
+        if not service_names:
+            print_warning("配置中没有定义任何服务。")
+            return False
+        
+        console.print(f"{Emojis.RESTART} 正在重启所有服务...", style="restart")
+        success = True
+        for name in service_names:
+            if not manager.restart(name):
+                print_error(f"重启服务 '{name}' 失败")
+                success = False
+            else:
+                console.print(f"{Emojis.RUNNING} 服务 '{name}' 已成功重启", style="restart")
+        
+        if success:
+            print_success("所有服务已成功重启！")
+        else:
+            print_warning("有些服务重启失败，请检查日志获取详情。")
+        
+        return success
+    else:
+        result = manager.restart(service_name)
+        if result:
+            console.print(f"{Emojis.RUNNING} 服务 '{service_name}' 已成功重启", style="restart")
+        else:
+            print_error(f"重启服务 '{service_name}' 失败")
+        return result
+
+def handle_log(manager: ServiceManager, log_manager: LogManager, args) -> bool:
+    """处理日志查看命令"""
+    service_name = args.service
+    follow = not args.no_follow
+    lines = args.lines
+    
+    if service_name == 'all':
+        services = manager.get_service_names()
+        if not services:
+            print_warning("配置中没有定义任何服务。")
+            return False
+    else:
+        if service_name not in manager.get_service_names():
+            print_error(f"服务 '{service_name}' 在配置中未找到。")
+            return False
+        services = [service_name]
+    
+    # 使用LogManager查看日志
+    log_manager.tail_logs(services, follow=follow, lines=lines)
+    return True
+
+def handle_list(manager: ServiceManager) -> bool:
+    """处理列出服务命令"""
+    service_names = manager.get_service_names()
+    
+    if not service_names:
+        print_warning("配置中没有定义任何服务。")
+        return True
+    
+    print_header("服务列表")
+    
+    # 构建服务列表数据
+    services = []
+    for name in service_names:
+        is_running = manager.is_running(name)
+        pid = manager.get_service_pid(name)
+        
+        services.append({
+            "name": name,
+            "status": "running" if is_running else "stopped",
+            "pid": pid
+        })
+    
+    # 使用Rich表格显示服务列表
+    print_service_table(services)
+    
+    console.print(f"[dim]配置文件: {manager.config_path}[/]")
+    console.print(f"[dim]运行中服务: {len(manager.get_running_services())}/{len(service_names)}[/]")
+    console.print()
+    
+    return True
+
+def main():
+    """CLI 应用程序入口点"""
+    # 显示头部
+    print_header("SERVLY - Modern Process Manager")
+    
+    parser = setup_arg_parser()
+    args = parser.parse_args()
+    
+    if not args.command:
+        parser.print_help()
+        return 1
+    
+    # 创建服务管理器
+    try:
+        service_manager = ServiceManager(config_path=args.config)
+    except Exception as e:
+        print_error(f"加载配置文件时出错: {escape(str(e))}")
+        return 1
+    
+    # 创建日志管理器
+    log_manager = LogManager(service_manager.log_dir)
+    
+    # 处理命令
+    try:
+        if args.command == 'start':
+            success = handle_start(service_manager, args.service)
+        elif args.command == 'stop':
+            success = handle_stop(service_manager, args.service)
+        elif args.command == 'restart':
+            success = handle_restart(service_manager, args.service)
+        elif args.command == 'log':
+            success = handle_log(service_manager, log_manager, args)
+        elif args.command == 'list':
+            success = handle_list(service_manager)
+        else:
+            parser.print_help()
+            return 1
+    except KeyboardInterrupt:
+        console.print(f"\n{Emojis.STOP} 操作被用户中断", style="dim")
+        return 1
+    except Exception as e:
+        print_error(f"执行命令时出错: {escape(str(e))}")
+        logger.exception("命令执行异常")
+        return 1
+        
+    return 0 if success else 1
+
+if __name__ == "__main__":
+    sys.exit(main())