Enum LogFileSetting 

pub enum LogFileSetting {
    Path(PathBuf),
    Special(String),
}

Daemon log-file setting: an explicit path or the literal "stderr" / "-" opt-out token. The opt-out preserves the pre-G-iter-2 behaviour (logging to stderr only) for operators who run sqryd under a service manager that captures stderr to its own journal.

Source: G_daemon_control_plane.md §5.3 + 00_contracts.md §3.CC-6.

This type is added in the Layer-1 foundation pass so consumers (cluster-G Layer-2) can plumb it through the daemon config without a forward-reference to a yet-to-land type. The migration of DaemonConfig::log_file from Option<PathBuf> to this enum happens in cluster-G Layer-2.

Wire shape: a single TOML string. The deserializer classifies the canonical opt-out tokens ("stderr", "-") as Self::Special; every other string becomes Self::Path. #[serde(untagged)] would silently misclassify the opt-out tokens as Path("stderr") because PathBuf::from(&str) always succeeds — see Codex Layer-1 iter-1 review (CC-6 partially-closed defect 1). The manual Deserialize impl below is the canonical fix: classify opt-out tokens before falling back to PathBuf.

Variants

Path(PathBuf)

Explicit file path. Default: <runtime_dir>/sqryd.log on Linux/macOS, %LOCALAPPDATA%\sqry\sqryd.log on Windows.

Special(String)

Literal "stderr" / "-": log to stderr only (the legacy behaviour). Any other string never reaches this variant; the deserializer routes unknown values to Self::Path so operators can spell ordinary filenames freely.

Implementations

impl LogFileSetting

pub fn resolve(&self) -> Option<PathBuf>

Materialise the configured setting into the file path the rolling appender should target. Returns None when the operator opted out of file logging (Special("stderr") or Special("-")) — the appender is then disabled and stderr receives the structured log stream.

Trait Implementations

impl Clone for LogFileSetting

fn clone(&self) -> LogFileSetting

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LogFileSetting

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for LogFileSetting

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl PartialEq for LogFileSetting

fn eq(&self, other: &LogFileSetting) -> 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 LogFileSetting

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl Eq for LogFileSetting

impl StructuralPartialEq for LogFileSetting