You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
|
|
# grunt-contrib-copy [![Build Status](https://secure.travis-ci.org/gruntjs/grunt-contrib-copy.png?branch=master)](http://travis-ci.org/gruntjs/grunt-contrib-copy)
> Copy files and folders.
## Getting Started
This plugin requires Grunt `~0.4.0`
If you haven't used [Grunt](http://gruntjs.com/) before, be sure to check out the [Getting Started](http://gruntjs.com/getting-started) guide, as it explains how to create a [Gruntfile](http://gruntjs.com/sample-gruntfile) as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:
```shell npm install grunt-contrib-copy --save-dev ```
Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:
```js grunt.loadNpmTasks('grunt-contrib-copy'); ```
*This plugin was designed to work with Grunt 0.4.x. If you're still using grunt v0.3.x it's strongly recommended that [you upgrade](http://gruntjs.com/upgrading-from-0.3-to-0.4), but in case you can't please use [v0.3.2](https://github.com/gruntjs/grunt-contrib-copy/tree/grunt-0.3-stable).*
## Copy task
_Run this task with the `grunt copy` command._
Task targets, files and options may be specified according to the grunt [Configuring tasks](http://gruntjs.com/configuring-tasks) guide. ### Options
#### processContent
Type: `Function(content, srcpath)`
This option is passed to `grunt.file.copy` as an advanced way to control the file contents that are copied.
#### processContentExclude
Type: `String`
This option is passed to `grunt.file.copy` as an advanced way to control which file contents are processed.
### Usage Examples
```js copy: { main: { files: [ {src: ['path/*'], dest: 'dest/', filter: 'isFile'}, // includes files in path {src: ['path/**'], dest: 'dest/'}, // includes files in path and its subdirs {expand: true, cwd: 'path/', src: ['**'], dest: 'dest/'}, // makes all src relative to cwd {expand: true, flatten: true, src: ['path/**'], dest: 'dest/', filter: 'isFile'} // flattens results to a single level ] } } ```
## Release History
* 2013-02-14 v0.4.0 First official release for Grunt 0.4.0. * 2013-01-22 v0.4.0rc7 Updating grunt/gruntplugin dependencies to rc7. Changing in-development grunt/gruntplugin dependency versions from tilde version ranges to specific versions. * 2013-01-13 v0.4.0rc5 Updating to work with grunt v0.4.0rc5. Conversion to grunt v0.4 conventions. Replace basePath with cwd. Empty directory support. * 2012-10-17 v0.3.2 Pass copyOptions on single file copy. * 2012-10-11 v0.3.1 Rename grunt-contrib-lib dep to grunt-lib-contrib. * 2012-09-23 v0.3.0 General cleanup and consolidation. Global options depreciated. * 2012-09-17 v0.2.4 No valid source check. * 2012-09-16 v0.2.3 Path.sep fallback for node <= 0.7.9. * 2012-09-16 v0.2.2 Single file copy support. Test refactoring. * 2012-09-06 v0.2.0 Refactored from grunt-contrib into individual repo.
---
Task submitted by [Chris Talkington](http://christalkington.com/)
*This file was generated on Fri Feb 22 2013 09:26:58.*
|