处理多个版本控制系统的存储器的杂项工具
支持的版本控制系统
- gi
- jujutsu(jj),与git或非git合用同一地点
- 金属
- 树苗
- 颠覆
查找 Root [同步]
根据寄存器内的路径, 找到根的路径
示例
findRootSync("/my-git-repo/some/subdirectory"); // => "/my-git-repo"
示例
await findRoot("/my-git-repo/some/subdirectory"); // => "/my-git-repo"
导入
注:截至v1.0.0,这是一个只使用无害环境管理模块的软件包。 它可以作为无害环境管理模块从任何节点.js版本中导入,但如果需要从CJS软件包中获取此包,则必须使用Node.js v20.19.0+或v22.12.0+. 如果你得到一个 ERR_REQUIRE_ESM 调用时出错 require("@altano/repository-tools") 确定你正在一个足够新版本的Node.js上.
您可以直接导入所有工具或函数:
| 使用子路径导出 | 导入到使用 |
|---|
| 没有 | import { findRoot } from "@altano/repository-tools"; |
| 对 | import { findRoot } from "@altano/repository-tools/findRoot.js"; |
关于 @altano/repository-tools 的常见问题
@altano/repository-tools 是什么？
处理多个版本控制系统的存储器的杂项工具(git, svn等)
如何安装 @altano/repository-tools？
在项目目录运行 npm install @altano/repository-tools，或使用 pnpm add / yarn add / bun add。
@altano/repository-tools 支持 TypeScript 吗？
支持。包内自带 TypeScript 类型声明（package.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。
@altano/repository-tools 支持 ESM 还是 CommonJS？
以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module，更早的版本需要改用动态 import()。
@altano/repository-tools 可以商用吗？
@altano/repository-tools 使用 ISC 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。
@altano/repository-tools 的下载量有多少？
根据 npm 官方下载统计，@altano/repository-tools 在 2026/10/06 – 2026/11/04 这 30 天内被下载 1,056,858 次，日均约 35,229 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
@altano/repository-tools 还在维护吗？
最新版本 2.1.2 发布于 2026/10/15（21 天前）；至今共发布 16 个版本，其中过去 12 个月发布了 7 个；首次发布于 2024/04/08。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。