testgen-cli

TestGen

AI-Powered Multi-Language Test Generation CLI

TestGen automatically generates production-ready tests for source code across JavaScript/TypeScript, Python, Go, Rust, and Java using LLM APIs (Anthropic Claude, OpenAI GPT, Google Gemini, Groq).

 ████████╗███████╗███████╗████████╗ ██████╗ ███████╗███╗   ██╗
 ╚══██╔══╝██╔════╝██╔════╝╚══██╔══╝██╔════╝ ██╔════╝████╗  ██║
    ██║   █████╗  ███████╗   ██║   ██║  ███╗█████╗  ██╔██╗ ██║
    ██║   ██╔══╝  ╚════██║   ██║   ██║   ██║██╔══╝  ██║╚██╗██║
    ██║   ███████╗███████║   ██║   ╚██████╔╝███████╗██║ ╚████║
    ╚═╝   ╚══════╝╚══════╝   ╚═╝    ╚═════╝ ╚══════╝╚═╝  ╚═══╝
 
                     Universal TEST Generator

Features

• 🖥️ Interactive TUI Mode: Full terminal UI with visual forms and live progress
• 🌍 Multi-Language Support: JavaScript/TypeScript, Python, Go, Rust, Java
• 🧪 Multiple Test Types: Unit, edge-cases, negative, table-driven, integration
• 🔌 Framework Aware: Jest, Vitest, pytest, Go testing, cargo test, JUnit
• 💰 Cost Optimized: Semantic caching, request batching
• 🔧 CI/CD Ready: JSON output, meaningful exit codes, quiet mode
• 🏗️ Clean Architecture: Extensible adapter pattern

Installation

Quick Install (Recommended)

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/princepal9120/testgen-cli/main/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/princepal9120/testgen-cli/main/install.ps1 | iex

From Source

# Clone the repository
git clone https://github.com/princepal9120/testgen-cli.git
cd testgen-cli

# Build
go build -o testgen .

# Install globally (optional)
go install .

Binary Releases

Download pre-built binaries from GitHub Releases.

Supported platforms:

• Linux: x86_64, aarch64
• macOS: x86_64, aarch64 (Apple Silicon)
• Windows: x86_64

Quick Start

Step 1: Get an API Key

Choose a provider and get your API key:

Step 2: Set Your API Key

# Choose ONE provider and set the environment variable:

# Anthropic Claude (recommended)
export ANTHROPIC_API_KEY="sk-ant-api03-xxxxx"

# OpenAI GPT
export OPENAI_API_KEY="sk-xxxxx"

# Google Gemini (free tier available)
export GEMINI_API_KEY="AIzaSyxxxxx"

# Groq (fastest, free tier)
export GROQ_API_KEY="gsk_xxxxx"

💡 Tip: Add this to your ~/.bashrc or ~/.zshrc to persist across sessions.

Step 3: Generate Tests

# Launch interactive TUI mode
testgen tui

# Or use CLI commands directly:

# Generate tests for a single file
testgen generate --file=./src/utils.py --type=unit

# Generate tests for a directory recursively
testgen generate --path=./src --recursive --type=unit,edge-cases

# Preview without writing files
testgen generate --path=./src --dry-run

# Analyze cost before generation
testgen analyze --path=./src --cost-estimate

Commands

testgen tui

Launch the interactive Terminal User Interface.

testgen tui

Features:

• Visual home screen to choose actions
• Interactive config forms (path, types, parallel, dry-run, validate)
• Command preview before execution
• Live progress with spinner and file-by-file updates
• Results summary with generated file paths

Controls:

testgen generate

Generate tests for source files.

testgen generate [OPTIONS]

Options:
  -p, --path string           Source directory to generate tests for
      --file string           Single source file to generate tests for
  -t, --type strings          Test types: unit, edge-cases, negative, table-driven, integration (default [unit])
  -f, --framework string      Target test framework (auto-detected by default)
  -o, --output string         Output directory for generated tests
  -r, --recursive             Process directories recursively
  -j, --parallel int          Number of parallel workers (default 2)
      --dry-run               Preview output without writing files
      --validate              Run generated tests after creation
      --output-format string  Output format: text, json (default "text")
      --include-pattern       Glob pattern for files to include
      --exclude-pattern       Glob pattern for files to exclude
      --batch-size int        Batch size for API requests (default 5)
      --report-usage          Generate usage/cost report

testgen validate

Validate existing tests and coverage.

testgen validate [OPTIONS]

Options:
  -p, --path string           Directory to validate (default ".")
  -r, --recursive             Check recursively (default true)
      --min-coverage float    Minimum coverage percentage (0-100)
      --fail-on-missing-tests Exit with error if tests missing
      --report-gaps           Show coverage gaps per file
      --output-format string  Output format: text, json (default "text")

testgen analyze

Analyze codebase for test generation cost estimation.

testgen analyze [OPTIONS]

Options:
  -p, --path string           Directory to analyze (default ".")
      --cost-estimate         Show estimated API costs
      --detail string         Detail level: summary, per-file, per-function (default "summary")
  -r, --recursive             Analyze recursively (default true)
      --output-format string  Output format: text, json (default "text")

Configuration

Create a .testgen.yaml file in your project root:

llm:
  provider: anthropic        # anthropic, openai, gemini, or groq
  model: claude-3-5-sonnet-20241022
  # Models per provider:
  #   anthropic: claude-3-5-sonnet-20241022
  #   openai: gpt-4-turbo-preview
  #   gemini: gemini-1.5-pro, gemini-1.5-flash
  #   groq: llama-3.3-70b-versatile, mixtral-8x7b-32768
  temperature: 0.3

generation:
  batch_size: 5
  parallel_workers: 4
  timeout_seconds: 30

output:
  format: text
  include_coverage: true

languages:
  javascript:
    frameworks: [jest, vitest]
    default_framework: jest
  python:
    frameworks: [pytest, unittest]
    default_framework: pytest
  go:
    frameworks: [testing]
  rust:
    frameworks: [cargo-test]

Environment Variables

Supported Languages

Exit Codes

CI/CD Integration

GitHub Actions

name: Generate Tests
on: [pull_request]

jobs:
  testgen:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-go@v5
        with:
          go-version: '1.25.7'
      - name: Install TestGen
        run: go install github.com/princepal9120/testgen-cli@latest
      - name: Generate tests
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: |
          testgen generate --path=./src \
            --recursive \
            --type=unit \
            --output-format=json

Development

# Run tests
go test ./... -v

# Build
go build -o testgen .

# Run linter
golangci-lint run

# Run local CI quality checks
make ci

Community and Governance

• Contributing guide: CONTRIBUTING.md
• Code of conduct: CODE_OF_CONDUCT.md
• Security policy: SECURITY.md
• Support channels: SUPPORT.md
• Roadmap: ROADMAP.md

Engineering Quality

Quality and release standards are documented in:

• QUALITY.md
• docs/TESTING_STRATEGY.md

License

Apache 2.0 - See LICENSE for details.