Struct ConfigHandle 

pub struct ConfigHandle<'repo> { /* private fields */ }

Read merged config and update the repository-local config file.

Implementations

impl<'repo> ConfigHandle<'repo>

pub fn new(repo: &'repo Repository) -> Self

Bind config operations to repo.

pub fn repository(&self) -> &'repo Repository

Underlying repository.

pub fn get(&self, key: &str) -> Result<Option<String>>

Look up a merged config value (system / global / local / worktree cascade).

Errors

Propagates config load failures.

Examples

use grit_lib::repo::{InitOptions, Repository};
let dir = std::env::temp_dir().join("grit-config-get-doc");
let repo = Repository::init(&dir, &InitOptions::default())?;
let _ = repo.config_handle().get("core.repositoryformatversion");

pub fn set_local(&self, key: &str, value: &str) -> Result<()>

Set a key in the repository-local config file and reload the in-memory snapshot.

For linked worktrees this writes commondir/config when the per-worktree git directory has no config file, matching Git’s --local target.

Errors

Propagates config parse, validation, and I/O errors.

pub fn unset_local(&self, key: &str) -> Result<()>

Remove key from the repository-local config file and reload the snapshot.

Errors

Propagates config parse, validation, and I/O errors.

pub fn remove_local_section(&self, section: &str) -> Result<()>

Remove an entire section from the repository-local config file.

Section names use dotted form (for example branch.topic or branch.feature/x).

Errors

Propagates config parse, validation, and I/O errors.

pub fn snapshot(&self) -> Result<Arc<ConfigSet>>

Shared merged config snapshot (same as Repository::config).

Trait Implementations

impl<'repo> Clone for ConfigHandle<'repo>

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'repo> Copy for ConfigHandle<'repo>

impl<'repo> Debug for ConfigHandle<'repo>

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

Formats the value using the given formatter.