Repository reference

Project root

5 files▾

Overview

Start with the product brief and repository contract.

1▾

README.md
project root

Build and packaging

Native build graph and Python packaging entry points.

2▾

Repository policy

Ignore rules and licensing metadata for the whole project.

2▾

Python wrapper

6 files▾

Entry points

Package marker and the Python CLI command surface.

2▾

Configuration

Default values and runtime settings for the Python wrapper.

2▾

Output

Terminal printing and report shaping for Python-facing flows.

2▾

Native commands

8 files▾

Entry point

Top-level native executable dispatch.

1▾

main.cpp
src

Check command

Interface and implementation for inspection-only checks.

2▾

Doctor command

Interface and implementation for diagnosis and repair flows.

2▾

Planned commands

Reserved files for build, setup, and validate behaviors.

3▾

Native core

16 files▾

Reporting and process

Core report types and subprocess execution primitives.

3▾

Platform and hardware detection

Host, driver, GPU, and CUDA environment discovery.

8▾

Repair and build helpers

Configuration, repo patching, and builder orchestration.

5▾

Kernels and UI

9 files▾

Elementwise kernel

Simple elementwise CUDA sample and shared declarations.

2▾

Memory benchmark

Memory transfer benchmarking kernels and declarations.

2▾

Reduction kernel

Reduction sample kernels and matching headers.

2▾

UI layer

Terminal placeholders and native report rendering.

3▾

Automation and tests

11 files▾

Automation

Bootstrap helpers and Docker environments for local reproduction.

3▾

C++ tests

Native coverage for CUDA environment, driver, and GPU probes.

3▾

Python tests

CLI, configuration, and report-output verification in Python.

3▾

Vendored placeholders

Reserved directories for future third-party dependencies.

2▾

Python wrapper regression tests

Implementedv0.0.0

tests/python/test_cli.py

This test module focuses on the Python bridge contract rather than CUDA semantics. It mocks `resolve_core_binary()` and `subprocess.run()` to prove that `check`, `doctor --json`, and `doctor auto --json` are forwarded exactly as expected.

cli.py pyproject.toml

Reference

Tests `check` forwarding.
Tests `doctor --json` forwarding.
Tests `doctor auto --json` forwarding.

Why it matters

The Python wrapper is intentionally thin, so argument-forwarding correctness is the main thing worth testing at this layer. These tests make sure the wrapper stays a transparent shim.

src/commands/doctor.cpp

cuda_doctor/__init__.py

Related files

Python wrapper

cuda_doctor/cli.py

Python entrypoint that resolves the native binary and forwards parsed CLI arguments into it.

Packaging

pyproject.toml

Defines the Python package metadata and registers the `cuda-doctor` console script entry point.