Skip to content

near/nearcore / .claude/skills/migrate-pytest

migrate-pytest

Verified

Migrate a pytest integration test to the test-loop framework. Use when converting a pytest from pytest/tests/ to a deterministic test-loop test.

Migrate a pytest integration test to the test-loop framework.

Target pytest file: $ARGUMENTS

Follow these steps in order:

1. Understand the pytest

  • Read the target pytest file
  • Identify each distinct test scenario (steps, test methods, or test functions)
  • For each scenario, write in details:
    • What is being tested (the behavior under test)
    • The network topology (how many validators, archival nodes, RPC nodes, observers)
    • Key configuration (epoch_length, gc settings, archive mode, split storage, etc.)
    • The sequence of actions (start nodes, wait for blocks, kill/restart, send txs, etc.)
    • The assertions (what is verified and how)
  • Present this analysis to the user before proceeding
  • Write this analysis into <test_name>_migration.md in the project root.

2. Study the test-loop framework

  • Read test-loop-tests/README.md for the builder API and patterns
  • Read relevant examples from test-loop-tests/src/examples/ that are relevant to the pytest being migrated (list available examples with ls test-loop-tests/src/examples/)
  • Browse existing tests in test-loop-tests/src/tests/ for patterns similar to what the pytest does

3. Design the test-loop test

For each pytest scenario, decide:

  • Whether it maps to a separate #[test] function or can be combined
  • The simplest builder API setup that covers the scenario
  • Which test-loop utilities to use (runners, node accessors, transactions)
  • Whether any simplification is appropriate (the README says: "it would be extremely hard to migrate the logic precisely. Instead, migrate tests only if they make sense to you")

Present the plan to the user and get confirmation before writing code.

4. Write the test

  • Create test-loop-tests/src/tests/<test_name>.rs
  • Follow the instructions in test-loop-tests/README.md
  • Register the module in test-loop-tests/src/tests/mod.rs (keep alphabetical order)

5. Verify

  • Run cargo check --package test-loop-tests --features test_features to verify compilation
  • Run each test individually: cargo test --package test-loop-tests --features test_features -- tests::<module>::<test_name> --exact --show-output
  • Fix any compilation errors or test failures
  • Run cargo fmt --package test-loop-tests

6. Clean up the pytest

  • Delete the original pytest file
  • Remove its entries from nightly/pytest-sanity.txt (check for both regular and --features nightly variants, and commented-out spice variants)
  • Search for any other references to the pytest filename

7. Summary

Report what was done:

  • Which pytest scenarios were migrated (and any that were intentionally simplified or skipped)
  • The new test file location and test function names
  • Approximate runtime comparison if available
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 321kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 321kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 321kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 197kUpdated Claude CodeCodexVerifiedInstall