python-test-updater

Python Test Updater

Update Python tests to work correctly with new code versions.

Workflow

1. Understand the Inputs

Gather required inputs:

• Old version of Python code (file or content)
• New version of Python code (file or content)
• Old test module or test functions (file or content)

Verify inputs:

• Code files are valid Python
• Test files use pytest or unittest
• Files are readable

2. Analyze Code Changes

Automated analysis:

python scripts/analyze_code_diff.py <old_file> <new_file>

Manual analysis:

• Read both old and new code versions
• Identify what changed
• Understand the nature of changes

Identify change types:

Function signature changes:

• Added parameters
• Removed parameters
• Renamed parameters
• Changed parameter types
• Changed default values

Return value changes:

• Changed return type
• Changed return structure
• Added return fields
• Removed return fields

Behavior changes:

• Modified logic
• Changed validation rules
• Updated error handling
• Altered workflows

Class changes:

• Added/removed methods
• Modified constructor
• Changed inheritance
• Updated attributes

Async changes:

• Sync to async conversion
• Async to sync conversion

See test-update-patterns.md for detailed patterns.

3. Analyze Test Structure

Read the old tests:

• Identify test functions
• Understand test setup (fixtures, mocks)
• Note test assertions
• Check test organization

Identify test components:

• Test functions/methods
• Fixtures
• Parametrized tests
• Mocked dependencies
• Assertions

Map tests to code:

• Which tests cover which functions/classes
• What behavior each test verifies
• What assertions check what conditions

4. Determine Required Updates

For each code change, identify test impact:

Signature changes → Update function calls

# Old code: function(arg1, arg2)
# New code: function(arg1, arg2, arg3=default)

# Old test
result = function(value1, value2)

# Updated test
result = function(value1, value2)  # Works with default
# OR
result = function(value1, value2, value3)  # Explicit value