Oswajanie YAML w projektach C++

Wyobraź sobie, że piszesz konfigurację dla swojej aplikacji. JSON wydaje się zbyt restrykcyjny z swoimi cudzysłowami i nawiasami, XML to przestarzały relikt przeszłości, a zwykłe pliki .ini nie radzą sobie z zagnieżdżaniem. Wtedy na scenę wkracza YAML. Jest piękny, czytelny i... cholera, trudny do sparsowania, jeśli próbujesz napisać własne rozwiązanie.

Jeśli pracujesz z C++, prawdopodobnie słyszałeś o yaml-cpp. To bez wątpienia najpopularniejsze narzędzie do pracy z tym formatem. Projekt istnieje na GitHubie od ponad dziesięciu lat, zgromadził imponujące 6000 gwiazdek i stał się de facto standardem dla wielu dużych systemów, w tym ROS (Robot Operating System).

Co to jest i dlaczego tego potrzebujesz

yaml-cpp to biblioteka, która potrafi konwertować pliki YAML na obiekty C++ i odwrotnie. Główną zaletą jest pełna obsługa specyfikacji YAML 1.2. Oznacza to, że wszelkie "podstępne" elementy, takie jak kotwy, aliasy czy wieloliniowe bloki, zostaną obsłużone poprawnie.

Dla kogo to jest? Przede wszystkim dla tych, którzy mają dość sztywnych formatów konfiguracyjnych. YAML pozwala pisać konfiguracje, które są bezbolesne do czytania własnymi oczami, a yaml-cpp zajmuje się całą brudną robotą związaną z ich parsowaniem.

Jak to działa w praktyce

Biblioteka oferuje intuicyjne API, które w pewnym stopniu przypomina pracę z std::map czy popularnymi bibliotekami JSON. Nie musisz ręcznie iterować przez tokeny — po prostu uzyskujesz dostęp do węzłów za pomocą kluczy.

Odczytywanie danych

Powiedzmy, że mamy plik config.yaml:

last_login: 2023-10-27
user:
  name: "Ivan"
  roles: [admin, editor]

W kodzie przekłada się to na elegancką konstrukcję:

#include "yaml-cpp/yaml.h"
#include <iostream>

int main() {
    YAML::Node config = YAML::LoadFile("config.yaml");

    if (config["user"]) {
        std::string name = config["user"]["name"].as<std::string>();
        std::cout << "Привет, " << name << "!\n";
    }

    // Можно даже итерироваться по спискам
    for (auto role : config["user"]["roles"]) {
        std::cout << "Роль: " << role.as<std::string>() << "\n";
    }
}

Tworzenie YAML od zera

Generowanie dokumentów (emitting) działa równie prosto. Budujesz drzewo obiektów, a biblioteka zajmuje się wcięciami i formatowaniem:

YAML::Emitter out;
out << YAML::BeginMap;
out << YAML::Key << "pi";
out << YAML::Value << 3.14159;
out << YAML::EndMap;

std::cout << out.c_str();

Zawiłości integracji i kompilacji

Projekt używa CMake, więc integracja zazwyczaj nie sprawia problemów. Najnowocześniejszym podejściem jest użycie FetchContent. Eliminuje to konieczność ręcznego pobierania źródeł czy bawienia się w git submoduły. Wystarczy dodać kilka linijek do swojego CMakeLists.txt, a CMake pobierze wymaganą wersję biblioteki podczas kompilacji projektu.

Jeden ciekawy szczegół: domyślnie yaml-cpp jest budowana jako biblioteka statyczna. Jeśli potrzebujesz biblioteki dynamicznej (.so lub .dll), musisz jawnie przekazać flagę -DYAML_BUILD_SHARED_LIBS=ON.

Przy okazji, jeśli używasz GCC i lubisz debugować z flagą _GLIBCXX_DEBUG, bądź ostrożny. Biblioteka jest wrażliwa na tę flagę: zarówno yaml-cpp, jak i twój projekt muszą być kompilowane z tymi samymi ustawieniami debugowania standardowej biblioteki, w przeciwnym razie możesz złapać dziwne segfaulty znikąd.

Czy są jakieś haczyki

Mimo swojego statusu "standardu", yaml-cpp ma swoje własne dziwactwa. Dokumentacja w samym repozytorium jest dość lakoniczna; główne informacje są pogrzebane w Wiki lub automatycznie generowanych raportach CodeDocs.

Pamiętaj też o zmianach w API. Wersje przed 0.5.0 używały starego interfejsu, który jest teraz uznawany za przestarzały. Jeśli utrzymujesz starożytny projekt legacy, możesz potrzebować gałęzi 0.3.x, ale deweloperzy ostrzegają: w 2026 roku wsparcie dla starego API całkowicie się zakończy.

Kto powinien tego spróbować

Jeśli właśnie zaczynasz nowy projekt C++ i potrzebujesz miejsca do przechowywania ustawień — wybierz yaml-cpp. To niezawodne, sprawdzone rozwiązanie. Świetnie sprawdza się w przypadku:

• Silników gier (opis poziomów, parametry postaci).
• Narzędzi systemowych z masą flag.
• Robotyki i systemów wbudowanych, gdzie YAML już stał się normą.

W przypadku małych projektów biblioteka może wydawać się odrobinę ciężka, ale za komfort pisania i czytania konfiguracji to całkowicie adekwatna cena. Od czego zacząć? Po prostu zajrzyj do tutoriala w Wiki projektu — wszystkie podstawowe przykłady są tam, wystarczające na 90% zadań.