gitwebhooks 2.1.3__tar.gz → 2.2.0__tar.gz

{gitwebhooks-2.1.3 → gitwebhooks-2.2.0}/CLAUDE.md

@@ -42,26 +42,34 @@ sudo gitwebhooks-cli service uninstall
 # 方式1: 使用模块入口
 python3 -m gitwebhooks.cli -c /path/to/config.ini
 
-# 方式2: 使用 CLI 工具（使用默认配置）
+# 方式2: 使用 CLI 工具（自动查找配置文件）
 gitwebhooks-cli
 
 # 方式3: 指定配置文件
 gitwebhooks-cli -c /path/to/config.ini
 
 # systemd 服务管理
-systemctl start git-webhooks-server
-systemctl stop git-webhooks-server
-systemctl restart git-webhooks-server
-systemctl status git-webhooks-server
+systemctl start gitwebhooks
+systemctl stop gitwebhooks
+systemctl restart gitwebhooks
+systemctl status gitwebhooks
 ```
 
+**配置文件自动查找**：
+- 不指定 `-c` 参数时，系统按优先级自动查找配置文件：
+  1. `~/.gitwebhooks.ini`（用户级，最高优先级）
+  2. `/usr/local/etc/gitwebhooks.ini`（本地级）
+  3. `/etc/gitwebhooks.ini`（系统级）
+- 启动时会显示正在使用的配置文件路径
+- 找不到配置文件时显示友好的错误消息
+
 ### 测试开发
 ```bash
 # 直接运行（开发模式）
-./gitwebhooks-cli -c git-webhooks-server.ini.sample
+./gitwebhooks-cli -c gitwebhooks.ini.sample
 
 # 或使用模块方式
-python3 -m gitwebhooks.cli -c git-webhooks-server.ini.sample
+python3 -m gitwebhooks.cli -c gitwebhooks.ini.sample
 
 # 运行测试套件
 python3 -m pytest tests/
