rdp-session 0.2.2

Thin Python subprocess wrapper for the rdp-session Rust CLI

rdp-session Python Wrapper

Thin Python wrapper around the rdp-session Rust CLI.

The package invokes the CLI through subprocess.run, requests JSON output, and returns the parsed create-session report. It does not embed IronRDP directly.

Install

From PyPI:

python -m pip install rdp-session

PyPI wheels include the Windows x86_64 and ARM64 CLI binaries, so the wrapper can use the matching bundled rdp-session.exe immediately after installation.

python -m pip install -e .

From GitHub:

python -m pip install "git+https://github.com/jqwn/rdp-session.git"

As a pinned dependency:

rdp-session @ git+https://github.com/jqwn/rdp-session.git@<tag-or-commit>

Automatic binary download remains available for source/GitHub installs when no bundled, configured, or PATH binary is found. It is supported for released tags whose package version matches the release tag, for example 0.2.2 and v0.2.2. If you install from a branch or arbitrary commit, pass tool=... or set RDP_SESSION_BIN to a binary built from the same commit.

The Rust CLI is resolved in this order:

• pass tool=... to create_session
• set RDP_SESSION_BIN
• use the bundled PyPI wheel binary
• put rdp-session.exe on PATH
• on Windows x86_64 or ARM64, automatically download the matching versioned release asset from GitHub and cache it under the user's local app data directory after verifying the release .sha256 sidecar

Bundled, cached, and newly downloaded binaries are verified against .sha256 sidecars before execution. This catches corruption and cache replacement, but it is not a substitute for code signing.

Use

Password from environment:

from rdp_session import create_session

report = create_session(
    host="127.0.0.1",
    username="appuser",
    password_env="RDP_PASSWORD",
    screenshot=r"C:\Temp\rdp-desktop.png",
)

print(report.detached)

Password through subprocess stdin:

from rdp_session import create_session

report = create_session(
    host="127.0.0.1",
    username="appuser",
    password="secret",
)

Do not pass passwords in command-line arguments. When password is provided, the wrapper sends it to the child process through stdin.