feat: add copy helper

README.md

@@ -52,6 +52,21 @@ temporaryFile()       // '/private/var/folders/p0/p7xckky93s30rshd51gs4pdc0000gn
 temporaryDirectory()  // '/private/var/folders/p0/p7xckky93s30rshd51gs4pdc0000gn/T/1b7e9277860eb90b94aad816d4f66f8e'
 ```
 
+### `copy`
+Provides [`globby`-boosted copying API](https://github.com/antongolub/globby-cp).
+```js
+import {copy} from 'zx-extra'
+
+await copy({
+  from:       'src/**/*.js',
+  to:         'dist/',
+  baseFrom,   // process.cwd()
+  baseTo,     // process.cwd(),
+  debug,      // () => {}
+  ignoreFiles // undefined
+})
+```
+
 ### `ctx`
 [async_hooks](https://nodejs.org/api/async_hooks.html)-driven scope isolator.
 Creates a separate zx-context for the specified function.

package.json

@@ -37,8 +37,9 @@
   "dependencies": {
     "@qiwi/deep-proxy": "^2.0.2",
     "@types/ip": "^1.1.0",
-    "@types/node": "^18.0.0",
+    "@types/node": "^18.0.1",
     "@types/semver": "^7.3.10",
+    "globby-cp": "^1.0.1",
     "ip": "^1.1.8",
     "is-reachable": "^5.2.1",
     "npm-run-path": "^5.1.0",

src/main/js/goods.mjs

@@ -2,3 +2,4 @@ export * as tempy from 'tempy'
 export { default as ip } from 'ip'
 export { semver } from './semver.mjs'
 export { default as tcping } from 'is-reachable'
+export { copy } from 'globby-cp'

src/test/js/test.mjs

@@ -1,5 +1,5 @@
 import {strict as assert} from 'node:assert'
-import {$, semver, createHook, ip, tempy, tcping, sleep, ctx} from '../../main/js/index.mjs'
+import {$, semver, createHook, ip, tempy, tcping, sleep, ctx, copy, fs, path} from '../../main/js/index.mjs'
 
 // $.raw
 {
@@ -123,6 +123,18 @@ import {$, semver, createHook, ip, tempy, tcping, sleep, ctx} from '../../main/j
   assert(!(await tcping('unknown:1234')))
 }
 
+// copy
+{
+  const from = tempy.temporaryDirectory()
+  const to = tempy.temporaryDirectory()
+  const footxt = path.resolve(from, 'foo.txt')
+
+  await fs.outputFile(footxt, 'foo')
+
+  await copy({from: footxt, to})
+  assert.equal((await fs.readFile(path.resolve(to, 'foo.txt'))).toString('utf-8').trim(), 'foo')
+}
+
 // ctx()
 {
   await ctx(async ($) => {