porytiles::LayerValue< T > Struct Template Reference

A small container that holds an optional-wrapped value, validation state, and metadata about the value source. More...

#include <layer_value.hpp>

Collaboration diagram for porytiles::LayerValue< T >:

Static Public Member Functions
static LayerValue	valid (T val, std::string source_key, std::string source_info)
	Creates a LayerValue representing a valid configuration value.
static LayerValue	valid (T val, std::string source_key, std::string source_info, std::vector< std::string > source_details)
	Creates a LayerValue representing a valid configuration value with detailed source context.
static LayerValue	invalid (std::string error, std::string source_info)
	Creates a LayerValue representing an invalid configuration value.
static LayerValue	invalid (std::string error, std::string source_info, std::vector< std::string > source_details)
	Creates a LayerValue representing an invalid configuration value with detailed source context.
static LayerValue	not_provided ()
	Creates a LayerValue representing that the provider does not supply this configuration.

Public Attributes
std::optional< T >	value
std::string	source_key
std::string	source_info
std::vector< std::string >	source_details
ValidationState	state = ValidationState::not_provided
std::string	error_message

Detailed Description

template<typename T>
struct porytiles::LayerValue< T >

A small container that holds an optional-wrapped value, validation state, and metadata about the value source.

LayerValue supports three states:

• not_provided: Provider doesn't handle this config (empty optional, no error) - continue to next provider
• valid: Provider supplies valid config (has value, no error) - use this value
• invalid: Provider attempted to supply config but it's invalid (no value, has error message) - fail immediately

Template Parameters

T	The type of the underlying value

Definition at line 37 of file layer_value.hpp.

Member Function Documentation

invalid() [1/2]

template<typename T >

static LayerValue porytiles::LayerValue< T >::invalid ( std::string  error, std::string  source_info  )

inlinestatic

Creates a LayerValue representing an invalid configuration value.

Parameters

error	Error message describing why the value is invalid
source_info	String describing the source that attempted to provide this value

Returns

A LayerValue in the invalid state

Definition at line 88 of file layer_value.hpp.

invalid() [2/2]

template<typename T >

static LayerValue porytiles::LayerValue< T >::invalid ( std::string  error, std::string  source_info, std::vector< std::string >  source_details  )

inlinestatic

Creates a LayerValue representing an invalid configuration value with detailed source context.

Parameters

error	Error message describing why the value is invalid
source_info	String describing the source that attempted to provide this value
source_details	Vector of strings showing contextual lines around the source

Returns

A LayerValue in the invalid state

Definition at line 101 of file layer_value.hpp.

not_provided()

template<typename T >

static LayerValue porytiles::LayerValue< T >::not_provided ( )

inlinestatic

Creates a LayerValue representing that the provider does not supply this configuration.

Returns

A LayerValue in the not_provided state

Definition at line 117 of file layer_value.hpp.

valid() [1/2]

template<typename T >

static LayerValue porytiles::LayerValue< T >::valid ( T  val, std::string  source_key, std::string  source_info  )

inlinestatic

Creates a LayerValue representing a valid configuration value.

Parameters

val	The valid configuration value
source_key	The provider-specific identifier for this value (e.g., "--num-tiles-per-metatile" for CLI)
source_info	String describing the source of this value (e.g., "CliOptionProvider")

Returns

A LayerValue in the valid state

Definition at line 53 of file layer_value.hpp.

valid() [2/2]

template<typename T >

static LayerValue porytiles::LayerValue< T >::valid ( T  val, std::string  source_key, std::string  source_info, std::vector< std::string >  source_details  )

inlinestatic

Creates a LayerValue representing a valid configuration value with detailed source context.

Parameters

val	The valid configuration value
source_key	The provider-specific identifier for this value (e.g., "fieldmap.num_tiles_in_primary" for YAML)
source_info	String describing the source of this value (e.g., "./porytiles.yaml:12")
source_details	Vector of strings showing contextual lines around the source

Returns

A LayerValue in the valid state

Definition at line 70 of file layer_value.hpp.

Member Data Documentation

error_message

template<typename T >

std::string porytiles::LayerValue< T >::error_message

Definition at line 43 of file layer_value.hpp.

source_details

template<typename T >

std::vector<std::string> porytiles::LayerValue< T >::source_details

Definition at line 41 of file layer_value.hpp.

source_info

template<typename T >

std::string porytiles::LayerValue< T >::source_info

Definition at line 40 of file layer_value.hpp.

source_key

template<typename T >

std::string porytiles::LayerValue< T >::source_key

Definition at line 39 of file layer_value.hpp.

state

template<typename T >

ValidationState porytiles::LayerValue< T >::state = ValidationState::not_provided

Definition at line 42 of file layer_value.hpp.

value

template<typename T >

std::optional<T> porytiles::LayerValue< T >::value

Definition at line 38 of file layer_value.hpp.

---

The documentation for this struct was generated from the following file:

• porytiles/include/porytiles/infra/config/layer_value.hpp