ncp

What is ncp?

The ncp (node-copy-paste) npm package is a Node.js module that provides asynchronous recursive file copying with Node.js. It is often used for tasks such as copying entire directories, handling errors, and limiting the number of concurrent file transfers.

What are ncp's main functionalities?

Asynchronous Recursive File & Directory Copying

This feature allows you to copy files and directories from a source to a destination asynchronously. You can also set a limit on the number of concurrent copy actions.

const ncp = require('ncp').ncp;

ncp.limit = 16;

ncp(source, destination, function (err) {
 if (err) {
   return console.error(err);
 }
 console.log('Copy operation complete!');
});

Error Handling

ncp provides a callback function that can be used to handle errors that occur during the copy process.

const ncp = require('ncp').ncp;

ncp(source, destination, function (err) {
 if (err) {
   console.error('Error during copy:', err);
 }
});

Filtering Files

ncp allows you to specify a filter for the copy operation, so only files that match the given regular expression will be copied.

const ncp = require('ncp').ncp;

ncp(source, destination, {
 filter: /\.(txt|html)$/i
}, function (err) {
 if (err) {
   return console.error(err);
 }
 console.log('Copy operation complete!');
});

Other packages similar to ncp

fs-extra

fs-extra is a package that builds upon the standard fs module, providing additional methods like copy and copySync. It offers similar file copying capabilities and includes more file system methods, making it a more comprehensive solution than ncp.

cpy

cpy is a file copying tool for Node.js. It supports copying multiple files and has a fluent API that allows for glob patterns and options. It is a more modern alternative to ncp with promise support.

copyfiles

copyfiles is a package that can be used to copy files from one directory to another, supporting glob patterns and allowing for flattening of the directory structure. It is simpler than ncp but does not support recursive copying of directories.

README

ncp - Asynchronous recursive file & directory copying

Think cp -r, but pure node, and asynchronous. ncp can be used both as a CLI tool and programmatically.

Command Line usage

Usage is simple: ncp [source] [dest] [concurrency limit]

The 'concurrency limit' is an integer that represents how many pending file system requests ncp has at a time.

If there are no errors, ncp will output done. when complete.

Programmatic usage

Programmatic usage of ncp is just as simple.

var ncp = require('ncp').ncp;

ncp.limit = 16;

ncp(source, destination, function (err) {
 if (err) {
   return console.error(err);
 }
 console.log('done!');
});

Please open an issue if any bugs arise. As always, I accept (working) pull requests, and refunds are available at /dev/null.