rollup-plugin-copy-merge

Copy & Merge files and folders, with glob support. This plugin is extended rollup-plugin-copy plugin which support the merge functionality. Thanks #vladshcherbin

Installation

1# yarn
2yarn add rollup-plugin-copy-merge --dev
3
4# npm
5npm i rollup-plugin-copy-merge --save-dev

Usage

1// rollup.config.js
2import copy from 'rollup-plugin-copy-merge'
3
4export default {
5  input: 'src/index.js',
6  output: {
7    file: 'dist/app.js',
8    format: 'cjs'
9  },
10  plugins: [
11    copy({
12      targets: [
13        { src: 'src/index.html', dest: 'dist/public' },
14        { src: ['assets/fonts/arial.woff', 'assets/fonts/arial.woff2'], dest: 'dist/public/fonts' },
15        { src: 'assets/images/**/*', dest: 'dist/public/images' }
16        { src: 'assets/js/*.js', file: 'dist/public/scripts.js' },
17      ]
18    })
19  ]
20}

Configuration

There are some useful options:

targets

Type: Array | Default: []

Array of targets to copy. A target is an object with properties:

• src (string, Array): Path or glob of what to copy
• dest (string, Array): One or more destinations where to copy
• file (string): destination file where to copy. all source files will merge into this file. (only supports for 'utf8' contents)
• rename (string, Function): Change destination file or folder name
• transform (Function): Modify file contents (only supports for 'utf8' contents)

Each object should have dest or file, and src properties, rename and transform are optional. globby is used inside, check it for glob pattern examples.

Merge (extended)

Can merge using file attribute.

1copy({
2  targets: [{ src: 'assets/polyfill/*.js', file: 'dist/public/polyfill.js' }],
3  flatten: false
4});

File

1copy({
2  targets: [{ src: 'src/index.html', dest: 'dist/public' }]
3});

Folder

1copy({
2  targets: [{ src: 'assets/images', dest: 'dist/public' }]
3});

Glob

1copy({
2  targets: [{ src: 'assets/*', dest: 'dist/public' }]
3});

Glob: multiple items

1copy({
2  targets: [
3    {
4      src: ['src/index.html', 'src/styles.css', 'assets/images'],
5      dest: 'dist/public'
6    }
7  ]
8});

Glob: negated patterns

1copy({
2  targets: [{ src: ['assets/images/**/*', '!**/*.gif'], dest: 'dist/public/images' }]
3});

Multiple targets

1copy({
2  targets: [
3    { src: 'src/index.html', dest: 'dist/public' },
4    { src: 'assets/images/**/*', dest: 'dist/public/images' }
5  ]
6});

Multiple destinations

1copy({
2  targets: [{ src: 'src/index.html', dest: ['dist/public', 'build/public'] }]
3});

Rename with a string

1copy({
2  targets: [{ src: 'src/app.html', dest: 'dist/public', rename: 'index.html' }]
3});

Rename with a function

1copy({
2  targets: [
3    {
4      src: 'assets/docs/*',
5      dest: 'dist/public/docs',
6      rename: (name, extension, src_path) => `${name}-v1.${extension}`
7    }
8  ]
9});

Transform file contents

1copy({
2  targets: [
3    {
4      src: 'src/index.html',
5      dest: 'dist/public',
6      transform: (contents, src_file_name, src_path) =>
7        contents.toString().replace('__SCRIPT__', 'app.js')
8    }
9  ]
10});

verbose

Type: boolean | Default: false

Output copied items to console.

1copy({
2  targets: [{ src: 'assets/*', dest: 'dist/public' }],
3  verbose: true
4});

hook

Type: string | Default: buildEnd

Rollup hook the plugin should use. By default, plugin runs when rollup has finished bundling, before bundle is written to disk.

1copy({
2  targets: [{ src: 'assets/*', dest: 'dist/public' }],
3  hook: 'writeBundle'
4});

copyOnce

Type: boolean | Default: false

Copy items once. Useful in watch mode.

1copy({
2  targets: [{ src: 'assets/*', dest: 'dist/public' }],
3  copyOnce: true
4});

flatten

Type: boolean | Default: true

Remove the directory structure of copied files.

1copy({
2  targets: [{ src: 'assets/**/*', dest: 'dist/public' }],
3  flatten: false
4});

All other options are passed to packages, used inside:

• globby

Original Author

Cédric Meuter Vlad Shcherbin

License

MIT