xml.hpp

Go to the documentation of this file.

#pragma once
 
// XML parse/generate wrapper over pugixml.
// Provides a simplified API for common XML operations.
 
#include <string>
#include <string_view>
#include <vector>
#include <optional>
#include <functional>
 
// Forward-declare pugixml types to avoid header leak
namespace pugi { class xml_document; class xml_node; }
 
namespace pulp::runtime {

class XmlDocument {
public:
    XmlDocument();
    ~XmlDocument();

    bool parse(std::string_view xml_string);

    bool load_file(std::string_view path);

    std::string to_string() const;

    bool save_file(std::string_view path) const;

    std::string root_name() const;

    std::optional<std::string> root_attribute(std::string_view name) const;

    std::vector<std::string> xpath_strings(std::string_view xpath) const;

    std::optional<std::string> xpath_string(std::string_view xpath) const;

    void walk(std::function<void(std::string_view name, std::string_view text)> fn) const;

    bool is_valid() const { return valid_; }

    const std::string& error() const { return error_; }
 
    // No copy, move OK
    XmlDocument(const XmlDocument&) = delete;
    XmlDocument& operator=(const XmlDocument&) = delete;
    XmlDocument(XmlDocument&&) noexcept;
    XmlDocument& operator=(XmlDocument&&) noexcept;
 
private:
    struct Impl;
    Impl* impl_ = nullptr;
    bool valid_ = false;
    std::string error_;
};

std::string xml_generate(std::string_view root_name,
                         const std::vector<std::pair<std::string, std::string>>& elements);
 
}  // namespace pulp::runtime