Konwerter TOML na JSON

Czym jest TOML i dlaczego warto konwertować na JSON?

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

const toml = `
[package]
name = "my-app"
version = "1.0.0"

[dependencies]
serde = { version = "1.0", features = ["derive"] }
`;

const data = parse(toml);
const json = JSON.stringify(data, null, 2);

console.log(json);
// {
//   "package": { "name": "my-app", "version": "1.0.0" },
//   "dependencies": {
//     "serde": { "version": "1.0", "features": ["derive"] }
//   }
// }

Kluczowe funkcje

Przykłady

[package]
name = "my-app"
version = "1.0.0"
edition = "2021"
authors = ["Jane Doe <jane@example.com>"]

[dependencies]
serde = { version = "1.0", features = ["derive"] }
tokio = { version = "1", features = ["full"] }

[dev-dependencies]
criterion = "0.5"

[[bin]]
name = "my-app"
path = "src/main.rs"

[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"
]

[project.optional-dependencies]
dev = ["pytest>=8.0", "ruff>=0.4"]

[tool.ruff]
line-length = 100

[build]
command = "npm run build"
publish = "dist"

[build.environment]
NODE_VERSION = "20"

[[redirects]]
from = "/old-path"
to = "/new-path"
status = 301
force = true

[[headers]]
for = "/*"

[headers.values]
X-Frame-Options = "DENY"

baseURL = "https://example.org"
languageCode = "en-us"
title = "My Hugo Site"
theme = "ananke"

[params]
description = "A static site built with Hugo"
mainSections = ["posts", "docs"]

[[menu.main]]
name = "Blog"
url = "/posts/"
weight = 1

[[menu.main]]
name = "About"
url = "/about/"
weight = 2

edition = "2021"
max_width = 100
hard_tabs = false
tab_spaces = 4
newline_style = "Unix"
use_small_heuristics = "Default"
reorder_imports = true
reorder_modules = true

title = "Deployment Log"
last_deployed = 1979-05-27T07:32:00Z
release_date = 1979-05-27
maintenance_window = 02:00:00

[[servers]]
name = "alpha"
ip = "10.0.0.1"
ports = [8001, 8002]

[[servers]]
name = "beta"
ip = "10.0.0.2"
ports = [9001]

Jak używać

1. 1

   Wklej swój TOML

   Wpisz lub wklej swój TOML do pola wejściowego powyżej. Możesz też kliknąć „Wczytaj przykład”, aby wypróbować prawdziwy plik Cargo.toml, pyproject.toml lub konfigurację wdrożenia.

2. 2

   Zobacz wynik JSON na żywo

   JSON pojawia się natychmiast w panelu wyjściowym. Dostosuj opcję Wcięcie (2 lub 4 spacje) do docelowego formatu. Daty, tabele i tablice tabel są obsługiwane automatycznie.

3. 3

   Kopiuj lub pobierz

   Kliknij Kopiuj, aby przenieść JSON do schowka, lub Pobierz, aby zapisać go jako plik .json gotowy dla Twojego programu, API lub narzędzi.

Typowe pułapki TOML

name = my-app

name = "my-app"

name = "a"
name = "b"

name = "a"
alt_name = "b"

released = 2026-7-2

released = 2026-07-02

