Konwerter YAML ⇄ JSON

Co robi YAML ⇄ JSON

YAML ⇄ JSON konwertuje ustrukturyzowaną konfigurację między YAML opartym na wcięciach a ścisłym JSON-em. Przydaje się przy przenoszeniu przykładów między manifestami Kubernetes, plikami CI, ustawieniami statycznych stron, danymi testowymi API, metadanymi pakietów, fragmentami dokumentacji i konfiguracją aplikacji. Kierunek YAML na JSON analizuje YAML i zwraca sformatowany JSON z wcięciem dwóch spacji. Kierunek JSON na YAML analizuje ścisły JSON i zapisuje czytelny YAML, który można wkleić do plików konfiguracyjnych lub szkiców dokumentacji. Błędy walidacji są wyświetlane od razu, dzięki czemu wychwycisz błędy wcięć, brakujące dwukropki, nieprawidłowe cudzysłowy JSON, zbędne przecinki i przypadkowe tabulatory, zanim skopiujesz uszkodzony wynik.

Narzędzie pokazuje jednocześnie źródło i wynik, więc małe przekształcenia łatwo zweryfikować. Zostało zaprojektowane do codziennej pracy programistów: sprawdzania przykładu konfiguracji podczas przeglądu kodu, przygotowywania przykładów do dokumentacji, tłumaczenia między narzędziami preferującymi różne formaty oraz porządkowania danych testowych przed commitem. Nie próbuje interpretować schematów specyficznych dla projektu ani nie stosuje ukrytych wartości domyślnych.

Prywatny przepływ pracy w przeglądarce

Całe przetwarzanie odbywa się w Twojej przeglądarce za pomocą JavaScriptu po stronie klienta. Narzędzie nie wysyła na serwer fragmentów kodu, wartości konfiguracji, wygenerowanych danych, treści zapytań ani skopiowanych przykładów i nie wymaga konta. Model wyłącznie lokalny ma znaczenie w narzędziach dla programistów, ponieważ wklejane do nich treści często wyglądają jak prawdziwe dane aplikacji: odpowiedzi API, logi, próbki przypominające zmienne środowiskowe, zapytania do bazy danych, znaczniki z szkiców lub wartości skopiowane podczas debugowania produkcji. Lokalne przekształcanie zmniejsza ryzyko i przyspiesza pracę, bo nie ma komunikacji przez sieć.

Interfejs jest celowo zwarty, aby można było wkleić dane, dostosować opcje, sprawdzić wynik, skopiować go i wrócić do edytora. Wyniki należy jednak zweryfikować, zanim trafią do commita, zostaną publicznie udostępnione lub użyte w procesie produkcyjnym. Narzędzia w przeglądarce świetnie nadają się do szybkiej inspekcji i przygotowania, ale nie znają każdej konwencji projektu, zasady klasyfikacji danych ani wymagań walidacji specyficznych dla aplikacji.

Praktyczne wskazówki

Złożony YAML sprawdź, zanim na nim polegasz, ponieważ YAML obsługuje funkcje, które nie mają idealnych odpowiedników w JSON, m.in. niestandardowe tagi, daty, aliasy, klucze scalania oraz wartości, które mogą zostać zinterpretowane jako wartości logiczne lub liczby. JSON ma mniejszy model danych, więc najbezpieczniej używać go dla zwykłych obiektów, tablic, ciągów znaków, liczb, wartości logicznych i null. Przy konwersji konfiguracji na potrzeby produkcji zweryfikuj gotowy plik w narzędziu, które będzie go używać. Jeśli w danych wejściowych znajdują się sekrety, usuń je, zanim skopiujesz przykłady gdzie indziej, mimo że ta strona wykonuje konwersję lokalnie.