Go: модульное тестирование под микросервисной архитектурой (на базе Ginkgo, gomock, Gomega).
Go: модульное тестирование под микросервисной архитектурой (на базе Ginkgo, gomock, Gomega).

Введение

В этой статье для реализации модульного тестирования в основном используются инструменты Ginkgo[2], gomock[3] и Gomega[4]. Студенты, которые раньше этого не понимали, могут сначала ознакомиться с соответствующими документами.

1. Введение и краткое введение в пакет Ginkgo.

Язык кода:javascript
копировать
$ go get github.com/onsi/ginkgo/v2/ginkgo
$ go get github.com/onsi/gomega

Первая команда — получить ginkgo и установить ginkgo исполняемый файл в GOPATH/bin –- Вам нужно поставить его на свой компьютер GOPATH Настройте его и настройте. Вторая команда устанавливает все gomega библиотека. Таким образом, вы можете импортировать gomega Включите это в свой тестовый код:

Язык кода:javascript
копировать
import "github.com/onsi/gomega"
import "github.com/onsi/ginkgo"

Ginkgo подключается к существующей инфраструктуре тестирования Go, и вы можете использовать go test для запуска пакета Ginkgo. Это также означает, что тесты Ginkgo можно использовать наряду с традиционным тестированием Go. И go test, и ginkgo проведут все тесты в вашем наборе.

2. Использование Dockertest

Используйте Dockertest для завершения интеграционного теста базы данных соединений Golang нашего сервиса. Библиотека Dockertest предоставляет простые в использовании команды для запуска контейнеров Docker и их использования для тестирования. Простое понимание инструмента Dockertest заключается в использовании Docker для создания контейнера, его остановки и удаления после завершения тестового запуска. Более подробную информацию можно найти в официальном представлении Dockertest[5].

Установите Докертест

Язык кода:javascript
копировать
go get -u github.com/ory/dockertest/v3

Напишите код конфигурации Dockertest и используйте его для тестирования. Перейдите в service/user/internal/data/ и создайте в каталоге новый файл docker_mysql.go. Напишите код следующим образом:

Язык кода:javascript
копировать
package data

import (
 "database/sql"
 "fmt"
 "github.com/ory/dockertest/v3" // Обратите внимание на введение этого индивидуального пакета.
 "log"
 "time"
)

func DockerMysql(img, version string) (string, func()) {
 return innerDockerMysql(img, version)
}

// инициализация Docker mysql контейнер
func innerDockerMysql(img, version string) (string, func()) {
 // uses a sensible default on windows (tcp/http) and linux/osx (socket)
 pool, err := dockertest.NewPool("")
 pool.MaxWait = time.Minute * 2
 if err != nil {
  log.Fatalf("Could not connect to docker: %s", err)
 }
 
 // pulls an image, creates a container based on it and runs it
 resource, err := pool.Run(img, version, []string{"MYSQL_ROOT_PASSWORD=secret", "MYSQL_ROOT_HOST=%"})
 if err != nil {
  log.Fatalf("Could not start resource: %s", err)
 }

 conStr := fmt.Sprintf("root:secret@(localhost:%s)/mysql?parseTime=true", resource.GetPort("3306/tcp"))

 if err := pool.Retry(func() error {
  var err error
  db, err := sql.Open("mysql", conStr)
  if err != nil {
   return err
  }
  return db.Ping()
 }); err != nil {
  log.Fatalf("Could not connect to docker: %s", err)
 }

 // Функция обратного вызова закрывает контейнер
 return conStr, func() {
  if err = pool.Purge(resource); err != nil {
   log.Fatalf("Could not purge resource: %s", err)
  }
 }
}

Используйте Ginkgo для написания тестового кода, который ссылается на Dockertest, или создайте новый файл data_suite_test.go в этом каталоге. Напишите код следующим образом: В коде есть подробные комментарии, поэтому я не буду объяснять его здесь слишком подробно.

