Copy or rename a file with optional package version number (CLI tool designed for use in npm package.json scripts)

copy-file-util takes a source file and copies it to a new destination.  The command's console output includes a timestamp and formatting helpful in build systems.

Install package for node:

$ npm install --save-dev copy-file-util

copy-file [SOURCE] [TARGET]

Parameters:

• The first parameter is the source file.
• The second parameter is the target file or folder (use the --folder flag).

Run copy-file from the "scripts" section of your package.json file.

Example package.json scripts:

   "scripts": {
      "pub-license": "copy-file src/LICENSE doc/license.txt",
      "backup-license": "copy-file src/LICENSE --folder backup",
   },

Example terminal commands:

$ npm install --save-dev copy-file-util
$ copy-file src/web/api.html docs/api-manual.html

You can also install copy-file-util globally (--global) and then run it anywhere directly from the terminal.

Command-line flags:

• copy-file app.js app.mjs --quiet
  Displays no output.

• copy-file app.js --folder dist
  Copies app.js into the dist folder.

• copy-file 'src/Legal Notice.md' --folder dist
  Copies a file that has a space in its filename.

• copy-file node_modules/ui-xlib/colors.less --folder src/css --platform-eol
  Copies colors.less into your project and converts the file's EOL characters to \n for LF on Unix and \r\n for CRLF on Windows.

• copy-file app.js --move --folder dist
  Like the mv Unix command.

• copy-file default-config.json settings/config.json --no-overwrite
  Performs a safe copy that aborts if the settings/config.json file already exists.

The target parameter can contain template variables, like {{package.version}} and {{package.name}}, which will be replaced with values with values from your project's package.json file.

Example:

• copy-file build/my-app.js dist/my-app-v{{package.version}}.js
  Creates a copy of my-app.js named something like my-app-v1.2.3.js based on the version of your project.

Even though copy-file-util is primarily intended for build scripts, the package can be used programmatically in ESM and TypeScript projects.

Example:

import { copyFile } from 'copy-file-util';

const result = copyFile.cp('src/web/api.html' { targetFile: 'docs/api-manual.html' });
console.info('Execution time:', result.duration, 'ms');

See the TypeScript Declarations at the top of copy-file.ts for documentation.

CLI Build Tools for package.json

• 🎋 add-dist-header:  Prepend a one-line banner comment (with license notice) to distribution files
• 📄 copy-file-util:  Copy or rename a file with optional package version number
• 📂 copy-folder-util:  Recursively copy files from one folder to another folder
• 🪺 recursive-exec:  Run a command on each file in a folder and its subfolders
• 🔍 replacer-util:  Find and replace strings or template outputs in text files
• 🔢 rev-web-assets:  Revision web asset filenames with cache busting content hash fingerprints
• 🚆 run-scripts-util:  Organize npm package.json scripts into groups of easy to manage commands
• 🚦 w3c-html-validator:  Check the markup validity of HTML files using the W3C validator

Feel free to submit questions at:
github.com/center-key/copy-file-util/issues

MIT License