gombok

Hello Gombok! 👋

안녕하세요! 해당 도구는 Golang에서 Java Library 중 하나인 Lombok과 유사한 기능을 제공하는 도구입니다. 해당 도구를 사용하면, Golang에서 주석을 활용한 어노테이션을 이용해 Getter, Setter, Constructor, Builder 등 자주 사용하는 유틸함수를 쉽게 생성하여 사용할 수 있습니다.

🇺🇸 English

Install With Go

• 혹시 Go가 설치되어 있지 않으신가요?

터미널에 다음 명령어를 입력합니다.

$ go install github.com/YangTaeyoung/[email protected]

Usage

1. 어노테이션을 스캔할 폴더에 들어갑니다.

   cd <path>
   

   • 다음과 같은 파일이 있다고 가정합니다.

     // in ./test/test.go
     
     // @Builder
     type Test struct {
         Name string
         Age  int
     }
     

2. 아래의 명령어를 실행합니다.

   $ gombok
   

3. gombok는 test 폴더에 있는 모든 Go 파일들을 스캔하여, 어노테이션을 찾아 다음과 같은 파일을 생성합니다.

   // in ./test/test_gombok.go
   
   // DO NOT EDIT THIS FILE. THIS FILE WAS AUTO GENERATED BY GOMBOK.
   package test
   
   // TestBuilder is a builder for Test
   type TestBuilder struct {
       target *Test
   }
   
   // SetName sets the Name field of the target Test
   func (tb TestBuilder) WithName(name string) TestBuilder {
       tb.target.Name = name
   
       return tb
   }
   
   // SetAge sets the Age field of the target Test
   func (tb TestBuilder) WithAge(age int) TestBuilder {
       tb.target.Age = age
   
       return tb
   }
   
   // Build constructs a Test from the builder
   func (tb TestBuilder) Build() Test {
       return *tb.target
   }
   
   // NewTestBuilder creates a new builder instance for Test
   func NewTestBuilder() TestBuilder {
       return TestBuilder{target: &Test{}}
   }
   

4. 이제 다음과 같이 쉽게 만들어 진 함수를 사용할 수 있습니다.

   func SomeMethod() {
       test := NewTestBuilder().WithName("Yang").WithAge(25).Build()
   }
   

Annotations

Default Constructor

// @{생성자 어노테이션}.Default를 통해 해당 생성자를 패키지의 기본 생성자 New()로 만들 수 있습니다.

// some_file.go
// Test
// @AllArgsConstructor.Default
type Test struct {
    Name string
    Age  int
}

// some_file_gombok.go

// New
func New(name string, age int) Test {
   return Test{
      Name: name,
      Age:  age,
   }
}

Tags

다음 태그를 이용하여 gombok을 통해 생성되는 함수의 동작을 변경할 수 있습니다.

Example

// @Builder
type Test struct {
    Name string `builder:"ignore"`
    Age  int
}

Trouble Shooting 👊

$ gombok
> zsh: command not found: gombok

go로 설치한 프로그램을 실행할 때 발생하는 에러입니다. ~/.zshrc 파일(혹은 ~/.bashrc)의 하단에 다음과 같이 환경변수를 추가합니다.

# ...
export PATH="$HOME/go/bin:$PATH"