yaml_config Namespace Reference

Detailed Description

Utilities to work with static YAML config.

Classes
class	Iterator
struct	Schema
	JSON Schema-like type definition. More...
class	SchemaPtr
class	YamlConfig
	Datatype that represents YAML with substituted variables. More...

Typedefs
using	Value = YamlConfig
using	Exception = formats::yaml::Exception
using	ParseException = formats::yaml::ParseException

Enumerations
enum class	FieldType {   kBool ,   kInteger ,   kNumber ,   kString ,   kArray ,   kObject }

Functions
std::string	ToString (FieldType type)
formats::yaml::Value	Serialize (const SchemaPtr &schema, formats::serialize::To< formats::yaml::Value >)
Schema	Parse (const formats::yaml::Value &schema, formats::parse::To< Schema >)
formats::yaml::Value	Serialize (const Schema &schema, formats::serialize::To< formats::yaml::Value >)
bool	Parse (const YamlConfig &value, formats::parse::To< bool >)
int64_t	Parse (const YamlConfig &value, formats::parse::To< int64_t >)
uint64_t	Parse (const YamlConfig &value, formats::parse::To< uint64_t >)
double	Parse (const YamlConfig &value, formats::parse::To< double >)
std::string	Parse (const YamlConfig &value, formats::parse::To< std::string >)
std::chrono::seconds	Parse (const YamlConfig &value, formats::parse::To< std::chrono::seconds >)
	Parses duration from string, understands suffixes: ms, s, m, h, d.
std::chrono::milliseconds	Parse (const YamlConfig &value, formats::parse::To< std::chrono::milliseconds >)
	Parses duration from string, understands suffixes: ms, s, m, h, d.
formats::json::Value	Parse (const YamlConfig &value, formats::parse::To< formats::json::Value >)
	Converts YAML to JSON.
YamlConfig	Parse (const YamlConfig &value, formats::parse::To< YamlConfig >)
	Converts YAML to YAML. Returns self.
formats::yaml::Value	Parse (const YamlConfig &value, formats::parse::To< formats::yaml::Value >)
	Flattens a YamlConfig, applying all of its special syntax.
template<typename ParentComponent>
Schema	MergeSchemas (const std::string &yaml_string)
	Merge parent and child components schemas of static configs.
template<typename T, typename Value>
std::vector< T >	ParseMapToArray (const Value &value)
template<typename Value>
ItemsWrapper< Value >	Items (Value &&value)
	Wrapper for handy python-like iteration over a map.

Typedef Documentation

Exception

using yaml_config::Exception = formats::yaml::Exception

Definition at line 24 of file yaml_config.hpp.

ParseException

using yaml_config::ParseException = formats::yaml::ParseException

Definition at line 25 of file yaml_config.hpp.

Value

using yaml_config::Value = YamlConfig

Definition at line 15 of file fwd.hpp.

Enumeration Type Documentation

FieldType

enum class yaml_config::FieldType

strong

Definition at line 22 of file schema.hpp.

Function Documentation

Items()

template<typename Value>

ItemsWrapper< Value > formats::common::Items

(

Value &&

value

)

Wrapper for handy python-like iteration over a map.

for (const auto& [name, value]: Items(map)) ...

Definition at line 115 of file items.hpp.

MergeSchemas()

template<typename ParentComponent>

Schema yaml_config::MergeSchemas

(

const std::string &

yaml_string

)

Merge parent and child components schemas of static configs.

See also

Static configs validation

Examples

components/component_sample_test.cpp, libraries/easy/samples/4_custom_dependency/main.cpp, libraries/easy/samples/5_pg_service_template/src/main.cpp, samples/grpc_middleware_service/src/middlewares/server/meta_filter.cpp, samples/grpc_service/src/greeter_service.cpp, samples/tcp_service/main.cpp, samples/ydb_service/components/federated_topic_reader.cpp, and samples/ydb_service/components/topic_reader.cpp.

Definition at line 23 of file merge_schemas.hpp.

Parse() [1/5]

formats::json::Value yaml_config::Parse	(	const YamlConfig &	value,
		formats::parse::To< formats::json::Value >	)

Converts YAML to JSON.

Exceptions

yaml_config::YamlConfig::Exception

if value.IsMissing()

Parse() [2/5]

formats::yaml::Value yaml_config::Parse	(	const YamlConfig &	value,
		formats::parse::To< formats::yaml::Value >	)

Flattens a YamlConfig, applying all of its special syntax.

Exceptions

yaml_config::YamlConfig::Exception

if value.IsMissing()

Parse() [3/5]

std::chrono::milliseconds yaml_config::Parse	(	const YamlConfig &	value,
		formats::parse::To< std::chrono::milliseconds >	)

Parses duration from string, understands suffixes: ms, s, m, h, d.

Exceptions

On	invalid type and invalid string format

Parse() [4/5]

std::chrono::seconds yaml_config::Parse	(	const YamlConfig &	value,
		formats::parse::To< std::chrono::seconds >	)

Parses duration from string, understands suffixes: ms, s, m, h, d.

Exceptions

On	invalid type, invalid string format, and if the duration is not a whole amount of seconds

Parse() [5/5]

YamlConfig yaml_config::Parse ( const YamlConfig & value, formats::parse::To< YamlConfig >  )

inline

Converts YAML to YAML. Returns self.

Definition at line 277 of file yaml_config.hpp.

ParseMapToArray()

template<typename T, typename Value>

std::vector< T > yaml_config::ParseMapToArray

(

const Value &

value

)

Definition at line 11 of file map_to_array.hpp.