Gofakeit — фейковые данные в Go

Маскот Go: голубой гофер с крупными глазами на фоне колонн зелёных символов.

Надёжные и реалистичные тестовые данные критичны для качества и работоспособности приложений. Умение генерировать фейковые данные, имитирующие реальные сценарии, помогает покрыть больше кейсов и снижает количество ошибок в продакшне.

Стандартная библиотека Go не содержит инструментов для генерации фейковых данных, но в экосистеме есть несколько внешних пакетов. Один из популярных — Gofakeit.

Начало работы с Gofakeit

Превью Gofakeit на GitHub

Gofakeit — пакет для генерации фейковых данных в программах на Go. Он поддерживает множество типов данных, позволяет настраивать форматы, локализацию и реалистичную генерацию времени и дат.

Добавьте зависимость в проект (в каталоге проекта после go mod init):

go get github.com/brianvoe/gofakeit/v6

Импорт в файле .go:

import (
    "github.com/brianvoe/gofakeit/v6"
)

Общие возможности Gofakeit: генерация имён, email, телефонов, компаний, кредитных карт, фраз и многое другое. Также доступна инициализация структур через теги fake.

Генерация базовых фейковых данных

Простой пример, который генерирует и печатает разные типы фейковых значений:

package main

import (
    "fmt"
    "github.com/brianvoe/gofakeit/v6"
)

func main() {
    // Генерация фейкового имени
    name := gofakeit.Name()
    fmt.Println("Name:", name)

    // Фейковый email
    email := gofakeit.Email()
    fmt.Println("Email:", email)

    // Фейковый телефон
    phone := gofakeit.Phone()
    fmt.Println("Phone:", phone)

    // Фейковая компания
    company := gofakeit.Company()
    fmt.Println("Company:", company)

    // Фейковая кредитная карта
    creditCard := gofakeit.CreditCardNumber()
    fmt.Println("Credit Card:", creditCard)

    // Фейковая «хакерская» фраза
    hackerPhrase := gofakeit.HackerPhrase()
    fmt.Println("Hacker Phrase:", hackerPhrase)

    // Фейковая должность
    jobTitle := gofakeit.JobTitle()
    fmt.Println("Job Title:", jobTitle)

    // Фейковая валюта (аббревиатура)
    currency := gofakeit.CurrencyShort()
    fmt.Println("Currency:", currency)
}

Коротко: main генерирует несколько значений и выводит их в консоль. Это удобно для быстрого ручного тестирования и прототипов.

Заполнение структур через теги

Gofakeit умеет автоматически заполнять экспортируемые поля структур на основе тега fake.

import (
    "fmt"
    "time"

    "github.com/brianvoe/gofakeit/v6"
)

type Person struct {
    ID        string    `fake:"{uuid}"`
    FirstName string    `fake:"{firstname}"`
    LastName  string    `fake:"{lastname}"`
    Age       int       `fake:"{number:18,60}"`
    Email     string    `fake:"{email}"`
    Address   string    `fake:"{address}"`
    CreatedAt time.Time `fake:"{date}"`
}

func main() {
    var person Person

    gofakeit.Struct(&person)

    fmt.Printf("ID: %s\n", person.ID)
    fmt.Printf("First Name: %s\n", person.FirstName)
    fmt.Printf("Last Name: %s\n", person.LastName)
    fmt.Printf("Age: %d\n", person.Age)
    fmt.Printf("Email: %s\n", person.Email)
    fmt.Printf("Address: %s\n", person.Address)
    fmt.Printf("Created At: %s\n", person.CreatedAt)
}

Вызов gofakeit.Struct(&obj) заполнит поля, опираясь на синтаксис внутри тега fake.

Результат вывода структуры, заполненной Gofakeit

Генерация сложных текстов

Gofakeit генерирует предложения, абзацы и lorem ipsum:

package main

import (
    "fmt"

    "github.com/brianvoe/gofakeit/v6"
)

func generateRandomSentence() string {
    // Сгенерировать предложение из 6 слов
    sentence := gofakeit.Sentence(6)
    return sentence
}

func generateRandomParagraph() string {
    // Сгенерировать абзац из 3 предложений, 4–8 слов каждое
    paragraph := gofakeit.Paragraph(3, 4, 8, "\n")
    return paragraph
}

func generateLoremIpsum() string {
    // Generate 2 paragraphs of lorem ipsum text, 3–5 sentences per paragraph
    loremIpsum := gofakeit.LoremIpsumParagraph(3, 5, 12, "\n")
    return loremIpsum
}

func main() {
    // Необязательно: фиксировать seed для предсказуемых результатов
    gofakeit.Seed(0)

    fmt.Println("Random Sentence:")
    fmt.Println(generateRandomSentence())

    fmt.Println("\nRandom Paragraph:")
    fmt.Println(generateRandomParagraph())

    fmt.Println("\nLorem Ipsum Text:")
    fmt.Println(generateLoremIpsum())
}

Обратите внимание: Seed позволяет воспроизводить наборы данных между запусками — полезно для детерминированных тестов.

Использование с базой данных

Gofakeit удобно сочетать с пакетом database/sql для наполнения тестовой БД динамическими данными. Примерный шаблон вставки записей:

