Spindle이 OCaml 5용 Eio 웹 프레임워크를 제공한다

Spindle은 OCaml 5와 Eio로 웹 애플리케이션을 만드는 프레임워크입니다. 타입에서 JSON과 프런트엔드 스키마, API 문서까지 생성한다는 점에서 저는 멈춰 섰습니다. 서버와 화면이 각자 형식을 다시 적다가 어긋나는 일을 줄일 수 있기 때문입니다.

OpenAPI 문서를 서비스와 함께 제공하는 방식은 keepjson에서도 보입니다. keepjson은 대화형 문서와 OpenAPI 3.1 명세를 제공하고, Spindle은 타입에서 OpenAPI 문서를 생성합니다. 구현 방식은 다르지만 API 계약을 확인하기 쉽게 만든다는 점이 닮았습니다.

서버의 타입에서 JSON과 Zod 또는 Melange 스키마를 파생하고, 라우트 정의를 바탕으로 OpenAPI 3.2 문서를 제공합니다. 문서에서 API를 직접 시험할 수 있다는 점도 실용적입니다.

다만 이 선택은 OCaml 5와 Eio를 쓰는 프로젝트에 특히 잘 맞으므로, 다른 기술 스택을 쓰는 팀에는 이점이 제한적입니다. 자체 HTTP/1.1 엔진을 두고 RFC 요구사항을 테스트한다고 프로젝트는 설명합니다. 그 테스트가 있다는 사실과 실제 운영 환경의 프록시·클라이언트 조합에서 호환된다는 사실은 다릅니다.

OCaml 5와 Eio를 검토 중이라면 작은 라우트 하나를 만드십시오. 대화형 API 문서에서 입력 범위와 응답 가능한 오류가 어떻게 표시되는지 확인하십시오. 이어 실제로 쓰는 프록시와 클라이언트에서 같은 요청을 보내, 문서에 적힌 계약과 운영 경로가 맞아떨어지는지 직접 시험하십시오.

새 웹 프레임워크를 고를 때, 타입 정의와 API 문서가 실제 호출까지 이어지는지 어떤 순서로 확인하십니까?