servly 0.1.0__py3-none-any.whl → 0.2.0__py3-none-any.whl

servly/__init__.py

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

servly/cli.py

@@ -0,0 +1,295 @@
+#!/usr/bin/env python3
+"""
+Command-line interface for Servly process manager.
+"""
+import os
+import sys
+import argparse
+import logging
+from pathlib import Path
+from typing import List, Optional
+
+from servly.service import ServiceManager
+from servly.logs import LogManager
+from servly.logs import Colors, Emojis  # 导入颜色和表情符号定义
+from servly.logs import align_colored_text  # 导入对齐工具函数
+
+# 配置彩色日志记录器
+class ColoredFormatter(logging.Formatter):
+    """添加颜色支持的日志格式化器"""
+    
+    def format(self, record):
+        log_message = super().format(record)
+        
+        if record.levelno >= logging.ERROR:
+            return f"{Emojis.ERROR} {Colors.BRIGHT_RED}{log_message}{Colors.RESET}"
+        elif record.levelno >= logging.WARNING:
+            return f"{Emojis.WARNING} {Colors.YELLOW}{log_message}{Colors.RESET}"
+        elif record.levelno >= logging.INFO:
+            return f"{Emojis.INFO} {Colors.GREEN}{log_message}{Colors.RESET}"
+        else:
+            return f"{Colors.BRIGHT_BLACK}{log_message}{Colors.RESET}"
+
+# 配置日志
+handler = logging.StreamHandler()
+handler.setFormatter(ColoredFormatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s'))
+logger = logging.getLogger('servly')
+logger.setLevel(logging.INFO)
+logger.addHandler(handler)
+
+def print_header():
+    """打印美化的 Servly 头部"""
+    print(f"\n{Colors.CYAN}{Colors.BOLD}{'=' * 50}")
+    print(f"{Emojis.SERVICE} SERVLY {Colors.BRIGHT_BLACK}- Modern Process Manager")
+    print(f"{Colors.CYAN}{'=' * 50}{Colors.RESET}\n")
+
+def setup_arg_parser() -> argparse.ArgumentParser:
+    """设置命令行参数解析器"""
+    parser = argparse.ArgumentParser(
+        description=f"{Colors.CYAN}{Colors.BOLD}{Emojis.SERVICE} Servly - Modern process manager{Colors.RESET}",
+        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(f"{Emojis.WARNING} {Colors.YELLOW}配置中没有定义任何服务。{Colors.RESET}")
+            return False
+        
+        print(f"{Emojis.START} {Colors.BRIGHT_GREEN}正在启动所有服务...{Colors.RESET}")
+        success = True
+        for name in service_names:
+            if not manager.start(name):
+                print(f"{Emojis.ERROR} {Colors.RED}启动服务 '{name}' 失败{Colors.RESET}")
+                success = False
+            else:
+                print(f"{Emojis.RUNNING} {Colors.GREEN}服务 '{name}' 已成功启动{Colors.RESET}")
+        
+        if success:
+            print(f"\n{Emojis.RUNNING} {Colors.BRIGHT_GREEN}所有服务已成功启动！{Colors.RESET}")
+        else:
+            print(f"\n{Emojis.WARNING} {Colors.YELLOW}有些服务启动失败，请检查日志获取详情。{Colors.RESET}")
+        
+        return success
+    else:
+        result = manager.start(service_name)
+        if result:
+            print(f"{Emojis.RUNNING} {Colors.GREEN}服务 '{service_name}' 已成功启动{Colors.RESET}")
+        else:
+            print(f"{Emojis.ERROR} {Colors.RED}启动服务 '{service_name}' 失败{Colors.RESET}")
+        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:
+            print(f"{Emojis.INFO} {Colors.BRIGHT_BLACK}当前没有正在运行的服务。{Colors.RESET}")
+            return True
+        
+        print(f"{Emojis.STOP} {Colors.YELLOW}正在停止所有服务...{Colors.RESET}")
+        success = True
+        for name in service_names:
+            if not manager.stop(name):
+                print(f"{Emojis.ERROR} {Colors.RED}停止服务 '{name}' 失败{Colors.RESET}")
+                success = False
+            else:
+                print(f"{Emojis.STOPPED} {Colors.YELLOW}服务 '{name}' 已停止{Colors.RESET}")
+        
+        if success:
+            print(f"\n{Emojis.STOPPED} {Colors.YELLOW}所有服务已成功停止！{Colors.RESET}")
+        else:
+            print(f"\n{Emojis.WARNING} {Colors.YELLOW}有些服务停止失败，请检查日志获取详情。{Colors.RESET}")
+        
+        return success
+    else:
+        result = manager.stop(service_name)
+        if result:
+            print(f"{Emojis.STOPPED} {Colors.YELLOW}服务 '{service_name}' 已成功停止{Colors.RESET}")
+        else:
+            print(f"{Emojis.ERROR} {Colors.RED}停止服务 '{service_name}' 失败{Colors.RESET}")
+        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(f"{Emojis.WARNING} {Colors.YELLOW}配置中没有定义任何服务。{Colors.RESET}")
+            return False
+        
+        print(f"{Emojis.RESTART} {Colors.MAGENTA}正在重启所有服务...{Colors.RESET}")
+        success = True
+        for name in service_names:
+            if not manager.restart(name):
+                print(f"{Emojis.ERROR} {Colors.RED}重启服务 '{name}' 失败{Colors.RESET}")
+                success = False
+            else:
+                print(f"{Emojis.RUNNING} {Colors.MAGENTA}服务 '{name}' 已成功重启{Colors.RESET}")
+        
+        if success:
+            print(f"\n{Emojis.RUNNING} {Colors.BRIGHT_GREEN}所有服务已成功重启！{Colors.RESET}")
+        else:
+            print(f"\n{Emojis.WARNING} {Colors.YELLOW}有些服务重启失败，请检查日志获取详情。{Colors.RESET}")
+        
+        return success
+    else:
+        result = manager.restart(service_name)
+        if result:
+            print(f"{Emojis.RUNNING} {Colors.MAGENTA}服务 '{service_name}' 已成功重启{Colors.RESET}")
+        else:
+            print(f"{Emojis.ERROR} {Colors.RED}重启服务 '{service_name}' 失败{Colors.RESET}")
+        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(f"{Emojis.WARNING} {Colors.YELLOW}配置中没有定义任何服务。{Colors.RESET}")
+            return False
+    else:
+        if service_name not in manager.get_service_names():
+            print(f"{Emojis.ERROR} {Colors.RED}服务 '{service_name}' 在配置中未找到。{Colors.RESET}")
+            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(f"{Emojis.WARNING} {Colors.YELLOW}配置中没有定义任何服务。{Colors.RESET}")
+        return True
+    
+    # 表头
+    print(f"\n{Colors.CYAN}{Colors.BOLD}{Emojis.SERVICE} 服务列表{Colors.RESET}")
+    print(f"{Colors.CYAN}{'─' * 60}{Colors.RESET}")
+    
+    # 列标题
+    print(f"{Colors.BOLD}{align_colored_text('  名称', 25)} {align_colored_text('状态', 20)} {align_colored_text('PID', 10)}{Colors.RESET}")
+    print(f"{Colors.BRIGHT_BLACK}{'─' * 60}{Colors.RESET}")
+    
+    # 服务列表
+    for name in service_names:
+        is_running = manager.is_running(name)
+        pid = manager.get_service_pid(name) or '-'
+        
+        if is_running:
+            status_text = f"{Emojis.RUNNING} {Colors.GREEN}RUNNING{Colors.RESET}"
+            pid_text = f"{Colors.GREEN}{pid}{Colors.RESET}"
+        else:
+            status_text = f"{Emojis.STOPPED} {Colors.BRIGHT_BLACK}STOPPED{Colors.RESET}"
+            pid_text = f"{Colors.BRIGHT_BLACK}{pid}{Colors.RESET}"
+        
+        # 为不同服务使用不同颜色
+        service_color = Colors.CYAN if is_running else Colors.BRIGHT_BLACK
+        service_text = f"{service_color}{name}{Colors.RESET}"
+        
+        # 使用对齐辅助函数确保正确对齐包含颜色代码的文本
+        aligned_service = align_colored_text(f"  {service_text}", 25)
+        aligned_status = align_colored_text(status_text, 20)
+        aligned_pid = align_colored_text(pid_text, 10)
+        
+        print(f"{aligned_service}{aligned_status}{aligned_pid}")
+    
+    print(f"\n{Colors.BRIGHT_BLACK}配置文件: {manager.config_path}{Colors.RESET}")
+    print(f"{Colors.BRIGHT_BLACK}运行中服务: {len(manager.get_running_services())}/{len(service_names)}{Colors.RESET}")
+    print()
+    
+    return True
+
+def main():
+    """CLI 应用程序入口点"""
+    # 显示头部
+    print_header()
+    
+    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(f"{Emojis.ERROR} {Colors.RED}加载配置文件时出错: {e}{Colors.RESET}")
+        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:
+        print(f"\n{Emojis.STOP} {Colors.BRIGHT_BLACK}操作被用户中断{Colors.RESET}")
+        return 1
+    except Exception as e:
+        print(f"\n{Emojis.ERROR} {Colors.RED}执行命令时出错: {e}{Colors.RESET}")
+        return 1
+        
+    return 0 if success else 1
+
+if __name__ == "__main__":
+    sys.exit(main())

servly/logs.py

@@ -0,0 +1,266 @@
+"""
+Log management functionality for Servly.
+"""
+import os
+import sys
+import time
+import select
+import fcntl
+import termios
+import subprocess
+import re
+from pathlib import Path
+from typing import List, Dict, Optional, Tuple
+import random
+
+
+# ANSI 颜色代码
+class Colors:
+    RESET = "\033[0m"
+    BOLD = "\033[1m"
+    UNDERLINE = "\033[4m"
+    
+    BLACK = "\033[30m"
+    RED = "\033[31m"
+    GREEN = "\033[32m"
+    YELLOW = "\033[33m"
+    BLUE = "\033[34m"
+    MAGENTA = "\033[35m"
+    CYAN = "\033[36m"
+    WHITE = "\033[37m"
+    
+    BRIGHT_BLACK = "\033[90m"
+    BRIGHT_RED = "\033[91m"
+    BRIGHT_GREEN = "\033[92m"
+    BRIGHT_YELLOW = "\033[93m"
+    BRIGHT_BLUE = "\033[94m"
+    BRIGHT_MAGENTA = "\033[95m"
+    BRIGHT_CYAN = "\033[96m"
+    BRIGHT_WHITE = "\033[97m"
+    
+    # 背景色
+    BG_BLACK = "\033[40m"
+    BG_RED = "\033[41m"
+    BG_GREEN = "\033[42m"
+    BG_YELLOW = "\033[43m"
+    BG_BLUE = "\033[44m"
+    BG_MAGENTA = "\033[45m"
+    BG_CYAN = "\033[46m"
+    BG_WHITE = "\033[47m"
+
+
+# 服务相关的 emoji
+class Emojis:
+    SERVICE = "🔧"
+    START = "🟢"
+    STOP = "🔴"
+    RESTART = "🔄"
+    INFO = "ℹ️ "
+    WARNING = "⚠️ "
+    ERROR = "❌"
+    LOG = "📝"
+    STDOUT = "📤"
+    STDERR = "📥"
+    TIME = "🕒"
+    RUNNING = "✅"
+    STOPPED = "⛔"
+    LOADING = "⏳"
+
+
+# 处理彩色文本对齐的辅助函数
+def strip_ansi_codes(text: str) -> str:
+    """删除字符串中的所有 ANSI 转义代码"""
+    ansi_escape = re.compile(r'\x1B(?:[@-Z\\-_]|\[[0-?]*[ -/]*[@-~])')
+    return ansi_escape.sub('', text)
+
+def get_visible_length(text: str) -> int:
+    """获取文本在终端中的可见长度（排除 ANSI 代码和宽字符）"""
+    text = strip_ansi_codes(text)
+    # 处理中文等宽字符（在大多数终端中占用两个字符宽度）
+    length = 0
+    for char in text:
+        if ord(char) > 127:  # 简单判断是否是非ASCII字符
+            length += 2
+        else:
+            length += 1
+    return length
+
+def align_colored_text(text: str, width: int, align='left') -> str:
+    """
+    将彩色文本对齐到指定宽度
+    
+    Args:
+        text: 可能包含 ANSI 颜色代码的文本
+        width: 期望的显示宽度
+        align: 对齐方式，'left', 'right' 或 'center'
+        
+    Returns:
+        对齐后的文本，保留颜色代码
+    """
+    visible_length = get_visible_length(text)
+    padding = max(0, width - visible_length)
+    
+    if align == 'right':
+        return ' ' * padding + text
+    elif align == 'center':
+        left_padding = padding // 2
+        right_padding = padding - left_padding
+        return ' ' * left_padding + text + ' ' * right_padding
+    else:  # left alignment
+        return text + ' ' * padding
+
+
+class LogManager:
+    """Handles viewing and managing logs for servly services."""
+    
+    def __init__(self, log_dir: Path):
+        self.log_dir = log_dir
+        # 为每个服务分配一个固定颜色，使日志更易读
+        self.service_colors = {}
+        self.available_colors = [
+            Colors.GREEN, Colors.YELLOW, Colors.BLUE, Colors.MAGENTA, Colors.CYAN,
+            Colors.BRIGHT_GREEN, Colors.BRIGHT_YELLOW, Colors.BRIGHT_BLUE, 
+            Colors.BRIGHT_MAGENTA, Colors.BRIGHT_CYAN
+        ]
+        
+    def get_log_files(self, service_name: str) -> Dict[str, Path]:
+        """Get the stdout and stderr log files for a service."""
+        return {
+            'stdout': self.log_dir / f"{service_name}-out.log",
+            'stderr': self.log_dir / f"{service_name}-error.log"
+        }
+    
+    def _get_service_color(self, service_name: str) -> str:
+        """为服务分配一个固定的颜色"""
+        if service_name not in self.service_colors:
+            if not self.available_colors:
+                # 如果颜色用完了，就随机分配
+                self.service_colors[service_name] = random.choice([
+                    Colors.GREEN, Colors.YELLOW, Colors.BLUE, Colors.MAGENTA, Colors.CYAN
+                ])
+            else:
+                # 从可用颜色中选择一个
+                self.service_colors[service_name] = self.available_colors.pop(0)
+        return self.service_colors[service_name]
+    
+    def _format_log_header(self, service: str, log_type: str) -> str:
+        """格式化日志头部，带颜色和 emoji"""
+        service_color = self._get_service_color(service)
+        emoji = Emojis.STDOUT if log_type == 'stdout' else Emojis.STDERR
+        type_color = Colors.GREEN if log_type == 'stdout' else Colors.YELLOW
+        
+        return (f"\n{Colors.BOLD}{Colors.WHITE}{Emojis.LOG} Log Stream: "
+                f"{service_color}{service}{Colors.RESET} "
+                f"{Colors.BRIGHT_BLACK}({type_color}{emoji} {log_type}{Colors.BRIGHT_BLACK}){Colors.RESET}\n"
+                f"{Colors.BRIGHT_BLACK}{'─' * 60}{Colors.RESET}")
+    
+    def _format_log_line(self, service: str, log_type: str, line: str, show_timestamp: bool = True) -> str:
+        """格式化单行日志，带颜色和 emoji"""
+        service_color = self._get_service_color(service)
+        timestamp = time.strftime("%Y-%m-%d %H:%M:%S") if show_timestamp else ""
+        
+        # 根据日志类型选择颜色
+        line_color = Colors.RESET
+        if log_type == 'stderr' and ('error' in line.lower() or 'exception' in line.lower()):
+            prefix = f"{Emojis.ERROR} "
+            line_color = Colors.BRIGHT_RED
+        elif log_type == 'stderr':
+            prefix = f"{Emojis.WARNING} "
+            line_color = Colors.YELLOW
+        else:
+            prefix = f"{Emojis.INFO} "
+        
+        # 格式化输出
+        if show_timestamp:
+            return (f"{Colors.BRIGHT_BLACK}[{Emojis.TIME} {timestamp}]{Colors.RESET} "
+                    f"{service_color}{service}{Colors.RESET} "
+                    f"{prefix}{line_color}{line.rstrip()}{Colors.RESET}")
+        else:
+            return f"{line_color}{line.rstrip()}{Colors.RESET}"
+    
+    def tail_logs(self, service_names: List[str], follow: bool = True, lines: int = 10):
+        """
+        Display logs for specified services in real-time.
+        
+        Args:
+            service_names: List of service names to show logs for
+            follow: Whether to follow logs in real-time (like tail -f)
+            lines: Number of recent lines to display initially
+        """
+        if not service_names:
+            print(f"{Emojis.WARNING} {Colors.YELLOW}No services specified for log viewing.{Colors.RESET}")
+            return
+
+        # Check if the logs exist
+        log_files = []
+        for service in service_names:
+            service_logs = self.get_log_files(service)
+            for log_type, log_path in service_logs.items():
+                if log_path.exists():
+                    log_files.append((service, log_type, log_path))
+                else:
+                    service_color = self._get_service_color(service)
+                    print(f"{Emojis.WARNING} {Colors.YELLOW}No {log_type} logs found for {service_color}{service}{Colors.RESET}.")
+                    
+        if not log_files:
+            print(f"{Emojis.WARNING} {Colors.YELLOW}No log files found for specified services.{Colors.RESET}")
+            return
+            
+        if follow:
+            self._follow_logs(log_files)
+        else:
+            self._display_recent_logs(log_files, lines)
+    
+    def _display_recent_logs(self, log_files: List[Tuple[str, str, Path]], lines: int):
+        """Display the most recent lines from log files."""
+        for service, log_type, log_path in log_files:
+            print(self._format_log_header(service, log_type))
+            try:
+                # 读取最后N行
+                with open(log_path, 'r') as f:
+                    content = f.readlines()
+                    last_lines = content[-lines:] if len(content) >= lines else content
+                    
+                    # 打印每一行，增加格式
+                    for line in last_lines:
+                        print(self._format_log_line(service, log_type, line, show_timestamp=False))
+            except Exception as e:
+                print(f"{Emojis.ERROR} {Colors.RED}Error reading logs: {str(e)}{Colors.RESET}")
+    
+    def _follow_logs(self, log_files: List[Tuple[str, str, Path]]):
+        """Follow logs in real-time, similar to tail -f."""
+        # Dictionary to keep track of file positions
+        file_handlers = {}
+        
+        try:
+            # Open all log files
+            for service, log_type, log_path in log_files:
+                f = open(log_path, 'r')
+                # Move to the end of the file
+                f.seek(0, os.SEEK_END)
+                file_handlers[(service, log_type)] = f
+                
+                # 打印日志头部
+                print(self._format_log_header(service, log_type))
+                
+            print(f"\n{Emojis.LOADING} {Colors.BRIGHT_BLACK}Following logs... (Ctrl+C to stop){Colors.RESET}")
+            print(f"{Colors.BRIGHT_BLACK}{'─' * 60}{Colors.RESET}")
+            
+            while True:
+                has_new_data = False
+                
+                for (service, log_type), f in file_handlers.items():
+                    line = f.readline()
+                    if line:
+                        has_new_data = True
+                        print(self._format_log_line(service, log_type, line))
+                
+                if not has_new_data:
+                    time.sleep(0.1)
+                    
+        except KeyboardInterrupt:
+            print(f"\n{Emojis.STOP} {Colors.BRIGHT_BLACK}Stopped following logs.{Colors.RESET}")
+        finally:
+            # Close all file handlers
+            for f in file_handlers.values():
+                f.close()

servly/service.py

@@ -0,0 +1,213 @@
+"""
+Service management functionality for Servly.
+"""
+import os
+import subprocess
+import signal
+import yaml
+import logging
+import time
+from pathlib import Path
+from typing import Dict, Union, List, Optional, Any
+
+logger = logging.getLogger(__name__)
+
+class ServiceManager:
+    """Manages processes based on servly.yml configuration."""
+    
+    def __init__(self, config_path: str = "servly.yml", servly_dir: str = ".servly"):
+        self.config_path = config_path
+        self.servly_dir = Path(servly_dir)
+        self.pid_dir = self.servly_dir / "pids"
+        self.log_dir = self.servly_dir / "logs"
+        self._ensure_dirs()
+        self.services = self._load_config()
+        
+    def _ensure_dirs(self):
+        """Create required directories if they don't exist."""
+        self.pid_dir.mkdir(parents=True, exist_ok=True)
+        self.log_dir.mkdir(parents=True, exist_ok=True)
+        
+    def _load_config(self) -> Dict[str, Any]:
+        """Load service configurations from servly.yml."""
+        if not os.path.exists(self.config_path):
+            logger.error(f"Configuration file not found: {self.config_path}")
+            return {}
+            
+        try:
+            with open(self.config_path, 'r') as file:
+                config = yaml.safe_load(file) or {}
+                
+            # Validate config and convert simple format to detailed format
+            validated_config = {}
+            for name, conf in config.items():
+                if name.lower() == "servly":
+                    logger.warning(f"'servly' is a reserved name and cannot be used as a service name.")
+                    continue
+                    
+                if isinstance(conf, str):
+                    validated_config[name] = {"cmd": conf}
+                elif isinstance(conf, dict) and "cmd" in conf:
+                    validated_config[name] = conf
+                elif isinstance(conf, dict) and "script" in conf:
+                    validated_config[name] = conf
+                    # Convert script to cmd for consistency
+                    validated_config[name]["cmd"] = conf["script"]
+                else:
+                    logger.warning(f"Invalid configuration for service '{name}', skipping.")
+                    
+            return validated_config
+        except Exception as e:
+            logger.error(f"Error loading configuration: {str(e)}")
+            return {}
+    
+    def get_pid_file(self, service_name: str) -> Path:
+        """Get the path to a service's PID file."""
+        return self.pid_dir / f"{service_name}.pid"
+    
+    def get_service_pid(self, service_name: str) -> Optional[int]:
+        """Get the PID for a running service, or None if not running."""
+        pid_file = self.get_pid_file(service_name)
+        if not pid_file.exists():
+            return None
+            
+        try:
+            with open(pid_file, 'r') as f:
+                pid = int(f.read().strip())
+                
+            # Check if process is still running
+            if self._is_process_running(pid):
+                return pid
+            else:
+                # Clean up stale PID file
+                os.remove(pid_file)
+                return None
+        except (ValueError, FileNotFoundError):
+            return None
+    
+    def _is_process_running(self, pid: int) -> bool:
+        """Check if process with given PID is running."""
+        try:
+            os.kill(pid, 0)
+            return True
+        except ProcessLookupError:
+            return False
+        except PermissionError:
+            # Process exists but we don't have permission to send signals to it
+            return True
+    
+    def is_running(self, service_name: str) -> bool:
+        """Check if a service is running."""
+        return self.get_service_pid(service_name) is not None
+    
+    def get_service_names(self) -> List[str]:
+        """Get list of configured service names."""
+        return list(self.services.keys())
+    
+    def get_running_services(self) -> List[str]:
+        """Get list of currently running services."""
+        return [name for name in self.get_service_names() if self.is_running(name)]
+    
+    def start(self, service_name: str) -> bool:
+        """Start a specified service."""
+        if service_name not in self.services:
+            logger.error(f"Service '{service_name}' not found in configuration.")
+            return False
+            
+        if self.is_running(service_name):
+            logger.info(f"Service '{service_name}' is already running.")
+            return True
+            
+        config = self.services[service_name]
+        cmd = config.get("cmd")
+        if not cmd:
+            logger.error(f"No command specified for service '{service_name}'.")
+            return False
+            
+        # Prepare environment variables
+        env = os.environ.copy()
+        if "env" in config and isinstance(config["env"], dict):
+            env.update(config["env"])
+            
+        # Prepare working directory
+        cwd = config.get("cwd", os.getcwd())
+        
+        # Prepare log files
+        stdout_log = self.log_dir / f"{service_name}-out.log"
+        stderr_log = self.log_dir / f"{service_name}-error.log"
+        
+        try:
+            with open(stdout_log, 'a') as out, open(stderr_log, 'a') as err:
+                # Add timestamp to logs
+                timestamp = time.strftime("%Y-%m-%d %H:%M:%S")
+                out.write(f"\n--- Starting service '{service_name}' at {timestamp} ---\n")
+                err.write(f"\n--- Starting service '{service_name}' at {timestamp} ---\n")
+                
+                # Start the process
+                process = subprocess.Popen(
+                    cmd,
+                    shell=True,
+                    stdout=out,
+                    stderr=err,
+                    cwd=cwd,
+                    env=env,
+                    start_new_session=True  # Detach from current process group
+                )
+                
+            # Save the PID to file
+            with open(self.get_pid_file(service_name), 'w') as f:
+                f.write(str(process.pid))
+                
+            logger.info(f"Started service '{service_name}' with PID {process.pid}")
+            return True
+            
+        except Exception as e:
+            logger.error(f"Failed to start service '{service_name}': {str(e)}")
+            return False
+    
+    def stop(self, service_name: str, timeout: int = 5) -> bool:
+        """Stop a specified service."""
+        pid = self.get_service_pid(service_name)
+        if not pid:
+            logger.info(f"Service '{service_name}' is not running.")
+            return True
+            
+        try:
+            # First try SIGTERM for graceful shutdown
+            os.killpg(os.getpgid(pid), signal.SIGTERM)
+            
+            # Wait for process to terminate
+            for _ in range(timeout):
+                if not self._is_process_running(pid):
+                    break
+                time.sleep(1)
+                
+            # If still running, force kill with SIGKILL
+            if self._is_process_running(pid):
+                os.killpg(os.getpgid(pid), signal.SIGKILL)
+                time.sleep(0.5)
+                
+            # Clean up PID file
+            pid_file = self.get_pid_file(service_name)
+            if os.path.exists(pid_file):
+                os.remove(pid_file)
+                
+            logger.info(f"Stopped service '{service_name}'")
+            return True
+            
+        except ProcessLookupError:
+            # Process already terminated
+            pid_file = self.get_pid_file(service_name)
+            if os.path.exists(pid_file):
+                os.remove(pid_file)
+            logger.info(f"Service '{service_name}' was not running")
+            return True
+            
+        except Exception as e:
+            logger.error(f"Failed to stop service '{service_name}': {str(e)}")
+            return False
+    
+    def restart(self, service_name: str) -> bool:
+        """Restart a service."""
+        self.stop(service_name)
+        return self.start(service_name)

servly-0.2.0.dist-info/METADATA

@@ -0,0 +1,133 @@
+Metadata-Version: 2.4
+Name: servly
+Version: 0.2.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
+
+# 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.2.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+servly/__init__.py,sha256=HT8I94RyP6_gNoVJWOVSkeOEQIl3QnT60zCP2PJVon0,73
+servly/cli.py,sha256=HeOOsnaJGMaiSWQ5Z-hkCLjxpmoUfES37hgfTHBuDMk,12142
+servly/logs.py,sha256=HfC_EByTbgz6MpW8IpemEwpRPPE0xME46zUy2CyJvqU,9779
+servly/service.py,sha256=5xhSD0HkfQw8xnY5J0GRxyFE8_CHBq5yfatbhL625PM,8123
+servly-0.2.0.dist-info/METADATA,sha256=YICRthT2IW92tOXYTUmZN1cCGZ3LtWBhtLPIIZADKeA,2630
+servly-0.2.0.dist-info/WHEEL,sha256=lTU6B6eIfYoiQJTZNc-fyaR6BpL6ehTzU3xGYxn2n8k,91
+servly-0.2.0.dist-info/entry_points.txt,sha256=enHpE2d9DYdzfIWBcnIjuIkcNVk118xghL0AeTUL0Yg,43
+servly-0.2.0.dist-info/top_level.txt,sha256=JLi7GX0KwWF-mh8i1-lVJ2q4SO1KfI2CNxQk_VNfNZE,7
+servly-0.2.0.dist-info/RECORD,,

servly-0.2.0.dist-info/entry_points.txt

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

servly-0.2.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+servly

servly-0.1.0.dist-info/METADATA

@@ -1,14 +0,0 @@
-Metadata-Version: 2.4
-Name: servly
-Version: 0.1.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
-
-# XM

servly-0.1.0.dist-info/RECORD

@@ -1,7 +0,0 @@
-xm/__init__.py,sha256=L6zbQIZKsAP-Knhm6fBcQFPoVdIDuejxze60qX23jiw,21
-xm/cli.py,sha256=Wb9RNHjD2vJ3sysY52U9gORMDA6bVSnZ4sd6MmoA9rc,108
-servly-0.1.0.dist-info/METADATA,sha256=RwhsvIBoTDT6sg_UyUjU_H5kCe_6MHF-iA_xYn4HFsE,379
-servly-0.1.0.dist-info/WHEEL,sha256=lTU6B6eIfYoiQJTZNc-fyaR6BpL6ehTzU3xGYxn2n8k,91
-servly-0.1.0.dist-info/entry_points.txt,sha256=tNnO4et40QVUJwNa0i2e5lOvMpcba6chlfwK4d4-SpA,35
-servly-0.1.0.dist-info/top_level.txt,sha256=4v0vf9bT58AtJn_CpjgroekLoaoDDo5QvmFqNby7gPc,3
-servly-0.1.0.dist-info/RECORD,,

servly-0.1.0.dist-info/entry_points.txt

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

servly-0.1.0.dist-info/top_level.txt

@@ -1 +0,0 @@
-xm

xm/__init__.py

@@ -1 +0,0 @@
-__version__ = '0.1.0'

xm/cli.py

@@ -1,7 +0,0 @@
-#!/usr/bin/env python3
-
-def main():
-    print("Hello World from xm!")
-
-if __name__ == "__main__":
-    main()