Node.js와 브라우저에서 타입이 지정된 스키마를 만들고 쿼리를 실행할 수 있는 GraphQL의 JavaScript 레퍼런스 구현입니다.
graphql-hive/graphql-inspector
GraphQL 스키마 비교, 호환성을 깨뜨리는 변경 탐지, 작업 검증, 유사 타입 검색을 지원하는 툴킷입니다.
- 스타
- 1,767
- 포크
- 218
- 열린 이슈
- 132
- 마지막 커밋
- 그저께
어떤 프로젝트인가요?
GraphQL Inspector는 두 GraphQL 스키마의 차이를 나열하고 각 변경 사항을 호환성을 깨뜨리는 변경, 호환성을 유지하는 변경, 위험한 변경으로 분류해 영향에 대한 설명을 제공합니다. 또한 스키마를 기준으로 쿼리, 뮤테이션, 프래그먼트를 검사해 잘못된 작업이 서버에 도달하기 전에 찾아낼 수 있습니다.
차이 비교 외에도 스키마 내에서 유사하거나 중복된 타입을 찾고, 스키마를 사용하는 작업과 프래그먼트를 바탕으로 스키마 커버리지를 보고합니다. 가짜 데이터를 제공하는 모의 GraphQL 서버와 GraphiQL을 실행할 수도 있습니다.
이 도구는 GitHub App, GitHub Action, CLI, Docker 이미지로 사용할 수 있으며 TypeScript 및 JavaScript 프로젝트를 위한 프로그래밍 API도 제공합니다.
핵심 기능
- 01두 스키마를 비교하고 각 변경 사항을 호환성을 깨뜨리는 변경, 호환성을 유지하는 변경, 위험한 변경으로 분류해 설명합니다.
- 02스키마를 기준으로 작업과 프래그먼트를 검증합니다.
- 03스키마 변경 알림을 전송합니다.
- 04유사하거나 중복된 타입을 찾습니다.
- 05작업과 프래그먼트를 바탕으로 스키마 커버리지를 보고합니다.
- 06가짜 데이터와 GraphiQL을 제공하는 모의 GraphQL 서버를 실행합니다.
활용 사례
- GitHub Action으로 pull request에서 호환성을 깨뜨리는 스키마 변경을 차단합니다.
- 배포 전에 CI에서 클라이언트 쿼리가 스키마에 부합하는지 확인합니다.
- 클라이언트 작업에서 실제로 사용하는 스키마 영역을 점검합니다.
- 대규모 GraphQL API에서 중복 타입을 정리합니다.
토픽
자주 묻는 질문
- graphql-inspector은(는) 무엇인가요?
- GraphQL 스키마 비교, 호환성을 깨뜨리는 변경 탐지, 작업 검증, 유사 타입 검색을 지원하는 툴킷입니다. GraphQL Inspector는 두 GraphQL 스키마의 차이를 나열하고 각 변경 사항을 호환성을 깨뜨리는 변경, 호환성을 유지하는 변경, 위험한 변경으로 분류해 영향에 대한 설명을 제공합니다. 또한 스키마를 기준으로 쿼리, 뮤테이션, 프래그먼트를 검사해 잘못된 작업이 서버에 도달하기 전에 찾아낼 수 있습니다.
- graphql-inspector은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- graphql-inspector은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- graphql-inspector은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. graphql-inspector의 마지막 커밋은 2026년 10월 20일입니다.
- graphql-inspector은(는) 어디에 사용할 수 있나요?
- GitHub Action으로 pull request에서 호환성을 깨뜨리는 스키마 변경을 차단합니다. 배포 전에 CI에서 클라이언트 쿼리가 스키마에 부합하는지 확인합니다. 클라이언트 작업에서 실제로 사용하는 스키마 영역을 점검합니다. 대규모 GraphQL API에서 중복 타입을 정리합니다.
- graphql-inspector은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/graphql-hive/graphql-inspector
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
REST, GraphQL, WebSocket, SSE, Socket.IO, MQTT 요청을 보내는 오픈소스 API 개발 도구 모음
GraphQL, REST, WebSockets, SSE, gRPC를 지원하고 로컬, Git, 클라우드 저장소를 제공하는 오픈소스 크로스 플랫폼 API 클라이언트입니다.
콘텐츠 모델에서 REST 및 GraphQL 콘텐츠 API를 생성하는 TypeScript 기반 오픈소스 셀프 호스팅 헤드리스 CMS입니다.
Grafast 실행 엔진과 PostGraphile 자동 GraphQL API 빌더를 포함한 GraphQL 및 PostgreSQL 도구 모노레포입니다.
GraphQL Federation 및 기타 GraphQL API를 위한 오픈소스 스키마 레지스트리·분석 플랫폼으로, Hive Cloud 또는 자체 호스팅 방식으로 사용할 수 있습니다.