build-asset v2.0.6
build-test
This package is currently in BETA
Overview
This is a command line tool that performs asset management tasks such as copying files from one location to another.
Guide
To start you will need to install this package for your project by executing the following command within your project from the console.
npm install --save-dev build-asset
Once the package is installed you can run the tool from a terminal using the build-asset
command. Normally you will
do this within an npm script element. Take the following excerpt from an example package.json file:
{
"scripts": {
"asset": "build-asset \"src/public/**/*\" -i src/public -o dist -v 1.0.0 -n public",
"asset-watch": "build-asset \"src/public/**/*\" -i src/public -o dist -v 1.0.0 -n public -w",
}
}
In the example above the asset
script will copy all of the files within the src/public
folder to the dist/1.0.0/public
folder.
The asset-watch
script will copy the same source files whenever one of them is updated or added.
Also notice that the glob patterns are surrounded by double quotes. This is necessary in order to prevent the terminal from expanding the glob patterns into actual file paths.
API
Usage:
build-asset <files> [<files>] -o <output directory> [-i <base input directory>]
[-m [<package.json]] [-v <version>] [-n <name>] [-w] [-k]
Options:
Option | Description |
---|---|
<files> | A glob pattern that identifies files to copy. Multiple glob patterns can be specified. |
-i | The base directory used when creating folder paths in the output directory. Defaults to the current working directory. |
-k | When this option is specified the output folder will not be deleted before files are emitted. |
-m | Read in the version number from a package.json file. If a file isn't specified the package.json in the cwd will be used. |
-n | A name to include in the output path |
-o | The directory to copy files to. |
-v | A version number to include in the output path. |
-w | When present the files specified in the glob pattern(s) will be watched for changes and copied when they do change. |