feat: add tildify

DOC.md

@@ -12301,6 +12301,26 @@ fs.createReadStream('in.txt')
     .pipe(fs.createWriteStream('out.txt'));
 ```
 
+## tildify 
+
+Convert absolute path to tilde path.
+
+<details>
+<summary>Type Definition</summary>
+<pre>
+<code class="language-typescript">function tildify(path: string): string;</code>
+</pre>
+</details>
+
+|Name  |Desc           |
+|------|---------------|
+|path  |Path to convert|
+|return|Tilde path     |
+
+```javascript
+tildify('/home/surunzi/dev'); // -> '~/dev'
+```
+
 ## timeAgo 
 
 Format datetime with *** time ago statement.

DOC_CN.md

@@ -12292,6 +12292,26 @@ fs.createReadStream('in.txt')
     .pipe(fs.createWriteStream('out.txt'));
 ```
 
+## tildify
+
+将绝对路径转换为波浪线路径。
+
+<details>
+<summary>类型定义</summary>
+<pre>
+<code class="language-typescript">function tildify(path: string): string;</code>
+</pre>
+</details>
+
+|参数名|说明|
+|-----|---|
+|path|要转换的路径|
+|返回值|波浪线路径|
+
+```javascript
+tildify('/home/surunzi/dev'); // -> '~/dev'
+```
+
 ## timeAgo
 
 将时间格式化成多久之前的形式。

cspell.json

@@ -412,6 +412,7 @@
     "template",
     "throttle",
     "through",
+    "tildify",
     "timeAgo",
     "times",
     "timeTaken",

i18n/tildify.md

@@ -0,0 +1,8 @@
+## CN
+
+将绝对路径转换为波浪线路径。
+
+|参数名|说明|
+|-----|---|
+|path|要转换的路径|
+|返回值|波浪线路径|

index.json

@@ -6366,6 +6366,18 @@
             "node"
         ]
     },
+    "tildify": {
+        "dependencies": [
+            "startWith"
+        ],
+        "description": "Convert absolute path to tilde path.",
+        "env": [
+            "node"
+        ],
+        "test": [
+            "node"
+        ]
+    },
     "timeAgo": {
         "dependencies": [
             "isDate",

src/tildify.js

@@ -0,0 +1,35 @@
+/* Convert absolute path to tilde path.
+ *
+ * |Name  |Desc           |
+ * |------|---------------|
+ * |path  |Path to convert|
+ * |return|Tilde path     |
+ */
+
+/* example
+ * tildify('/home/surunzi/dev'); // -> '~/dev'
+ */
+
+/* module
+ * env: node
+ */
+
+/* typescript
+ * export declare function tildify(path: string): string;
+ */
+
+_('startWith');
+
+const path = require('path');
+const os = require('os');
+
+const homeDir = os.homedir();
+
+exports = function(p) {
+    p = path.normalize(p) + path.sep;
+    if (startWith(p, homeDir)) {
+        p = p.replace(homeDir + path.sep, `~${path.sep}`);
+    }
+
+    return p.slice(0, -1);
+};

test/tildify.js

@@ -0,0 +1,13 @@
+const os = require('os');
+const homeDir = os.homedir();
+
+const isWindows = util.isWindows;
+
+it('basic', function() {
+    if (isWindows) {
+        expect(tildify(homeDir + '\\dev')).to.equal('~\\dev');
+    } else {
+        expect(tildify(homeDir + '/dev')).to.equal('~/dev');
+        expect(tildify('/usr/dev')).to.equal('/usr/dev');
+    }
+});