Brak wyniku TOML w konwerterze danych może wyglądać jak błąd, ale często jest użyteczną informacją. Poprawny JSON albo YAML nie musi być poprawnie konwertowalny do TOML. TOML jest węższy, bo został zaprojektowany głównie dla konfiguracji, a nie dla każdego możliwego kształtu dokumentu.
W Konwerterze JSON / YAML / TOML wynik TOML pojawia się tylko wtedy, gdy model danych pasuje do ograniczeń formatu. To bezpieczniejsze niż wygenerowanie pliku, który wygląda wiarygodnie, ale zmienia znaczenie struktury.
TOML jest węższy, bo powstał dla konfiguracji, nie dla każdego kształtu dokumentu
JSON i YAML mogą reprezentować wiele różnych modeli: obiekty, tablice, skomplikowane zagnieżdżenia, listy na najwyższym poziomie i mieszane typy. TOML koncentruje się na czytelnej konfiguracji z tabelami i parami klucz-wartość.
Ta węższość jest zaletą, gdy piszesz konfigurację. Jest ograniczeniem, gdy próbujesz przenieść dowolny dokument.
Poprawne wejście to nie to samo co konwertowalne wejście
Plik może być poprawnym JSON-em i nadal nie pasować do TOML. Walidacja składni mówi tylko, że parser rozumie dokument. Konwersja do TOML wymaga dodatkowego pytania: czy ten kształt da się zapisać w TOML bez zmiany sensu?
Jeśli odpowiedź brzmi nie, brak wyniku jest lepszy niż fałszywy sukces.
Tablica na najwyższym poziomie to najprostszy przykład ograniczenia
Wejście JSON może zaczynać się od tablicy, na przykład listy obiektów. To poprawny JSON, ale nie zawsze jest sensownym dokumentem TOML na najwyższym poziomie. TOML oczekuje konfiguracji o innym kształcie.
W takim przypadku trzeba albo zmienić model danych, albo wybrać format, który lepiej pasuje do listy, na przykład JSON albo YAML.
Zgodne typy wartości też mają znaczenie
Ograniczenia nie kończą się na najwyższym poziomie. Znaczenie mają też typy wartości, zagnieżdżenia i to, czy dokument wygląda jak konfiguracja, a nie ogólna struktura danych.
Dlatego narzędzie nie powinno traktować TOML jako automatycznego wyjścia dla każdej poprawnej treści.
Realistyczny przykład handoffu
Developer dostaje przykład YAML z dokumentacji API i chce wkleić go do pliku konfiguracyjnego. Jeśli struktura jest obiektem z prostymi wartościami i zagnieżdżeniami pasującymi do tabel, TOML może być dobrym wynikiem. Jeśli wejście jest listą rekordów albo ogólnym payloadem, TOML prawdopodobnie nie jest właściwym formatem.
Wtedy szybka konwersja mówi nie tylko "udało się" albo "nie udało się". Mówi, czy model danych pasuje do celu.
Czasem właściwą odpowiedzią jest przestać konwertować
Jeśli dokument nie pasuje do TOML, nie trzeba go na siłę przepychać. Możesz zostawić JSON, użyć YAML albo zmienić strukturę wejścia tak, aby naprawdę była konfiguracją.
To bardziej odpowiedzialne niż tworzenie TOML tylko po to, by mieć plik z oczekiwanym rozszerzeniem.
Brak wyniku TOML to użyteczna informacja zwrotna
Brak wyjścia TOML nie musi oznaczać awarii narzędzia. Często oznacza, że format docelowy nie pasuje do danych. To sygnał, aby sprawdzić model, nie tylko składnię.
Otwórz Konwerter JSON / YAML / TOML, gdy chcesz zweryfikować fragment, albo przeczytaj jak konwertować JSON, YAML i TOML bez uszkadzania danych, jeśli potrzebujesz pełniejszego przepływu.
