Struct GitConfig 

pub struct GitConfig { /* private fields */ }

Git configuration for Bashkit.

Controls git behavior including author identity and remote access.

Example

use bashkit::GitConfig;

let config = GitConfig::new()
    .author("Deploy Bot", "deploy@example.com");

Security

• Author identity is sandboxed (never reads from host)
• Remote URLs require explicit allowlist (Phase 2)
• All operations confined to virtual filesystem

Implementations

impl GitConfig

pub fn new() -> Self

Create a new git configuration with default sandbox identity.

Example

use bashkit::GitConfig;

let config = GitConfig::new();
// Uses default author: "sandbox <sandbox@bashkit.local>"

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

Set the author name and email for commits.

Security (TM-GIT-002)

This is the only way to set author identity. The git builtin will never read from host ~/.gitconfig or environment variables.

Example

use bashkit::GitConfig;

let config = GitConfig::new()
    .author("CI Bot", "ci@example.com");

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

Add a remote URL pattern to the allowlist (Phase 2).

Remote operations (clone, push, pull, fetch) require URLs to be in the allowlist. This method will be used in Phase 2.

Example

use bashkit::GitConfig;

let config = GitConfig::new()
    .allow_remote("https://github.com/myorg/");

pub fn allow_remotes( self, patterns: impl IntoIterator<Item = impl Into<String>>, ) -> Self

Add multiple remote URL patterns to the allowlist (Phase 2).

pub fn allow_all_remotes(self) -> Self

Allow all remote URLs.

Warning

This is dangerous and should only be used for testing or when the script is fully trusted.

pub fn author_name(&self) -> &str

Get the configured author name.

pub fn author_email(&self) -> &str

Get the configured author email.

Trait Implementations

impl Clone for GitConfig

fn clone(&self) -> GitConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GitConfig

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

Formats the value using the given formatter.

impl Default for GitConfig

fn default() -> Self

Returns the “default value” for a type.