JSON to TOML 변환기

TOML이란 무엇이며 왜 JSON에서 변환하나요?

// Convert JSON to TOML in Node.js using the smol-toml library
import { stringify } from 'smol-toml';

const data = JSON.parse(`{
  "package": { "name": "my-app", "version": "1.0.0" },
  "dependencies": { "serde": { "version": "1.0" } }
}`);

// The top-level value must be an object; null values on objects are dropped.
const toml = stringify(data);

console.log(toml);
// [package]
// name = "my-app"
// version = "1.0.0"
//
// [dependencies.serde]
// version = "1.0"

주요 기능

예시

{
  "package": {
    "name": "my-app",
    "version": "1.0.0",
    "edition": "2021"
  },
  "dependencies": {
    "serde": { "version": "1.0", "features": ["derive"] },
    "tokio": { "version": "1", "features": ["full"] }
  }
}

{
  "build-system": {
    "requires": ["hatchling"],
    "build-backend": "hatchling.build"
  },
  "project": {
    "name": "my-package",
    "version": "0.3.1",
    "requires-python": ">=3.10",
    "dependencies": ["requests>=2.31", "pydantic>=2.0"]
  }
}

{
  "title": "My Service",
  "debug": false,
  "port": 8080,
  "database": {
    "host": "localhost",
    "port": 5432,
    "pool_size": 10
  },
  "features": ["auth", "metrics", "tracing"]
}

{
  "servers": [
    { "name": "alpha", "ip": "10.0.0.1", "ports": [8001, 8002] },
    { "name": "beta", "ip": "10.0.0.2", "ports": [9001] }
  ]
}

{
  "build": {
    "command": "npm run build",
    "publish": "dist",
    "environment": { "NODE_VERSION": "20" }
  },
  "redirects": [
    { "from": "/old", "to": "/new", "status": 301, "force": true }
  ]
}

{
  "tool": {
    "ruff": { "line-length": 100, "target-version": "py310" },
    "black": { "line-length": 100 }
  }
}

사용 방법

1. 1

   JSON 붙여넣기

   위 입력 필드에 JSON을 입력하거나 붙여넣으세요. 'Load example'을 클릭해 Cargo.toml 소스, pyproject.toml 소스, 앱 설정 객체를 시험해 볼 수도 있습니다.

2. 2

   실시간 TOML 출력 보기

   출력 패널에 TOML이 즉시 나타납니다. JSON에 최상위 배열이나 null 값이 있으면, 도구가 깨진 출력을 만드는 대신 무엇을 해야 하는지 정확히 설명합니다.

3. 3

   복사 또는 다운로드

   Copy를 클릭해 TOML을 클립보드에 담거나, Download를 클릭해 Cargo, Poetry, Hugo, Netlify, 또는 TOML을 읽는 모든 도구에 쓸 준비가 된 .toml 파일로 저장하세요.

흔한 JSON-to-TOML 함정

[1, 2, 3]

{ "items": [1, 2, 3] }

{ "name": "a", "nickname": null }

{ "name": "a", "nickname": "" }

{ "ports": [8001, null, 8003] }

{ "ports": [8001, 8003] }

{ 'name': 'a', 'active': true, }

{ "name": "a", "active": true }

{ "ratio": 1.0 }  →  ratio = 1

{ "ratio": 1.5 }  →  ratio = 1.5

{ "server": { "a": 1 }, "server": [1] }

{ "server": { "a": 1 }, "servers": [1] }

일반적인 사용 사례

Cargo.toml 생성

스캐폴딩 도구, API, 스크립트에서 나온 구조화된 JSON을 유효한 Rust Cargo.toml로 바꾸세요. 중첩된 [dependencies] 테이블과 인라인 테이블이 자동으로 생성됩니다.

pyproject.toml 생성

JSON 프로젝트 메타데이터를 점 표기 [tool.*] 테이블을 포함한 PEP 621 pyproject.toml로 변환하여, JSON을 내보내는 도구가 Python 패키징 구성을 생산하게 하세요.

