WholeSum interview

This repository contains the prepared environment for a 40-minute pair-programming exercise. The exercise is a deliberately naive, self-contained toy example and does not represent the internal WholeSum architecture.

Before the interview

Install the project and confirm the baseline checks pass:

uv sync
uv run python -m pytest
uv run ruff check .
uv run ruff format --check .

The project requires Python 3.12 or later and uv.

Starting the exercise

At the start of the interview you will receive apply.sh and interview.patch. Place both files in the repository root, then run:

chmod +x apply.sh
./apply.sh
uv sync
uv run python -m pytest

apply.sh resets the repository to its prepared baseline before applying the exercise, so do not use it to preserve work in progress.

The applied patch adds CANDIDATE.md, which contains the problem statement and acceptance criteria. All exercise tests are visible.

Repository structure

• src/ws/interview/app.py contains the FastAPI application.
• src/ws/interview/database.py provides the transactional database fake.
• schema.sql documents the corresponding PostgreSQL entities.
• tests/ contains the test suite.