refactor: 将项目的根目录命名由 basePath 修改为 rootPath，这样更容易识别

Author: linjianghe

business/e2e-build/index.js

@@ -1,8 +1,8 @@
 const matman = require('../matman');
 
-function getClientScriptHandler(basePath, buildPath, regMatch) {
+function getClientScriptHandler(rootPath, buildPath, regMatch) {
   const clientScript = new matman.ClientScript({
-    basePath: basePath,
+    rootPath: rootPath,
     buildPath: buildPath,
     regMatch: regMatch
   });

business/local-server/config/index.js

@@ -4,7 +4,7 @@ const path = require('path');
 /**
  * 获取最终的配置数据
  * @param {Object | String} opts 用户传递过来的参数
- * @param {String} [opts.basePath] 项目根目录
+ * @param {String} [opts.rootPath] 项目根目录
  * @returns {Object}
  */
 function getConfigOpts(opts) {
@@ -29,9 +29,9 @@ function getConfigOpts(opts) {
     return null;
   }
 
-  // 如果没有 basePath，则将无法启动成功
-  if (!configOpts.basePath) {
-    console.error('Should define basePath!', opts, configOpts);
+  // 如果没有 rootPath，则将无法启动成功
+  if (!configOpts.rootPath) {
+    console.error('Should define rootPath!', opts, configOpts);
     return null;
   }
 
@@ -43,8 +43,8 @@ function getConfigOpts(opts) {
     }, configOpts.mocker);
   }
 
-  // 日志文件存储的路径，默认值为 ${basePath}/logs
-  configOpts.LOG_PATH = configOpts.LOG_PATH || path.join(configOpts.basePath, 'logs');
+  // 日志文件存储的路径，默认值为 ${rootPath}/logs
+  configOpts.LOG_PATH = configOpts.LOG_PATH || path.join(configOpts.rootPath, 'logs');
 
   // matman 启动之后的服务端口号，默认为 9527
   configOpts.port = configOpts.port || 9527;

business/local-server/plugins/mocker/router.js

@@ -13,8 +13,8 @@ const HANDLER_NAME_FIELD = 'mockerName';
 module.exports = (router, entry) => {
   // 创建 MockerParser 对象
   const mockerParser = new MockerParser({
-    basePath: matman.mockerUtil.getMockServerBasePath(entry.basePath, entry.mockServerPath),
-    buildPath: matman.mockerUtil.getMockServerBuildPath(entry.basePath, entry.buildPath)
+    basePath: matman.mockerUtil.getMockServerBasePath(entry.rootPath, entry.mockServerPath),
+    buildPath: matman.mockerUtil.getMockServerBuildPath(entry.rootPath, entry.buildPath)
   });
 
   // 获取所有的 mocker 列表

lib/internal/build/builder-webpack3/builder.js

@@ -18,15 +18,15 @@ class Builder {
    * @desc     创建用于生产环境中的webpack打包配置
    *
    * @param {Object} params
-   * @param {RegExp} params.basePath 项目根目录
+   * @param {RegExp} params.rootPath 项目根目录
    * @param {RegExp} params.clientScriptMatch 正则表达式，用于匹配路径中那些文件是 client script
    * @param {Object} params.entry 传递给webpack 的 entry属性属性
    * @param {String} params.clientScriptBuildPath 输出打包后的 client script 的路径
    * @param {Object} opts
    * @example
    */
   static createProdConfig(params = {}, opts = {}) {
-    const clientScriptHandler = e2eBuild.getClientScriptHandler(params.basePath, params.clientScriptBuildPath, params.clientScriptMatch);
+    const clientScriptHandler = e2eBuild.getClientScriptHandler(params.rootPath, params.clientScriptBuildPath, params.clientScriptMatch);
 
     // 设置打包规则
     const prodRules = [];

lib/internal/build/utils/index.js

@@ -57,9 +57,9 @@ function getConfig(targetPath) {
   return fsHandler.handle.getModuleResult(configFile)
     .then((config) => {
 
-      // basePath 默认值为 matman.config.js 当前目录
-      if (!config.basePath) {
-        config.basePath = path.dirname(configFile);
+      // rootPath 默认值为 matman.config.js 当前目录
+      if (!config.rootPath) {
+        config.rootPath = path.dirname(configFile);
       }
 
       return config;

lib/internal/start/start.js

@@ -28,13 +28,9 @@ module.exports = function (args) {
 
   let matmanConfig = require(configAbsolutePath);
 
-  // 如果不定义 basePath，则默认取 process.cwd()
-  if (!matmanConfig.basePath) {
-    matmanConfig.basePath = cwd;
-  }
-
-  if (!matmanConfig.buildPath) {
-    matmanConfig.buildPath = path.resolve(matmanConfig.basePath, './build');
+  // 如果不定义 rootPath，则默认取 process.cwd()
+  if (!matmanConfig.rootPath) {
+    matmanConfig.rootPath = cwd;
   }
 
   // 启动本地服务

test/data/demo_03/build/build/db.json

@@ -0,0 +1 @@
+{}

test/data/demo_03/matman.config.js

@@ -1,8 +1,8 @@
 const path = require('path');
 
 module.exports = {
-  // basePath: __dirname,
-  // dataPath: path.resolve(__dirname, './build'),
+  // rootPath: __dirname,
+  // buildPath: path.resolve(__dirname, './build'),
   // mockServerPath: path.resolve(__dirname, '../../../../matman/test/data/fixtures/mock_server/mockers'),
   mockServerPath: path.resolve(__dirname, '../../../../now-h5-weishi-redpacket/matman-app/src/mock_server/mockers'),
   // clientScriptBuildPath: path.join(__dirname, 'dist-client-script'),

test/data/demo_99/index.js

@@ -2,7 +2,7 @@ const path = require('path');
 const localServer = require('../../../business/local-server');
 
 localServer.startServer({
-  basePath: __dirname,
-  dataPath: path.resolve(__dirname, './app'),
+  rootPath: __dirname,
+  buildPath: path.resolve(__dirname, './app'),
   mockServerPath: path.resolve(__dirname, '../../../../matman/test/data/fixtures/mock_service/mockers'),
 });