Bundle and validate OpenAPI files into one publishable spec with swagger-cli
여러 파일로 구성된 OpenAPI 정의를 하나의 검증된 산출물로 병합하여 문서, 코드 생성 또는 CI 게이트가 스펙에 의존하기 전에 사전 검증합니다.
사전 요구 사항
Node.js, npm 또는 npx, 그리고 필요에 따라 로컬 또는 원격 $ref 대상을 사용하는 하나 이상의 Swagger/OpenAPI JSON 또는 YAML 파일
설치
사용자 환경에 맞는 상위 설치 또는 설정 경로를 따르십시오:
- npm install -g @apidevtools/swagger-cli
- git clone https://github.com/APIDevTools/swagger-cli.git
- npm install
- npm test
상위 저장소의 요구 사항 및 주의 사항:
- pre-commit 이라는 유용한 Python 도구가 있으며, 다양한 사전 커밋 검사를 실행하는 데 사용할 수 있습니다. swagger-cli validate 명령어를 git 사전 커밋의 일부로 통합할 수 있습니다.
기본 사용법 또는 시작 방법:
-
bash
-
swagger-cli [options]
-
상위 문서에서 추출: https://raw.githubusercontent.com/APIDevTools/swagger-cli/HEAD/README.md