ports = [8001, 8002

ports = [8001, 8002]

snowflake = 1420070400000000000

snowflake = "1420070400000000000"

[servers]
name = "a"
[servers]
name = "b"

[[servers]]
name = "a"
[[servers]]
name = "b"

Typowe zastosowania

Metadane Cargo w Rust

Konwertuj Cargo.toml na JSON, aby budować pulpity zależności, audytować wersje i cechy skrzyń (crate) lub przekazywać dane manifestu do skryptów i CI oczekujących JSON zamiast TOML.

Konfiguracja projektu Python

Konwertuj pyproject.toml na JSON, aby przeglądać metadane projektu PEP 621, wyodrębniać listy zależności lub zasilać narzędzia programowo odczytujące konfigurację pakowania.

Inspekcja konfiguracji wdrożenia

Konwertuj netlify.toml, foundry.toml lub inne konfiguracje platform na JSON, aby audytować przekierowania, nagłówki i ustawienia kompilacji lub wygenerować równoważną konfigurację dla innej platformy.

Migracja formatu konfiguracji

Konwertuj konfigurację aplikacji z TOML na JSON przy przejściu na system preferujący JSON lub jako krok pośredni przed dalszym przekształceniem za pomocą narzędzi JSON, takich jak jq.

Ustawienia witryny statycznej

Konwertuj plik config.toml witryny Hugo na JSON, aby migrować ustawienia witryny, porównywać konfigurację między środowiskami lub zbudować interfejs ustawień oparty na JSON.

Dane wejściowe API i skryptów

Zamień napisany przez człowieka TOML na JSON, który REST API, funkcja serverless lub skrypt automatyzacji może bezpośrednio wykorzystać, łącząc czytelną konfigurację z danymi wejściowymi dla maszyn.

Szczegóły techniczne

Parsowanie TOML 1.0.0 przez smol-toml

TOML jest parsowany za pomocą biblioteki smol-toml — parsera bez zależności, w pełni zgodnego z TOML 1.0.0. Poprawnie obsługuje zagnieżdżone tabele, klucze z kropkami, tabele wbudowane, tablice tabel, łańcuchy wieloliniowe i wszystkie cztery typy daty i czasu, a błędy parsowania zgłasza z pozycją wiersza i kolumny.

Bezstratna obsługa daty i czasu oraz bezpieczna obsługa liczb całkowitych

Daty i czasy TOML są serializowane do łańcuchów JSON zachowujących ich dokładny rodzaj (data-czas z przesunięciem, data-czas lokalny, data lokalna, czas lokalny). Liczby całkowite spoza bezpiecznego zakresu JavaScript (2^53 - 1) są podczas parsowania promowane do BigInt, a następnie konwertowane na najbliższą liczbę JSON z ostrzeżeniem o precyzji, więc prawidłowy TOML nigdy nie odmawia konwersji.

100% w przeglądarce — bez wysyłania, bez serwera

Całe przetwarzanie odbywa się w silniku JavaScript Twojej przeglądarki. Żadne dane nie są nigdzie przesyłane. Dane większe niż 200 KB przełączają się z trybu na żywo na tryb ręczny (jawne kliknięcie Konwertuj), aby interfejs pozostał responsywny.

Najlepsze praktyki

Przechowuj bardzo duże liczby całkowite jako łańcuchy

Jeśli Twój TOML ma liczby całkowite powyżej 2^53 - 1 (identyfikatory Snowflake, znaczniki czasu w nanosekundach, duże liczniki), przed konwersją umieść je w cudzysłowach jako łańcuchy. Liczby JSON w przeglądarce nie mogą przechować ich dokładnie, a narzędzie ostrzeże Cię, gdy będzie musiało zaokrąglić.

Preferuj wcięcie 2-spacjowe dla wyniku JSON

Wcięcie dwuspacjowe to najczęściej stosowana konwencja dla JSON i daje czysty, czytelny wynik, który dobrze współpracuje z większością formaterów i narzędzi do porównywania. Wcięcie czterospacjowe zostaw na sytuacje, gdy wymaga go przewodnik stylu.

Sprawdź poprawność wyniku JSON przed użyciem

Po konwersji, jeśli zamierzasz ręcznie edytować JSON lub przekazać go w miejsce o rygorystycznych wymaganiach, przepuść go przez nasz formater JSON, aby potwierdzić, że jest prawidłowy i spójnie sformatowany.

Przechowuj komentarze TOML osobno

JSON nie ma składni komentarzy, więc komentarze # z TOML są usuwane podczas konwersji. Jeśli komentarze stanowią ważną dokumentację, przechowuj oryginalny TOML w systemie kontroli wersji obok wygenerowanego JSON.

Używaj tablic tabel dla powtarzających się sekcji

Gdy masz wiele podobnych sekcji (serwery, przekierowania, pliki binarne), zapisuj je jako tablice tabel ([[section]]) zamiast powtarzać [section]. Konwertują się one na czystą tablicę obiektów JSON, zamiast powodować błąd zduplikowanej tabeli.

Często zadawane pytania