cweill/gotests is one of the server-side repositories TopGit tracks, currently at 5.3k stars, written primarily in Go. Automatically generate Go test boilerplate from your source code.
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
gotests is a powerful Go test generator that automatically creates table-driven tests from your source code. It analyzes function and method signatures to generate comprehensive test scaffolding, saving you time and ensuring consistency across your test suite.
Key Features
🚀 Zero-config test generation - Works out of the box with any Go project
🎯 Smart test scaffolding - Generates complete table-driven test structure with proper type handling
🔧 Flexible filtering - Generate tests for specific functions, exported functions, or entire packages
📦 Auto-imports - Automatically adds required imports to test files
🧬 Full generics support - Works seamlessly with Go 1.18+ type parameters
🔄 Recursive generation - Process entire directory trees with ./... pattern
🎨 Custom templates - Built-in support for testify and custom test templates
⚡ Parallel subtests - Optional parallel test execution support
Demo
The following shows gotests in action using the official Sublime Text 3 plugin. Plugins also exist for Emacs, also Emacs, Vim, Atom Editor, Visual Studio Code, and IntelliJ Goland.
Installation
Minimum Go version: Go 1.22
Use go install to install and update:
$ go install github.com/cweill/gotests/gotests@latest
Usage
From the commandline, gotests can generate Go tests for specific source files or an entire directory. By default, it prints its output to stdout.
$ gotests [options] PATH ...
Available options:
-all generate tests for all functions and methods
-excl regexp. generate tests for functions and methods that don't
match. Takes precedence over -only, -exported, and -all
-exported generate tests for exported functions and methods. Takes
precedence over -only and -all
-i print test inputs in error messages
-named switch table tests from using slice to map (with test name for the key)
-only regexp. generate tests for functions and methods that match only.
Takes precedence over -all
-nosubtests disable subtest generation when >= Go 1.7
-parallel enable parallel subtest generation when >= Go 1.7.
-w write output to (test) files instead of stdout
-template_dir Path to a directory containing custom test code templates. Takes
precedence over -template. This can also be set via environment
variable GOTESTS_TEMPLATE_DIR
-template Specify custom test code templates, e.g. testify. This can also
be set via environment variable GOTESTS_TEMPLATE
-template_params_file read external parameters to template by json with file
-template_params read external parameters to template by json with stdin
-use_go_cmp use cmp.Equal (google/go-cmp) instead of reflect.DeepEqual
-ai generate test cases using AI (requires Ollama)
-ai-model AI model to use (default "qwen2.5-coder:0.5b")
-ai-endpoint Ollama API endpoint (default "http://localhost:11434")
-ai-min-cases minimum number of test cases to generate with AI (default 3)
-ai-max-cases maximum number of test cases to generate with AI (default 10)
-version print version information and exit
AI-Powered Test Generation
gotests can generate intelligent test cases using local LLMs via Ollama. This feature analyzes your function implementations and generates realistic test values, edge cases, and error conditions.
Quick Start
Install Ollama (https://ollama.ai)
Pull a model:
ollama pull qwen2.5-coder:0.5b # Small, fast model (400MB)
# or
ollama pull llama3.2:latest # Larger, more capable (2GB)
Generate tests with AI:
gotests -all -ai -w yourfile.go
Example
Given this function:
func CalculateDiscount(price float64, percentage int) (float64, error) {
if price < 0 {
return 0, errors.New("price cannot be negative")
}
if percentage < 0 || percentage > 100 {
return 0, errors.New("percentage must be between 0 and 100")
}
discount := price * float64(percentage) / 100.0
return price - discount, nil
}
The AI generates (showing 3 cases; by default, the AI generates between 3-10 cases):
# Use a different model
gotests -all -ai -ai-model llama3.2:latest -w yourfile.go
# Generate a specific number of test cases (min = max)
gotests -all -ai -ai-min-cases 5 -ai-max-cases 5 -w yourfile.go
# Generate a range of test cases (AI chooses between 3-7)
gotests -all -ai -ai-min-cases 3 -ai-max-cases 7 -w yourfile.go
# Combine with other flags
gotests -exported -ai -parallel -w yourfile.go
How It Works
Analyzes function implementation and logic
Generates realistic test values based on actual code
Creates test cases for edge cases and error conditions
Function signatures (name, parameters, return types)
Complete function bodies including all code and comments
No file paths or project context
Privacy considerations:
⚠️ Function bodies may contain sensitive information - business logic, algorithms, or credentials/secrets in comments
✅ Local-first by default - Using Ollama keeps all data on your machine; nothing is sent to external servers
✅ Offline operation - AI generation works completely offline with local models
🔒 Recommendation: Avoid using -ai on code containing secrets, API keys, or proprietary algorithms in comments
If using cloud providers in the future:
Function source code will be transmitted to the cloud provider's API
Review the provider's data retention and privacy policies
Consider using -ai only on non-sensitive codebases
Quick Start Examples
Generate tests for a single function
Given a file math.go:
package math
func Add(a, b int) int {
return a + b
}
Generate a test:
$ gotests -only Add -w math.go
This creates math_test.go with:
func TestAdd(t *testing.T) {
type args struct {
a int
b int
}
tests := []struct {
name string
args args
want int
}{
// TODO: Add test cases.
}
for _, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
if got := Add(tt.args.a, tt.args.b); got != tt.want {
t.Errorf("Add() = %v, want %v", got, tt.want)
}
})
}
}
Generate tests for all exported functions
$ gotests -all -exported -w .
This generates tests for all exported functions in the current directory.
Generate tests recursively
$ gotests -all -w ./...
This generates tests for all functions in the current directory and all subdirectories.
Generate tests with testify
$ gotests -all -template testify -w calculator.go
This generates tests using the testify assertion library.
Common workflows
# Generate tests for all exported functions in a package
$ gotests -exported -w pkg/*.go
# Generate only tests for specific functions matching a pattern
$ gotests -only "^Process" -w handler.go
# Generate tests excluding certain functions
$ gotests -all -excl "^helper" -w utils.go
# Generate parallel subtests
$ gotests -all -parallel -w service.go
Go Generics Support
gotests fully supports Go generics (type parameters) introduced in Go 1.18+. It automatically generates tests for generic functions and methods on generic types.
Example: Generic Function
Given this generic function:
func FindFirst[T comparable](slice []T, target T) (int, error) {
for i, v := range slice {
if v == target {
return i, nil
}
}
return -1, ErrNotFound
}
The most recent commit recorded on cweill/gotests was 1.0 years ago, based on the GitHub push timestamp. The repository has 354 forks — one of the better signals of community interest.
How does cweill/gotests compare to other Backend projects?
cweill/gotests is tracked by TopGit in the Backend category, with 5.3k GitHub stars and written in Go. Browse the Backend topic page on TopGit to compare it against similar projects by stars and activity.
How many stars does cweill/gotests have?
cweill/gotests has 5.3k GitHub stars — refresh the page for the live number, or check github.com/cweill/gotests. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
Is cweill/gotests open source?
Yes — cweill/gotests ships under the Apache-2.0 license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/cweill/gotests.
What is cweill/gotests?
cweill/gotests (cweill/gotests) is a Go project on GitHub. From the project's own README: Automatically generate Go test boilerplate from your source code.
Where do I read more about cweill/gotests?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/cweill/gotests is the definitive source.
Read full README in the tab above.
Is gotests worth your time?
ChatGPT, Claude and Perplexity can all read this page. Ask one of them what it makes of gotests.