Go(고) 테스트 효율성의 혁명! Mockery(모커리)로 '가짜 객체' 자동 생성하고 칼퇴근!

Go(고) 테스트 효율성의 혁명! Mockery(모커리)로 '가짜 객체' 자동 생성하고 칼퇴근!

여러분, 안녕하세요! 코딩하다 보면 "이거 제대로 돌아가나?" 하고 테스트하는 과정, 정말 중요하지만 동시에 귀찮을 때도 많지 않습니까?

특히 내 코드가 다른 코드(외부 라이브러리나 모듈)랑 얽혀있을 때, 순수하게 내 코드만 테스트하기가 여간 까다로운 게 아닙니다.

이럴 때 등장하는 구원투수가 바로 '목 객체(Mock Object)', 우리말로는 '가짜 객체'라고 할 수 있는데요.

오늘 소개해 드릴 Mockery(모커리)는 바로 이 귀찮은 '가짜 객체' 만드는 작업을 대신 해주는 아주 고마운 도구랍니다.

Mockery(모커리)를 사용하면 테스트 효율성이 쭉쭉 올라가고, 개발 시간은 확 줄어드니, 오늘 저와 함께 Mockery(모커리)의 세계로 빠져보실까요?

Mockery(모커리)란 무엇일까요? 왜 써야 할까요?

Mockery(모커리)는 Go(고) 개발자들을 위해 특별히 설계된, 테스트용 목(Mock) 객체를 자동으로 만들어주는 강력하고 사용하기 쉬운 코드 생성 도구입니다.

우리가 만든 Go(고) 인터페이스(Interface, 어떤 기능을 제공해야 하는지에 대한 약속 같은 것)를 Mockery(모커리)가 똑똑하게 분석해서, 그 인터페이스를 따르는 '가짜' 구현체를 자동으로 만들어주는데요.

이렇게 하면 어떤 점이 좋을까요?

첫째, 개발자가 직접 목(Mock) 객체를 만드는 수고를 덜 수 있습니다.

반복적이고 지루한 작업은 Mockery(모커리)에게 맡기고, 우리는 더 중요한 핵심 로직 개발에 집중할 수 있게 된답니다.


둘째, 테스트 코드의 품질이 올라갑니다.

잘 만들어진 목(Mock) 객체는 테스트하려는 코드만 딱 분리해서, 외부 요인에 의한 영향 없이 정확하게 테스트할 수 있도록 도와주기 때문입니다.

Mockery(모커리)의 핵심 매력 포인트! 이것만은 알고 가세요!

Mockery(모커리)가 왜 많은 Go(고) 개발자들의 사랑을 받는지, 그 핵심적인 매력들을 한번 살펴보겠습니다.

1. 귀찮은 목(Mock) 객체, 이제는 자동 생성!

가장 큰 장점은 역시 목(Mock) 객체를 자동으로 만들어준다는 점입니다.

개발자가 일일이 손으로 목(Mock) 객체를 만들 필요 없이, Mockery(모커리)가 Go(고) 인터페이스를 분석해서 필요한 목(Mock) 구현체를 알아서 척척 만들어줍니다.

덕분에 시간도 절약하고, 실수할 가능성도 줄어든답니다.

2. Testify(테스티파이)와 찰떡궁합!

Mockery(모커리)는 Go(고) 테스트에서 아주 인기 있는 stretchr/testify(스트레처/테스티파이) 프레임워크와도 완벽하게 호환되어, 기존 테스트 코드에 자연스럽게 녹아들 수 있도록 설계되었답니다.

Testify(테스티파이)를 이미 사용하고 계신다면, Mockery(모커리)를 함께 사용했을 때 그 시너지가 어마어마할 것입니다.

3. 내 입맛대로 맞춤 설정 가능!

단순히 자동으로 만들어주는 것에서 그치지 않고, 개발자가 특정 테스트 상황에 맞게 생성된 목(Mock) 객체의 행동을 원하는 대로 조절할 수 있는 유연성까지 제공합니다.

