Struct BodySectionPatch 

#[non_exhaustive]
pub struct BodySectionPatch {
    pub context: Option<String>,
    pub decision: Option<String>,
    pub consequences: Option<String>,
}

Selects which ADR body sections to patch on Repository::update.

None for a field means leave that section’s on-disk bytes untouched. Some(text) replaces the targeted portion (for MADR 4.0.0 ## Decision Outcome, only the intro before ### subsections unless consequences is also set).

Migration from pre-BodySectionPatch update(&adr)

The previous Repository::update(&adr) re-rendered body sections from adr.context / adr.decision / adr.consequences. An empty BodySectionPatch::default() does not do that: it only updates metadata. To change body text, put the new content in the corresponding patch field; values on adr alone are ignored for body content.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

context: Option<String>

Patch the context section (## Context / ## Context and Problem Statement).

decision: Option<String>

Patch the decision intro (## Decision / ## Decision Outcome body before H3 subsections).

consequences: Option<String>

Patch consequences (## Consequences, or MADR ### Consequences under Decision Outcome).

Implementations

impl BodySectionPatch

pub fn new() -> Self

Create an empty patch (metadata-only when passed to Repository::update).

pub fn is_empty(&self) -> bool

Returns true when no body sections should be modified.

pub fn with_context(self, text: impl Into<String>) -> Self

Set the context section patch.

pub fn with_decision(self, text: impl Into<String>) -> Self

Set the decision section patch.

pub fn with_consequences(self, text: impl Into<String>) -> Self

Set the consequences section patch.

Trait Implementations

impl Clone for BodySectionPatch

fn clone(&self) -> BodySectionPatch

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BodySectionPatch

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

Formats the value using the given formatter.

impl Default for BodySectionPatch

fn default() -> BodySectionPatch

Returns the “default value” for a type.

impl Eq for BodySectionPatch

impl PartialEq for BodySectionPatch

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for BodySectionPatch