fake_git_repo.rs

  1use crate::{FakeFs, FakeFsEntry, Fs};
  2use anyhow::{Context as _, Result, bail};
  3use collections::{HashMap, HashSet};
  4use futures::future::{self, BoxFuture, join_all};
  5use git::{
  6    Oid,
  7    blame::Blame,
  8    repository::{
  9        AskPassDelegate, Branch, CommitDetails, CommitOptions, FetchOptions, GitRepository,
 10        GitRepositoryCheckpoint, PushOptions, Remote, RepoPath, ResetMode, Worktree,
 11    },
 12    status::{
 13        DiffTreeType, FileStatus, GitStatus, StatusCode, TrackedStatus, TreeDiff, TreeDiffStatus,
 14        UnmergedStatus,
 15    },
 16};
 17use gpui::{AsyncApp, BackgroundExecutor, SharedString, Task, TaskLabel};
 18use ignore::gitignore::GitignoreBuilder;
 19use parking_lot::Mutex;
 20use rope::Rope;
 21use smol::future::FutureExt as _;
 22use std::{
 23    path::PathBuf,
 24    sync::{Arc, LazyLock},
 25};
 26use util::{paths::PathStyle, rel_path::RelPath};
 27
 28pub static LOAD_INDEX_TEXT_TASK: LazyLock<TaskLabel> = LazyLock::new(TaskLabel::new);
 29pub static LOAD_HEAD_TEXT_TASK: LazyLock<TaskLabel> = LazyLock::new(TaskLabel::new);
 30
 31#[derive(Clone)]
 32pub struct FakeGitRepository {
 33    pub(crate) fs: Arc<FakeFs>,
 34    pub(crate) checkpoints: Arc<Mutex<HashMap<Oid, FakeFsEntry>>>,
 35    pub(crate) executor: BackgroundExecutor,
 36    pub(crate) dot_git_path: PathBuf,
 37    pub(crate) repository_dir_path: PathBuf,
 38    pub(crate) common_dir_path: PathBuf,
 39}
 40
 41#[derive(Debug, Clone)]
 42pub struct FakeGitRepositoryState {
 43    pub event_emitter: smol::channel::Sender<PathBuf>,
 44    pub unmerged_paths: HashMap<RepoPath, UnmergedStatus>,
 45    pub head_contents: HashMap<RepoPath, String>,
 46    pub index_contents: HashMap<RepoPath, String>,
 47    // everything in commit contents is in oids
 48    pub merge_base_contents: HashMap<RepoPath, Oid>,
 49    pub oids: HashMap<Oid, String>,
 50    pub blames: HashMap<RepoPath, Blame>,
 51    pub current_branch_name: Option<String>,
 52    pub branches: HashSet<String>,
 53    pub simulated_index_write_error_message: Option<String>,
 54    pub refs: HashMap<String, String>,
 55}
 56
 57impl FakeGitRepositoryState {
 58    pub fn new(event_emitter: smol::channel::Sender<PathBuf>) -> Self {
 59        FakeGitRepositoryState {
 60            event_emitter,
 61            head_contents: Default::default(),
 62            index_contents: Default::default(),
 63            unmerged_paths: Default::default(),
 64            blames: Default::default(),
 65            current_branch_name: Default::default(),
 66            branches: Default::default(),
 67            simulated_index_write_error_message: Default::default(),
 68            refs: HashMap::from_iter([("HEAD".into(), "abc".into())]),
 69            merge_base_contents: Default::default(),
 70            oids: Default::default(),
 71        }
 72    }
 73}
 74
 75impl FakeGitRepository {
 76    fn with_state_async<F, T>(&self, write: bool, f: F) -> BoxFuture<'static, Result<T>>
 77    where
 78        F: 'static + Send + FnOnce(&mut FakeGitRepositoryState) -> Result<T>,
 79        T: Send,
 80    {
 81        let fs = self.fs.clone();
 82        let executor = self.executor.clone();
 83        let dot_git_path = self.dot_git_path.clone();
 84        async move {
 85            executor.simulate_random_delay().await;
 86            fs.with_git_state(&dot_git_path, write, f)?
 87        }
 88        .boxed()
 89    }
 90}
 91
 92impl GitRepository for FakeGitRepository {
 93    fn reload_index(&self) {}
 94
 95    fn load_index_text(&self, path: RepoPath) -> BoxFuture<'_, Option<String>> {
 96        let fut = self.with_state_async(false, move |state| {
 97            state
 98                .index_contents
 99                .get(&path)
100                .context("not present in index")
101                .cloned()
102        });
103        self.executor
104            .spawn_labeled(*LOAD_INDEX_TEXT_TASK, async move { fut.await.ok() })
105            .boxed()
106    }
107
108    fn load_committed_text(&self, path: RepoPath) -> BoxFuture<'_, Option<String>> {
109        let fut = self.with_state_async(false, move |state| {
110            state
111                .head_contents
112                .get(&path)
113                .context("not present in HEAD")
114                .cloned()
115        });
116        self.executor
117            .spawn_labeled(*LOAD_HEAD_TEXT_TASK, async move { fut.await.ok() })
118            .boxed()
119    }
120
121    fn load_blob_content(&self, oid: git::Oid) -> BoxFuture<'_, Result<String>> {
122        self.with_state_async(false, move |state| {
123            state.oids.get(&oid).cloned().context("oid does not exist")
124        })
125        .boxed()
126    }
127
128    fn load_commit(
129        &self,
130        _commit: String,
131        _cx: AsyncApp,
132    ) -> BoxFuture<'_, Result<git::repository::CommitDiff>> {
133        unimplemented!()
134    }
135
136    fn set_index_text(
137        &self,
138        path: RepoPath,
139        content: Option<String>,
140        _env: Arc<HashMap<String, String>>,
141    ) -> BoxFuture<'_, anyhow::Result<()>> {
142        self.with_state_async(true, move |state| {
143            if let Some(message) = &state.simulated_index_write_error_message {
144                anyhow::bail!("{message}");
145            } else if let Some(content) = content {
146                state.index_contents.insert(path, content);
147            } else {
148                state.index_contents.remove(&path);
149            }
150            Ok(())
151        })
152    }
153
154    fn remote_url(&self, _name: &str) -> Option<String> {
155        None
156    }
157
158    fn diff_tree(&self, _request: DiffTreeType) -> BoxFuture<'_, Result<TreeDiff>> {
159        let mut entries = HashMap::default();
160        self.with_state_async(false, |state| {
161            for (path, content) in &state.head_contents {
162                let status = if let Some((oid, original)) = state
163                    .merge_base_contents
164                    .get(path)
165                    .map(|oid| (oid, &state.oids[oid]))
166                {
167                    if original == content {
168                        continue;
169                    }
170                    TreeDiffStatus::Modified { old: *oid }
171                } else {
172                    TreeDiffStatus::Added
173                };
174                entries.insert(path.clone(), status);
175            }
176            for (path, oid) in &state.merge_base_contents {
177                if !entries.contains_key(path) {
178                    entries.insert(path.clone(), TreeDiffStatus::Deleted { old: *oid });
179                }
180            }
181            Ok(TreeDiff { entries })
182        })
183        .boxed()
184    }
185
186    fn revparse_batch(&self, revs: Vec<String>) -> BoxFuture<'_, Result<Vec<Option<String>>>> {
187        self.with_state_async(false, |state| {
188            Ok(revs
189                .into_iter()
190                .map(|rev| state.refs.get(&rev).cloned())
191                .collect())
192        })
193    }
194
195    fn show(&self, commit: String) -> BoxFuture<'_, Result<CommitDetails>> {
196        async {
197            Ok(CommitDetails {
198                sha: commit.into(),
199                ..Default::default()
200            })
201        }
202        .boxed()
203    }
204
205    fn reset(
206        &self,
207        _commit: String,
208        _mode: ResetMode,
209        _env: Arc<HashMap<String, String>>,
210    ) -> BoxFuture<'_, Result<()>> {
211        unimplemented!()
212    }
213
214    fn checkout_files(
215        &self,
216        _commit: String,
217        _paths: Vec<RepoPath>,
218        _env: Arc<HashMap<String, String>>,
219    ) -> BoxFuture<'_, Result<()>> {
220        unimplemented!()
221    }
222
223    fn path(&self) -> PathBuf {
224        self.repository_dir_path.clone()
225    }
226
227    fn main_repository_path(&self) -> PathBuf {
228        self.common_dir_path.clone()
229    }
230
231    fn merge_message(&self) -> BoxFuture<'_, Option<String>> {
232        async move { None }.boxed()
233    }
234
235    fn status(&self, path_prefixes: &[RepoPath]) -> Task<Result<GitStatus>> {
236        let workdir_path = self.dot_git_path.parent().unwrap();
237
238        // Load gitignores
239        let ignores = workdir_path
240            .ancestors()
241            .filter_map(|dir| {
242                let ignore_path = dir.join(".gitignore");
243                let content = self.fs.read_file_sync(ignore_path).ok()?;
244                let content = String::from_utf8(content).ok()?;
245                let mut builder = GitignoreBuilder::new(dir);
246                for line in content.lines() {
247                    builder.add_line(Some(dir.into()), line).ok()?;
248                }
249                builder.build().ok()
250            })
251            .collect::<Vec<_>>();
252
253        // Load working copy files.
254        let git_files: HashMap<RepoPath, (String, bool)> = self
255            .fs
256            .files()
257            .iter()
258            .filter_map(|path| {
259                // TODO better simulate git status output in the case of submodules and worktrees
260                let repo_path = path.strip_prefix(workdir_path).ok()?;
261                let mut is_ignored = repo_path.starts_with(".git");
262                for ignore in &ignores {
263                    match ignore.matched_path_or_any_parents(path, false) {
264                        ignore::Match::None => {}
265                        ignore::Match::Ignore(_) => is_ignored = true,
266                        ignore::Match::Whitelist(_) => break,
267                    }
268                }
269                let content = self
270                    .fs
271                    .read_file_sync(path)
272                    .ok()
273                    .map(|content| String::from_utf8(content).unwrap())?;
274                let repo_path = RelPath::new(repo_path, PathStyle::local()).ok()?;
275                Some((RepoPath::from_rel_path(&repo_path), (content, is_ignored)))
276            })
277            .collect();
278
279        let result = self.fs.with_git_state(&self.dot_git_path, false, |state| {
280            let mut entries = Vec::new();
281            let paths = state
282                .head_contents
283                .keys()
284                .chain(state.index_contents.keys())
285                .chain(git_files.keys())
286                .collect::<HashSet<_>>();
287            for path in paths {
288                if !path_prefixes.iter().any(|prefix| path.starts_with(prefix)) {
289                    continue;
290                }
291
292                let head = state.head_contents.get(path);
293                let index = state.index_contents.get(path);
294                let unmerged = state.unmerged_paths.get(path);
295                let fs = git_files.get(path);
296                let status = match (unmerged, head, index, fs) {
297                    (Some(unmerged), _, _, _) => FileStatus::Unmerged(*unmerged),
298                    (_, Some(head), Some(index), Some((fs, _))) => {
299                        FileStatus::Tracked(TrackedStatus {
300                            index_status: if head == index {
301                                StatusCode::Unmodified
302                            } else {
303                                StatusCode::Modified
304                            },
305                            worktree_status: if fs == index {
306                                StatusCode::Unmodified
307                            } else {
308                                StatusCode::Modified
309                            },
310                        })
311                    }
312                    (_, Some(head), Some(index), None) => FileStatus::Tracked(TrackedStatus {
313                        index_status: if head == index {
314                            StatusCode::Unmodified
315                        } else {
316                            StatusCode::Modified
317                        },
318                        worktree_status: StatusCode::Deleted,
319                    }),
320                    (_, Some(_), None, Some(_)) => FileStatus::Tracked(TrackedStatus {
321                        index_status: StatusCode::Deleted,
322                        worktree_status: StatusCode::Added,
323                    }),
324                    (_, Some(_), None, None) => FileStatus::Tracked(TrackedStatus {
325                        index_status: StatusCode::Deleted,
326                        worktree_status: StatusCode::Deleted,
327                    }),
328                    (_, None, Some(index), Some((fs, _))) => FileStatus::Tracked(TrackedStatus {
329                        index_status: StatusCode::Added,
330                        worktree_status: if fs == index {
331                            StatusCode::Unmodified
332                        } else {
333                            StatusCode::Modified
334                        },
335                    }),
336                    (_, None, Some(_), None) => FileStatus::Tracked(TrackedStatus {
337                        index_status: StatusCode::Added,
338                        worktree_status: StatusCode::Deleted,
339                    }),
340                    (_, None, None, Some((_, is_ignored))) => {
341                        if *is_ignored {
342                            continue;
343                        }
344                        FileStatus::Untracked
345                    }
346                    (_, None, None, None) => {
347                        unreachable!();
348                    }
349                };
350                if status
351                    != FileStatus::Tracked(TrackedStatus {
352                        index_status: StatusCode::Unmodified,
353                        worktree_status: StatusCode::Unmodified,
354                    })
355                {
356                    entries.push((path.clone(), status));
357                }
358            }
359            entries.sort_by(|a, b| a.0.cmp(&b.0));
360            anyhow::Ok(GitStatus {
361                entries: entries.into(),
362                renamed_paths: HashMap::default(),
363            })
364        });
365        Task::ready(match result {
366            Ok(result) => result,
367            Err(e) => Err(e),
368        })
369    }
370
371    fn stash_entries(&self) -> BoxFuture<'_, Result<git::stash::GitStash>> {
372        async { Ok(git::stash::GitStash::default()) }.boxed()
373    }
374
375    fn branches(&self) -> BoxFuture<'_, Result<Vec<Branch>>> {
376        self.with_state_async(false, move |state| {
377            let current_branch = &state.current_branch_name;
378            Ok(state
379                .branches
380                .iter()
381                .map(|branch_name| Branch {
382                    is_head: Some(branch_name) == current_branch.as_ref(),
383                    ref_name: branch_name.into(),
384                    most_recent_commit: None,
385                    upstream: None,
386                })
387                .collect())
388        })
389    }
390
391    fn worktrees(&self) -> BoxFuture<'_, Result<Vec<Worktree>>> {
392        unimplemented!()
393    }
394
395    fn create_worktree(
396        &self,
397        _: String,
398        _: PathBuf,
399        _: Option<String>,
400    ) -> BoxFuture<'_, Result<()>> {
401        unimplemented!()
402    }
403
404    fn change_branch(&self, name: String) -> BoxFuture<'_, Result<()>> {
405        self.with_state_async(true, |state| {
406            state.current_branch_name = Some(name);
407            Ok(())
408        })
409    }
410
411    fn create_branch(
412        &self,
413        name: String,
414        _base_branch: Option<String>,
415    ) -> BoxFuture<'_, Result<()>> {
416        self.with_state_async(true, move |state| {
417            state.branches.insert(name);
418            Ok(())
419        })
420    }
421
422    fn rename_branch(&self, branch: String, new_name: String) -> BoxFuture<'_, Result<()>> {
423        self.with_state_async(true, move |state| {
424            if !state.branches.remove(&branch) {
425                bail!("no such branch: {branch}");
426            }
427            state.branches.insert(new_name.clone());
428            if state.current_branch_name == Some(branch) {
429                state.current_branch_name = Some(new_name);
430            }
431            Ok(())
432        })
433    }
434
435    fn blame(&self, path: RepoPath, _content: Rope) -> BoxFuture<'_, Result<git::blame::Blame>> {
436        self.with_state_async(false, move |state| {
437            state
438                .blames
439                .get(&path)
440                .with_context(|| format!("failed to get blame for {:?}", path))
441                .cloned()
442        })
443    }
444
445    fn stage_paths(
446        &self,
447        paths: Vec<RepoPath>,
448        _env: Arc<HashMap<String, String>>,
449    ) -> BoxFuture<'_, Result<()>> {
450        Box::pin(async move {
451            let contents = paths
452                .into_iter()
453                .map(|path| {
454                    let abs_path = self
455                        .dot_git_path
456                        .parent()
457                        .unwrap()
458                        .join(&path.as_std_path());
459                    Box::pin(async move { (path.clone(), self.fs.load(&abs_path).await.ok()) })
460                })
461                .collect::<Vec<_>>();
462            let contents = join_all(contents).await;
463            self.with_state_async(true, move |state| {
464                for (path, content) in contents {
465                    if let Some(content) = content {
466                        state.index_contents.insert(path, content);
467                    } else {
468                        state.index_contents.remove(&path);
469                    }
470                }
471                Ok(())
472            })
473            .await
474        })
475    }
476
477    fn unstage_paths(
478        &self,
479        paths: Vec<RepoPath>,
480        _env: Arc<HashMap<String, String>>,
481    ) -> BoxFuture<'_, Result<()>> {
482        self.with_state_async(true, move |state| {
483            for path in paths {
484                match state.head_contents.get(&path) {
485                    Some(content) => state.index_contents.insert(path, content.clone()),
486                    None => state.index_contents.remove(&path),
487                };
488            }
489            Ok(())
490        })
491    }
492
493    fn stash_paths(
494        &self,
495        _paths: Vec<RepoPath>,
496        _env: Arc<HashMap<String, String>>,
497    ) -> BoxFuture<'_, Result<()>> {
498        unimplemented!()
499    }
500
501    fn stash_pop(
502        &self,
503        _index: Option<usize>,
504        _env: Arc<HashMap<String, String>>,
505    ) -> BoxFuture<'_, Result<()>> {
506        unimplemented!()
507    }
508
509    fn stash_apply(
510        &self,
511        _index: Option<usize>,
512        _env: Arc<HashMap<String, String>>,
513    ) -> BoxFuture<'_, Result<()>> {
514        unimplemented!()
515    }
516
517    fn stash_drop(
518        &self,
519        _index: Option<usize>,
520        _env: Arc<HashMap<String, String>>,
521    ) -> BoxFuture<'_, Result<()>> {
522        unimplemented!()
523    }
524
525    fn commit(
526        &self,
527        _message: gpui::SharedString,
528        _name_and_email: Option<(gpui::SharedString, gpui::SharedString)>,
529        _options: CommitOptions,
530        _askpass: AskPassDelegate,
531        _env: Arc<HashMap<String, String>>,
532    ) -> BoxFuture<'_, Result<()>> {
533        unimplemented!()
534    }
535
536    fn push(
537        &self,
538        _branch: String,
539        _remote: String,
540        _options: Option<PushOptions>,
541        _askpass: AskPassDelegate,
542        _env: Arc<HashMap<String, String>>,
543        _cx: AsyncApp,
544    ) -> BoxFuture<'_, Result<git::repository::RemoteCommandOutput>> {
545        unimplemented!()
546    }
547
548    fn pull(
549        &self,
550        _branch: Option<String>,
551        _remote: String,
552        _rebase: bool,
553        _askpass: AskPassDelegate,
554        _env: Arc<HashMap<String, String>>,
555        _cx: AsyncApp,
556    ) -> BoxFuture<'_, Result<git::repository::RemoteCommandOutput>> {
557        unimplemented!()
558    }
559
560    fn fetch(
561        &self,
562        _fetch_options: FetchOptions,
563        _askpass: AskPassDelegate,
564        _env: Arc<HashMap<String, String>>,
565        _cx: AsyncApp,
566    ) -> BoxFuture<'_, Result<git::repository::RemoteCommandOutput>> {
567        unimplemented!()
568    }
569
570    fn get_remotes(&self, _branch: Option<String>) -> BoxFuture<'_, Result<Vec<Remote>>> {
571        unimplemented!()
572    }
573
574    fn check_for_pushed_commit(&self) -> BoxFuture<'_, Result<Vec<gpui::SharedString>>> {
575        future::ready(Ok(Vec::new())).boxed()
576    }
577
578    fn diff(&self, _diff: git::repository::DiffType) -> BoxFuture<'_, Result<String>> {
579        unimplemented!()
580    }
581
582    fn checkpoint(&self) -> BoxFuture<'static, Result<GitRepositoryCheckpoint>> {
583        let executor = self.executor.clone();
584        let fs = self.fs.clone();
585        let checkpoints = self.checkpoints.clone();
586        let repository_dir_path = self.repository_dir_path.parent().unwrap().to_path_buf();
587        async move {
588            executor.simulate_random_delay().await;
589            let oid = git::Oid::random(&mut executor.rng());
590            let entry = fs.entry(&repository_dir_path)?;
591            checkpoints.lock().insert(oid, entry);
592            Ok(GitRepositoryCheckpoint { commit_sha: oid })
593        }
594        .boxed()
595    }
596
597    fn restore_checkpoint(&self, checkpoint: GitRepositoryCheckpoint) -> BoxFuture<'_, Result<()>> {
598        let executor = self.executor.clone();
599        let fs = self.fs.clone();
600        let checkpoints = self.checkpoints.clone();
601        let repository_dir_path = self.repository_dir_path.parent().unwrap().to_path_buf();
602        async move {
603            executor.simulate_random_delay().await;
604            let checkpoints = checkpoints.lock();
605            let entry = checkpoints
606                .get(&checkpoint.commit_sha)
607                .context(format!("invalid checkpoint: {}", checkpoint.commit_sha))?;
608            fs.insert_entry(&repository_dir_path, entry.clone())?;
609            Ok(())
610        }
611        .boxed()
612    }
613
614    fn compare_checkpoints(
615        &self,
616        left: GitRepositoryCheckpoint,
617        right: GitRepositoryCheckpoint,
618    ) -> BoxFuture<'_, Result<bool>> {
619        let executor = self.executor.clone();
620        let checkpoints = self.checkpoints.clone();
621        async move {
622            executor.simulate_random_delay().await;
623            let checkpoints = checkpoints.lock();
624            let left = checkpoints
625                .get(&left.commit_sha)
626                .context(format!("invalid left checkpoint: {}", left.commit_sha))?;
627            let right = checkpoints
628                .get(&right.commit_sha)
629                .context(format!("invalid right checkpoint: {}", right.commit_sha))?;
630
631            Ok(left == right)
632        }
633        .boxed()
634    }
635
636    fn diff_checkpoints(
637        &self,
638        _base_checkpoint: GitRepositoryCheckpoint,
639        _target_checkpoint: GitRepositoryCheckpoint,
640    ) -> BoxFuture<'_, Result<String>> {
641        unimplemented!()
642    }
643
644    fn default_branch(&self) -> BoxFuture<'_, Result<Option<SharedString>>> {
645        async { Ok(Some("main".into())) }.boxed()
646    }
647}
648
649#[cfg(test)]
650mod tests {
651    use crate::{FakeFs, Fs};
652    use gpui::BackgroundExecutor;
653    use serde_json::json;
654    use std::path::Path;
655    use util::path;
656
657    #[gpui::test]
658    async fn test_checkpoints(executor: BackgroundExecutor) {
659        let fs = FakeFs::new(executor);
660        fs.insert_tree(
661            path!("/"),
662            json!({
663                "bar": {
664                    "baz": "qux"
665                },
666                "foo": {
667                    ".git": {},
668                    "a": "lorem",
669                    "b": "ipsum",
670                },
671            }),
672        )
673        .await;
674        fs.with_git_state(Path::new("/foo/.git"), true, |_git| {})
675            .unwrap();
676        let repository = fs
677            .open_repo(Path::new("/foo/.git"), Some("git".as_ref()))
678            .unwrap();
679
680        let checkpoint_1 = repository.checkpoint().await.unwrap();
681        fs.write(Path::new("/foo/b"), b"IPSUM").await.unwrap();
682        fs.write(Path::new("/foo/c"), b"dolor").await.unwrap();
683        let checkpoint_2 = repository.checkpoint().await.unwrap();
684        let checkpoint_3 = repository.checkpoint().await.unwrap();
685
686        assert!(
687            repository
688                .compare_checkpoints(checkpoint_2.clone(), checkpoint_3.clone())
689                .await
690                .unwrap()
691        );
692        assert!(
693            !repository
694                .compare_checkpoints(checkpoint_1.clone(), checkpoint_2.clone())
695                .await
696                .unwrap()
697        );
698
699        repository.restore_checkpoint(checkpoint_1).await.unwrap();
700        assert_eq!(
701            fs.files_with_contents(Path::new("")),
702            [
703                (Path::new(path!("/bar/baz")).into(), b"qux".into()),
704                (Path::new(path!("/foo/a")).into(), b"lorem".into()),
705                (Path::new(path!("/foo/b")).into(), b"ipsum".into())
706            ]
707        );
708    }
709}