어떤 함수가 호출되면 어떤 값을 반환할지, 혹은 특정 함수가 몇 번 호출되어야 하는지 등을 세밀하게 설정할 수 있어서, 정말 다양한 테스트 시나리오를 효과적으로 검증할 수 있습니다.

4. 명령어 한 줄이면 끝! 편리한 CLI(씨엘아이)

복잡한 설정 없이 간단한 명령줄 인터페이스(CLI, Command-Line Interface)를 제공해서, 개발자들이 손쉽게 목(Mock) 객체를 생성하고, 빌드 스크립트나 CI/CD(지속적 통합/지속적 배포) 파이프라인에도 쉽게 통합할 수 있도록 도와줍니다.

개발 효율성을 한층 더 높여주는 셈이죠.

Mockery(모커리) 사용법, 초간단 가이드! 바로 따라 해 보세요!

자, 그럼 이제 실제로 Mockery(모커리)를 어떻게 사용하는지 단계별로 알아보겠습니다.

정말 간단하니, 부담 갖지 말고 천천히 따라오십시오!

1단계: Mockery(모커리) 설치하기

가장 먼저 Mockery(모커리)를 우리 컴퓨터에 설치해야 합니다.

Go(고)의 패키지 매니저를 사용하면 아주 간단하게 설치할 수 있는데요.

터미널(명령 프롬프트)을 열고 다음 명령어를 입력해 주십시오.

// github.com/vektra/mockery/v2의 최신 버전을 설치합니다.
go install github.com/vektra/mockery/v2@latest

이 명령어 한 줄이면 Mockery(모커리) 설치는 끝입니다! 참 쉽죠?

2단계: 목(Mock) 객체 생성하기

Mockery(모커리)가 설치되었다면, 이제 우리 프로젝트에 있는 인터페이스들을 위한 목(Mock) 객체를 생성할 차례입니다.

프로젝트의 루트 디렉토리로 이동한 후, 다음 명령어를 실행하면 되는데요.

// 현재 프로젝트의 모든 인터페이스에 대한 목(Mock) 객체를 생성합니다.
mockery --all

이 mockery --all 명령어 한 방이면, 프로젝트 내 모든 인터페이스에 대한 목(Mock) 객체가 mocks라는 폴더(기본 설정) 안에 자동으로 뿅 하고 생성됩니다.

특정 인터페이스만 생성하고 싶다면 --name 옵션을 사용하면 된답니다.

3단계: 생성된 목(Mock) 객체, 테스트에서 활용하기

이렇게 만들어진 목(Mock) 객체는 테스트 파일에서 불러와서 사용하면 되는데요.

예를 들어, 우리가 테스트하려는 코드가 YourInterface(유어인터페이스)라는 인터페이스에 의존하고 있다고 가정해 봅시다.

Mockery(모커리)가 만들어준 mocks.YourInterface(목스.유어인터페이스)를 사용하면, 이 인터페이스의 실제 구현 없이도 테스트를 진행할 수 있습니다.

package main

import (
    "testing" // Go의 테스팅 패키지입니다.

    // testify/assert 패키지는 테스트 결과를 검증하는 데 도움을 줍니다.
    "github.com/stretchr/testify/assert"
    // mockery가 생성한 목 객체가 있는 경로를 적어줍니다. (실제 프로젝트 경로에 맞게 수정 필요)
    "github.com/your_project/mocks"
)

func TestExample(t *testing.T) {
    // mocks 패키지 안에 있는 YourInterface의 목 객체를 생성합니다.
    mockService := new(mocks.YourInterface)

    // 목 객체의 행동을 미리 설정합니다.
    // YourMethod가 "input"이라는 인자로 호출되면, "output"과 nil(오류 없음)을 반환하도록 설정합니다.
    mockService.On("YourMethod", "input").Return("output", nil)

    // 이제 테스트 코드에서 실제 서비스 대신 mockService를 사용합니다.
    result, err := mockService.YourMethod("input")

    // 반환된 결과와 오류를 검증합니다.
    assert.NoError(t, err)           // 오류가 없는지 확인합니다.
    assert.Equal(t, "output", result) // 결과값이 "output"과 같은지 확인합니다.

    // 목 객체가 우리가 설정한 대로 호출되었는지 확인합니다.
    mockService.AssertExpectations(t)
}

