Files

API sandbox

Note: this document is intended for humans and robots alike.

Sandbox environment for:

  • tested snippets using our existing API
  • mocks of WIP future APIs (shimmed over the existing API)
  • tested snippets using the future API

Structure

The tests in test_current/ and test_draft/ are intended to match such that one can directly diff the directories:

git diff --no-index rerun_py/tests/api_sandbox/test_current rerun_py/tests/api_sandbox/test_draft

Tests outside of these directories are just for illustration purposes.

The snippets can be run using:

pytest -c rerun_py/pyproject.toml rerun_py/tests/api_sandbox

The rerun_draft is a mock of the future API. The implementation matters little, the main point is for the draft tests to pass.

Snapshots

This makes heavy use of inline_snapshots.

Run this command to fill and fix all snapshots:

pytest -c rerun_py/pyproject.toml rerun_py/tests/api_sandbox --inline-snapshot=fix,create

Formatting

As per usual, the formatting is checked using:

pixi run py-fmt-check