amos-apptool 1.1.0 → 1.2.0

package/esm/index.js

@@ -72,4 +72,4 @@ export * from "./math/calendarUtils";
 
 export { default as encodeUrl } from "./url/encodeUrl";
 
-export { default as restfulUrl } from "./url/restfulUrl";
+export * from "./url/restfulUrl";

package/esm/url/restfulUrl.js

@@ -1,7 +1,40 @@
 import utils from "./../utils";
 
+import parseText from "./../parseText";
+
+import _trim from "./../_trim";
+
 const _regex = /\{\s*([^\|\}]+?)\s*(?:\|([^\}]*))?\s*\}/g;
 
-export default function restfulUrl(e, r, t) {
-  return t || (t = _regex), e.replace ? e.replace(t, (e, t) => utils.isUndefined(r[t]) ? e : r[t]) : e;
-}
+export function restfulUrl(t, r, e) {
+  return e || (e = _regex), t.replace ? t.replace(e, (t, e) => utils.isUndefined(r[e]) ? t : r[e]) : t;
+}
+
+const defaultRE = /\{((?:.|\n)+?)\}/g;
+
+export function formatUrl(t, r = {}, e) {
+  return e || (e = defaultRE), parseText(t, r, e);
+}
+
+export function changeParam(t, r) {
+  if (!t || utils.isEmpty(r)) return t;
+  let e = t;
+  return Object.keys(r).forEach(function(t) {
+    let i = r[t];
+    utils.isUndefined(i) ? i = "" : utils.isArray(i) || utils.isObject(i) && (i = JSON.stringify(i)), 
+    e = function(t, r, e) {
+      const i = r + "=([^&]*)", n = r + "=" + e;
+      if (t.match(i)) {
+        const e = new RegExp(`(${r}=)([^&]*)`, "gi");
+        return t.replace(e, n);
+      }
+      return t.match("[?]") ? t + "&" + n : t + "?" + n;
+    }(e, t, i);
+  }), e;
+}
+
+export const completePrefix = (t = "", r = "") => {
+  if (!t || "" === t) return r;
+  return t.endsWith("/") && (t = t.substring(0, t.length - 1)), t = _trim(t), r.startsWith("/") && (r = r.substring(1)), 
+  [ t, r = (r = _trim(r)).replace(/\/\/+/g, "/") ].join("/");
+};

package/index.d.ts

@@ -291,6 +291,58 @@ export function encodeUrl(url: string): string;
  */
 export function restfulUrl(url: string, options: {}, regexps: RegExp): string;
 
