testing-basics
Essential testing patterns for any project. Use when: writing tests, setting up testing, or fixing test issues. Triggers: "test", "testing", "unit test", "write tests".
Installation
Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.
View source ↗GuidesSkill instructions
Testing Basics
Core testing patterns that apply to any language or framework.
Test Structure
AAA Pattern
Arrange → Act → Assert
# Arrange
user = User(name="Alice")
# Act
result = user.greet()
# Assert
assert result == "Hello, Alice!"
Test Types
| Type | Scope | Speed | When to use |
|---|---|---|---|
| Unit | Single function/class | Fast | Core logic |
| Integration | Multiple components | Medium | APIs, DB |
| E2E | Full system | Slow | Critical paths |
Naming Tests
test_[what]_[condition]_[expected]
Examples:
-
test_login_valid_credentials_returns_token -
test_checkout_empty_cart_raises_error -
test_search_no_results_returns_empty_list
What to Test
Do Test
- Business logic
- Edge cases
- Error handling
- Public interfaces
Don't Test
- Framework code
- Simple getters/setters
- Implementation details
- External services directly
Test Isolation
Each test should:
- Run independently
- Not depend on order
- Clean up after itself
- Not share state
Mocking
Mock external dependencies, not internal logic:
# Good: mock external service
@patch('app.services.email.send')
def test_signup_sends_welcome_email(mock_send):
signup(user)
mock_send.assert_called_once()
# Bad: mock internal implementation
@patch('app.models.user.User._validate') # Don't do this
Coverage
- Aim for meaningful coverage, not 100%
- Cover happy paths first
- Then error cases
- Then edge cases
Quick Checklist
Before committing:
- Tests pass locally
- New code has tests
- No flaky tests added
- Test names are descriptive
Examples
Read the usage examples in the source repository.
View source ↗Source history
- Indexed on
- 2026-01-20
- Index updated
- 2026-03-03
- Branch
- main
Index and sync dates describe this directory. View the source repository for code history.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!