Skip to main content

nxdk-pgraph-test-runner

PyPI - Version PyPI - Python Version


Table of Contents

Purpose

This test harness utilizes the nxdk_pgraph_tests project to exercise the NV2A 3D accelerator on the original Microsoft Xbox. The runner is intended to be used with an emulator (e.g., xemu) and is able to detect and recover from crashes.

Installation

Prerequisites

  • An xbox emulator (e.g., xemu) - required

pip installation

# Optionally create a virtual env
#   pip -m venv .venv
#   source .venv/bin/activate

pip install nxdk-pgraph-test-runner

nxdk-pgraph-test-runner --help

Configuration

A default config may be generated by running the nxdk-pgraph-test-runner command.

Emulator command line

"emulator_command = /path/to/emulator {ISO}"

The command may utilize the following macros:

  • {ISO} - Replaced with the path to the nxdk_pgraph_tests.iso xiso file.

Example invocation

This is a sample invocation that will run xemu against a previously downloaded nxdk_pgraph_tests iso. It will create a results directory with the results of the tests.

nxdk-pgraph-test-runner \
    --override-ftp-ip 10.0.2.2 \
    --iso-path ~/nxdk_pgraph_tests_xiso.iso \
    --emulator-command "/path/to/xemu -dvd_path \"{ISO}\"" \
    -I lo0

This assumes that xemu is configured to use NAT networking, so the IP reported to the pgraph tester is set to the qemu 10.0.2.2 host address and the loopback interface (-I lo0) is used.

License

nxdk-pgraph-test-runner is distributed under the terms of the MIT license.

Metadata

Release files for nxdk-pgraph-test-runner 0.1.28

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for nxdk-pgraph-test-runner 0.1.28
File Size Uploaded
nxdk_pgraph_test_runner-0.1.28.tar.gz 21.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for nxdk-pgraph-test-runner 0.1.28
File Interpreter ABI Platform
nxdk_pgraph_test_runner-0.1.28-py3-none-any.whl Python 3 none any Details

Total release size: 43.2 kB

Release files / nxdk_pgraph_test_runner-0.1.28.tar.gz

Download URL nxdk_pgraph_test_runner-0.1.28.tar.gz
Size 21.1 kB
Tags Source
SHA-256 checksum
How to use checksums
def72907719bf18c42c74ec55001bbc0b53cb311d51281caa563124c4578a555
BLAKE2b-256 checksum
How to use checksums
7f76bd4912588ebe1580b30e99d8c2884195be28a4bb87bda203c274894e06f4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / nxdk_pgraph_test_runner-0.1.28-py3-none-any.whl

Download URL nxdk_pgraph_test_runner-0.1.28-py3-none-any.whl
Size 22.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
27bcd960cb759a1edf955927eefd32ed9fd501d5680e717a373adb315789b91f
BLAKE2b-256 checksum
How to use checksums
651515cf9998132b7d37ff3181f2982f5cc03805caeca26eb376bec0260a0ed7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release history Release notifications | RSS feed

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page