+/**
+ * 替换 url 参数。如果url中无指定的参数，则自动追加。
+ *
+ * 自动将对象中的 undefined 值，转化为 ''。null 值则直接返回 null 字符串。
+ *
+ * params 参数中的数据格式，建议调用处统一处理为 string 格式。内部仅统一处理 undefined 和 {} 格式。
+ * @param href 需要替换参数的 url。为空字符串则直接返回 href
+ * @param params 参数对象。为空对象，则直接返回 href。
+ * @example
+ *  // 无参数，自动追加
+ * changeParam('a/b/d/g', { a: 1, b: 2, c: 3 }); // 'a/b/d/g?a=1&b=2&c=3'
+ *  // 更新已有参数的值
+ *  changeParam('a/b/d/g?a=aa&b=bb&c=cc', { a: 1, b: 2, c: 3 }); // 'a/b/d/g?a=1&b=2&c=3'
+ *  // url 中无参数 d，自动追加参数
+ *  changeParam('a/b/d/g?a=aa&b=bb&c=cc', { a: 1, b: 2, c: 3, d: 5 }); // 'a/b/d/g?a=1&b=2&c=3&d=5'
+ *  // undefined 值转化为 ''
+ *  changeParam('a/b/d/g', { a: 1, b: 2, c: undefined }); // 'a/b/d/g?a=1&b=2&c='
+ *  // null 值转化为 'null'
+ *  changeParam('a/b/d/g', { a: 1, b: null, c: undefined }); // 'a/b/d/g?a=1&b=null&c='
+ *  // [] 和 {} 值。最好不要给参数中传入 {} 值
+ *  changeParam('a/b/d/g', { a: { m: 3 }, b: [1,2] }); // a/b/d/g?a={"m":3}&b=1,2
+ *  // 更换 token={token} 值，注意 原理并不是替换 {token} 值，而是更新 `token=xxx` 值，也就是目标是 `=` 左边的 `key` 与 params 中的 key 匹配
+ *  changeParam('a/b/d/g?token={token}', { a: 'file', b: [1,2], token: 'mytoken' }); // a/b/d/g?token=mytoken&a=file&b=1,2
+ */
+export function changeParam(href: String, params: Object): String;
+
+ /**
+  * 格式化url
+  * @param {string} targetStr
+  * @param {object} dataObj
+  * @param {string|RegExp} regexps 可选, default: /\{(.*)\}/g);
+  * @example
+  *  formatUrl('a/{b}/{c}/d',{a: 1, b:2}) // 返回: 'a/1/2/d'
+  *  formatUrl('a/{{b}}/{{c}}/d',{a: 1, b:2}, /\{\{(.*)\}\}/g) // 返回: 'a/1/2/d'
+  */
+export function formatUrl(targetStr: string, dataObj: {}, regexps: string|RegExp): string;
+
+/**
+ * 补全 url
+ * @param left 左边通用前缀
+ * @param right 右边具体的 url
+ * @return
+ * @example
+ *  completePrefix('/aa/', 'b/c/d'); // '/aa/b/c/d'
+ *  completePrefix('/aa /', ' b/c/d'); // '/aa/b/c/d'
+ *  completePrefix('aa ', ' b c/d'); // 'aa/b c/d'
+ *  completePrefix(' aa ', ' b c/d '); // 'aa/b c/d'
+ *  // 注意，不会自动去除 url 内部的空格，会自动将 url 内部多余的 `/` 去掉
+ *  completePrefix('// aa /', '/ b c///d /'); // '/ aa/b c/d /'
+ */
+export function completePrefix(left = '', right = ''): string;
+
 /**
  *
  * @param str

package/lib/index.js

@@ -39,8 +39,7 @@ var _exportNames = {
   subtraction: !0,
   accMul: !0,
   accDivide: !0,
-  encodeUrl: !0,
-  restfulUrl: !0
+  encodeUrl: !0
 };
 
 Object.defineProperty(exports, "Base64", {
@@ -178,11 +177,6 @@ Object.defineProperty(exports, "Base64", {
   get: function() {
     return _randomColor.default;
   }
-}), Object.defineProperty(exports, "restfulUrl", {
-  enumerable: !0,
-  get: function() {
-    return _restfulUrl.default;
-  }
 }), Object.defineProperty(exports, "shallowCopy", {
   enumerable: !0,
   get: function() {
@@ -259,4 +253,13 @@ Object.keys(_calendarUtils).forEach(function(e) {
   }));
 });
 
-var _encodeUrl = _interopRequireDefault(require("./url/encodeUrl")), _restfulUrl = _interopRequireDefault(require("./url/restfulUrl"));
+var _encodeUrl = _interopRequireDefault(require("./url/encodeUrl")), _restfulUrl = require("./url/restfulUrl");
+
+Object.keys(_restfulUrl).forEach(function(e) {
+  "default" !== e && "__esModule" !== e && (Object.prototype.hasOwnProperty.call(_exportNames, e) || e in exports && exports[e] === _restfulUrl[e] || Object.defineProperty(exports, e, {
+    enumerable: !0,
+    get: function() {
+      return _restfulUrl[e];
+    }
+  }));
+});

package/lib/url/restfulUrl.js

@@ -4,12 +4,44 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 
 Object.defineProperty(exports, "__esModule", {
   value: !0
-}), exports.default = restfulUrl;
+}), exports.changeParam = changeParam, exports.completePrefix = void 0, exports.formatUrl = formatUrl, 
+exports.restfulUrl = restfulUrl;
 
-var _utils = _interopRequireDefault(require("./../utils")), _regex = /\{\s*([^\|\}]+?)\s*(?:\|([^\}]*))?\s*\}/g;
+var _utils = _interopRequireDefault(require("./../utils")), _parseText = _interopRequireDefault(require("./../parseText")), _trim2 = _interopRequireDefault(require("./../_trim")), _regex = /\{\s*([^\|\}]+?)\s*(?:\|([^\}]*))?\s*\}/g;
 
 function restfulUrl(e, r, t) {
   return t || (t = _regex), e.replace ? e.replace(t, function(e, t) {
     return _utils.default.isUndefined(r[t]) ? e : r[t];
   }) : e;
-}
+}
+
+var defaultRE = /\{((?:.|\n)+?)\}/g;
+
+function formatUrl(e) {
+  var r = arguments.length > 1 && void 0 !== arguments[1] ? arguments[1] : {}, t = arguments.length > 2 ? arguments[2] : void 0;
+  return t || (t = defaultRE), (0, _parseText.default)(e, r, t);
+}
+
+function changeParam(e, r) {
+  if (!e || _utils.default.isEmpty(r)) return e;
+  var t = e;
+  return Object.keys(r).forEach(function(e) {
+    var i = r[e];
+    _utils.default.isUndefined(i) ? i = "" : _utils.default.isArray(i) || _utils.default.isObject(i) && (i = JSON.stringify(i)), 
+    t = function(e, r, t) {
+      var i = r + "=([^&]*)", u = r + "=" + t;
+      if (e.match(i)) {
+        var a = new RegExp("(".concat(r, "=)([^&]*)"), "gi");
+        return e.replace(a, u);
+      }
+      return e.match("[?]") ? e + "&" + u : e + "?" + u;
+    }(t, e, i);
+  }), t;
+}
+
+var completePrefix = exports.completePrefix = function() {
+  var e = arguments.length > 0 && void 0 !== arguments[0] ? arguments[0] : "", r = arguments.length > 1 && void 0 !== arguments[1] ? arguments[1] : "";
+  return e && "" !== e ? (e.endsWith("/") && (e = e.substring(0, e.length - 1)), e = (0, 
+  _trim2.default)(e), r.startsWith("/") && (r = r.substring(1)), [ e, r = (r = (0, 
+  _trim2.default)(r)).replace(/\/\/+/g, "/") ].join("/")) : r;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "amos-apptool",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "amos app tool",
   "main": "./lib/index.js",
   "module": "./esm/index.js",