copyfiles-now

A fast zero runtime-dependency tool for copying files using glob patterns into destination directory.

It's API compatible with copyfiles but it uses 43.8x less memory, has 0 dependencies and it's 1.24x faster copying 5,000 files.

Install

npm i -D copyfiles-now

Node.js 18+ is required. The package does not run install scripts. The launcher selects the native binary at runtime and fails loudly if it is missing.

Replace the package, not your scripts:

- npm i -D copyfiles
+ npm i -D copyfiles-now

CLI

Run without installing:

npx copyfiles-now 'src/**/*.css' dist

Run from your project scripts:

copyfiles 'src/**/*.css' dist
copyfiles -u 1 'src/assets/**/*' dist
copyfiles --flat 'src/**/*.css' 'vendor/**/*.css' dist
copyfiles -e '**/*.tmp.css' 'src/**/*.css' dist
copyfiles --all 'src/**/*.txt' dist
copyfiles --soft 'src/**/*.txt' dist
copyup 'public/**/*' dist

copyup is equivalent to copyfiles --up 1.

Supported flags: --up, --flat, --exclude, --all, --soft, --error, --follow, and --verbose.

Node API

const copyfiles = require('copyfiles-now')

copyfiles(['src/**/*.css', 'dist'], err => {
  if (err) throw err
})

copyfiles(['src/**/*.css', 'dist'], 1, err => {
  if (err) throw err
})

copyfiles(['src/**/*.css', 'dist'], {
  up: 1,
  exclude: ['**/*.tmp.css'],
  all: true,
  soft: true
}, err => {
  if (err) throw err
})

The callback is required, matching copyfiles.

Benchmarks

Local darwin-arm64 snapshot. Copy runtime uses bench/stress.sh with 5,000 .txt files. Lower is better.

| Metric | copyfiles | copyfiles-now | Improvement | | --- | ---: | ---: | ---: | | Direct runtime deps | 7 | 0 | 7 fewer | | Startup time | 40.4 ms ± 0.7 | 1.3 ms ± 0.1 | 31.07x faster | | Copy 5,000 files | 900.3 ms ± 22.4 | 726.1 ms ± 16.3 | 1.24x faster | | Startup RSS | 57.5 MB | 1.9 MB | 30.0x less memory | | Copy RSS, 5,000 files | 166.5 MB | 3.8 MB | 43.8x less memory |

Run locally:

npm run build:native
bash bench/startup.sh
bash bench/memory.sh
bash bench/stress.sh

Development

cargo fmt --check
cargo clippy --all-targets --all-features -- -D warnings
npm test
npm run pack:dry

License

MIT