Struct Identity 

pub struct Identity {
    pub name: String,
    pub email: String,
}

Who a commit is attributed to.

git commit fails outright with no user.email configured, so this cannot be left to the machine. Inheriting the repository’s identity would attribute the agent’s commit to whichever human configured that checkout, which is the wrong default; requiring configuration would fail on a fresh machine, which is the wrong other one. So the harness supplies one and the caller may replace it.

This is what git log shows for every commit a run makes, and it is passed as -c user.name=… -c user.email=… on the commit itself rather than written into the repository’s config, so a run leaves the checkout’s own identity untouched.

use io_harness::{Identity, TaskContract, Verification};

// The default: a name at a domain that can never exist. RFC 2606 reserves
// `.invalid` precisely so a synthetic address cannot accidentally be
// someone's real one.
assert_eq!(Identity::default().email, "agent@io-harness.invalid");

// Replace it when the commits should be attributable to your service, so
// a human reading `git log` a month later can tell which system made
// them and where to ask about it.
let contract = TaskContract::workspace(
    "fix the failing test and commit the fix",
    "/path/to/repo",
    Verification::WorkspaceFileContains { file: "src/lib.rs".into(), needle: "fn".into() },
)
.with_commit_identity("nightly-agent", "nightly-agent@example.com");

Neither field may be empty or hold a control character: both reach the commit object and the reflog, and a newline in a name has nowhere useful to go. A bad one is an Error::Config.

Fields

name: String

The committer name.

email: String

The committer email.

Trait Implementations

impl Clone for Identity

fn clone(&self) -> Identity

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Identity

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

Formats the value using the given formatter.

impl Default for Identity

fn default() -> Self

An agent identity at a domain that can never exist. .invalid is reserved by RFC 2606 precisely so that a synthetic address cannot accidentally be someone’s.

impl Eq for Identity

impl PartialEq for Identity

fn eq(&self, other: &Identity) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Identity