Язык кода:javascript
копировать
package data_test

import (
 "context"
 "github.com/pkg/errors"
 "gorm.io/gorm"
 "testing"
 "user/internal/conf"
 "user/internal/data"

 . "github.com/onsi/ginkgo"
 . "github.com/onsi/gomega"
)

// тест data метод
func TestData(t *testing.T) {
 //  Ginkgo позвонив Fail(description string) функция, указывающая на сбой
 // использовать RegisterFailHandler Передайте эту функцию Gomega ... это верно Ginkgo и Gomega единственная точка соединения между
 RegisterFailHandler(Fail)
 // уведомить Ginkgo Запустите тестовый пакет. Если кто-либо из ваших specs Неудача, Гинкго будет автоматически использовать testing.T неудача.
 RunSpecs(t, "test biz data ")
}

var cleaner func()      // Определить удаление mysql Функция обратного вызова контейнера
var Db *data.Data       // используется для теста data
var ctx context.Context // контекст

// initialize  AutoMigrate gorm метод, который автоматически создает таблицы
func initialize(db *gorm.DB) error {
 err := db.AutoMigrate(
  &data.User{},
 )
 return errors.WithStack(err)
}

// ginkgo использовать BeforeEach для твоего Specs Установить статус
var _ = BeforeSuite(func() {
 // Перед выполнением тестовых операций с базой данных, перед связью docker Создано контейнером mysql
 //con, f := data.DockerMysql("mysql", "latest")
 con, f := data.DockerMysql("mariadb", "latest")
 cleaner = f // Завершенный тест,Закрытие обратного вызова для контейнерметода
 config := &conf.Data{Database: &conf.Data_Database{Driver: "mysql", Source: con}}
 db := data.NewDB(config)
 mySQLDb, _, err := data.NewData(config, nil, db, nil)
 if err != nil {
  return
 }
 if err != nil {
  return
 }
 Db = mySQLDb
 err = initialize(db)
 if err != nil {
  return
 }
 Expect(err).NotTo(HaveOccurred())
})

// После окончания теста Закрыть и удалить с помощью функции обратного вызова docker Создано контейнером
var _ = AfterSuite(func() {
 cleaner()
})

Чтобы протестировать моделируемое соединение с базой данных, запустите команду go test в этом каталоге и получите следующие результаты:

Примечание. Здесь вы можете видеть, что, хотя есть 0 пройденных, есть также 0 сбойных. Это потому, что мы не проверяли это здесь. Мы просто проверяем, успешно ли соединение с базой данных, и мы не выполняли такие операции, как CURD. Операция здесь может быть медленной, поскольку образ mysql будет извлечен из Docker Hub. В этой статье используется образ mariadb, и я заранее загрузил образ mariadb:latest. Если на вашем компьютере установлен процессор Apple M1, рекомендуется использовать его. Мариадб.

3. Напишите модульные тесты

Долгая подготовительная работа наконец завершена. Теперь давайте формально напишем код модульного теста.

1. Напишите тестовый код для уровня данных.

Или создайте новый файл user_test.go в каталоге данных и напишите следующее содержимое:

Язык кода:javascript
копировать
package data_test

import (
 . "github.com/onsi/ginkgo"
 . "github.com/onsi/gomega"
 "user/internal/biz"
 "user/internal/data"
)

var _ = Describe("User", func() {
 var ro biz.UserRepo
 var uD *biz.User
 BeforeEach(func() {
  // Вот Db да data_suite_test.go определено в документе
  ro = data.NewUserRepo(Db, nil)
  // Здесь вы можете импортировать собранные извне данные.
  uD = &biz.User{
   ID:       1,
   Mobile:   "13803881388",
   Password: "admin123456",
   NickName: "aliliin",
   Role:     1,
   Birthday: 693629981,
  }
 })

 // настраивать It Блок для добавления отдельной индивидуальной спецификации
 It("CreateUser", func() {
  u, err := ro.CreateUser(ctx, uD)
  Ω(err).ShouldNot(HaveOccurred())
  // собранные данные mobile для 13803881388
  Ω(u.Mobile).Should(Equal("13803881388")) // Номер мобильного телефона должен быть номером мобильного телефона, записанным при создании для.
 })

})

