Skip to content

SKILL.md

Latest commit

 

History

History
304 lines (236 loc) · 7.71 KB

SKILL.md

File metadata and controls

304 lines (236 loc) · 7.71 KB
Raw
name run-tests
description Run project test suite

Run Tests Skill

📋 Overview

Intelligently run project test suites, automatically detecting test frameworks and executing:

  • 🔍 Auto-detection: Identify Jest, Pytest, Mocha, JUnit, etc.
  • 📊 Coverage reports: Generate code coverage statistics
  • ⚡ Parallel execution: Speed up test runs
  • 🎯 Selective testing: Support running specific tests

🔧 Prerequisites

Framework Language Detection Files Installation
Pytest Python pytest.ini, test_*.py pip install pytest pytest-cov
Jest JavaScript jest.config.js, *.test.js npm install --save-dev jest
Mocha JavaScript mocha.opts, test/ npm install --save-dev mocha
JUnit Java pom.xml, build.gradle Built into Maven/Gradle
Go Test Go *_test.go Built into Go

Note: AI will automatically detect the test framework used by the project

🚀 Usage

Method 1: Use AI Assistant

"Run project tests"
"Execute all unit tests"
"Run tests and generate coverage report"

Method 2: Run Commands Manually

Python (Pytest):

pytest                          # Run all tests
pytest --cov=.                  # Generate coverage
pytest tests/test_api.py        # Run specific file
pytest -k "test_login"          # Run matching tests
pytest -v                       # Verbose output

JavaScript (Jest):

npm test                        # Run all tests
npm test -- --coverage          # Generate coverage
npm test -- api.test.js         # Run specific file
npm test -- -t "login"          # Run matching tests
jest --watch                    # Watch mode

JavaScript (Mocha):

npm test                        # Run all tests
mocha test/                     # Specify directory
mocha test/**/*.test.js         # Use glob
mocha --reporter spec           # Specify reporter format

Java (Maven):

mvn test                        # Run all tests
mvn test -Dtest=ApiTest         # Run specific test class
mvn test -DfailIfNoTests=false  # Don't fail if no tests

Go:

go test ./...                   # Run tests in all packages
go test -v ./...                # Verbose output
go test -cover ./...            # Coverage
go test -run TestLogin          # Run specific test

🎯 Test Types

Unit Tests

  • ✅ Function/method level testing
  • ✅ Isolated dependencies (Mock/Stub)
  • ✅ Fast execution
  • ✅ High coverage targets

Integration Tests

  • ✅ Multi-component interaction testing
  • ✅ Database/API integration
  • ✅ End-to-end flows
  • ✅ Environment dependencies

Performance Tests

  • ✅ Response time testing
  • ✅ Load testing
  • ✅ Stress testing
  • ✅ Benchmark testing

📊 Output Examples

Pytest Output:

================================= test session starts ==================================
platform win32 -- Python 3.11.7, pytest-7.4.3
rootdir: C:\Project
plugins: cov-4.1.0
collected 45 items

tests/test_api.py ........                                                  [ 17%]
tests/test_auth.py .....                                                    [ 29%]
tests/test_database.py ..........                                           [ 51%]
tests/test_utils.py ....................                                    [100%]

---------- coverage: platform win32, python 3.11.7 -----------
Name                  Stmts   Miss  Cover
-----------------------------------------
src/api.py              120      5    96%
src/auth.py              85      0   100%
src/database.py         150     12    92%
src/utils.py             95      3    97%
-----------------------------------------
TOTAL                   450     20    96%

============================== 45 passed in 2.34s ==================================

Jest Output:

PASS  tests/api.test.js
PASS  tests/auth.test.js
PASS  tests/utils.test.js

Test Suites: 3 passed, 3 total
Tests:       45 passed, 45 total
Snapshots:   0 total
Time:        3.421 s
Ran all test suites.

----------------------|---------|----------|---------|---------|-------------------
File                  | % Stmts | % Branch | % Funcs | % Lines | Uncovered Line #s
----------------------|---------|----------|---------|---------|-------------------
All files             |   94.2  |   88.5   |   96.3  |   94.8  |
 api.js               |   96.5  |   90.2   |  100.0  |   97.1  | 45,78
 auth.js              |  100.0  |  100.0   |  100.0  |  100.0  |
 utils.js             |   89.4  |   82.1   |   91.7  |   90.2  | 23,45-48,92
----------------------|---------|----------|---------|---------|-------------------

⚙️ Configuration

Pytest (pytest.ini)

[pytest]
testpaths = tests
python_files = test_*.py
python_classes = Test*
python_functions = test_*
addopts = 
    -v
    --cov=src
    --cov-report=html
    --cov-report=term
    --cov-fail-under=80
markers =
    slow: marks tests as slow
    integration: marks tests as integration tests

Jest (jest.config.js)

module.exports = {
  testEnvironment: 'node',
  coverageDirectory: 'coverage',
  collectCoverageFrom: [
    'src/**/*.{js,ts}',
    '!src/**/*.test.{js,ts}',
  ],
  coverageThreshold: {
    global: {
      branches: 80,
      functions: 80,
      lines: 80,
      statements: 80,
    },
  },
  testMatch: [
    '**/__tests__/**/*.[jt]s?(x)',
    '**/?(*.)+(spec|test).[jt]s?(x)',
  ],
};

Mocha (.mocharc.json)

{
  "require": ["chai"],
  "spec": "test/**/*.test.js",
  "reporter": "spec",
  "timeout": 5000,
  "recursive": true
}

🔄 CI/CD Integration

GitHub Actions

name: Run Tests
on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      
      - name: Set up Python
        uses: actions/setup-python@v5
        with:
          python-version: '3.11'
      
      - name: Install dependencies
        run: |
          pip install -r requirements.txt
          pip install pytest pytest-cov
      
      - name: Run tests
        run: pytest --cov=src --cov-report=xml
      
      - name: Upload coverage
        uses: codecov/codecov-action@v3
        with:
          file: ./coverage.xml

GitLab CI

test:
  stage: test
  image: python:3.11
  script:
    - pip install -r requirements.txt pytest pytest-cov
    - pytest --cov=src --cov-report=term
  coverage: '/TOTAL.*\s+(\d+%)$/'

🆘 FAQ

Q: How to run only failed tests?
A:

  • Pytest: pytest --lf (last failed)
  • Jest: jest --onlyFailures

Q: How to skip slow tests?
A:

  • Pytest: Use marker @pytest.mark.slow then pytest -m "not slow"
  • Jest: Use test.skip() or --testPathIgnorePatterns

Q: How to run tests in parallel?
A:

  • Pytest: pip install pytest-xdist then pytest -n auto
  • Jest: Parallel by default, use --maxWorkers=4 to adjust

Q: What if test coverage is low?
A:

  1. Identify uncovered code: Check HTML report
  2. Write missing tests
  3. Refactor complex functions to improve testability

Q: What if tests run slowly?
A:

  1. Use parallel execution
  2. Mock external dependencies (database, API)
  3. Separate fast and slow tests

🔗 Related Resources