@@ -204,7 +212,7 @@ python3 -m pytest tests/
 ## 文件结构
 
 ```
-git-webhooks-server/
+gitwebhooks/
 ├── gitwebhooks-cli                  # CLI 命令行工具
 ├── gitwebhooks/                     # 主包目录
 │   ├── __init__.py                  # 包入口
@@ -250,8 +258,8 @@ git-webhooks-server/
 │   ├── integration/                 # 集成测试
 │   ├── utils/                       # 测试工具
 │   └── conftest.py                  # pytest 配置
-├── git-webhooks-server.ini.sample   # 配置文件模板
-├── git-webhooks-server.service.sample # systemd 服务模板
+├── gitwebhooks.ini.sample           # 配置文件模板
+├── gitwebhooks.service.sample       # systemd 服务模板
 ├── install.sh                       # 安装/卸载脚本
 ├── message.sh                       # 颜色输出辅助脚本
 ├── README.md                        # 项目说明（英文）
@@ -268,10 +276,10 @@ git-webhooks-server/
 
 ## 配置文件位置
 
-- 默认配置路径: `/usr/local/etc/git-webhooks-server.ini`
-- 日志文件: `/var/log/git-webhooks-server.log`
+- 默认配置路径: `/usr/local/etc/gitwebhooks.ini`
+- 日志文件: `/var/log/gitwebhooks.log`
 - 安装后的 CLI: `/usr/local/bin/gitwebhooks-cli`
-- systemd 服务: `/usr/lib/systemd/system/git-webhooks-server.service`
+- systemd 服务: `/usr/lib/systemd/system/gitwebhooks.service`
 
 ## Active Technologies
 - Python 3.6+ + Python 标准库（无外部依赖）
@@ -292,6 +300,7 @@ git-webhooks-server/
 - INI 配置文件，systemd 服务单元文件 (001-install-method-guidance)
 - Python 3.7+ (项目要求) + Python 标准库仅（无外部依赖） (001-fix-config-init-bug)
 - INI 配置文件 (configparser) (001-fix-config-init-bug)
+- Python 3.7+ (项目要求) + Python 标准库（pathlib, configparser, argparse） (001-config-priority)
 
 ## Recent Changes
 - 001-config-init-wizard: 添加 `config init` 交互式向导，支持配置级别选择、平台配置和仓库配置

{gitwebhooks-2.1.3 → gitwebhooks-2.2.0}/PKG-INFO

@@ -1,14 +1,14 @@
 Metadata-Version: 2.4
 Name: gitwebhooks
-Version: 2.1.3
+Version: 2.2.0
 Summary: A lightweight Git webhook server for automated deployment supporting GitHub, Gitee, GitLab, and custom webhooks
 Author-email: Troy Tse <troy@holyhi.net>
 Maintainer-email: Troy Tse <troy@holyhi.net>
 License-Expression: MIT
-Project-URL: Homepage, https://github.com/troytse/git-webhooks-server
-Project-URL: Documentation, https://github.com/troytse/git-webhooks-server#readme
-Project-URL: Repository, https://github.com/troytse/git-webhooks-server.git
-Project-URL: Issues, https://github.com/troytse/git-webhooks-server/issues
+Project-URL: Homepage, https://github.com/troytse/gitwebhooks
+Project-URL: Documentation, https://github.com/troytse/gitwebhooks#readme
+Project-URL: Repository, https://github.com/troytse/gitwebhooks.git
+Project-URL: Issues, https://github.com/troytse/gitwebhooks/issues
 Keywords: webhook,git,github,gitee,gitlab,deployment,automation,server,devops
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: No Input/Output (Daemon)
@@ -291,9 +291,47 @@ pip uninstall gitwebhooks
 
 ## Usage
 
+### Configuration File Auto-Discovery
+
+The `gitwebhooks-cli` automatically searches for configuration files in the following order (priority):
+
+1. **User level**: `~/.gitwebhooks.ini` (highest priority)
+2. **Local level**: `/usr/local/etc/gitwebhooks.ini`
+3. **System level**: `/etc/gitwebhooks.ini` (lowest priority)
+
+You can run `gitwebhooks-cli` without specifying `-c` parameter, and it will automatically use the first existing configuration file.
+
+```bash
+# Auto-discover and use configuration file
+gitwebhooks-cli
+
+# The server will display which config file is being used
+# Using configuration file: /home/user/.gitwebhooks.ini
+```
+
+If you want to use a specific configuration file, use the `-c` parameter:
+
+```bash
+# Use a specific configuration file
+gitwebhooks-cli -c /path/to/custom.ini
+```
+
+If no configuration file is found, a friendly error message will display all searched paths:
+
+```
+Error: Configuration file not found.
+Searched paths:
+  1. /home/user/.gitwebhooks.ini
+  2. /usr/local/etc/gitwebhooks.ini
+  3. /etc/gitwebhooks.ini
+
+You can create a configuration file using:
+  gitwebhooks-cli config init
+```
+
 ### 1. Configure Repository
 
-Edit `~/.gitwebhook.ini`:
+Edit your configuration file (e.g., `~/.gitwebhooks.ini`):
 
 ```ini
 [your_name/repository]
@@ -307,7 +345,7 @@ cmd=git fetch --all && git reset --hard origin/master && git pull
 # If running as a service
 systemctl restart gitwebhooks
 
-# Or run directly:
+# Or run directly (auto-discovers config file):
 gitwebhooks-cli
 ```
 

{gitwebhooks-2.1.3 → gitwebhooks-2.2.0}/README.md

@@ -251,9 +251,47 @@ pip uninstall gitwebhooks
 
 ## Usage
 
+### Configuration File Auto-Discovery
+
+The `gitwebhooks-cli` automatically searches for configuration files in the following order (priority):
+
+1. **User level**: `~/.gitwebhooks.ini` (highest priority)
+2. **Local level**: `/usr/local/etc/gitwebhooks.ini`
+3. **System level**: `/etc/gitwebhooks.ini` (lowest priority)
+
+You can run `gitwebhooks-cli` without specifying `-c` parameter, and it will automatically use the first existing configuration file.
+
+```bash
+# Auto-discover and use configuration file
+gitwebhooks-cli
+
+# The server will display which config file is being used
+# Using configuration file: /home/user/.gitwebhooks.ini
+```
+
+If you want to use a specific configuration file, use the `-c` parameter:
+
+```bash
+# Use a specific configuration file
+gitwebhooks-cli -c /path/to/custom.ini
+```
+
+If no configuration file is found, a friendly error message will display all searched paths:
+
+```
+Error: Configuration file not found.
+Searched paths:
+  1. /home/user/.gitwebhooks.ini
+  2. /usr/local/etc/gitwebhooks.ini
+  3. /etc/gitwebhooks.ini
+
+You can create a configuration file using:
+  gitwebhooks-cli config init
+```
+
 ### 1. Configure Repository
 
-Edit `~/.gitwebhook.ini`:
+Edit your configuration file (e.g., `~/.gitwebhooks.ini`):
 
 ```ini
 [your_name/repository]