Ω — это синтаксис пакета gomega, а это использование пакета гинкго.

Или запустите команду go test в этом каталоге и получите следующие результаты:

4. Внедрить пакет gomock, зависимости симуляции макета объекта.

Язык кода:javascript
копировать
// gomock В основном состоит из двух частей: gomock Библиотеки и вспомогательные инструменты генерации кода mockgen
go get github.com/golang/mock  
go get github.com/golang/mock/gomock
1. Напишите метод для создания фиктивных файлов.

Измените файл user/internal/biz/user.go.

Язык кода:javascript
копировать
package biz

// Обратите внимание, что эта строка добавляет mock команда данных
//go:generate mockgen -destination=../mocks/mrepo/user.go -package=mrepo . UserRepo
type UserRepo interface {
  CreateUser(context.Context, *User) (*User, error)
}

Войдите в каталог biz и выполните команду

Язык кода:javascript
копировать
mockgen -destination=../mocks/mrepo/user.go -package=mrepo . UserRepo

Здесь мы используем инструмент Mockgen, предоставленный Gomock, для создания реализации интерфейса, который будет имитироваться. При создании кода макета мы используем инструмент Mockgen. Он может автоматически генерировать код на основе заданного интерфейса.

После выполнения вы увидите дополнительный файл service/user/internal/mocks/mrepo/user.go.

2. Напишите методы тестирования для бизнес-слоя.

В каталоге уровня biz добавьте файл biz_suite_test.go со следующим содержимым:

Язык кода:javascript
копировать
package biz_test

import (
 "context"
 "github.com/golang/mock/gomock"
 . "github.com/onsi/ginkgo"
 . "github.com/onsi/gomega"
 "testing"
)

func TestBiz(t *testing.T) {
 RegisterFailHandler(Fail)
 RunSpecs(t, "biz user test")
}

var ctl *gomock.Controller
var cleaner func()
var ctx context.Context

var _ = BeforeEach(func() {
 ctl = gomock.NewController(GinkgoT())
 cleaner = ctl.Finish
 ctx = context.Background()
})
var _ = AfterEach(func() {
 // remove any mocks
 cleaner()
})

По-прежнему в каталоге бизнес-слоя добавьте новый файл user_test.go со следующим содержимым:

Язык кода:javascript
копировать
package biz_test

import (
 "github.com/golang/mock/gomock"
 . "github.com/onsi/ginkgo"
 . "github.com/onsi/gomega"
 "user/internal/biz"
 "user/internal/mocks/mrepo"
)

var _ = Describe("UserUsecase", func() {
 var userCase *biz.UserUsecase
 var mUserRepo *mrepo.MockUserRepo

 BeforeEach(func() {
  mUserRepo = mrepo.NewMockUserRepo(ctl)
  userCase = biz.NewUserUsecase(mUserRepo, nil)
 })

 It("Create", func() {
  info := &biz.User{
   ID:       1,
   Mobile:   "13803881388",
   Password: "admin123456",
   NickName: "aliliin",
   Role:     1,
   Birthday: 693629981,
  }
  mUserRepo.EXPECT().CreateUser(ctx, gomock.Any()).Return(info, nil)
  l, err := userCase.Create(ctx, info)
  Ω(err).ShouldNot(HaveOccurred())
  Ω(err).ToNot(HaveOccurred())
  Ω(l.ID).To(Equal(int64(1)))
  Ω(l.Mobile).To(Equal("13803881388"))
 })

})
3. Проверка модульных тестов

Или запустите команду go test в каталоге бизнес-слоя и получите следующие результаты:

краткое содержание

