Konwerter TOML na JSON

Witaj w narzędziu Konwerter TOML na JSON, darmowym narzędziu online, które zamienia dowolną konfigurację TOML w czysty, poprawny JSON jednym kliknięciem. Niezależnie od tego, czy migrujesz Cargo.toml do potoku opartego na JSON, wizualnie debugujesz głęboko zagnieżdżone ustawienia, czy wprowadzasz plik TOML do usługi akceptującej tylko JSON, ten konwerter poprawnie obsługuje każdą konstrukcję TOML: tabele, podtabele, tablice tabel, tabele wierszowe, klucze kropkowe, ciągi wielowierszowe, liczby szesnastkowe/ósemkowe/binarne, daty i specjalne liczby zmiennoprzecinkowe. Wybierz styl wyjściowy pasujący do Twojej pracy — pretty 2-space, pretty 4-space, kompaktowy lub sortowany według kluczy — i sprawdź wynik za pomocą drzewa struktury, panelu statystyk i diagramu transformacji.

Co to jest TOML i dlaczego warto go konwertować na JSON?

TOML (Tom's Obvious Minimal Language) to format konfiguracji zaprojektowany tak, aby był jednoznaczny i łatwy do odczytania dla ludzi. Obsługuje metadane pakietów dla Cargo (Rust), Poetry (Python) i wielu innych narzędzi deweloperskich. Z kolei JSON jest uniwersalnym formatem wymiany danych w sieci. Wiele systemów — interfejsy REST API, bazy danych dokumentów, localStorage w przeglądarce i aplikacje JavaScript — obsługuje wyłącznie JSON. Konwersja TOML na JSON pozwala połączyć te dwa światy bez konieczności ręcznego przepisywania konfiguracji.

Typowe powody konwersji TOML na JSON

• Przekazywanie TOML do API obsługującego tylko JSON — na przykład do usługi wdrażania lub platformy flag funkcji.
• Wizualna inspekcja głęboko zagnieżdżonej konfiguracji — struktura nawiasów klamrowych w JSON sprawia, że hierarchia jest widoczna na pierwszy rzut oka.
• Generowanie pakietów konfiguracyjnych front-endu — zachowaj format edycji w TOML, ale wysyłaj JSON do przeglądarki.
• Praca z linterami i JSON Schema — waliduj strukturę TOML, przepuszczając ją przez walidator JSON Schema.
• Porównywanie konfiguracji — porównuj (diff) posortowany JSON między środowiskami, aby wykryć różnice.
• Migracja starej konfiguracji — stopniowo przenoś plik TOML do usługi konfiguracyjnej opartej na JSON.

Kluczowe funkcje tego konwertera

• Pełna obsługa TOML 1.0 — ciągi podstawowe i literalne (jedno- i wielowierszowe), liczby całkowite w systemach dziesiętnym/szesnastkowym/ósemkowym/binarnym z separatorami podkreślenia, liczby zmiennoprzecinkowe z notacją naukową, inf, -inf, nan, wartości logiczne, daty i czasy.
• Zagnieżdżone struktury — tabele, podtabele ([a.b.c]), tablice tabel ([[a]]), tabele wierszowe ({ a = 1, b = 2 }) i klucze kropkowe.
• Cztery style wyjściowe — pretty 2-space, pretty 4-space, kompaktowy (zminifikowany) oraz sortowane klucze dla łatwiejszego porównywania wersji.
• Wizualne drzewo struktury — zobacz, jak konstrukcje TOML stają się obiektami i tablicami JSON, z oznaczeniami typów (table, AoT, array, string, number, bool).
• Panel statystyk — liczba tabel, kluczy, tablic, tablic tabel, głębokość oraz licznik znaków wejściowych/wyjściowych.
• Komunikaty o błędach z numerem linii — każdy błąd parsowania zawiera dokładny numer linii, co pozwala na natychmiastową poprawkę.
• Biblioteka próbek jednym kliknięciem — ładuj przykłady Cargo.toml, pyproject.toml, konfiguracji aplikacji, liczb lub ciągów wielowierszowych.
• Kopiowanie i pobieranie — kopiuj JSON do schowka lub pobierz jako plik .json.
• Responsywność mobilna — działa wygodnie na telefonach, tabletach i komputerach stacjonarnych.
• Prywatność danych — TOML jest przetwarzany po stronie serwera, a wynik jest zwracany w tej samej odpowiedzi; żadne dane nie są przechowywane.

Jak TOML mapuje się na JSON

Większość konstrukcji TOML ma czysty, bezstratny odpowiednik w JSON. Oto mapowanie stosowane przez konwerter:

Przykłady

title = "Aplikacja"
[server]
host = "localhost"
port = 8080

{
  "title": "Aplikacja",
  "server": {
    "host": "localhost",
    "port": 8080
  }
}

[[user]]
name = "Alicja"
admin = true

[[user]]
name = "Robert"
admin = false

{
  "user": [
    { "name": "Alicja", "admin": true },
    { "name": "Robert", "admin": false }
  ]
}

db.host = "10.0.0.1"
db.port = 5432
db.options = { ssl = true, pool = 20 }

{
  "db": {
    "host": "10.0.0.1",
    "port": 5432,
    "options": { "ssl": true, "pool": 20 }
  }
}

Jak korzystać z Konwertera TOML na JSON

1. Wklej swój TOML do pola wejściowego lub kliknij Szybką próbkę, aby załadować gotową konfigurację.
2. Wybierz styl wyjściowy — pretty 2-space (domyślny), pretty 4-space, kompaktowy lub sortowane klucze.
3. Kliknij Konwertuj na JSON. Narzędzie przeanalizuje TOML i wygeneruje wynik JSON wraz ze statystykami i drzewem struktury.
4. Sprawdź wynik — przejrzyj panel statystyk, rozwiń drzewo struktury, aby zobaczyć hierarchię i zapoznaj się z diagramem konwersji.
5. Skopiuj lub pobierz JSON. Przycisk Kopiuj umieści go w schowku; Pobierz zapisze go jako konwertowany.json.

Obsługiwane funkcje TOML

Ciągi znaków (Strings)

• Ciągi podstawowe używają podwójnych cudzysłowów i obsługują sekwencje ucieczki: \n, \t, \r, \", \\, \uXXXX, \UXXXXXXXX.
• Ciągi literalne używają pojedynczych cudzysłowów i zawierają surowe znaki bez sekwencji ucieczki.
• Wielowierszowe ciągi podstawowe używają potrójnych cudzysłowów (""") i obsługują backslash na końcu linii do usuwania białych znaków.
• Wielowierszowe ciągi literalne używają potrójnych pojedynczych cudzysłowów (''') i zachowują wszystko dosłownie.

Liczby (Numbers)

• Liczby całkowite dziesiętne z opcjonalnymi podkreśleniami: 1_000_000.
• Liczby szesnastkowe/ósemkowe/binarne: 0xDEADBEEF, 0o755, 0b1010.
• Liczby zmiennoprzecinkowe z opcjonalnym znakiem, częścią dziesiętną i wykładnikiem: 3.14, -2e-3, 6.022e23.
• Specjalne wartości: inf, -inf, nan (konwertowane na JSON null).

Tabele i Tablice

• Tabele: [nazwa] otwiera nową tabelę.
• Podtabele: [a.b.c] tworzy zagnieżdżone tabele.
• Tablice tabel: [[nazwa]] dołącza nową tabelę do tablicy.
• Tabele wierszowe (inline): { a = 1, b = 2 }.
• Tablice: [1, 2, 3] mogą zajmować wiele linii i zawierać mieszane typy wartości.

Wybór odpowiedniego stylu wyjściowego

• Pretty 2-space — domyślny. Kompaktowy, a jednocześnie czytelny; idealny do większości zastosowań, w tym plików konfiguracyjnych w git.
• Pretty 4-space — pasuje do wcięć w stylu PEP-8; preferowany przez niektóre zespoły pracujące w Python i Java.
• Kompaktowy (zminifikowany) — jedna linia, brak zbędnych białych znaków; najmniejszy rozmiar do przesyłania przez sieć.
• Sortowane klucze — ładny wynik z kluczami posortowanymi alfabetycznie. Doskonały do porównywania zmian (diff), ponieważ identyczne konfiguracje zawsze dają taki sam wynik bajtowy, niezależnie od kolejności kluczy w TOML.

Często zadawane pytania

Co to jest TOML i dlaczego warto go konwertować na JSON?

TOML to format konfiguracji zaprojektowany jako oczywisty i minimalny. Konwersja na JSON umożliwia przesyłanie konfiguracji do systemów obsługujących tylko JSON, wizualne debugowanie struktur, udostępnianie danych web API oraz integrację z kodem JavaScript.

Czy ten konwerter obsługuje tablice tabel i tabele wierszowe?

Tak. Konwerter w pełni obsługuje składnię [[array.of.tables]] (tłumaczoną na tablice obiektów JSON), tabele wierszowe, takie jak { a = 1, b = 2 }, podtabele, klucze kropkowe i dowolną głębokość zagnieżdżenia.

Jakie style wyjściowe są obsługiwane?

Cztery style: Pretty 2-space (domyślny), Pretty 4-space, Kompaktowy (zminifikowany JSON w jednej linii) oraz Sortowane klucze (dla łatwiejszego porównywania zmian).

Jak daty i godziny TOML są konwertowane na JSON?

JSON nie ma natywnego typu daty, więc daty TOML (RFC 3339, np. 2026-04-25T12:00:00Z) są zapisywane jako ciągi znaków w JSON. Wszystkie formaty czasu są zachowywane dosłownie.

Co się dzieje z wartościami inf i nan?

Standard JSON nie dopuszcza literałów Infinity ani NaN, więc wartości te z TOML (inf, -inf, nan) są zamieniane na null w wyjściu JSON, aby zachować zgodność z RFC 8259.

Gdzie mogę znaleźć błędy parsowania i jak je naprawić?

Konwerter wskazuje dokładną linię błędu i opis (np. niezamknięty cudzysłów, brak znaku równości). Najczęstsze przyczyny to błędy w nawiasach, niedozwolone tabulatory lub próba ponownego zdefiniowania tabeli.

Czy istnieje limit rozmiaru?

Narzędzie radzi sobie z plikami TOML o rozmiarze kilku megabajtów. Przy bardzo dużych plikach wydajność zależy głównie od renderowania w przeglądarce, a nie od samego parsowania.

Czy moje dane TOML są gdzieś wysyłane lub przechowywane?

Dane są przetwarzane po stronie serwera w celu wygenerowania wyniku i natychmiast usuwane. Nie logujemy, nie przechowujemy ani nie przesyłamy Twojej konfiguracji nigdzie indziej.

Czy mogę przekonwertować JSON z powrotem na TOML?

To narzędzie działa w jedną stronę (TOML → JSON). Do operacji odwrotnej należy użyć konwertera JSON na TOML lub bibliotek programistycznych, takich jak tomli_w (Python), @iarna/toml (JS) lub crate toml (Rust).

Wskazówki dla czystej konwersji

• Używaj sortowania kluczy przy porównywaniu wersji — Twój JSON w systemie kontroli wersji będzie stabilny dla wszystkich członków zespołu.
• Preferuj ciągi wielowierszowe (""" lub ''') dla długich tekstów zamiast łączenia ich za pomocą \n.
• Grupuj powiązane klucze w tabelach — są bardziej czytelne niż długie klucze z kropkami.
• Uważaj na przypadkowe redefinicje tabel — TOML zabrania dwukrotnego definiowania tej samej tabeli; konwerter wyłapie to jako błąd.
• Stosuj format RFC 3339 dla dat — formaty lokalne również są parsowane, ale RFC 3339 najlepiej współpracuje z systemami konsumującymi JSON.

Dodatkowe zasoby

• Oficjalna specyfikacja TOML
• TOML na Wikipedii
• JSON.org — wprowadzenie do JSON
• RFC 8259 — Format wymiany danych JSON