本文介绍如何使用 npm 包 territory 来管理你的代码库。territory 是一个强大的工具，可以帮助你更好地组织和管理你的代码。
安装 Territory
首先，你需要在本地安装 Territory。通过以下命令可以很容易地完成安装：
npm install territory --save-dev
初始化
在你的项目根目录下，运行以下命令来初始化 Territory：
territory init
这将会创建一个 .territory.json 文件，以及一个 territory 目录，你可以在 .territory.json 文件中配置你的代码库、规则、标签等信息。
配置
Territory 的配置文件是 .territory.json，它包含了项目的目录结构、规则、标签等信息，让 Territory 能够正确地管理你的代码库。
以下是一个简单的 .territory.json 配置文件的示例：
-- -------------------- ---- -------
-
-------------- -
-
------- ------
-------------- ---------
-------- -
-
------- --------------
--------- ---------
-
-
--
-
------- -------
-------------- --------
-------- -
-
------- ----------------------------
--------- ---------
-
-
-
--
------- -
-
------- ----------
-------- ------
--
-
------- ------
-------- -----
-
-
-配置文件中，territories 数组定义了项目的目录结构和规则。每个元素是一个 territory，包含了 name、description、rules 等字段。
tags 定义了项目中使用的标签信息。
规则
规则是用来匹配文件的。每个规则包含一个 test 字段和一个 action 字段。具体可以参考上述示例，test 字段是一个正则表达式，当文件名匹配该正则表达式时，执行 action。action 可以是 INCLUDE 或者 EXCLUDE，分别表示包含文件和排除文件。
需要注意的是，规则的匹配顺序与在代码里书写的顺序有关，越靠前的规则优先匹配。
标签
标签是用来标记文件的。每个标签包含一个 name 和一个 color 字段。 name 表示标签的名称，color 表示标签的颜色。标签可以应用在规则中匹配到的文件上。
使用
Territory 允许你在项目目录下运行以下命令来执行不同的操作：
territory：检查文件匹配情况。territory list：列出所有标签。territory apply：将标签应用到匹配的文件上。territory status：列出未提交的更改。
检查文件匹配情况
命令 territory 将按照配置文件中的规则来匹配文件，并列出匹配的结果。
以下是一个示例输出:
-- -------------------- ---- -------
- ---------
-
-------------- -
---------- -
-
------------ ------
-------- -
-
------- --------------
--------- ---------
-
-
-
--
------- --
--
-------------------- -
---------- -
-
------------ -------
-------- -
-
------- ----------------------------
--------- ---------
-
-
-
--
------- --
-
-输出格式为一个 JSON 对象，每个 key 是匹配到的文件，对应的值是一个对象，包含三个字段：
matches：匹配到的规则信息，包括规则所属的territory和规则本身。tags：应用在该文件上的标签。
列出所有标签
命令 territory list 列出了所有标签以及它们的颜色。
以下是一个示例输出：
$ territory list feature: blue bug: red
将标签应用到匹配的文件上
命令 territory apply 将应用指定的标签到匹配到的文件上。
以下是一个示例命令：
$ territory apply -t feature src/main.js
执行该命令后，将会将 feature 标签应用于 src/main.js 文件上。
列出未提交的更改
命令 territory status 将列出所有未提交的更改。
以下是一个示例输出:
$ territory status M: src/main.js [feature]
输出格式为一行字符串，以文件状态开始，然后是文件路径和标签信息。
结论
Territory 是一个非常强大的工具，它可以帮助你更好地组织和管理你的代码库。希望本篇文章能够帮助你理解如何使用 Territory 来管理你的项目。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/60056be481e8991b448e59d4