go-add-test

go-add-test

Add unit/integration tests to a GOB Go microservice following established project patterns.

Triggers

• "add test", "add tests", "criar teste", "novo teste", "test coverage", "testar"
• "write tests for", "escrever testes para"
• Examples: "add tests for process-service service layer", "criar testes de domain para bulletin-service"

Instructions

You generate Go tests for GOB microservices following the MockFunc pattern established in gob-member-service and gob-auth-service.

Step 1: Identify Target

Parse the user request to determine:

• Service: which service in services/ (e.g., gob-process-service)
• Layer: which layer to test: domain, service, handler, repository, consumer
• Scope: specific file/method or entire layer

If not specified, ask the user.

Step 2: Pre-flight Reads

Before writing ANY test code, read these files in the target service:

1. Repository interfaces — internal/repository/repository.go or similar interface files
   • These define the methods you need to mock
2. Target source file — the file being tested (e.g., internal/service/member_service.go)
   • Understand every method signature, dependencies, and error paths
3. Domain structs — internal/domain/*.go
   • Needed for creating test fixtures
4. Existing tests — any *_test.go files in the target package
   • Follow existing patterns if tests already exist
5. DTO structs — internal/dto/dto.go if testing service/handler layer
   • Request/response types used by the methods

Step 3: Generate Mocks (if mocks_test.go doesn't exist)

Create mocks_test.go in the same package as the tests. Use the MockFunc pattern:

package service

import (
    "context"

    "github.com/google/uuid"
    "github.com/gob/{service}/internal/domain"
)

// --- MockXxxRepository ---

type MockXxxRepository struct {
    FindByIDFunc    func(ctx context.Context, id uuid.UUID) (*domain.Xxx, error)
    CreateFunc      func(ctx context.Context, entity *domain.Xxx) error
    UpdateFunc      func(ctx context.Context, entity *domain.Xxx) error
    DeleteFunc      func(ctx context.Context, id uuid.UUID) error
    ListFunc        func(ctx context.Context, limit, offset int) ([]*domain.Xxx, int, error)
    // Add one field per interface method
}

func (m *MockXxxRepository) FindByID(ctx context.Context, id uuid.UUID) (*domain.Xxx, error) {
    if m.FindByIDFunc != nil {
        return m.FindByIDFunc(ctx, id)
    }
    return nil, nil
}

func (m *MockXxxRepository) Create(ctx context.Context, entity *domain.Xxx) error {
    if m.CreateFunc != nil {
        return m.CreateFunc(ctx, entity)
    }
    return nil
}

// ... implement ALL interface methods with nil-check + safe default