위 코드에서 mockService.On("YourMethod", "input").Return("output", nil) 이 부분은, '만약 YourInterface(유어인터페이스)의 YourMethod(유어메소드)가 "input"이라는 값으로 호출되면, "output"이라는 결과와 함께 오류는 없는 것으로 행동해줘!' 라고 목(Mock) 객체에게 미리 연기를 시키는 것과 같습니다.

그리고 실제로 mockService.YourMethod("input")를 호출하여 결과를 받고, assert 패키지를 사용해 그 결과가 우리가 예상한 값과 일치하는지 확인합니다.

마지막으로 mockService.AssertExpectations(t)는 '우리가 시킨 대로 목(Mock) 객체가 제대로 연기했는지 확인해줘!' 하는 부분이랍니다.

Mockery(모커리) 사용, 왜 강력 추천할까요? 개발 효율 UP! 코드 품질 UP!

Mockery(모커리)를 여러분의 Go(고) 개발 과정에 적극적으로 도입한다면, 다음과 같은 엄청난 효과들을 경험할 수 있습니다.

• 테스트 효율성 극대화: 수동으로 목(Mock) 객체를 만드는 시간을 절약하고, 더 많은 테스트 케이스를 작성하는 데 집중할 수 있습니다.
  
  
• 깔끔한 코드베이스 유지: 자동으로 생성된 일관된 목(Mock) 코드는 전체 코드베이스를 더욱 깔끔하고 유지보수하기 쉽게 만들어줍니다.
  
  
• 애플리케이션 안정성 강화: 더욱 철저하고 다양한 테스트를 통해 애플리케이션의 숨겨진 버그를 미리 찾아내고, 전반적인 안정성과 성능을 향상시킬 수 있습니다.
  
  

Mockery(모커리)에 대한 더 자세한 정보나 고급 사용법이 궁금하시다면, Mockery(모커리) 깃허브(GitHub) 저장소를 방문해 보시는 것을 추천한데요.

궁금증 해결! Mockery(모커리) 자주 묻는 질문 (FAQs)

Mockery(모커리)에 대해 아직 궁금한 점이 있으실 수 있습니다.

몇 가지 자주 나오는 질문들을 통해 궁금증을 해결해 드리겠습니다!

Q1: Mockery(모커리)가 Go(고) 테스트에 구체적으로 어떤 도움을 주나요?

A: Mockery(모커리)는 인터페이스(Interface)에 대한 목(Mock) 구현체를 자동으로 생성해 줍니다.

이를 통해 개발자가 직접 목(Mock) 코드를 작성하는 수고를 덜어주고, 테스트 커버리지를 높이는 데 도움을 준답니다.

Q2: Mockery(모커리)로 생성된 목(Mock) 객체를 원하는 대로 바꿀 수 있나요?

A: 네, 물론입니다! 개발자는 특정 테스트 시나리오에 맞춰 목(Mock) 객체의 행동을 자유롭게 커스터마이징할 수 있습니다.

이를 통해 더욱 정교하고 효과적인 테스트가 가능해집니다.

Q3: Mockery(모커리)를 CI/CD(씨아이/씨디) 파이프라인에서도 사용할 수 있나요?

A: 네, 그렇습니다! Mockery(모커리)는 간단한 명령줄 인터페이스(CLI)를 제공하기 때문에, 자동화된 빌드 및 테스트 워크플로우, 즉 CI/CD(씨아이/씨디) 파이프라인에 매우 쉽게 통합하여 사용할 수 있습니다.

반복적인 목(Mock) 객체 작성에 지치셨다면, 지금 바로 Mockery(모커리)를 도입해서 테스트 효율성을 극대화하고, 더 중요한 핵심 로직 개발에 집중해 보시는 건 어떨까요? 여러분의 Go(고) 개발 라이프가 한층 더 즐거워질 것이라고 확신합니다!

---