Project Clice

简体中文

English

简体中文

English

Appearance

Namespace clore ​

Summary ​

clore 命名空间主要围绕声明式选项配置与任务协调展开。其核心是 Options 结构体，内部通过一系列以 _DecoOptStruct_ 为前缀的嵌套结构体（如 _DecoOptStruct_0 至 _DecoOptStruct_10）来组织不同的配置字段，每个字段都定义了相应的类型别名（如 _deco_base_t、Step、Action、result_type、_deco_callback_base_t）以及用于初始化和析构的成员函数。这些结构体配合 deco_field_ty 变量，共同构成一个用于描述和初始化装饰选项的框架。此外，命名空间还提供了 log_generation_summary 和 await_task_result 两个自由函数，分别负责记录生成操作的汇总信息、阻塞等待异步任务并返回其结果。整体上，clore 提供了一套模块化的选项定义机制和基础的异步任务管理能力，适合用于需要灵活配置和任务编排的场景。

Diagram ​

Subnamespaces ​

Types ​

clore::Options ​

Declaration: main.cpp:18

Definition: main.cpp:18

Insufficient evidence to summarize; provide more EVIDENCE.

Invariants ​

  • All fields have required = false, making every option optional.
  • Each option has an associated help string.
  • rate_limit is typed as std::uint32_t, implying a non-negative integer default.
  • Flag fields (dry_run, agent_mode, help, version) are boolean and declared via DecoFlag.
  • Internal _DecoOptStruct_* types carry the decoration metadata for each field.

Key Members ​

  • Fields: config, compile_commands, source_dir, output_dir, log_level, model, rate_limit, dry_run, agent_mode, help, version
  • Nested structs: _DecoOptStruct_0 through _DecoOptStruct_10

Usage Patterns ​

  • Parsed by command-line argument handling code in main or initialization.
  • Accessed directly to configure application behavior (e.g., logging, paths, model selection).
  • Metadata from decorator macros used to generate help text and validation logic.
  • Fields like source_dir, output_dir used for file path customization.
  • Flags like dry_run and agent_mode alter execution flow.

Member Types ​

clore::Options::_DecoOptStruct_0 ​

Declaration: main.cpp:19

Definition: main.cpp:19

Member Types ​
clore::Options::_DecoOptStruct_0::__deco_field_ty ​

Declaration: main.cpp:19

Definition: main.cpp:19

Member Types ​
clore::Options::_DecoOptStruct_0::__deco_field_ty::Action ​

Declaration: main.cpp:19

clore::Options::_DecoOptStruct_0::__deco_field_ty::Step ​

Declaration: main.cpp:19

clore::Options::_DecoOptStruct_0::__deco_field_ty::_deco_base_t ​

Declaration: main.cpp:19

clore::Options::_DecoOptStruct_0::__deco_field_ty::_deco_callback_base_t ​

Declaration: main.cpp:19

clore::Options::_DecoOptStruct_0::__deco_field_ty::result_type ​

Declaration: main.cpp:19

Member Functions ​
clore::Options::_DecoOptStruct_0::__deco_field_ty::__deco_field_ty ​

Declaration: main.cpp:19

Definition: main.cpp:19

Declaration ​
cpp
clore::Options::_DecoOptStruct_0::__deco_field_ty::__deco_field_ty();
clore::Options::_DecoOptStruct_0::_deco_base_t ​

Declaration: main.cpp:19

Member Variables ​
clore::Options::_DecoOptStruct_0::deco_field_ty ​

Declaration: main.cpp:19

Member Functions ​
clore::Options::_DecoOptStruct_0::~_DecoOptStruct_0<ResTy> ​

Declaration: main.cpp:19

Definition: main.cpp:19

Declaration ​
cpp
clore::Options::_DecoOptStruct_0::~_DecoOptStruct_0<ResTy>();
clore::Options::_DecoOptStruct_1 ​

Declaration: main.cpp:24

Definition: main.cpp:24

