PyPTO Testing Skill

Overview

Build and test the PyPTO project to verify code changes haven't broken anything.

How to Use

1. Read agent instructions at .claude/agents/testing/AGENT.md
2. Invoke Task tool with subagent_type="testing" (specialized agent)
3. Agent will build project and run all tests

Environment Setup

If .claude/skills/testing/testing.env exists: Source it before testing.

bash
1[ -f .claude/skills/testing/testing.env ] && source .claude/skills/testing/testing.env

If doesn't exist: Skip and suggest creating one (see testing.env.example).

Testing Workflow

bash
1# 1. Activate environment (if testing.env exists)
2[ -f .claude/skills/testing/testing.env ] && source .claude/skills/testing/testing.env
3
4# 2. Build project
5cmake --build build
6
7# 3. Set PYTHONPATH
8export PYTHONPATH=$(pwd)/python:$PYTHONPATH
9
10# 4. Run tests
11python -m pytest tests/ut/ -v

Test Commands

bash
1# Run all tests
2python -m pytest tests/ut/ -v
3
4# Run specific test file
5python -m pytest tests/ut/test_ir_basic.py -v
6
7# Run specific test
8python -m pytest tests/ut/test_ir_basic.py::test_tensor_expr_creation -v
9
10# Run with coverage
11python -m pytest tests/ut/ --cov=pypto_core --cov-report=html

Test Structure

text
1tests/ut/
2├── core/          # Core functionality
3├── ir/            # IR (nodes, expressions, operators, parser)
4└── pass/          # Pass manager

Testing Checklist

• Project builds without errors
• No new compiler warnings
• All existing tests pass
• New features have tests
• Bug fixes have regression tests
• Tests in tests/ut/ (not elsewhere)

Common Issues

Output Format

text
1## Testing Summary
2**Status:** ✅ PASS / ⚠️ WARNINGS / ❌ FAIL
3
4### Build Results
5[Compiler output, warnings/errors]
6
7### Test Results
8- Total: X | Passed: X | Failed: X | Skipped: X
9
10### Failures
11[Failed test details if any]
12
13### Recommendations
14[Actions to fix issues]

Decision Criteria

Important Notes

• Always rebuild before running tests
• Check both build and test output
• Look for new warnings even if tests pass
• Verify new features have corresponding tests

Related Skills

• code-review - Code review (runs in parallel with testing)
• git-commit - Complete commit workflow