Git Repository Detection 是一个聚焦于从 Git 远程地址中提取 GitHub 仓库标识的技术技能,核心目标是得到 owner/repo 形式的完整标识,以便在 GitHub CLI、GitHub API 或自定义脚本中复用。
用途
- 当需要为 gh 命令或 GitHub API 提供仓库标识时,从当前目录的 git 远程中自动推导。
- 在脚本、Makefile、Python 程序或 CI 流程中识别当前仓库的 owner、name 与完整标识。
- 处理多个远程(origin、upstream 等)时分别解析对应仓库。
主要能力
- URL 解析:支持 HTTPS(https://github.com/owner/repo.git)、SSH(git@github.com:owner/repo.git)以及 GitHub Enterprise 自定义域名,能清理 .git 后缀与多余路径。
- 标识提取:提供完整标识、仅 owner、仅 name 三类单行命令,含 sed 与 awk 两种实现。
- 校验与容错:检查远程是否存在、是否为 GitHub 地址、仓库是否可访问;并提供无远程、多远程、非 GitHub 远程、子模块等边界情况的处理示例。
- 反向构建:由 owner/repo 生成 HTTPS 与 SSH 克隆地址。
- 集成示例:给出 Shell 函数、Makefile 变量、Python 脚本、环境变量与 git/shell 别名的写法。
- 故障排查:说明远程缺失、远程配置错误、解析失败时的排查步骤。
使用方式 以命令行方式调用 git remote get-url origin 获取远程 URL,再通过配套的 sed/awk 表达式或通用解析函数提取 owner/repo;也可将解析逻辑封装为 Shell 函数、环境变量或 Python 函数,在脚本中复用。资料同时给出用 gh repo view 做存在性校验、以及拼接 api.github.com/repos/ 路径发起 API 请求的示例。
适用场景
- 编写依赖仓库标识的自动化脚本或 Makefile 目标。
- 在 GitHub CLI 与 API 调用前自动识别当前仓库。
- 需要同时区分 origin 与 upstream 的多远程工作流。
限制
- 主要针对 GitHub 及其企业版 URL;其他托管平台的解析需自行调整。
- 实际可用性依赖于本地已配置远程,且访问私有仓库需要相应凭证;资料未提供收费、价格或平台支持范围等信息。