Konwerter YAML na JSON

Konwerter YAML na JSON

YAML jest czytelniejszy dla ludzi, JSON — łatwiejszy w programach. Ten konwerter YAML na JSON zamienia jeden na drugi bez instalowania narzędzi: wklejasz plik konfiguracyjny, a obok od razu widzisz JSON, liczbę elementów, głębokość zagnieżdżenia i wykryte typy wartości.

Wynik może być sformatowany (wcięcie 2 spacje, 4 spacje lub tabulator) albo zwarty w jednej linii. Opcjonalnie posortujesz klucze map alfabetycznie albo zachowasz wszystkie wartości jako tekst. Gotowe przykłady pokazują typowe pliki: prosty, zagnieżdżony, Docker Compose i ConfigMap z Kubernetes.

Obsługiwana składnia

Przykład

app:
  name: MyApp
  features:
    - auth
    - api

Daje JSON (przy wyłączonej opcji „Sformatowany JSON”):

{"app":{"name":"MyApp","features":["auth","api"]}}

Jak działa konwerter YAML na JSON

Parser czyta dokument linia po linii i na podstawie wcięcia buduje drzewo zależności. Wcięcie wyznacza poziom zagnieżdżenia, a dwukropek rozdziela klucz od wartości. Linia rozpoczęta myślnikiem i spacją jest elementem listy i trafia do klucza, który stoi bezpośrednio nad nią. Lista może mieć to samo wcięcie co jej klucz (porty:, a pod spodem - 80) albo głębsze.

Kolejność operacji jest stała: odczyt linii, odrzucenie pustych wierszy i komentarzy, ustalenie poziomu na podstawie liczby spacji, przypisanie węzła do rodzica, rozpoznanie typu wartości, a na końcu serializacja całej struktury do formatu JSON. Typ rozpoznawany jest po zapisie wartości, a nie po nazwie klucza, dlatego ta sama nazwa klucza może raz nieść liczbę, a raz tekst.

Wynik różni się od wejścia przede wszystkim tym, że JSON nie zna komentarzy ani wcięć jako elementu składni. Wszystkie klucze trafiają do cudzysłowów, a wartości liczbowe, logiczne i puste zachowują swój typ. Kolejność kluczy pokrywa się z kolejnością w pliku wejściowym, chyba że włączysz „Sortuj klucze map” (sortowanie naturalne, kolejność elementów list zostaje bez zmian). Polskie znaki i ukośniki trafiają do wyniku wprost, bez zamiany na sekwencje \u0105 czy \/. Wynik odświeża się sam chwilę po ostatniej zmianie w polu, a przycisk „Konwertuj na JSON” przelicza go jawnie.

Przykład krok po kroku

1. Przygotuj dokument. Klucz najwyższego poziomu to serwis, a pod nim stoją cztery klucze potomne: nazwa: api, wersja: 2.1, aktywne: true oraz porty: z dwoma elementami listy, - 80 i - 443.
2. Wklej treść do pola. Dokument zajmuje siedem linii bez pustych wierszy. Wcięcia wykonaj spacjami: klucze potomne cofnięte o dwa znaki względem rodzica, elementy listy o kolejne dwa.
3. Sprawdź poziomy. serwis leży na poziomie zerowym, cztery klucze potomne na pierwszym, a elementy listy pod kluczem porty na drugim. Kafelek „Głębokość” pokaże 3: obiekt główny, obiekt serwis i listę portów.
4. Ustal typy. 2.1 to liczba dziesiętna, 80 i 443 to liczby całkowite, true to wartość logiczna, a api zwykły tekst. Tabela „Wykryte typy wartości” pokaże: tekst 1, liczba całkowita 2, liczba dziesiętna 1, wartość logiczna 1, lista 1, obiekt 2.
5. Odczytaj wynik. Kafelek „Kluczy i elementów” pokaże 7: klucz serwis, cztery klucze potomne i dwa elementy listy. Sformatowany JSON z wcięciem 4 spacji ma 11 linii, a w wersji zwartej mieści się w jednej: {"serwis":{"nazwa":"api","wersja":2.1,"aktywne":true,"porty":[80,443]}}.

Mapowanie elementów YAML na JSON

Praktyczne wskazówki

• Ustaw edytor na spacje. Wyłącz wstawianie tabulatorów, zanim zaczniesz pisać YAML. Jeden tabulator wystarczy, żeby konwersja zatrzymała się z błędem wskazującym linię.
• Trzymaj stałe wcięcie na każdym poziomie. Elementy tego samego poziomu muszą mieć identyczne wcięcie. Linia wcięta głębiej, nad którą nie stoi klucz: bez wartości, kończy się komunikatem o nieoczekiwanym wcięciu.
• Konwertuj po każdej większej zmianie. Zamiana na JSON pokazuje strukturę bez wcięć, więc łatwiej zauważysz, że jakiś klucz wylądował o poziom wyżej, niż powinien.
• Sprawdzaj typy w wyniku. Jeśli liczba trafiła do cudzysłowów, w YAML była w cudzysłowie, miała zera wiodące albo zawierała znak, którego parser nie uznaje za część liczby. Tabela wykrytych typów pod wynikiem pozwala to wyłapać bez czytania całego JSON.
• Wartości dla ConfigMap. Pole data w Kubernetes przyjmuje wyłącznie tekst, więc liczby i true ujmij w cudzysłowy albo włącz „Zachowaj wszystkie skalary jako tekst”. Ta opcja zamienia w tekst także krótkie listy [a, b], a sam klucz: nadal daje null.
• Usuwaj komentarze przed konwersją. Skoro JSON ich nie przechowuje, lepiej mieć świadomość, co wypadnie z dokumentu, zamiast szukać brakującej informacji w wyniku.

Ograniczenia i źródła błędów

• To uproszczony parser. Obsługuje bezpieczny podzbiór YAML: mapy, listy, zagnieżdżenia, cudzysłowy, komentarze i krótkie kolekcje w jednej linii. Konstrukcji spoza tego zakresu nie zgaduje, tylko zgłasza błąd z numerem i treścią linii.
• Brak obsługi kotwic, aliasów i tagów. Zapisy &baza, *baza, <<: *baza oraz jawne tagi typów (zaczynające się od wykrzyknika) są wyłączone ze względów bezpieczeństwa, dlatego powtórzone fragmenty trzeba rozpisać ręcznie.
• Wieloliniowe stringi i bloki tekstowe. Bloki | i > kończą się błędem. Tekst na kilka linii zapisz w jednej linii w podwójnym cudzysłowie, z \n w miejscu złamania.
• Jeden dokument naraz. Separator --- jest dopuszczalny tylko na początku; kolejny oznacza wiele dokumentów i daje błąd. Pliki Kubernetes z kilkoma zasobami konwertuj po jednym.
• Powtórzone klucze. Gdy ten sam klucz wystąpi dwa razy na jednym poziomie, zostaje ostatnia wartość, a pod wynikiem pojawia się ostrzeżenie.
• Limity. Do 256 KB tekstu w kodowaniu UTF-8 i najwyżej 512 poziomów zagnieżdżenia. Niespójne wcięcia, brak dwukropka przy kluczu albo myślnik bez spacji to najczęstsze przyczyny komunikatu o błędzie.