Skip to content

Repository files navigation

한국어 | English | 日本語 | 简体中文 | 繁體中文

🦴 Spine

Spine

Spine는 실행 흐름이 드러나는 백엔드 프레임워크입니다.
요청이 어떻게 해석되고 실행되는지 숨기지 않습니다.

핵심 아이디어

  • 실행 순서와 책임을 코드 구조로 고정합니다
  • 메서드 시그니처가 API 계약입니다
  • path.*, query.*, httperr.* 의미 타입을 사용합니다

링크


Spine CLI

Spine CLI는 Spine 프로젝트와 구성 요소를 생성하고, 소스 코드에서 HTTP·DI·interceptor·consumer·WebSocket 실행 계약을 검사하는 Go CLI입니다. 계약 snapshot/diff와 OpenAPI·AsyncAPI 내보내기도 지원합니다.

Go 1.25.5 이상에서 짧은 spine 명령으로 설치할 수 있습니다.

go install github.com/NARUBROWN/spine-cli/cmd/spine@v0.1.4
spine version

새 프로젝트를 만들거나 기존 프로젝트의 계약을 검사합니다.

spine new todo-api --module github.com/acme/todo-api
spine context --root ./todo-api --json
spine contract check --root ./todo-api --warnings-as-errors --json
spine verify --root ./todo-api --warnings-as-errors --json

생성기는 기존 파일을 기본적으로 덮어쓰지 않습니다. 변경 전에는 dry-run의 diff와 base_hash를 검토한 뒤 같은 hash를 --if-match로 전달하세요.

spine g resource order --root . --dry-run --json
spine g resource order --root . --if-match <base_hash> --json

현재 CLI v0.1.4가 새 프로젝트에 지정하는 Spine 버전은 v0.5.1입니다. 이 저장소의 다른 버전이나 개발 snapshot과 함께 사용할 때는 생성된 go.mod와 계약 검사 결과를 확인하세요. 전체 명령과 정확한 분석 범위는 Spine CLI 문서를 참고하세요.


License

MIT

About

요청 처리 과정을 명시적으로 드러내는 실행 중심 백엔드 프레임워크, Execution-centric backend framework that makes request handling explicit.

Topics

Resources

Stars

Watchers

Forks

Releases

Contributors

Languages