在日常工作中,我们经常需要 clone 远程的 Git 仓库。
一般我会创建一个文件夹,比如 ~/code
。然后在这个文件夹下 clone Git 仓库。
但这样做会导致一些问题:
遇到同名的 Git 仓库,会报 fatal: destination path 'xxx' already exists and is not an empty directory.
的错误。
公司内部的 Git 仓库和开源的 Git 仓库,用户名和邮箱不一样,需要对全局的 Git 配置做修改。
本文将介绍一款自己开源的的 cli 工具:mgre 帮助大家解决这些问题。
通过调研发现,已经有一些类似的工具,比如 projj, tanyao 等工具实现了类似的功能。
但是这些工具都有一些问题:
projj
已经很久没有更新了,issue 和 pr 都没有人处理。tanyao
提供的功能比较少,只能 clone 仓库。所以我决定自己开发一个工具,实现自己想要的功能。
# With pnpm
$ pnpm install -g mgre
# With yarn
$ yarn global add mgre
# With npm
$ npm install -g mgre
当我们需要 clone 一个仓库时,只需要执行 mgre clone
命令即可,比如
# support clone pattern like git clone
mgre clone https://github.com/zxf4399/mgre.git
# or
mgre clone [email protected]:zxf4399/mgre.git
在执行过程中,如果是首次执行,会提示你设置 base
目录(本地 Git 仓库的根目录)。
base
目录的默认值是 join(homedir(), ".mgre")
,支持修改。(在这台 ubuntu 云主机中就是 /home/ubuntu/.mgre
)
设置完 base
目录后,会继续提示你输入 Git 用户名和邮箱。(当然你也可以选择 Yes
跳过)
然而,需要注意的是,配置的 Git 用户名和邮箱仅适用于
github.com
仓库。如果你 clone 其他域名的 Git 仓库,您可能仍会看到输入 Git 用户名和邮箱的提示。
设置完 Git 用户名和邮箱后,就是熟悉的 git clone
过程了,只是仓库被 clone 到了 base
目录下。
base
├── config.json
├── github.com
│ └── zxf4399
│ └── mgre
└── mgre.db
当我们需要查找一个仓库时,只需要执行 mgre find
命令即可,比如
# find support fuzzy search
mgre find zxf4399/mgre
如果你已经 clone 了一些仓库,但是没有使用 mgre
管理,那么你可以使用 mgre import
命令导入这些仓库。
# For example, if the repository's local path is ~/code/mgre
mgre import ~/code/mgre
导入完成后, 这些仓库将会被移动到 base
目录下。
base
├── config.json
├── github.com
│ └── zxf4399
│ ├── mgre
│ └── zxf4399.github.io
└── mgre.db
如果你想删除 mgre
的配置文件,可以使用 mgre rm
命令。
mgre rm
本文介绍了 mgre,一款解决 Git 仓库 clone 过程中遇到的问题的 CLI 工具。该工具具有 clone 、find 、import 和 rm 命令等基本功能,可有效管理 Git 仓库。
如有任何问题或建议,请在下方留言,或者在 mgre_issue 中提出。
如果你觉得这个工具还不错,欢迎给我点个 star 。Thanks♪(・ω・)ノ
1
blankmiss 2023-03-08 22:20:15 +08:00
好像有个软件叫 sourcetree
|
2
zxf4399 OP @blankmiss
试了下 sourcetree 的默认行为是这个样子,不知道是不是还有配置能做到按 {domain}/{own}/{repo} 分类 https://raw.githubusercontent.com/zxf4399/oss/main/2023/03/09/TMftMY.png |
3
1OF7G 2023-03-09 22:33:28 +08:00
赞一个,有过类似的想法,不过没有去做。
顺便分享一下一个 userscript ,点 github 的复制链接,复制成一个本地 clone 命令,再自己粘贴执行 如:cd ~/github-repos; git clone https://github.com/facebook/react.git react@facebook; code react@facebook ```js window.addEventListener('click', (e)=>{ let clip; if (clip = e.target.closest(`input[value^="https://github.com/"][value$=".git"] + div > clipboard-copy`)) { const url = clip.value; const [_, group, repo] = url.match(/([a-zA-Z0-9_-]+)\/([a-zA-Z0-9_-]+)\.git/) const v = `cd ~/github-repos; git clone ${url} ${repo}@${group}; code ${repo}@${group}` clip.value = v document.querySelector('input[value^="https://github.com/"][value$=".git"]').value = v } }, {capture: true}) ``` |