Member Types ​
clore::Options::_DecoOptStruct_1::__deco_field_ty ​

Declaration: main.cpp:24

Definition: main.cpp:24

Member Types ​
clore::Options::_DecoOptStruct_1::__deco_field_ty::Action ​

Declaration: main.cpp:24

clore::Options::_DecoOptStruct_1::__deco_field_ty::Step ​

Declaration: main.cpp:24

clore::Options::_DecoOptStruct_1::__deco_field_ty::_deco_base_t ​

Declaration: main.cpp:24

clore::Options::_DecoOptStruct_1::__deco_field_ty::_deco_callback_base_t ​

Declaration: main.cpp:24

clore::Options::_DecoOptStruct_1::__deco_field_ty::result_type ​

Declaration: main.cpp:24

Member Functions ​
clore::Options::_DecoOptStruct_1::__deco_field_ty::__deco_field_ty ​

Declaration: main.cpp:24

Definition: main.cpp:24

Declaration ​
cpp
clore::Options::_DecoOptStruct_1::__deco_field_ty::__deco_field_ty();
clore::Options::_DecoOptStruct_1::_deco_base_t ​

Declaration: main.cpp:24

Member Variables ​
clore::Options::_DecoOptStruct_1::deco_field_ty ​

Declaration: main.cpp:24

Member Functions ​
clore::Options::_DecoOptStruct_1::~_DecoOptStruct_1<ResTy> ​

Declaration: main.cpp:24

Definition: main.cpp:24

Declaration ​
cpp
clore::Options::_DecoOptStruct_1::~_DecoOptStruct_1<ResTy>();
clore::Options::_DecoOptStruct_10 ​

Declaration: main.cpp:69

Definition: main.cpp:69

Member Types ​
clore::Options::_DecoOptStruct_10::__deco_field_ty ​

Declaration: main.cpp:69

Definition: main.cpp:69

Member Types ​
clore::Options::_DecoOptStruct_10::__deco_field_ty::_deco_base_t ​

Declaration: main.cpp:69

Member Functions ​
clore::Options::_DecoOptStruct_10::__deco_field_ty::__deco_field_ty ​

Declaration: main.cpp:69

Definition: main.cpp:69

Declaration ​
cpp
clore::Options::_DecoOptStruct_10::__deco_field_ty::__deco_field_ty();
clore::Options::_DecoOptStruct_10::_deco_base_t ​

Declaration: main.cpp:69

Member Functions ​
clore::Options::_DecoOptStruct_10::~_DecoOptStruct_10 ​

Declaration: main.cpp:69

Definition: main.cpp:69

Declaration ​
cpp
clore::Options::_DecoOptStruct_10::~_DecoOptStruct_10();
clore::Options::_DecoOptStruct_2 ​

Declaration: main.cpp:29

Definition: main.cpp:29

Member Types ​
clore::Options::_DecoOptStruct_2::__deco_field_ty ​

Declaration: main.cpp:29

Definition: main.cpp:29

Member Types ​
clore::Options::_DecoOptStruct_2::__deco_field_ty::Action ​

Declaration: main.cpp:29

clore::Options::_DecoOptStruct_2::__deco_field_ty::Step ​

Declaration: main.cpp:29

clore::Options::_DecoOptStruct_2::__deco_field_ty::_deco_base_t ​

Declaration: main.cpp:29

clore::Options::_DecoOptStruct_2::__deco_field_ty::_deco_callback_base_t ​

Declaration: main.cpp:29

clore::Options::_DecoOptStruct_2::__deco_field_ty::result_type ​

Declaration: main.cpp:29

Member Functions ​
clore::Options::_DecoOptStruct_2::__deco_field_ty::__deco_field_ty ​

Declaration: main.cpp:29

Definition: main.cpp:29

Declaration ​
cpp
clore::Options::_DecoOptStruct_2::__deco_field_ty::__deco_field_ty();
clore::Options::_DecoOptStruct_2::_deco_base_t ​

