Struct ConfigBuilder 

pub struct ConfigBuilder { /* private fields */ }

Builder for creating a Config.

Implementations

impl ConfigBuilder

pub fn root_dir(self, path: impl Into<PathBuf>) -> Self

Sets the root directory to scan.

pub fn output_dir(self, path: impl Into<PathBuf>) -> Self

Sets the output directory for generated files.

pub fn output_pattern(self, pattern: impl Into<String>) -> Self

Sets the output filename pattern.

Pattern must contain {index} and {ext} placeholders.

pub fn format(self, format: OutputFormat) -> Self

Sets the output format.

pub fn max_tokens(self, tokens: usize) -> Self

Sets the maximum tokens per chunk.

pub fn overlap_tokens(self, tokens: usize) -> Self

Sets the overlap tokens between chunks.

pub fn chunk_safety_margin(self, margin: usize) -> Self

Sets the chunk safety margin.

pub fn tokenizer(self, kind: TokenizerKind) -> Self

Sets the tokenizer implementation.

pub fn prefer_line_boundaries(self, enabled: bool) -> Self

Enables or disables line boundary preference.

pub fn dry_run(self, enabled: bool) -> Self

Enables dry run mode (no file writes).

pub fn include_binary_files(self, enabled: bool) -> Self

Enables or disables binary file inclusion.

pub fn backup_existing(self, enabled: bool) -> Self

Enables or disables backup creation.

pub fn filter_config(self, config: FilterConfig) -> Self

Sets the code filtering configuration.

pub fn file_filter_config(self, config: FileFilterConfig) -> Self

Sets the code filtering configuration.

pub fn preset(self, preset: PresetKind) -> Self

Sets the LLM preset.

pub fn template_path(self, path: impl Into<PathBuf>) -> Self

Sets the path to an external template file.

When provided, this template will be used instead of the built-in template for the selected format. The template file must exist and contain valid Tera syntax.

pub fn custom_format_name(self, name: impl Into<String>) -> Self

Sets the custom format name.

Required when using OutputFormat::Custom. This name will be used internally to identify the custom template.

pub fn custom_extension(self, ext: impl Into<String>) -> Self

Sets the custom file extension.

Required when using OutputFormat::Custom. This extension will be used for output files (without the leading dot).

Examples

use llm_utl::{Config, OutputFormat};

let config = Config::builder()
    .root_dir(".")
    .format(OutputFormat::Custom)
    .custom_extension("txt")  // Files will be .txt
    .custom_format_name("my_format")
    .template_path("./template.tera")
    .build()
    .expect("valid config");

pub fn custom_data(self, data: HashMap<String, Value>) -> Self

Sets custom data to be passed to templates.

This data will be available in templates under the ctx.custom namespace.

Examples

use llm_utl::Config;
use std::collections::HashMap;
use serde_json::Value;

let mut custom_data = HashMap::new();
custom_data.insert("version".to_string(), Value::String("1.0.0".to_string()));
custom_data.insert("author".to_string(), Value::String("John Doe".to_string()));

let config = Config::builder()
    .root_dir(".")
    .custom_data(custom_data)
    .build()
    .expect("valid config");

pub fn build(self) -> Result<Config>

Builds the configuration.

Errors

Returns an error if validation fails.

Trait Implementations

impl Debug for ConfigBuilder

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ConfigBuilder

fn default() -> ConfigBuilder

Returns the “default value” for a type.