На данный момент метод тестирования операторов SQL на уровне данных и метод тестирования базовой логики в biz написаны и пройдены. Модульные тесты уровня сервиса аналогичны и не будут здесь писаться.

boy illustration
Неразрушающее увеличение изображений одним щелчком мыши, чтобы сделать их более четкими артефактами искусственного интеллекта, включая руководства по установке и использованию.
boy illustration
Копикодер: этот инструмент отлично работает с Cursor, Bolt и V0! Предоставьте более качественные подсказки для разработки интерфейса (создание навигационного веб-сайта с использованием искусственного интеллекта).
boy illustration
Новый бесплатный RooCline превосходит Cline v3.1? ! Быстрее, умнее и лучше вилка Cline! (Независимое программирование AI, порог 0)
boy illustration
Разработав более 10 проектов с помощью Cursor, я собрал 10 примеров и 60 подсказок.
boy illustration
Я потратил 72 часа на изучение курсорных агентов, и вот неоспоримые факты, которыми я должен поделиться!
boy illustration
Идеальная интеграция Cursor и DeepSeek API
boy illustration
DeepSeek V3 снижает затраты на обучение больших моделей
boy illustration
Артефакт, увеличивающий количество очков: на основе улучшения характеристик препятствия малым целям Yolov8 (SEAM, MultiSEAM).
boy illustration
DeepSeek V3 раскручивался уже три дня. Сегодня я попробовал самопровозглашенную модель «ChatGPT».
boy illustration
Open Devin — инженер-программист искусственного интеллекта с открытым исходным кодом, который меньше программирует и больше создает.
boy illustration
Эксклюзивное оригинальное улучшение YOLOv8: собственная разработка SPPF | SPPF сочетается с воспринимаемой большой сверткой ядра UniRepLK, а свертка с большим ядром + без расширения улучшает восприимчивое поле
boy illustration
Популярное и подробное объяснение DeepSeek-V3: от его появления до преимуществ и сравнения с GPT-4o.
boy illustration
9 основных словесных инструкций по доработке академических работ с помощью ChatGPT, эффективных и практичных, которые стоит собрать
boy illustration
Вызовите deepseek в vscode для реализации программирования с помощью искусственного интеллекта.
boy illustration
Познакомьтесь с принципами сверточных нейронных сетей (CNN) в одной статье (суперподробно)
boy illustration
50,3 тыс. звезд! Immich: автономное решение для резервного копирования фотографий и видео, которое экономит деньги и избавляет от беспокойства.
boy illustration
Cloud Native|Практика: установка Dashbaord для K8s, графика неплохая
boy illustration
Краткий обзор статьи — использование синтетических данных при обучении больших моделей и оптимизации производительности
boy illustration
MiniPerplx: новая поисковая система искусственного интеллекта с открытым исходным кодом, спонсируемая xAI и Vercel.
boy illustration
Конструкция сервиса Synology Drive сочетает проникновение в интрасеть и синхронизацию папок заметок Obsidian в облаке.
boy illustration
Центр конфигурации————Накос
boy illustration
Начинаем с нуля при разработке в облаке Copilot: начать разработку с минимальным использованием кода стало проще
boy illustration
[Серия Docker] Docker создает мультиплатформенные образы: практика архитектуры Arm64
boy illustration
Обновление новых возможностей coze | Я использовал coze для создания апплета помощника по исправлению домашних заданий по математике
boy illustration
Советы по развертыванию Nginx: практическое создание статических веб-сайтов на облачных серверах
boy illustration
Feiniu fnos использует Docker для развертывания личного блокнота Notepad
boy illustration
Сверточная нейронная сеть VGG реализует классификацию изображений Cifar10 — практический опыт Pytorch
boy illustration
Начало работы с EdgeonePages — новым недорогим решением для хостинга веб-сайтов
boy illustration
[Зона легкого облачного игрового сервера] Управление игровыми архивами
boy illustration
Развертывание SpringCloud-проекта на базе Docker и Docker-Compose