Declaration: main.cpp:29

Member Variables ​
clore::Options::_DecoOptStruct_2::deco_field_ty ​

Declaration: main.cpp:29

Member Functions ​
clore::Options::_DecoOptStruct_2::~_DecoOptStruct_2<ResTy> ​

Declaration: main.cpp:29

Definition: main.cpp:29

Declaration ​
cpp
clore::Options::_DecoOptStruct_2::~_DecoOptStruct_2<ResTy>();
clore::Options::_DecoOptStruct_3 ​

Declaration: main.cpp:34

Definition: main.cpp:34

Member Types ​
clore::Options::_DecoOptStruct_3::__deco_field_ty ​

Declaration: main.cpp:34

Definition: main.cpp:34

Member Types ​
clore::Options::_DecoOptStruct_3::__deco_field_ty::Action ​

Declaration: main.cpp:34

clore::Options::_DecoOptStruct_3::__deco_field_ty::Step ​

Declaration: main.cpp:34

clore::Options::_DecoOptStruct_3::__deco_field_ty::_deco_base_t ​

Declaration: main.cpp:34

clore::Options::_DecoOptStruct_3::__deco_field_ty::_deco_callback_base_t ​

Declaration: main.cpp:34

clore::Options::_DecoOptStruct_3::__deco_field_ty::result_type ​

Declaration: main.cpp:34

Member Functions ​
clore::Options::_DecoOptStruct_3::__deco_field_ty::__deco_field_ty ​

Declaration: main.cpp:34

Definition: main.cpp:34

Declaration ​
cpp
clore::Options::_DecoOptStruct_3::__deco_field_ty::__deco_field_ty();
clore::Options::_DecoOptStruct_3::_deco_base_t ​

Declaration: main.cpp:34

Member Variables ​
clore::Options::_DecoOptStruct_3::deco_field_ty ​

Declaration: main.cpp:34

Member Functions ​
clore::Options::_DecoOptStruct_3::~_DecoOptStruct_3<ResTy> ​

Declaration: main.cpp:34

Definition: main.cpp:34

Declaration ​
cpp
clore::Options::_DecoOptStruct_3::~_DecoOptStruct_3<ResTy>();
clore::Options::_DecoOptStruct_4 ​

Declaration: main.cpp:37

Definition: main.cpp:37

Member Types ​
clore::Options::_DecoOptStruct_4::__deco_field_ty ​

Declaration: main.cpp:37

Definition: main.cpp:37

Member Types ​
clore::Options::_DecoOptStruct_4::__deco_field_ty::Action ​

Declaration: main.cpp:37

clore::Options::_DecoOptStruct_4::__deco_field_ty::Step ​

Declaration: main.cpp:37

clore::Options::_DecoOptStruct_4::__deco_field_ty::_deco_base_t ​

Declaration: main.cpp:37

clore::Options::_DecoOptStruct_4::__deco_field_ty::_deco_callback_base_t ​

Declaration: main.cpp:37

clore::Options::_DecoOptStruct_4::__deco_field_ty::result_type ​

Declaration: main.cpp:37

Member Functions ​
clore::Options::_DecoOptStruct_4::__deco_field_ty::__deco_field_ty ​

Declaration: main.cpp:37

Definition: main.cpp:37

Declaration ​
cpp
clore::Options::_DecoOptStruct_4::__deco_field_ty::__deco_field_ty();
clore::Options::_DecoOptStruct_4::_deco_base_t ​

Declaration: main.cpp:37

Member Variables ​
clore::Options::_DecoOptStruct_4::deco_field_ty ​

Declaration: main.cpp:37

Member Functions ​
clore::Options::_DecoOptStruct_4::~_DecoOptStruct_4<ResTy> ​

Declaration: main.cpp:37

Definition: main.cpp:37

Declaration ​
cpp
clore::Options::_DecoOptStruct_4::~_DecoOptStruct_4<ResTy>();
clore::Options::_DecoOptStruct_5 ​

