asyncapi-codegen

(★ 161)

An AsyncAPI Golang Code generator that generates all Go code from the broker to the application/user. Just plug your application to your favorite message broker!

파일 탐색기

최종 버전 다운로드 (.zip)

- - ci.yaml
- FUNDING.yml
- basic-schema.drawio
- basic-schema.svg
- codegen-preview.drawio
- codegen-preview.svg
- with-codegen-schema.drawio
- with-codegen-schema.svg
- - dagger.json
  - Makefile
- - Dockerfile
- - config.go
  - main.go
- util.go
- - interface.go
  - schema.go
  - versions.go
- - codegen.go
- - broker.go
  - broker_test.go
  - context.go
  - errorhandler.go
  - errors.go
  - logger.go
  - logger_test.go
  - middleware.go
- - map.go
  - map_test.go
  - must.go
  - must_test.go
  - pointer.go
  - reflect.go
  - reflect_test.go
  - slice.go
  - slice_test.go
  - string.go
- check-generation.sh
- brokers.go
- - main.go
- - help.mk
.asyncapi-tool
.cursorrules
.gitignore
.golangci.yml
CONTRIBUTING.md
CONTRIBUTORS.md
docker-compose.yaml
go.mod
go.sum
LICENSE
Makefile
README.md

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/lerenn/asyncapi-codegen

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd asyncapi-codegen

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. 공식 설치 스크립트

쉬움 추천

사전 준비물

Go go install 명령어를 쓰려면 Go가 필요합니다.

go install github.com/lerenn/asyncapi-codegen/cmd/asyncapi-codegen@latest

지정된 버전을 바로 다운로드해서 설치합니다. 레포를 직접 클론할 필요가 없습니다.

✅ 설치 후 새 터미널을 열고, 프로그램의 버전 확인 명령(예: --version)으로 정상 설치됐는지 확인하세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

3. Docker

쉬움

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Docker Desktop 컨테이너를 빌드하고 실행하려면 필요합니다. 설치 후 실행해서 백그라운드에 켜두세요.

docker run -v .:/code -w /code lerenn/asyncapi-codegen asyncapi-codegen -i ./asyncapi.yaml -p <your-package> -o ./asyncapi.gen.go

빌드된 이미지를 실제 컨테이너로 실행합니다.

✅ 터미널에 docker compose ps 를 입력해 컨테이너들이 Up 상태인지 확인하세요. README에 포트 번호가 적혀있다면 브라우저에서 http://localhost:포트번호 로 접속해보세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

4. Go

보통

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Go Go 언어 컴파일러 및 도구 모음입니다.

go install github.com/lerenn/asyncapi-codegen/cmd/asyncapi-codegen@latest

지정된 버전을 바로 다운로드해서 설치합니다. 레포를 직접 클론할 필요가 없습니다.

//go:generate go run github.com/lerenn/asyncapi-codegen/cmd/asyncapi-codegen@<version> -i ./asyncapi.yaml -p <your-package> -o ./asyncapi.gen.go

따로 빌드하지 않고 바로 Go 프로그램을 실행합니다.

✅ 빌드가 에러 없이 끝나면 성공입니다. go run . 을 썼다면 터미널 출력을 확인하세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

5. Make

보통

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Make Linux/macOS는 보통 기본 설치되어 있습니다. Windows는 별도 설치(예: MSYS2, WSL)가 필요합니다.

make

생성된 빌드 설정을 바탕으로 실제 컴파일을 진행해 실행 파일을 만듭니다.

✅ 에러 없이 끝나면 성공입니다. 생성된 실행 파일을 직접 실행해보세요.