XCUITest Goblin

Find orphaned tests, inconsistent naming, overused identifiers, bloated test files, and more — in under 1 second.

A zero-dependency CLI tool that analyzes your iOS XCUITest suite and surfaces actionable recommendations to keep your tests healthy.

📊 View Sample Report — See what XCUITest Goblin finds in a real project

Why Use This?

Your test suite grows organically. Tests get added, renamed, skipped, forgotten. Before you know it:

• 431 tests aren't in any test plan (they never run in CI)
• 16 files don't follow your naming convention
• 3 files have 30+ tests and are impossible to maintain
• 61 accessibility IDs are defined but never used in tests
• 5 test methods don't follow your naming convention

This tool finds these issues instantly and tells you exactly what to fix.

Quick Start

pip install xcuitest-goblin
xcuitest-goblin analyze /path/to/your/ios-project

That's it. In under a second, you get a full analysis report.

Example Output

✓ Analysis complete!

Results:
  - 58 test files
  - 505 test methods
  - 84 accessibility IDs
  - 15 test plans

Output: ./analysis/
Time: 0.15s

Sample Recommendations

## Recommendations

- **Split Large Test Files:** 3 file(s) contain more than 30 tests
- **Standardize File Naming:** 71.9% consistent, 16 non-compliant files
- **Standardize Method Naming:** 99.0% consistent (camelCase expected)
- **Refine Generic Accessibility IDs:** Done (150 uses), Cancel (58 uses)
- **Remove Unused Accessibility IDs:** 61 IDs defined but never used
- **Add Orphaned Tests to Plans:** 431 tests never run in CI

Use in Your PR Workflow

Add to your CI pipeline to catch test hygiene issues before they merge:

- name: Analyze Test Suite
  run: |
    xcuitest-goblin analyze . --quiet
    # Fails if critical issues found (coming soon)

Keep your test suite healthy with every PR.

Configurable Thresholds

Customize what triggers recommendations via thresholds.json:

xcuitest-goblin analyze /path/to/project --config ./my-thresholds.json

See Configuration Guide for all options.

Output Files

Installation

From PyPI (recommended)

pip install xcuitest-goblin

From Source

git clone https://github.com/jmcy9999/xcuitest-goblin.git
cd xcuitest-goblin
pip install -e .

Requires Python 3.10+. No external dependencies.

Documentation

• Usage Guide — CLI options, examples, configuration
• HTML Report Spec — Complete HTML report acceptance criteria

Try It Out

Give XCUITest Goblin a spin on your project and let us know what you think! We'd love your feedback — open an issue with suggestions, bug reports, or feature requests.

More features coming soon: CI integration with exit codes, test coverage analysis, flaky test detection, and more.

License

MIT