Declaration: main.cpp:43

Definition: main.cpp:43

Member Types ​
clore::Options::_DecoOptStruct_5::__deco_field_ty ​

Declaration: main.cpp:43

Definition: main.cpp:43

Member Types ​
clore::Options::_DecoOptStruct_5::__deco_field_ty::Action ​

Declaration: main.cpp:43

clore::Options::_DecoOptStruct_5::__deco_field_ty::Step ​

Declaration: main.cpp:43

clore::Options::_DecoOptStruct_5::__deco_field_ty::_deco_base_t ​

Declaration: main.cpp:43

clore::Options::_DecoOptStruct_5::__deco_field_ty::_deco_callback_base_t ​

Declaration: main.cpp:43

clore::Options::_DecoOptStruct_5::__deco_field_ty::result_type ​

Declaration: main.cpp:43

Member Functions ​
clore::Options::_DecoOptStruct_5::__deco_field_ty::__deco_field_ty ​

Declaration: main.cpp:43

Definition: main.cpp:43

Declaration ​
cpp
clore::Options::_DecoOptStruct_5::__deco_field_ty::__deco_field_ty();
clore::Options::_DecoOptStruct_5::_deco_base_t ​

Declaration: main.cpp:43

Member Variables ​
clore::Options::_DecoOptStruct_5::deco_field_ty ​

Declaration: main.cpp:43

Member Functions ​
clore::Options::_DecoOptStruct_5::~_DecoOptStruct_5<ResTy> ​

Declaration: main.cpp:43

Definition: main.cpp:43

Declaration ​
cpp
clore::Options::_DecoOptStruct_5::~_DecoOptStruct_5<ResTy>();
clore::Options::_DecoOptStruct_6 ​

Declaration: main.cpp:49

Definition: main.cpp:49

Member Types ​
clore::Options::_DecoOptStruct_6::__deco_field_ty ​

Declaration: main.cpp:49

Definition: main.cpp:49

Member Types ​
clore::Options::_DecoOptStruct_6::__deco_field_ty::Action ​

Declaration: main.cpp:49

clore::Options::_DecoOptStruct_6::__deco_field_ty::Step ​

Declaration: main.cpp:49

clore::Options::_DecoOptStruct_6::__deco_field_ty::_deco_base_t ​

Declaration: main.cpp:49

clore::Options::_DecoOptStruct_6::__deco_field_ty::_deco_callback_base_t ​

Declaration: main.cpp:49

clore::Options::_DecoOptStruct_6::__deco_field_ty::result_type ​

Declaration: main.cpp:49

Member Functions ​
clore::Options::_DecoOptStruct_6::__deco_field_ty::__deco_field_ty ​

Declaration: main.cpp:49

Definition: main.cpp:49

Declaration ​
cpp
clore::Options::_DecoOptStruct_6::__deco_field_ty::__deco_field_ty();
clore::Options::_DecoOptStruct_6::_deco_base_t ​

Declaration: main.cpp:49

Member Variables ​
clore::Options::_DecoOptStruct_6::deco_field_ty ​

Declaration: main.cpp:49

Member Functions ​
clore::Options::_DecoOptStruct_6::~_DecoOptStruct_6<ResTy> ​

Declaration: main.cpp:49

Definition: main.cpp:49

Declaration ​
cpp
clore::Options::_DecoOptStruct_6::~_DecoOptStruct_6<ResTy>();
clore::Options::_DecoOptStruct_7 ​

Declaration: main.cpp:55

Definition: main.cpp:55

Member Types ​
clore::Options::_DecoOptStruct_7::__deco_field_ty ​

Declaration: main.cpp:55

Definition: main.cpp:55

Member Types ​
clore::Options::_DecoOptStruct_7::__deco_field_ty::_deco_base_t ​

Declaration: main.cpp:55

Member Functions ​
clore::Options::_DecoOptStruct_7::__deco_field_ty::__deco_field_ty ​

