recursive-exec

Run a command on each file in a folder and its subfolders (CLI tool designed for use in npm package.json scripts)

recursive-exec is the Unix find -type f -exec command for use in your project's package.json file.

A) Setup

Install package for node:

$ npm install --save-dev recursive-exec

B) Usage

1. npm package.json scripts

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

Parameters:

• The first parameter is the source folder.
• The second parameter is the command template string.

Example package.json scripts:

   "scripts": {
      "minimize-js": "recursive-exec build/web --ext=.js 'uglifyjs {{file}} --output dist/web/{{basename}}.min.js'"
   },

The command template supports 6 variables:

Template Variable	Description	Example (source: 'build/web')
{{file}}	Full path including filename.	'build/web/lib/fetch-json.js'
{{filename}}	Relative path including filename.	'lib/fetch-json.js'
{{basename}}	Relative path including filename without file extension.	'lib/fetch-json'
{{path}}	Relative path without filename.	'lib'
{{name}}	Basename of file.	'fetch-json'
{{nameCamelCase}}	Basename of file converted to camel case.	'fetchJson'

2. Command-line npx

Example terminal command to minimize JavaScript files:

$ npm install --save-dev recursive-exec
$ npx recursive-exec build/web --ext=.js "uglifyjs {{file}} --output dist/web/{{basename}}.min.js"

You can also install recursive-exec globally (--global) and then run it anywhere directly from the terminal.

3. CLI flags

Command-line flags:

Flag	Description	Value
--echo	Show dry run preview of each command without executig it.	N/A
--exclude	Comma separated list of strings to match in paths to skip.	string
--ext	Filter files by file extension, such as .js. Use a comma to specify multiple extensions.	string
--note	Place to add a comment only for humans.	string
--quiet	Suppress informational messages.	N/A

Examples:

• recursive-exec src/web --ext=.less 'lessc src/web/{{filename}} build/web/{{basename}}.css'
  Compiles all LESS files in the src/web folder into CSS files in the build/web folder.

• recursive-exec src/web --ext=.less 'lessc {{file}} build/web/{{basename}}.css'
  Identical to the previous example since {{file}} includes the source folder (src/web) in the path.

• recursive-exec build/web --ext=.css 'csso {{file}} --output dist/web/{{filename}}'
  Optimizes the CSS files in the build/web folder and save the new files to the dist/web folder.

• recursive-exec build/web --ext=.js --quiet 'make-dir dist/web/{{path}}'
  Duplicates the folder structure from build/web over to dist/web (first run npm install --save-dev make-dir-cli).

• recursive-exec build/web --ext=.js 'uglifyjs {{file}} --output dist/web/{{basename}}.min.js'
  Minimizes the JavaScript files in the build/web folder and saves the new files to the dist/web folder with the .min.js file extension.

• recursive-exec src 'glob {{file}}'
  Lists out all source files.

• recursive-exec build/web-app --ext=.js --exclude=modules 'rollup {{file}} --file dist/web-app/{{filename}} --name {{nameCamelCase}}'
  Uses rollup to bundle the JavaScript for each web page but skip over the modules folders.

Note: Single quotes in commands are normalized so they work cross-platform and avoid the errors often encountered on Microsoft Windows.

C) Application Code

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

Example:

import { recursiveExec } from 'recursive-exec';

const options = { quiet: true };
const results = recursiveExec.find('src/web', 'ls -o {{file}}', options);
console.log('Number of files:', results.length);

See the TypeScript Declarations at the top of recursive-exec.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/recursive-exec/issues

MIT License