Skir: 프로토콜 버퍼 대안, 타입 안전 데이터 교환

Skir의 기능

Skir는 데이터 타입에 대한 단일 진실 공급원 역할을 하는 Protocol Buffers의 현대적 대안입니다. .skir 파일에 스키마를 한 번 작성하면 여러 언어를 위한 관용적이고 타입 안전한 코드를 생성합니다.

주요 기능 및 워크플로우

전체 구성은 하나의 YAML 파일에 있습니다. npx skir init으로 프로젝트를 초기화할 수 있습니다. 감시 모드는 파일이 변경될 때 자동으로 재컴파일합니다.

소스의 예시 스키마입니다:

struct Point {
  x: int32;
  y: int32;
  label: string;
}

struct Shape {
  points: [Point];
  /// 이 도형을 설명하는 짧은 문자열.
  label: string;
}
const TOP_RIGHT_CORNER: Point = {
  x: 600,
  y: 400,
  label: "top-right corner",
};

생성된 코드 사용법

생성된 코드에는 직렬화 및 역직렬화 메서드가 포함됩니다. TypeScript의 경우:

import { Point } from "../skirout/shapes";
const point = Point.create({
  x: 3,
  y: 4,
  label: "P"
});
const pointJson = Point.serializer.toJson(point);
console.log(pointJson); // [3, 4, "P"]
const restored = Point.serializer.fromJson(pointJson);
console.log(restored.label); // "P"

스키마 진화 및 RPC 지원

Skir는 장기간 운영되거나 분산 시스템에서 안전한 스키마 진화를 위한 내장 검사 및 가이드라인을 포함합니다. 또한 gRPC와 유사한 종단 간 타입 안전성을 가진 RPC를 지원합니다.

RPC 정의 예시:

struct WhatToWearRequest {
  temperature_celsius: float32;
  raining: bool;
}
struct WhatToWearResponse {
  bottom_outfit: string;
  sunglasses: bool;
}
method WhatToWear(WhatToWearRequest): WhatToWearResponse = 770862;