python : pydantic = javascript : ?

6개월·

273

질문

자바스크립트에서 파이썬의 pydantic 과 비슷한 것이 무엇일까?

대답

자바스크립트 (정확히는 타입스크립트) 생태계에서 파이썬의 Pydantic과 가장 유사하고 현재 널리 쓰이는 라이브러리는 Zod입니다.

Pydantic의 핵심 기능은 **데이터 검증(validation)**과 타입 강제(type enforcement), 그리고 설정 관리입니다. Zod는 특히 이 중 데이터 검증과 타입스크립트의 타입 시스템을 연동하는 데 매우 강력한 기능을 제공합니다.

👑 Zod: Pydantic의 가장 강력한 대안

Zod는 "스키마 우선(schema-first)" 방식을 사용합니다. 즉, 데이터의 유효성 검사 스키마를 먼저 정의하면, Zod가 이 스키마로부터 타입스크립트 타입을 자동으로 추론해 줍니다.

Pydantic과 Zod의 유사점:

런타임 데이터 검증: Pydantic이 런타임에 입력 데이터(JSON 등)를 검증하듯이, Zod도 parse() 메소드를 통해 런타임에 데이터를 검증합니다.
타입 안전성: 검증을 통과한 데이터는 Pydantic 모델 인스턴스처럼 완벽하게 타입이 보장됩니다.
세밀한 검증 규칙: Pydantic에서 EmailStr, gt=0 등을 사용하듯, Zod도 .email(), .min(1), .optional() 등 다양한 검증 체인을 제공합니다.

코드 비교:

Pydantic과 Zod가 얼마나 유사한지 코드로 비교해 보겠습니다.

Python (Pydantic)

Python

from pydantic import BaseModel, EmailStr, PositiveInt

class User(BaseModel): 
  id: PositiveInt 
  name: str 
  email: EmailStr 
  is_active: bool = True

TypeScript (Zod)

TypeScript

import { z } from 'zod';
// 1. 스키마 정의 
const UserSchema = z.object({ 
  id: z.number().positive(), 
  name: z.string(), 
  email: z.string().email(), 
  is_active: z.boolean().default(true), 
});

// 2. 스키마로부터 타입 추론 
type User = z.infer;

// User 타입은 Pydantic의 User 클래스와 거의 동일한 
// { id: number; name: string; email: string; is_active: boolean; } 
// 타입을 갖게 됩니다.

🚀 다른 대안들

Zod가 현재 가장 인기가 많지만, Pydantic과 유사한 목적을 가진 다른 라이브러리들도 있습니다.

class-validator (와 class-transformer)
- Pydantic처럼 **클래스(class)와 데코레이터(@)**를 사용한다는 점에서 구조적으로 Pydantic과 매우 유사합니다.
- 객체지향 프로그래밍(OOP) 방식이나 NestJS 같은 프레임워크(Pydantic이 FastAPI와 자주 쓰이는 것처럼)와 함께 사용할 때 Pydantic과 거의 동일한 경험을 제공합니다.
- 예시:
  TypeScript
```
import { IsEmail, IsNotEmpty, IsPositive } from 'class-validator';

class User {
  @IsPositive()
  id: number;

  @IsNotEmpty()
  name: string;

  @IsEmail()
  email: string;
}
```
Joi
- Node.js 초창기부터 널리 쓰인 매우 성숙한 데이터 검증 라이브러리입니다.
- Zod 이전에 사실상의 표준이었으나, 타입스크립트 타입 추론 기능은 Zod보다 약합니다.
Yup
- Joi와 문법이 유사하며, 특히 React 생태계에서 폼(Form) 유효성 검사 라이브러리(예: Formik)와 함께 많이 사용됩니다.

요약

가장 현대적이고 Pydantic의 강력한 타입 연동 기능을 원한다면: Zod를 추천합니다.
NestJS를 사용하거나 클래스/데코레이터 기반의 OOP 방식을 선호한다면: **class-validator**가 Pydantic과 구조적으로 가장 유사합니다.

#pydantic

#zod