servly 0.1.0__py3-none-any.whl → 0.3.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,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())

servly/logs.py

@@ -0,0 +1,226 @@
+"""
+Log management functionality for Servly.
+使用Rich库进行日志格式化和展示，实现PM2风格的日志效果。
+"""
+import os
+import sys
+import time
+import re
+from pathlib import Path
+from typing import List, Dict, Optional, Tuple
+
+from rich.console import Console
+from rich.theme import Theme
+from rich.text import Text
+from rich.panel import Panel
+from rich.table import Table
+from rich.live import Live
+
+# 自定义Rich主题
+custom_theme = Theme({
+    "warning": "yellow",
+    "error": "bold red",
+    "info": "green",
+    "dim": "dim",
+    "stdout_service": "green",
+    "stderr_service": "red",
+    "header": "cyan bold",
+    "subheader": "bright_black",
+    "running": "green",
+    "stopped": "bright_black",
+    "restart": "magenta",
+    "separator": "cyan",
+})
+
+# 创建Rich控制台对象
+console = Console(theme=custom_theme)
+
+# 服务相关的 emoji
+class Emojis:
+    """服务状态相关的emoji图标"""
+    SERVICE = "🔧"
+    START = "🟢"
+    STOP = "🔴"
+    RESTART = "🔄"
+    INFO = "ℹ️ "
+    WARNING = "⚠️ "
+    ERROR = "❌"
+    LOG = "📝"
+    STDOUT = "📤"
+    STDERR = "📥"
+    TIME = "🕒"
+    RUNNING = "✅"
+    STOPPED = "⛔"
+    LOADING = "⏳"
+
+# Rich格式化输出工具函数
+def print_header(title: str):
+    """打印美化的标题"""
+    console.print()
+    console.rule(f"[header]{Emojis.SERVICE} {title}[/]", style="separator")
+    console.print()
+
+def print_info(message: str):
+    """打印信息消息"""
+    console.print(f"{Emojis.INFO} {message}", style="info")
+
+def print_warning(message: str):
+    """打印警告消息"""
+    console.print(f"{Emojis.WARNING} {message}", style="warning")
+
+def print_error(message: str):
+    """打印错误消息"""
+    console.print(f"{Emojis.ERROR} {message}", style="error")
+
+def print_success(message: str):
+    """打印成功消息"""
+    console.print(f"{Emojis.RUNNING} {message}", style="running")
+
+def print_service_table(services: List[Dict]):
+    """打印服务状态表格"""
+    table = Table(show_header=True, header_style="header", expand=True)
+    table.add_column("名称", style="cyan")
+    table.add_column("状态")
+    table.add_column("PID")
+    
+    for service in services:
+        name = service["name"]
+        status = service["status"]
+        pid = service["pid"] or "-"
+        
+        status_style = "running" if status == "running" else "stopped"
+        status_emoji = Emojis.RUNNING if status == "running" else Emojis.STOPPED
+        status_text = f"{status_emoji} {status.upper()}"
+        
+        table.add_row(
+            name,
+            Text(status_text, style=status_style),
+            Text(str(pid), style=status_style)
+        )
+    
+    console.print(table)
+    console.print()
+
+
+class LogManager:
+    """管理和显示服务日志"""
+    
+    def __init__(self, log_dir: Path):
+        self.log_dir = log_dir
+        self.default_tail_lines = 15  # 默认展示最后15行日志
+        
+    def get_log_files(self, service_name: str) -> Dict[str, Path]:
+        """获取服务的stdout和stderr日志文件路径"""
+        return {
+            'stdout': self.log_dir / f"{service_name}-out.log",
+            'stderr': self.log_dir / f"{service_name}-error.log"
+        }
+    
+    def _parse_log_line(self, line: str) -> Tuple[str, str]:
+        """解析日志行，提取时间戳和内容"""
+        timestamp = ""
+        content = line.rstrip()
+        
+        # 尝试提取时间戳
+        timestamp_match = re.search(r'(\d{4}-\d{2}-\d{2}\s\d{2}:\d{2}:\d{2})', line)
+        if timestamp_match:
+            timestamp = timestamp_match.group(1)
+            # 移除行中已有的时间戳部分
+            content = line.replace(timestamp, "", 1).lstrip().rstrip()
+        else:
+            timestamp = time.strftime("%Y-%m-%d %H:%M:%S")
+        
+        return timestamp, content
+    
+    def tail_logs(self, service_names: List[str], follow: bool = True, lines: int = None):
+        """
+        显示服务日志
+        
+        Args:
+            service_names: 要查看的服务名称列表
+            follow: 是否实时跟踪日志（类似tail -f）
+            lines: 初始显示的行数，默认为self.default_tail_lines
+        """
+        if lines is None:
+            lines = self.default_tail_lines
+            
+        if not service_names:
+            print_warning("未指定要查看日志的服务。")
+            return
+
+        # 检查日志文件是否存在
+        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:
+                    style = "stderr_service" if log_type == "stderr" else "stdout_service" 
+                    console.print(f"{Emojis.WARNING} 未找到服务 [{style}]{service}[/] 的 {log_type} 日志。", style="warning")
+                    
+        if not log_files:
+            print_warning("未找到指定服务的日志文件。")
+            return
+            
+        if follow:
+            # 首先显示最后几行，然后再开始跟踪
+            self._display_recent_logs(log_files, lines)
+            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):
+        """显示最近的日志行"""
+        for service, log_type, log_path in log_files:
+            # PM2风格的标题
+            console.print(f"\n[dim]{log_path} last {lines} lines:[/]")
+            
+            try:
+                # 读取最后N行
+                with open(log_path, 'r') as f:
+                    content = f.readlines()
+                    last_lines = content[-lines:] if len(content) >= lines else content
+                    
+                    # 打印每一行，PM2格式
+                    for line in last_lines:
+                        timestamp, message = self._parse_log_line(line)
+                        style = "stderr_service" if log_type == "stderr" else "stdout_service"
+                        console.print(f"[{style}]{service}[/] | {timestamp}: {message}")
+            except Exception as e:
+                print_error(f"读取日志文件出错: {str(e)}")
+    
+    def _follow_logs(self, log_files: List[Tuple[str, str, Path]]):
+        """实时跟踪日志（类似tail -f）"""
+        file_handlers = {}
+        
+        try:
+            # 打开所有日志文件
+            for service, log_type, log_path in log_files:
+                f = open(log_path, 'r')
+                # 移动到文件末尾
+                f.seek(0, os.SEEK_END)
+                file_handlers[(service, log_type)] = f
+                
+            console.print(f"\n[dim]正在跟踪日志... (按Ctrl+C停止)[/]")
+            
+            while True:
+                has_new_data = False
+                
+                for (service, log_type), f in file_handlers.items():
+                    line = f.readline()
+                    if line:
+                        has_new_data = True
+                        timestamp, message = self._parse_log_line(line)
+                        style = "stderr_service" if log_type == "stderr" else "stdout_service"
+                        console.print(f"[{style}]{service}[/] | {timestamp}: {message}")
+                
+                if not has_new_data:
+                    time.sleep(0.1)
+                    
+        except KeyboardInterrupt:
+            console.print(f"\n[dim]已停止日志跟踪[/]")
+        finally:
+            # 关闭所有文件
+            for f in file_handlers.values():
+                f.close()

