Method write_for_edit

core/src/workspace/mod.rs:741–765

Companion to [`Self::read_for_edit`]. Performs a compare-and-swap write when both [`Self::fs_ext`] is available *and* a version token was returned by the prior read; falls back to a plain write otherwise. On version mismatch the returned error is the typed [`WorkspaceError::VersionConflict`] variant; callers can also still downcast `anyhow::Error::downcast_ref:: ()` when t

(
        &self,
        path: &WorkspacePath,
        content: &str,
        expected_version: Option<&str>,
    )

    /// downcast `anyhow::Error::downcast_ref::<WorkspaceVersionConflict>()`
    /// when the value has been lifted into an `anyhow::Result`.
    pub async fn write_for_edit(
        &self,
        path: &WorkspacePath,
        content: &str,
        expected_version: Option<&str>,
    ) -> WorkspaceResult<WorkspaceWriteOutcome> {
        if let (Some(ext), Some(version)) = (self.fs_ext(), expected_version) {
            let path = path.clone();
            let content = content.to_string();
            let expected = version.to_string();
            return self
                .run_with_timeout("write_text_if_version", async move {
                    ext.write_text_if_version(&path, &content, &expected).await
                })
                .await;
        }
        let fs = self.fs();
        let path = path.clone();
        let content = content.to_string();
        self.run_with_timeout(
            "write_text",
            async move { fs.write_text(&path, &content).await },
        )
        .await
    }

    pub fn local_root(&self) -> Option<&Path> {
        self.local_root.as_deref()