@@ -267,7 +305,7 @@ cmd=git fetch --all && git reset --hard origin/master && git pull
 # If running as a service
 systemctl restart gitwebhooks
 
-# Or run directly:
+# Or run directly (auto-discovers config file):
 gitwebhooks-cli
 ```
 

{gitwebhooks-2.1.3 → gitwebhooks-2.2.0}/README.zh.md

@@ -251,9 +251,47 @@ pip uninstall gitwebhooks
 
 ## 使用
 
+### 配置文件自动查找
+
+`gitwebhooks-cli` 会自动按以下顺序（优先级）搜索配置文件：
+
+1. **用户级**：`~/.gitwebhooks.ini`（最高优先级）
+2. **本地级**：`/usr/local/etc/gitwebhooks.ini`
+3. **系统级**：`/etc/gitwebhooks.ini`（最低优先级）
+
+您可以直接运行 `gitwebhooks-cli` 而无需指定 `-c` 参数，系统会自动使用第一个存在的配置文件。
+
+```bash
+# 自动查找并使用配置文件
+gitwebhooks-cli
+
+# 服务器会显示正在使用的配置文件
+# Using configuration file: /home/user/.gitwebhooks.ini
+```
+
+如果需要使用特定的配置文件，可以使用 `-c` 参数：
+
+```bash
+# 使用指定的配置文件
+gitwebhooks-cli -c /path/to/custom.ini
+```
+
+如果找不到配置文件，会显示友好的错误消息并列出所有搜索路径：
+
+```
+Error: Configuration file not found.
+Searched paths:
+  1. /home/user/.gitwebhooks.ini
+  2. /usr/local/etc/gitwebhooks.ini
+  3. /etc/gitwebhooks.ini
+
+You can create a configuration file using:
+  gitwebhooks-cli config init
+```
+
 ### 1. 配置仓库
 
-编辑 `~/.gitwebhook.ini`：
+编辑您的配置文件（例如 `~/.gitwebhooks.ini`）：
 
 ```ini
 [your_name/repository]
@@ -267,7 +305,7 @@ cmd=git fetch --all && git reset --hard origin/master && git pull
 # 如果作为服务运行
 systemctl restart gitwebhooks
 
