Test Automator

# Test Automator

> A Claude Code skill for creating and maintaining automated tests.

## Installation

This skill is part of the [agent-playbook](../../README.md) collection.

## Usage

```
You: Write tests for this function
You: Create test cases
You: Improve test coverage
```

## Testing Frameworks

| Language | Framework |
|----------|-----------|
| TypeScript/JS | Jest, Vitest, Mocha |
| Python | pytest, unittest |
| Go | testing package |
| Java | JUnit |

## Scripts

Generate test boilerplate:
```bash
python scripts/generate_test.py <filename>
```

Check test coverage:
```bash
python scripts/coverage_report.py
```

## Resources

- [Testing Best Practices](https://google.github.io/eng-practices/review/developer/tests.html)
- [Test Driven Development](https://www.amazon.com/Test-Driven-Development-Kent-Beck/dp/0321146530)


# Test Automation Best Practices

- Keep tests deterministic
- Avoid test order dependencies
- Prefer explicit fixtures
- Run tests in CI on every change


# Examples

This directory contains small, focused test automation examples.


# Unit Test Example

```python
from my_module import add

def test_add():
    assert add(2, 3) == 5
```


# Mocking Guide

- Mock external services
- Avoid mocking internal logic
- Use realistic data shapes


#!/usr/bin/env python3
# Template generator for coverage report.

from pathlib import Path
import argparse
import textwrap


def write_output(path: Path, content: str, force: bool) -> bool:
    if path.exists() and not force:
        print(f"{path} already exists (use --force to overwrite)")
        return False
    path.parent.mkdir(parents=True, exist_ok=True)
    path.write_text(content, encoding="utf-8")
    return True


def main() -> int:
    parser = argparse.ArgumentParser(description="Generate a coverage report.")
    parser.add_argument("--output", default="coverage-report.md", help="Output file path")
    parser.add_argument("--name", default="example", help="Component or repo name")
    parser.add_argument("--owner", default="team", help="Owning team")
    parser.add_argument("--force", action="store_true", help="Overwrite existing file")
    args = parser.parse_args()

    content = textwrap.dedent(
        f"""\
        # Coverage Report

        ## Summary
        Coverage for {args.name}

        ## Ownership
        - Owner: {args.owner}

        ## Coverage Breakdown
        - Lines:
        - Branches:
        - Functions:

        ## Low Coverage Areas
        - Module:
        - Module:

        ## Action Items
        - Add missing tests
        - Track progress
        """
    ).strip() + "\n"

    output = Path(args.output)
    if not write_output(output, content, args.force):
        return 1
    print(f"Wrote {output}")
    return 0


if __name__ == "__main__":
    raise SystemExit(main())


#!/usr/bin/env python3
# Template generator for test plan.

from pathlib import Path
import argparse
import textwrap


def write_output(path: Path, content: str, force: bool) -> bool:
    if path.exists() and not force:
        print(f"{path} already exists (use --force to overwrite)")
        return False
    path.parent.mkdir(parents=True, exist_ok=True)
    path.write_text(content, encoding="utf-8")
    return True


def main() -> int:
    parser = argparse.ArgumentParser(description="Generate a test plan.")
    parser.add_argument("--output", default="tests/test-plan.md", help="Output file path")
    parser.add_argument("--name", default="example", help="Feature or release name")
    parser.add_argument("--owner", default="team", help="Owning team")
    parser.add_argument("--force", action="store_true", help="Overwrite existing file")
    args = parser.parse_args()

    content = textwrap.dedent(
        f"""\
        # Test Plan

        ## Scope
        {args.name}

        ## Ownership
        - Owner: {args.owner}
        - QA contact: TBD

        ## Scenarios
        - Happy path
        - Error handling
        - Edge cases

        ## Test T