path_parser.hpp

Go to the documentation of this file.

// SPDX-FileCopyrightText: 2025 Povl Filip Sonne-Frederiksen
//
// SPDX-License-Identifier: GPL-3.0-or-later
 
#pragma once
 
#include <optional>
#include <stdexcept>
#include <string>
#include <string_view>
#include <vector>
 
namespace rux::database {

class PathError : public std::runtime_error {
public:
  explicit PathError(const std::string &message)
      : std::runtime_error(message) {}
};

enum class ComponentType {
  Collection, // e.g., "clouds", "meshes", "frames"
  Item,       // e.g., "mycloud", "123"
  Property,   // e.g., "metadata", "point_count"
  Index       // e.g., "[0]", "[5]"
};

struct PathComponent {
  ComponentType type;
  std::string value;
  std::optional<int> index;
 
  PathComponent(ComponentType t, std::string v)
      : type(t), value(std::move(v)), index(std::nullopt) {}
 
  PathComponent(ComponentType t, std::string v, int idx)
      : type(t), value(std::move(v)), index(idx) {}
 
  bool is_collection() const { return type == ComponentType::Collection; }
  bool is_item() const { return type == ComponentType::Item; }
  bool is_property() const { return type == ComponentType::Property; }
  bool is_index() const { return type == ComponentType::Index; }
  bool has_wildcard() const { return value.find('*') != std::string::npos; }
};

std::vector<PathComponent> parse_path(std::string_view path);

bool is_valid_collection(std::string_view name);

std::vector<std::string>
expand_wildcard(std::string_view pattern,
                const std::vector<std::string> &items);

bool matches_wildcard(std::string_view str, std::string_view pattern);
 
} // namespace rux::database