// Пример концепции: заполнение таблицы users
// db — *sql.DB
stmt, _ := db.Prepare("INSERT INTO users (id, name, email, created_at) VALUES (?, ?, ?, ?)")
for i := 0; i < 1000; i++ {
    id := gofakeit.UUID()
    name := gofakeit.Name()
    email := gofakeit.Email()
    createdAt := gofakeit.Date().Format(time.RFC3339)
    _, _ = stmt.Exec(id, name, email, createdAt)
}

Советы при наполнении БД:

Ограничьте объём тестовых данных в CI, чтобы не перегружать окружение.
Избегайте использования реальных PII — используйте только сгенерированные значения.
Разделяйте наборы данных: небольшие для unit-тестов, более крупные для интеграционных и нагрузочных.

Когда генерация фейковых данных не подходит

Important: фейковые данные удобны для тестирования, но не всегда заменяют реальные кейсы.

Тесты, критичные к точности бизнес-логики (финансовые расчёты, соответствие регуляциям), требуют максимально реалистичных или продакшн-образных данных.
Генераторы могут создавать синтаксически корректные, но семантически нереалистичные записи (например, несовместимые адреса и почтовые индексы).
Для тестов производительности реальная распределённость данных может отличаться от синтетической; учитывайте это при нагрузочном тестировании.

Альтернативные пакеты и совместимость

Если Gofakeit по каким-то причинам не подходит, рассмотрите:

github.com/go-faker/faker — более старые API и другой набор генераторов.
github.com/icrowley/fake — простая библиотека для базовых случаев.

Совет: проверяйте стабильность и активность репозитория перед выбором.

Практические методики и шаблоны

Мини-методология внедрения фейковых данных в тесты:

Определите классы данных: идентификаторы, PII, финансовые поля, временные ряды.
Напишите фабрики/продюсеры данных (функции, возвращающие объекты с фейковыми полями).
Используйте фиксацию seed для unit-тестов, рандомизацию для интеграционных.
Отдельно храните схемы данных для нагрузочных тестов.

Шаблон фабрики:

func NewFakeUser() User {
    return User{
        ID:    gofakeit.UUID(),
        Name:  gofakeit.Name(),
        Email: gofakeit.Email(),
        Age:   gofakeit.Number(18, 90),
    }
}

Чек-лист по ролям

Разработчику:
- Писать фабрики и wrapper’ы над gofakeit.
- Контролировать seed в unit-тестах.
- Не полагаться на один набор случайных значений.
Тестировщику:
- Создавать сценарии с краевыми и неожиданными значениями.
- Проверять валидацию и обработку ошибок при некорректных данных.
- Использовать как синтетические, так и зеркальные (копии продакшн) наборы где допустимо.
DBA/DevOps:
- Ограничивать объём тестовых данных в окружениях.
- Автоматизировать очистку тестовых таблиц.
- Следить за безопасностью и удалением PII.

Критерии приёмки для теста с фейковыми данными

Тест проходит локально и в CI при фиксированном seed.
Логика валидации и экстремальные кейсы покрыты.
Нет зависимостей от конкретных сгенерированных строк (мягкие утверждения).

Безопасность и конфиденциальность

Никогда не используйтесь настоящими PII (реальные emails/телефоны) в публичных тестовых базах.
Если импортируете продакшн-дамп для тестирования, примените анонимизацию/маскировку.
Для GDPR: храните и обрабатывайте персональные данные только в согласованных средах; по возможности используйте синтетические данные.

Полезный набор приёмов (cheat sheet)

gofakeit.Seed(0) — фиксированный seed для воспроизводимости.
gofakeit.UUID() — уникальный идентификатор.
gofakeit.Number(min, max) — число в диапазоне.
gofakeit.Date() — случайная дата.
gofakeit.Struct(&obj) — заполнение структуры по тегам.

Ментальные модели и когда усложнять генерацию

Простая модель: «фабрика каждого типа данных» — подходит для unit-тестов.
Сложная модель: генератор с правилами согласованности (например, страны ↔️ почтовые индексы) — нужен для интеграционных тестов.

Часто задаваемые вопросы

Как использовать эти фейковые тестовые данные?

Используйте их в unit-тестах и интеграционных тестах, чтобы проверить поведение мелких и составных частей приложения. Комбинируйте фиксированные и случайные наборы.

Какие ещё пакеты для тестирования есть в Go?

Go предоставляет пакет testing для написания тестов, бенчмарков и fuzz-тестирования. Gofakeit дополняет эти возможности, генерируя данные.

Откуда взялся Lorem Ipsum?

Lorem ipsum — распространённый тип заполнительного текста. Он используется разработчиками и дизайнерами как явный маркер «фейкового» текста, но при этом близок к настоящему языковому потоку.

Резюме

Gofakeit — мощный инструмент для генерации фейковых данных в Go.
Подходит для юнит-, интеграционных и некоторых видов нагрузочного тестирования.
Важны меры предосторожности: анонимизация, контроль PII и корректность семантики данных.

Notes: используйте синтетические данные как часть стратегии тестирования, но дополняйте их реальными сценариями там, где это необходимо.

Ключевые ссылки и ресурсы: репозиторий Gofakeit на GitHub и официальная документация пакета (поиск по имени пакета в pkg.go.dev).