API 参考

核心类

PInstaller 类

class PInstaller:
    def __init__(self, config=None):
        """初始化安装器"""

    def install(self, package, version=None):
        """安装指定包"""

    def uninstall(self, package):
        """卸载指定包"""

    def update(self, package):
        """更新指定包"""

配置选项

安装配置

config = {
    # 目标目录
    'target_dir': '/usr/local/bin',

    # 备份设置
    'backup_existing': True,
    'backup_dir': '/tmp/backups',

    # 网络设置
    'timeout': 30,
    'retry_attempts': 3,

    # 日志设置
    'log_level': 'INFO',
    'log_file': '/var/log/pinstaller.log'
}

错误处理

异常类型

class PInstallerError(Exception):
    """基础异常类"""

class PackageNotFoundError(PInstallerError):
    """包不存在异常"""

class NetworkError(PInstallerError):
    """网络错误异常"""

class PermissionError(PInstallerError):
    """权限错误异常"""

事件系统

事件监听

```python def on_install_start(package): print(f"开始安装: {package}")

def on_install_complete(package): print(f"安装完成: {package}")

注册事件监听器

installer.on('install_start', on_install_start) installer.on('install_complete', on_install_complete)