feat: integrate node-ip package

README.md

@@ -11,12 +11,20 @@ yarn add zx-extra
 ```
 
 ## Usage
-Inherits zx, so all origin methods are available.
+Inherits zx, so all origin methods are available. Follow [the upstream docs](https://github.com/google/zx) for details.
 
 ## Extras
 
+### `ip`
+Resolves the current IP address via [node-ip](https://github.com/indutny/node-ip).
+```js
+import {ip} from 'zx-extra'
+
+ip.address() // 1.2.3.4
+```
+
 ### `semver`
-Semantic versioning api from [node-semver](https://github.com/npm/node-semver)
+Semantic versioning API provided by [node-semver](https://github.com/npm/node-semver)
 ```js
 import {semver} from 'zx-extra'
 

package.json

@@ -38,6 +38,7 @@
     "@qiwi/deep-proxy": "^1.9.0",
     "@types/node": "^17.0.38",
     "@types/semver": "^7.3.9",
+    "ip": "^1.1.8",
     "npm-run-path": "^5.1.0",
     "zx": "^6.2.0"
   }

src/main/js/index.mjs

@@ -4,8 +4,9 @@ import {isTemplateSignature, randomId} from './util.mjs'
 import {npmRunPath} from 'npm-run-path'
 import {DeepProxy} from '@qiwi/deep-proxy'
 
-export { semver } from './semver.mjs'
 export * from 'zx'
+export { default as ip } from 'ip'
+export { semver } from './semver.mjs'
 
 export const $ = new DeepProxy(_$, ({DEFAULT, trapName, args}) => {
   if (trapName === 'apply') {

src/test/js/test.mjs

@@ -1,5 +1,5 @@
 import {strict as assert} from 'node:assert'
-import {$, semver, createHook} from '../../main/js/index.mjs'
+import {$, semver, createHook, ip} from '../../main/js/index.mjs'
 
 // $.raw
 {
@@ -105,3 +105,8 @@ import {$, semver, createHook} from '../../main/js/index.mjs'
   $.verbose = 2
 }
 
+// ip
+{
+  assert(/(\d+\.){3}\d+/.test(ip.address()))
+}
+