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.22

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.22
File Size Uploaded
nxdk_pgraph_test_runner-0.1.22.tar.gz 18.0 kB Details

Built distribution (wheel)

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

Total release size: 38.3 kB

Release files / nxdk_pgraph_test_runner-0.1.22.tar.gz

Download URL nxdk_pgraph_test_runner-0.1.22.tar.gz
Size 18.0 kB
Tags Source
SHA-256 checksum
How to use checksums
96611a3fbe03f80343c4fd0a4fb0621e3a4d96c7f357eb0b57c89ebd986abd90
BLAKE2b-256 checksum
How to use checksums
094eb7152983acf65854b1613f29802333667837395a950f1eaf496dc9cf4341
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.22-py3-none-any.whl

Download URL nxdk_pgraph_test_runner-0.1.22-py3-none-any.whl
Size 20.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d86a8acbea836dfcb8ecd222453f8ea17057acd89b92051ac40f096eb0ebe477
BLAKE2b-256 checksum
How to use checksums
967b7c3f1e9343b911a7ec1eac4a78bb9eb9a5b58cfcebdd5b5207a50858474d
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