Declaration: main.cpp:55

Definition: main.cpp:55

Declaration ​
cpp
clore::Options::_DecoOptStruct_7::__deco_field_ty::__deco_field_ty();
clore::Options::_DecoOptStruct_7::_deco_base_t ​

Declaration: main.cpp:55

Member Functions ​
clore::Options::_DecoOptStruct_7::~_DecoOptStruct_7 ​

Declaration: main.cpp:55

Definition: main.cpp:55

Declaration ​
cpp
clore::Options::_DecoOptStruct_7::~_DecoOptStruct_7();
clore::Options::_DecoOptStruct_8 ​

Declaration: main.cpp:60

Definition: main.cpp:60

Member Types ​
clore::Options::_DecoOptStruct_8::__deco_field_ty ​

Declaration: main.cpp:60

Definition: main.cpp:60

Member Types ​
clore::Options::_DecoOptStruct_8::__deco_field_ty::_deco_base_t ​

Declaration: main.cpp:60

Member Functions ​
clore::Options::_DecoOptStruct_8::__deco_field_ty::__deco_field_ty ​

Declaration: main.cpp:60

Definition: main.cpp:60

Declaration ​
cpp
clore::Options::_DecoOptStruct_8::__deco_field_ty::__deco_field_ty();
clore::Options::_DecoOptStruct_8::_deco_base_t ​

Declaration: main.cpp:60

Member Functions ​
clore::Options::_DecoOptStruct_8::~_DecoOptStruct_8 ​

Declaration: main.cpp:60

Definition: main.cpp:60

Declaration ​
cpp
clore::Options::_DecoOptStruct_8::~_DecoOptStruct_8();
clore::Options::_DecoOptStruct_9 ​

Declaration: main.cpp:66

Definition: main.cpp:66

Member Types ​
clore::Options::_DecoOptStruct_9::__deco_field_ty ​

Declaration: main.cpp:66

Definition: main.cpp:66

Member Types ​
clore::Options::_DecoOptStruct_9::__deco_field_ty::_deco_base_t ​

Declaration: main.cpp:66

Member Functions ​
clore::Options::_DecoOptStruct_9::__deco_field_ty::__deco_field_ty ​

Declaration: main.cpp:66

Definition: main.cpp:66

Declaration ​
cpp
clore::Options::_DecoOptStruct_9::__deco_field_ty::__deco_field_ty();
clore::Options::_DecoOptStruct_9::_deco_base_t ​

Declaration: main.cpp:66

Member Functions ​
clore::Options::_DecoOptStruct_9::~_DecoOptStruct_9 ​

Declaration: main.cpp:66

Definition: main.cpp:66

Declaration ​
cpp
clore::Options::_DecoOptStruct_9::~_DecoOptStruct_9();

Functions ​

clore::await_task_result ​

Declaration: main.cpp:92

Definition: main.cpp:92

函数 clore::await_task_result 接受一个 Task 对象的引用和一个 std::string_view 描述符，等待该任务完成并返回其最终结果。它返回一个 std::expected<Value, Error>，其中 Value 和 Error 分别默认为 Task::value_type 和 Task::error_type。调用者必须保证在调用期间提供的 Task 引用保持有效；该函数会阻塞直到任务结束。若任务成功完成，返回的 expected 包含结果值；若失败，则包含对应的错误。

Usage Patterns ​

  • retrieve result of async task with error handling
  • convert task outcome to std::expected

clore::log_generation_summary ​

Declaration: main.cpp:73

Definition: main.cpp:73

函数 clore::log_generation_summary 接受一个 const int & 参数，并返回 void。调用方应提供一个整数引用，该整数表示需要记录摘要的生成操作的标识符或关键数值。函数负责输出（记录）该生成的汇总信息，但不会修改传入的参数。

Usage Patterns ​

  • Called after a generation pass to produce a summary log of generation results and cache efficiency.

Copyright © 2024-2026