servly/service.py

@@ -0,0 +1,215 @@
+"""
+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
+        # 修改为使用配置文件所在目录
+        config_dir = os.path.dirname(os.path.abspath(config_path))
+        self.servly_dir = Path(config_dir) / 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.3.0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,9 @@
+servly/__init__.py,sha256=HT8I94RyP6_gNoVJWOVSkeOEQIl3QnT60zCP2PJVon0,73
+servly/cli.py,sha256=YmaKXHRZm77MJnMZ400EkuNayjlBw5UDfM5Y6T2z5x0,9583
+servly/logs.py,sha256=pGU91fnWKHL5NprGrke7jNrLea23TXr3K3AF7J1KEQM,7802
+servly/service.py,sha256=c4UrS1smK3NqEsERbCwjQUo1SKSQb1TaIbAzM1lrHeM,8253
+servly-0.3.0.dist-info/METADATA,sha256=PD-b0BWdppEy69aREDOCDfWvpYf6G5elvHNF28MdPhY,2658
+servly-0.3.0.dist-info/WHEEL,sha256=lTU6B6eIfYoiQJTZNc-fyaR6BpL6ehTzU3xGYxn2n8k,91
+servly-0.3.0.dist-info/entry_points.txt,sha256=enHpE2d9DYdzfIWBcnIjuIkcNVk118xghL0AeTUL0Yg,43
+servly-0.3.0.dist-info/top_level.txt,sha256=JLi7GX0KwWF-mh8i1-lVJ2q4SO1KfI2CNxQk_VNfNZE,7
+servly-0.3.0.dist-info/RECORD,,

servly-0.3.0.dist-info/entry_points.txt

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

servly-0.3.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()