Struct DebugMarker 

pub struct DebugMarker {
    pub session_id: String,
    pub timestamp: u64,
    pub description: Option<String>,
}

A debug marker that tracks metadata about inserted debug logs.

Format in code: /* ryo-debug:<session_id>:<timestamp>:<description> */

Examples

use ryo_mutations::debugger::DebugMarker;

let marker = DebugMarker::new();
let comment = marker.to_comment();
assert!(comment.starts_with("/* ryo-debug:"));

// Parse back from comment
let parsed = DebugMarker::from_comment(&comment).unwrap();
assert_eq!(parsed.session_id, marker.session_id);

Fields

session_id: String

Unique session identifier (groups related debug insertions).

timestamp: u64

Unix timestamp when the marker was created.

description: Option<String>

Optional description of what this debug log is for.

Implementations

impl DebugMarker

pub fn new() -> Self

Create a new marker with a random session ID and current timestamp.

pub fn with_session(session_id: impl Into<String>) -> Self

Create a marker with a specific session ID.

Use this when adding multiple debug logs in the same session so they can be removed together.

pub fn with_description(self, description: impl Into<String>) -> Self

Add a description to the marker.

pub fn to_comment(&self) -> String

Convert to a comment string for embedding in code.

Format: /* ryo-debug:<session_id>:<timestamp>:<description> */

pub fn to_marker_string(&self) -> String

Convert to a marker string (without comment delimiters).

Format: ryo-debug:<session_id>:<timestamp>:<description>

This is suitable for use as a string literal in code.

pub fn from_comment(s: &str) -> Option<Self>

Parse a marker from a comment string or marker string.

Accepts both formats:

• Comment: /* ryo-debug:session:ts:desc */
• String: ryo-debug:session:ts:desc

Returns None if the string is not a valid ryo debug marker.

pub fn from_string_literal(s: &str) -> Option<Self>

Parse a marker from a string literal (quoted string).

Accepts: "ryo-debug:session:ts:desc"

pub fn contains_marker(s: &str) -> bool

Check if a string contains a ryo debug marker.

Detects both comment format and string literal format.

pub fn extract_markers(s: &str) -> Vec<Self>

Extract all markers from a string.

Trait Implementations

impl Clone for DebugMarker

fn clone(&self) -> DebugMarker

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DebugMarker

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

Formats the value using the given formatter.

impl Default for DebugMarker

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for DebugMarker

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for DebugMarker

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for DebugMarker

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for DebugMarker

impl StructuralPartialEq for DebugMarker