psyexp-core

Task-agnostic harness for PsychoPy experiments, shared across the lab's task repos (heat-task, mid-task, mid-task-deterministic). It owns the plumbing that every task duplicates; each task repo keeps only its own stimuli, trial logic, and record schemas.

What's in here

Module	Responsibility
screen	setup_screen() — open a fullscreen PsychoPy window, enable VSYNC, run a frame-timing calibration, and return a ScreenDiagnostics.
diagnostics	The ScreenDiagnostics dataclass (import-light; no PsychoPy).
rundir	make_run_dir(data_dir, label, session_time) — timestamped output directory.
manifest	write_manifest(...) + system_info() — JSON run manifest with system/display/process diagnostics and the resolved psyexp_core_version. App-specific fields are injected via header / study_params.
recording	CsvWriter base class (maps a dataclass record onto a fixed column schema).
wizard	questionary / prompt_toolkit setup-wizard primitives: shared styles, ask_text / ask_select / ask_confirm, PosFloatValidator, prompt_unique_name, quit_app.
instructions	page_through(...) — a self-paced, keypress-driven instruction pager.
keyboard	PTB / PsychoPy-event keyboard abstraction.

Use from a task repo

Add it as a dependency. For day-to-day development, point at a local checkout so edits are live without reinstalling:

# your-task/pyproject.toml
dependencies = ["psyexp-core"]

[tool.uv.sources]
psyexp-core = { path = "../psyexp-core", editable = true }

For a reproducible release build, pin a tagged ref instead:

[tool.uv.sources]
psyexp-core = { git = "ssh://git@github.com/<you>/psyexp-core.git", tag = "v0.1.0" }

write_manifest records the resolved psyexp_core_version so each run is traceable back to a core version.