-# 或直接运行：
+# 或直接运行（自动查找配置文件）：
 gitwebhooks-cli
 ```
 

{gitwebhooks-2.1.3 → gitwebhooks-2.2.0}/gitwebhooks/__init__.py

@@ -3,7 +3,7 @@
 Automated deployment server supporting GitHub, Gitee, GitLab, and custom webhooks.
 """
 
-__version__ = '2.0.0'
+__version__ = '2.2.0'
 
 # Export main classes for convenient import paths
 from .server import WebhookServer

{gitwebhooks-2.1.3 → gitwebhooks-2.2.0}/gitwebhooks/cli/init_wizard.py

@@ -1,7 +1,7 @@
 """
 Interactive configuration initialization wizard.
 
-This module provides a user-friendly wizard for creating git-webhooks-server
+This module provides a user-friendly wizard for creating gitwebhooks
 configuration files through an interactive command-line interface.
 
 Features:
@@ -310,7 +310,7 @@ class Wizard:
     """
     Interactive configuration wizard.
 
-    Guides users through creating a git-webhooks-server configuration file
+    Guides users through creating a gitwebhooks configuration file
     by collecting server, platform, and repository configuration parameters.
     """
 
@@ -487,7 +487,7 @@ class Wizard:
             print("端口号必须在 1-65535 之间")
 
         # Log file
-        default_log = "/var/log/git-webhooks-server.log"
+        default_log = "/var/log/gitwebhooks.log"
         log_file = input(f"日志文件路径 [默认: {default_log}]: ").strip()
         if not log_file:
             log_file = default_log

{gitwebhooks-2.1.3 → gitwebhooks-2.2.0}/gitwebhooks/cli/service.py

@@ -111,7 +111,7 @@ def install_service(force: bool = False, verbose: int = 0, dry_run: bool = False
         print()
         print('For migration from conda:', file=sys.stderr)
         print('  1. Deactivate your conda environment: conda deactivate', file=sys.stderr)
-        print('  2. Install using pipx: pipx install git-webhooks-server', file=sys.stderr)
+        print('  2. Install using pipx: pipx install gitwebhooks', file=sys.stderr)
         print('     OR create a venv: python3 -m venv ~/venv/gitwebhooks', file=sys.stderr)
         return 1
 
@@ -205,14 +205,14 @@ def enable_and_start_service() -> int:
     # Ask if user wants to enable and start
     if not ask_yes_no('Enable and start service? (Y/n) ', default=True):
         print('Service installed but not started')
-        print('Start manually: sudo systemctl start git-webhooks-server')
+        print('Start manually: sudo systemctl start gitwebhooks')
         return 0
 
     # Enable service
     print('Enabling service...')
     try:
         subprocess.run(
-            ['systemctl', 'enable', 'git-webhooks-server'],
+            ['systemctl', 'enable', 'gitwebhooks'],
             check=True,
             capture_output=True
         )
@@ -224,7 +224,7 @@ def enable_and_start_service() -> int:
     print('Starting service...')
     try:
         subprocess.run(
-            ['systemctl', 'start', 'git-webhooks-server'],
+            ['systemctl', 'start', 'gitwebhooks'],
             check=True,
             capture_output=True
         )
@@ -234,7 +234,7 @@ def enable_and_start_service() -> int:
 
     print()
     print('Installation complete!')
-    print('Service status: systemctl status git-webhooks-server')
+    print('Service status: systemctl status gitwebhooks')
 
     return 0
 
@@ -302,7 +302,7 @@ def stop_and_disable_service() -> None:
     print('Stopping service...')
     try:
         subprocess.run(
-            ['systemctl', 'stop', 'git-webhooks-server'],
+            ['systemctl', 'stop', 'gitwebhooks'],
             check=False,
             capture_output=True
         )
@@ -314,7 +314,7 @@ def stop_and_disable_service() -> None:
     print('Disabling service...')
     try:
         subprocess.run(
-            ['systemctl', 'disable', 'git-webhooks-server'],
+            ['systemctl', 'disable', 'gitwebhooks'],
             check=False,
             capture_output=True
         )

{gitwebhooks-2.1.3 → gitwebhooks-2.2.0}/gitwebhooks/config/loader.py

@@ -98,15 +98,21 @@ class ConfigLoader:
 
         Note:
             Skips reserved section names: server, ssl, github, gitee, gitlab, custom
+            Skips repository sections with missing required options (logs warning)
         """
         configs = {}
         reserved_sections = self._get_reserved_sections()
 
         for section in self.parser.sections():
             if section not in reserved_sections:
-                repo_config = self.load_repository_config(section)
-                if repo_config is not None:
-                    configs[section] = repo_config
+                try:
+                    repo_config = self.load_repository_config(section)
+                    if repo_config is not None:
+                        configs[section] = repo_config
+                except (configparser.NoOptionError, ConfigurationError) as e:
+                    # Skip incomplete repository configurations
+                    import logging
+                    logging.warning('跳过不完整的仓库配置 [%s]: %s', section, e)
 
         return configs
 

{gitwebhooks-2.1.3 → gitwebhooks-2.2.0}/gitwebhooks/handlers/request.py

@@ -185,27 +185,32 @@ class WebhookRequestHandler(BaseHTTPRequestHandler):
 
         Returns:
             Tuple of (provider, event)
-        """
-        headers_dict = dict(self.headers)
 
+        Note:
+            HTTP headers are case-insensitive per RFC 2616.
+            Uses get() method which is case-insensitive for HTTPMessage.
+        """
         # GitHub
-        if HEADER_GITHUB_EVENT in headers_dict:
-            return Provider.GITHUB, headers_dict.get(HEADER_GITHUB_EVENT)
+        github_event = self.headers.get(HEADER_GITHUB_EVENT)
+        if github_event is not None:
+            return Provider.GITHUB, github_event
 
         # Gitee
-        if HEADER_GITEE_EVENT in headers_dict:
-            return Provider.GITEE, headers_dict.get(HEADER_GITEE_EVENT)
+        gitee_event = self.headers.get(HEADER_GITEE_EVENT)
+        if gitee_event is not None:
+            return Provider.GITEE, gitee_event
 
         # GitLab
-        if HEADER_GITLAB_EVENT in headers_dict:
-            return Provider.GITLAB, headers_dict.get(HEADER_GITLAB_EVENT)
+        gitlab_event = self.headers.get(HEADER_GITLAB_EVENT)
+        if gitlab_event is not None:
+            return Provider.GITLAB, gitlab_event
 
         # Custom
         custom_config = self._provider_configs.get(Provider.CUSTOM)
         if custom_config and custom_config.header_name:
-            header_value = headers_dict.get(custom_config.header_name, '')
-            if header_value.startswith(custom_config.header_value):
-                event = headers_dict.get(custom_config.header_event) if custom_config.header_event else None
+            header_value = self.headers.get(custom_config.header_name, '')
+            if header_value and header_value.startswith(custom_config.header_value):
+                event = self.headers.get(custom_config.header_event) if custom_config.header_event else None
                 return Provider.CUSTOM, event
 
         # Unable to identify

{gitwebhooks-2.1.3 → gitwebhooks-2.2.0}/gitwebhooks/logging/setup.py

@@ -5,6 +5,7 @@
 
 import logging
 import sys
+from pathlib import Path
 
 
 def setup_logging(log_file: str = None):
@@ -16,6 +17,7 @@ def setup_logging(log_file: str = None):
     根据配置设置日志记录：
     - 如果 log_file 为空，只输出到 stdout
     - 如果 log_file 非空，同时输出到文件和 stdout
+    - 如果日志目录不存在，只输出到 stdout（记录警告）
 
     Note:
         Python 3.8+ 使用 force 参数确保重新配置，
@@ -25,12 +27,21 @@ def setup_logging(log_file: str = None):
 
     # 文件处理器
     if log_file:
-        file_handler = logging.FileHandler(log_file, encoding='utf-8')
-        file_handler.setFormatter(logging.Formatter(
-            '%(asctime)s %(message)s',
-            datefmt='%Y-%m-%d %H:%M:%S'
-        ))
-        handlers.append(file_handler)
+        try:
+            log_path = Path(log_file)
+            # 确保日志目录存在
+            log_path.parent.mkdir(parents=True, exist_ok=True)
+
+            file_handler = logging.FileHandler(log_file, encoding='utf-8')
+            file_handler.setFormatter(logging.Formatter(
+                '%(asctime)s %(message)s',
+                datefmt='%Y-%m-%d %H:%M:%S'
+            ))
+            handlers.append(file_handler)
+        except (OSError, IOError) as e:
+            # 如果无法创建日志文件，回退到仅控制台输出
+            import warnings
+            warnings.warn(f'无法创建日志文件 {log_file}: {e}，将仅输出到控制台')
 
     # 控制台处理器
     console_handler = logging.StreamHandler(sys.stdout)

gitwebhooks-2.2.0/gitwebhooks/main/__init__.py

@@ -0,0 +1,182 @@
+"""CLI main function
+
+Command-line interface module providing compatibility with the original gitwebhooks.py.
+"""
+
+import argparse
+import sys
+from pathlib import Path
+from typing import List, Optional
+
+from gitwebhooks.server import WebhookServer
+from gitwebhooks.utils.exceptions import ConfigurationError
+from gitwebhooks.utils.constants import CONFIG_SEARCH_PATHS
+
+# Try to import subcommands, may not be available in older versions
+try:
+    from gitwebhooks.cli import register_subparsers
+    HAS_SUBCOMMANDS = True
+except ImportError:
+    HAS_SUBCOMMANDS = False
+
+
+def find_config_file() -> Optional[str]:
+    """Find configuration file by priority order.
+
+    Searches for configuration files in the following order:
+    1. User level: ~/.gitwebhooks.ini
+    2. Local level: /usr/local/etc/gitwebhooks.ini
+    3. System level: /etc/gitwebhooks.ini
+
+    Returns:
+        Path string of the first existing configuration file, or None if not found.
+
+    Examples:
+        >>> find_config_file()  # doctest: +SKIP
+        '/home/user/.gitwebhooks.ini'
+        >>> find_config_file()  # doctest: +SKIP
+        None
+    """
+    for config_path in CONFIG_SEARCH_PATHS:
+        expanded_path = Path(config_path).expanduser().resolve()
+        if expanded_path.exists():
+            return str(expanded_path)
+    return None
+
+
+def format_config_error(searched_paths: List[Path]) -> str:
+    """Format user-friendly error message for missing configuration file.
+
+    Args:
+        searched_paths: List of paths that were searched.
+
+    Returns:
+        Formatted error message string.
+
+    Examples:
+        >>> paths = [Path('/home/user/.gitwebhooks.ini')]
+        >>> format_config_error(paths)  # doctest: +SKIP
+        'Error: Configuration file not found.\\nSearched paths:\\n  1. /home/user/.gitwebhooks.ini\\n\\nYou can create a configuration file using:\\n  gitwebhooks-cli config init'
+    """
+    lines = [
+        'Error: Configuration file not found.',
+        'Searched paths:'
+    ]
+    for i, path in enumerate(searched_paths, 1):
+        lines.append(f'  {i}. {path}')
+    lines.append('')
+    lines.append('You can create a configuration file using:')
+    lines.append('  gitwebhooks-cli config init')
+    return '\n'.join(lines)
+
+
+def main(argv: List[str] = None) -> int:
+    """Main entry point
+
+    Args:
+        argv: Command-line argument list (defaults to sys.argv[1:])
+
+    Returns:
+        Exit code (0 = success, 1 = error)
+
+    Raises:
+        SystemExit: Exit on error
+
+    Command Line Arguments:
+        -h, --help      Show help message and exit
+        -c, --config    Specify configuration file path (optional)
+        service         Service management subcommands
+        config          Configuration management subcommands
+
+    Config Discovery:
+        When -c is not specified, searches in order:
+        1. ~/.gitwebhooks.ini (user level)
+        2. /usr/local/etc/gitwebhooks.ini (local level)
+        3. /etc/gitwebhooks.ini (system level)
+
+    Examples:
+        python3 -m gitwebhooks.main
+        python3 -m gitwebhooks.main -c /path/to/config.ini
+        gitwebhooks-cli --config /etc/webhooks.ini
+        gitwebhooks-cli service install
+        gitwebhooks-cli config init
+    """
+    if argv is None:
+        argv = sys.argv[1:]
+
+    # Create main argument parser
+    parser = argparse.ArgumentParser(
+        prog='gitwebhooks-cli',
+        description='Git Webhooks Server - Automated deployment webhook handler',
+        add_help=True
+    )
+    parser.add_argument(
+        '-c', '--config',
+        default=None,
+        help='Path to INI configuration file (default: auto-discover)'
+    )
+
+    # Add subcommands if available
+    if HAS_SUBCOMMANDS:
+        subparsers = parser.add_subparsers(dest='command', help='Subcommands')
+        register_subparsers(subparsers)
+
+    # Parse arguments
+    args = parser.parse_args(argv)
+
+    # If no subcommand, run server (backward compatible behavior)
+    if not hasattr(args, 'func'):
+        return run_server(args.config)
+
+    # Execute subcommand
+    return args.func(args)
+
+
+def run_server(config_file: Optional[str]) -> int:
+    """Run the webhook server
+
+    Args:
+        config_file: Path to configuration file, or None to auto-discover
+
+    Returns:
+        Exit code (0 = success, 1 = error)
+    """
+    # Auto-discover config file if not specified
+    if config_file is None:
+        config_file = find_config_file()
+        if config_file is None:
+            # No config found - format error with all search paths
+            searched_paths = [Path(p).expanduser().resolve() for p in CONFIG_SEARCH_PATHS]
+            error_msg = format_config_error(searched_paths)
+            print(error_msg, file=sys.stderr)
+            return 1
+
+    # Expand user path
+    config_path = Path(config_file).expanduser()
+
+    # Check configuration file exists
+    if not config_path.exists():
+        print(f'Error: Configuration file not found: {config_path}', file=sys.stderr)
+        return 1
+
+    # Print configuration file being used
+    print(f'Using configuration file: {config_path}')
+
+    # Create and run server
+    try:
+        server = WebhookServer(config_path=str(config_path))
+        server.run()
+        return 0
+    except ConfigurationError as e:
+        print(f'Configuration error: {e}', file=sys.stderr)
+        return 1
+    except KeyboardInterrupt:
+        print('\nServer stopped by user')
+        return 0
+    except Exception as e:
+        print(f'Error: {e}', file=sys.stderr)
+        return 1
+
+
+if __name__ == '__main__':
+    sys.exit(main())