py-admin-launch 0.1.0

A cross-platform command launcher for administrator privileges.

py-admin-launch

A cross-platform Python command/helper to launch a specified program with administrator privileges.

Strategy

• Linux desktop: pkexec for polkit GUI authentication, falling back to sudo when pkexec is not available.
• Windows: ShellExecuteW(..., "runas", ...).
• macOS: osascript + with administrator privileges, falling back to sudo when osascript is not available.

If the current process is already administrator/root, the command is launched directly as the current user.

CLI

Run from source:

python -m py_admin_launch -- your-command arg1 arg2

After installing the package:

py-admin-launch -- your-command arg1 arg2

Useful options:

py-admin-launch --wait --cwd /path/to/workdir -- your-command arg1 arg2

Python API

from py_admin_launch import launch

launch(["python", "-m", "http.server", "80"])

launch() accepts a command list plus optional cwd and wait arguments:

result = launch(["your-command", "arg1"], cwd="/tmp", wait=True)
print(result.elevated, result.returncode)