// Copyright 2020 The Jujutsu Authors//// Licensed under the Apache License, Version 2.0 (the "License");// you may not use this file except in compliance with the License.// You may obtain a copy of the License at//// https://www.apache.org/licenses/LICENSE-2.0//// Unless required by applicable law or agreed to in writing, software// distributed under the License is distributed on an "AS IS" BASIS,// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.// See the License for the specific language governing permissions and// limitations under the License. mod builtin;mod diff_working_copies;mod external; use std::sync::Arc; use futures::future::try_join_all;use jj_lib::backend::BackendError;use jj_lib::backend::CopyId;use jj_lib::backend::TreeValue;use jj_lib::config::ConfigGetError;use jj_lib::config::ConfigGetResultExt as _;use jj_lib::config::ConfigNamePathBuf;use jj_lib::conflicts::ConflictMarkerStyle;use jj_lib::conflicts::MaterializedFileConflictValue;use jj_lib::conflicts::try_materialize_file_conflict_value;use jj_lib::gitignore::GitIgnoreFile;use jj_lib::matchers::Matcher;use jj_lib::merge::Diff;use jj_lib::merge::Merge;use jj_lib::merge::MergedTreeValue;use jj_lib::merged_tree::MergedTree;use jj_lib::merged_tree_builder::MergedTreeBuilder;use jj_lib::repo_path::InvalidRepoPathError;use jj_lib::repo_path::RepoPath;use jj_lib::repo_path::RepoPathBuf;use jj_lib::repo_path::RepoPathUiConverter;use jj_lib::settings::UserSettings;use jj_lib::working_copy::SnapshotError;use thiserror::Error; use self::builtin::BuiltinToolError;use self::builtin::edit_diff_builtin;use self::builtin::edit_merge_builtin;use self::diff_working_copies::DiffCheckoutError;pub(crate) use self::diff_working_copies::new_utf8_temp_dir;pub use self::external::DiffToolMode;pub use self::external::ExternalMergeTool;use self::external::ExternalToolError;use self::external::edit_diff_external;pub use self::external::generate_diff;pub use self::external::invoke_external_diff;use crate::config::CommandNameAndArgs;use crate::ui::Ui; const BUILTIN_EDITOR_NAME: &str = ":builtin";const OURS_TOOL_NAME: &str = ":ours";const THEIRS_TOOL_NAME: &str = ":theirs"; #[derive(Debug, Error)]pub enum DiffEditError {    #[error(transparent)]    InternalTool(#[from] Box<BuiltinToolError>),    #[error(transparent)]    ExternalTool(#[from] ExternalToolError),    #[error(transparent)]    DiffCheckoutError(#[from] DiffCheckoutError),    #[error("Failed to snapshot changes")]    Snapshot(#[from] SnapshotError),    #[error(transparent)]    Config(#[from] ConfigGetError),} #[derive(Debug, Error)]pub enum DiffGenerateError {    #[error(transparent)]    ExternalTool(#[from] ExternalToolError),    #[error(transparent)]    DiffCheckoutError(#[from] DiffCheckoutError),} #[derive(Debug, Error)]pub enum ConflictResolveError {    #[error(transparent)]    InternalTool(#[from] Box<BuiltinToolError>),    #[error(transparent)]    ExternalTool(#[from] ExternalToolError),    #[error(transparent)]    InvalidRepoPath(#[from] InvalidRepoPathError),    #[error("Couldn't find the path {0:?} in this revision")]    PathNotFound(RepoPathBuf),    #[error("Couldn't find any conflicts at {0:?} in this revision")]    NotAConflict(RepoPathBuf),    #[error(        "Only conflicts that involve normal files (not symlinks, etc.) are supported. Conflict \         summary for {path:?}:\n{summary}",        summary = summary.trim_end()    )]    NotNormalFiles { path: RepoPathBuf, summary: String },    #[error("The conflict at {path:?} has {sides} sides. At most 2 sides are supported.")]    ConflictTooComplicated { path: RepoPathBuf, sides: usize },    #[error("{path:?} has conflicts in executable bit\n{summary}", summary = summary.trim_end())]    ExecutableConflict { path: RepoPathBuf, summary: String },    #[error(        "The output file is either unchanged or empty after the editor quit (run with --debug to \         see the exact invocation)."    )]    EmptyOrUnchanged,    #[error(transparent)]    Backend(#[from] jj_lib::backend::BackendError),    #[error(transparent)]    Io(#[from] std::io::Error),} #[derive(Debug, Error)]#[error("Stopped due to error after resolving {resolved_count} conflicts")]pub struct MergeToolPartialResolutionError {    pub source: ConflictResolveError,    pub resolved_count: usize,} #[derive(Debug, Error)]pub enum MergeToolConfigError {    #[error(transparent)]    Config(#[from] ConfigGetError),    #[error("The tool `{tool_name}` cannot be used as a merge tool with `jj resolve`")]    MergeArgsNotConfigured { tool_name: String },    #[error("The tool `{tool_name}` cannot be used as a diff editor")]    EditArgsNotConfigured { tool_name: String },} #[derive(Clone, Debug, Eq, PartialEq)]pub enum MergeTool {    Builtin,    Ours,    Theirs,    // Boxed because ExternalMergeTool is big compared to the Builtin variant.    External(Box<ExternalMergeTool>),} impl MergeTool {    fn external(tool: ExternalMergeTool) -> Self {        Self::External(Box::new(tool))    }     /// Resolves builtin merge tool names or loads external tool options from    /// `[merge-tools.<name>]`.    fn get_tool_config(        settings: &UserSettings,        name: &str,    ) -> Result<Option<Self>, MergeToolConfigError> {        match name {            BUILTIN_EDITOR_NAME => Ok(Some(Self::Builtin)),            OURS_TOOL_NAME => Ok(Some(Self::Ours)),            THEIRS_TOOL_NAME => Ok(Some(Self::Theirs)),            _ => Ok(get_external_tool_config(settings, name)?.map(Self::external)),        }    }} #[derive(Clone, Debug, Eq, PartialEq)]pub enum DiffEditTool {    Builtin,    // Boxed because ExternalMergeTool is big compared to the Builtin variant.    External(Box<ExternalMergeTool>),} impl DiffEditTool {    fn external(tool: ExternalMergeTool) -> Self {        Self::External(Box::new(tool))    }     /// Resolves builtin merge tool name or loads external tool options from    /// `[merge-tools.<name>]`.    fn get_tool_config(        settings: &UserSettings,        name: &str,    ) -> Result<Option<Self>, MergeToolConfigError> {        match name {            BUILTIN_EDITOR_NAME => Ok(Some(Self::Builtin)),            _ => Ok(get_external_tool_config(settings, name)?.map(Self::external)),        }    }} /// Finds the appropriate tool for diff editing or mergesfn editor_args_from_settings(    ui: &Ui,    settings: &UserSettings,    key: &'static str,) -> Result<CommandNameAndArgs, ConfigGetError> {    // TODO: Make this configuration have a table of possible editors and detect the    // best one here.    if let Some(args) = settings.get(key).optional()? {        Ok(args)    } else {        let default_editor = BUILTIN_EDITOR_NAME;        writeln!(            ui.hint_default(),            "Using default editor '{default_editor}'; run `jj config set --user {key} :builtin` \             to disable this message."        )        .ok();        Ok(default_editor.into())    }} /// List configured merge tools (diff editors, diff tools, merge editors)pub fn configured_merge_tools(settings: &UserSettings) -> impl Iterator<Item = &str> {    settings.table_keys("merge-tools")} /// Loads external diff/merge tool options from `[merge-tools.<name>]`.pub fn get_external_tool_config(    settings: &UserSettings,    name: &str,) -> Result<Option<ExternalMergeTool>, ConfigGetError> {    let full_name = ConfigNamePathBuf::from_iter(["merge-tools", name]);    let Some(mut tool) = settings.get::<ExternalMergeTool>(&full_name).optional()? else {        return Ok(None);    };    if tool.program.is_empty() {        tool.program = name.to_owned();    }    Ok(Some(tool))} /// Configured diff editor.#[derive(Clone, Debug)]pub struct DiffEditor {    tool: DiffEditTool,    base_ignores: Arc<GitIgnoreFile>,    use_instructions: bool,    conflict_marker_style: ConflictMarkerStyle,} impl DiffEditor {    /// Creates diff editor of the given name, and loads parameters from the    /// settings.    pub fn with_name(        name: &str,        settings: &UserSettings,        base_ignores: Arc<GitIgnoreFile>,        conflict_marker_style: ConflictMarkerStyle,    ) -> Result<Self, MergeToolConfigError> {        let tool = DiffEditTool::get_tool_config(settings, name)?            .unwrap_or_else(|| DiffEditTool::external(ExternalMergeTool::with_program(name)));        Self::new_inner(name, tool, settings, base_ignores, conflict_marker_style)    }     /// Loads the default diff editor from the settings.    pub fn from_settings(        ui: &Ui,        settings: &UserSettings,        base_ignores: Arc<GitIgnoreFile>,        conflict_marker_style: ConflictMarkerStyle,    ) -> Result<Self, MergeToolConfigError> {        let args = editor_args_from_settings(ui, settings, "ui.diff-editor")?;        let tool = if let Some(name) = args.as_str() {            DiffEditTool::get_tool_config(settings, name)?        } else {            None        }        .unwrap_or_else(|| DiffEditTool::external(ExternalMergeTool::with_edit_args(&args)));        Self::new_inner(&args, tool, settings, base_ignores, conflict_marker_style)    }     fn new_inner(        name: impl ToString,        tool: DiffEditTool,        settings: &UserSettings,        base_ignores: Arc<GitIgnoreFile>,        conflict_marker_style: ConflictMarkerStyle,    ) -> Result<Self, MergeToolConfigError> {        if let DiffEditTool::External(mergetool) = &tool            && mergetool.edit_args.is_empty()        {            return Err(MergeToolConfigError::EditArgsNotConfigured {                tool_name: name.to_string(),            });        }        Ok(Self {            tool,            base_ignores,            use_instructions: settings.get_bool("ui.diff-instructions")?,            conflict_marker_style,        })    }     /// Starts a diff editor on the two directories.    pub async fn edit(        &self,        trees: Diff<&MergedTree>,        matcher: &dyn Matcher,        format_instructions: impl FnOnce() -> String,    ) -> Result<MergedTree, DiffEditError> {        match &self.tool {            DiffEditTool::Builtin => {                Ok(                    edit_diff_builtin(trees, matcher, self.conflict_marker_style)                        .await                        .map_err(Box::new)?,                )            }            DiffEditTool::External(editor) => {                let instructions = self.use_instructions.then(format_instructions);                edit_diff_external(                    editor,                    trees,                    matcher,                    instructions.as_deref(),                    self.base_ignores.clone(),                    self.conflict_marker_style,                )                .await            }        }    }} /// A file to be merged by a merge tool.struct MergeToolFile {    repo_path: RepoPathBuf,    conflict: MergedTreeValue,    file: MaterializedFileConflictValue,} impl MergeToolFile {    async fn from_tree_and_path(        tree: &MergedTree,        repo_path: &RepoPath,    ) -> Result<Self, ConflictResolveError> {        let conflict = match tree.path_value(repo_path).await?.into_resolved() {            Err(conflict) => conflict,            Ok(Some(_)) => return Err(ConflictResolveError::NotAConflict(repo_path.to_owned())),            Ok(None) => return Err(ConflictResolveError::PathNotFound(repo_path.to_owned())),        };        let file =            try_materialize_file_conflict_value(tree.store(), repo_path, &conflict, tree.labels())                .await?                .ok_or_else(|| ConflictResolveError::NotNormalFiles {                    path: repo_path.to_owned(),                    summary: conflict.describe(tree.labels()),                })?;        // We only support conflicts with 2 sides (3-way conflicts)        if file.ids.num_sides() > 2 {            return Err(ConflictResolveError::ConflictTooComplicated {                path: repo_path.to_owned(),                sides: file.ids.num_sides(),            });        }        if file.executable.is_none() {            return Err(ConflictResolveError::ExecutableConflict {                path: repo_path.to_owned(),                summary: conflict.describe(tree.labels()),            });        }        Ok(Self {            repo_path: repo_path.to_owned(),            conflict,            file,        })    }} /// Configured 3-way merge editor.#[derive(Clone, Debug)]pub struct MergeEditor {    tool: MergeTool,    path_converter: RepoPathUiConverter,    conflict_marker_style: ConflictMarkerStyle,} impl MergeEditor {    /// Creates 3-way merge editor of the given name, and loads parameters from    /// the settings.    pub fn with_name(        name: &str,        settings: &UserSettings,        path_converter: RepoPathUiConverter,        conflict_marker_style: ConflictMarkerStyle,    ) -> Result<Self, MergeToolConfigError> {        let tool = MergeTool::get_tool_config(settings, name)?            .unwrap_or_else(|| MergeTool::external(ExternalMergeTool::with_program(name)));        Self::new_inner(name, tool, path_converter, conflict_marker_style)    }     /// Loads the default 3-way merge editor from the settings.    pub fn from_settings(        ui: &Ui,        settings: &UserSettings,        path_converter: RepoPathUiConverter,        conflict_marker_style: ConflictMarkerStyle,    ) -> Result<Self, MergeToolConfigError> {        let args = editor_args_from_settings(ui, settings, "ui.merge-editor")?;        let tool = if let Some(name) = args.as_str() {            MergeTool::get_tool_config(settings, name)?        } else {            None        }        .unwrap_or_else(|| MergeTool::external(ExternalMergeTool::with_merge_args(&args)));        Self::new_inner(&args, tool, path_converter, conflict_marker_style)    }     fn new_inner(        name: impl ToString,        tool: MergeTool,        path_converter: RepoPathUiConverter,        conflict_marker_style: ConflictMarkerStyle,    ) -> Result<Self, MergeToolConfigError> {        if let MergeTool::External(mergetool) = &tool            && mergetool.merge_args.is_empty()        {            return Err(MergeToolConfigError::MergeArgsNotConfigured {                tool_name: name.to_string(),            });        }        Ok(Self {            tool,            path_converter,            conflict_marker_style,        })    }     /// Starts a merge editor for the specified files.    pub async fn edit_files(        &self,        ui: &Ui,        tree: &MergedTree,        repo_paths: &[&RepoPath],    ) -> Result<(MergedTree, Option<MergeToolPartialResolutionError>), ConflictResolveError> {        let merge_tool_files: Vec<MergeToolFile> = try_join_all(            repo_paths                .iter()                .map(|&repo_path| MergeToolFile::from_tree_and_path(tree, repo_path)),        )        .await?;         match &self.tool {            MergeTool::Builtin => {                let tree = edit_merge_builtin(tree, &merge_tool_files)                    .await                    .map_err(Box::new)?;                Ok((tree, None))            }            MergeTool::Ours => {                let tree = pick_conflict_side(tree, &merge_tool_files, 0).await?;                Ok((tree, None))            }            MergeTool::Theirs => {                let tree = pick_conflict_side(tree, &merge_tool_files, 1).await?;                Ok((tree, None))            }            MergeTool::External(editor) => {                external::run_mergetool_external(                    ui,                    &self.path_converter,                    editor,                    tree,                    &merge_tool_files,                    self.conflict_marker_style,                )                .await            }        }    }} async fn pick_conflict_side(    tree: &MergedTree,    merge_tool_files: &[MergeToolFile],    add_index: usize,) -> Result<MergedTree, BackendError> {    let mut tree_builder = MergedTreeBuilder::new(tree.clone());    for merge_tool_file in merge_tool_files {        // We use file IDs here to match the logic for the other external merge tools.        // This ensures that the behavior is consistent.        let file = &merge_tool_file.file;        let file_id = file.ids.get_add(add_index).unwrap();        let executable = file.executable.expect("should have been resolved");        let new_tree_value = Merge::resolved(file_id.clone().map(|id| TreeValue::File {            id,            executable,            copy_id: CopyId::placeholder(),        }));        tree_builder.set_or_remove(merge_tool_file.repo_path.clone(), new_tree_value);    }    tree_builder.write_tree().await} #[cfg(test)]mod tests {    use jj_lib::config::ConfigLayer;    use jj_lib::config::ConfigSource;    use jj_lib::config::StackedConfig; 

Lines 1–500 of 1007. Load more