Struct LineInFileBlockExpectedState 

pub struct LineInFileBlockExpectedState { /* private fields */ }

Configuration for managing a line in a file

Implementations

impl LineInFileBlockExpectedState

pub fn absent( file_path: &str, line: Line, file_must_exist_anyway: bool, ) -> LineInFileBlockExpectedState

Creates a block for a line that should not exist in the file.

• file_path: Path to the file.
• line: The line (or pattern) to ensure is absent.
• file_must_exist_anyway: If true, the file must exist (but the line must not). If false, the file may not exist (and the line is trivially absent).

pub fn present_at_top( file_path: &str, line: Line, create: Option<bool>, ) -> LineInFileBlockExpectedState

Creates a block for a line that should exist at the top of the file.

• file_path: Path to the file.
• line: The line to insert (or ensure exists).
• create: If true, the file will be created if it doesn’t exist.

pub fn present_at_bottom( file_path: &str, line: Line, create: Option<bool>, ) -> LineInFileBlockExpectedState

Creates a block for a line that should exist at the bottom of the file.

• file_path: Path to the file.
• line: The line to insert (or ensure exists).
• create: If true, the file will be created if it doesn’t exist.

pub fn present_after( file_path: &str, line: Line, insert_after: &str, firstmatch: Option<bool>, create: Option<bool>, ) -> LineInFileBlockExpectedState

Creates a block for a line that should exist after a specific pattern.

• file_path: Path to the file.
• line: The line to insert (or ensure exists).
• insert_after: The pattern to match (e.g., a regex or literal string).
• firstmatch: If true, use the first match of insert_after. If false, use the last match.
• create: If true, the file will be created if it doesn’t exist.

pub fn present_before( file_path: &str, line: Line, insert_before: &str, firstmatch: Option<bool>, create: Option<bool>, ) -> LineInFileBlockExpectedState

Creates a block for a line that should exist before a specific pattern.

• file_path: Path to the file.
• line: The line to insert (or ensure exists).
• insert_before: The pattern to match (e.g., a regex or literal string).
• firstmatch: If true, use the first match of insert_before. If false, use the last match.
• create: If true, the file will be created if it doesn’t exist.

pub fn present_anywhere( file_path: &str, line: Line, create: Option<bool>, ) -> LineInFileBlockExpectedState

Creates a block for a line that should exist somewhere in the file (no position constraint).

• file_path: Path to the file.
• line: The line to ensure exists.
• create: If true, the file will be created if it doesn’t exist.

pub fn raw_line(content: Parameter<String>) -> Line

Helper to create a Line::Raw from a string.

pub fn regexp_line(pattern: &str) -> Line

Helper to create a Line::Regexp from a regex pattern.

pub fn regexp_with_backrefs_line(regexp: &str, content_to_insert: &str) -> Line

Helper to create a Line::RegexpWithBackrefs from a regex and replacement.

pub fn search_string_line(pattern: &str) -> Line

Helper to create a Line::SearchString from a literal string.

Trait Implementations

impl<Handler: HostHandler> AssessCompliance<Handler> for LineInFileBlockExpectedState

async fn assess_compliance( &self, host_handler: &mut Handler, host_properties: &Option<HostProperties>, privilege: &Privilege, optional_secret_provider: &Option<SecretProvidersPool>, ) -> Result<AttributeComplianceAssessment, RegentError>

Assess whether the host is compliant.

impl Check for LineInFileBlockExpectedState

fn check(&self) -> Result<(), RegentError>

Validate this item.

fn check_host_compatibility( &self, _host_properties: &HostProperties, ) -> Result<(), RegentError>

If host properties are known, checks whether this attribute is compatible with the host or not.

impl Clone for LineInFileBlockExpectedState

fn clone(&self) -> LineInFileBlockExpectedState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LineInFileBlockExpectedState

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for LineInFileBlockExpectedState

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for LineInFileBlockExpectedState

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for LineInFileBlockExpectedState

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for LineInFileBlockExpectedState

impl Timeout for LineInFileBlockExpectedState

fn default_timeout(&self) -> Duration

Get the default timeout for this operation.