JSON에서 사람이 편집하는 구성

애플리케이션의 JSON 설정을 사람이 편하게 편집할 수 있는 읽기 쉬운 TOML 구성 파일로 변환하고, 이후 주석을 손으로 추가하세요.

배포 구성 생성

JSON에서 netlify.toml, foundry.toml, 또는 유사한 플랫폼 설정을 생산하여, 중첩 객체와 객체 배열을 그 도구들이 기대하는 테이블과 테이블 배열로 바꾸세요.

구성 형식 마이그레이션

JSON 기반 시스템에서 TOML 기반 시스템으로 구성을 옮길 때 이 변환기를 다리로 삼고, null과 최상위 경고로 매핑되지 않을 부분을 잡아내세요.

TOML 구조 프로토타이핑

대부분의 개발자가 유창하게 입력하는 형식인 JSON으로 구성을 스케치한 다음, TOML로 변환하여 저장소에 커밋하기 전 관용적인 테이블과 테이블 배열 레이아웃을 확인하세요.

기술 세부 정보

RFC 8259 JSON 파싱

JSON 입력은 완전히 RFC 8259를 준수하는 브라우저의 기본 JSON.parse()로 파싱됩니다. 직렬화 전에 도구는 최상위 값이 객체인지 확인하고 null 값을 검사하여, 삭제되는 객체 키를 경고하거나 배열 안의 null을 정확한 경로와 함께 거부할 수 있습니다.

smol-toml을 통한 TOML 1.0.0 출력

TOML은 무의존성이며 완전히 TOML 1.0.0을 준수하는 직렬화기인 smol-toml 라이브러리로 생성됩니다. 중첩 객체는 테이블이 되고, 깊이 중첩된 객체는 점 표기 테이블이 되며, 객체 배열은 테이블 배열이 됩니다. 소수부가 0인 부동소수점은 TOML 규칙에 따라 정수로 작성되며 경고가 함께 나옵니다.

100% 브라우저 기반 — 업로드 없음, 서버 없음

모든 처리가 브라우저의 JavaScript 엔진에서 이루어집니다. 어떤 시점에도 데이터가 전송되지 않습니다. 200KB보다 큰 입력은 인터페이스 반응성을 유지하기 위해 실시간에서 수동 모드(명시적 Convert 클릭)로 전환됩니다.

모범 사례

최상위 배열은 키 아래로 감싸기

데이터가 자연스럽게 JSON 배열이라면 변환 전에 설명적인 키를 가진 객체({ "items": [...] })로 감싸세요. TOML 문서는 루트가 테이블이어야 하며, 키가 출력에서 배열에 명확한 이름을 부여합니다.

null이 무엇을 의미해야 하는지 정하기

변환 전에 null 필드가 사라져야 하는지(키 삭제) 값을 가져야 하는지 정하세요. TOML은 객체 null을 삭제하고 배열 null을 거부하므로, JSON에서 먼저 해결하면 예측 가능하고 완전한 출력을 얻습니다.

그룹화에는 중첩 객체 사용하기

JSON에서 관련 설정을 중첩 객체로 묶으세요 — 이는 TOML에서 깔끔한 [테이블]과 점 표기 테이블이 되며, 플랫한 키 목록보다 훨씬 읽기 쉽고 Cargo와 pyproject 구성이 조직되는 방식과 일치합니다.

JSON을 먼저 검증하기

JSON이 손으로 작성되었거나 신뢰할 수 없는 출처에서 왔다면, JSON 포매터로 검증하여 TOML로 변환하기 전에 후행 쉼표와 따옴표 실수를 잡으세요.

변환 후 주석 추가하기

JSON에는 주석이 없으므로 아무것도 넘어오지 않습니다. TOML은 # 주석을 지원하니, 생성된 TOML에 손으로 문서를 추가하세요 — 사람이 편집하는 구성을 애초에 TOML로 옮기는 주된 이유 중 하나입니다.

자주 묻는 질문