# dp-grunt-contrib-copy

> Copy files and folders. Forked from grunt-contrib-copy 0.4.1

Latest version **0.4.4** (published 2013-02-27) · 0 weekly downloads

> **Deprecated.** This package is deprecated.

## Install

```sh
npm install dp-grunt-contrib-copy
pnpm add dp-grunt-contrib-copy
yarn add dp-grunt-contrib-copy
bun add dp-grunt-contrib-copy
```

## Health

**Score 10/100 (F)** — status: deprecated.

Negative: deprecated.

## Facts

| | |
|---|---|
| Version | 0.4.4 |
| Published | 2013-02-27 |
| First published | 2013-01-07 |
| Weekly downloads | 0 |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >= 0.8.0 |
| Dependencies | 1 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 719 |
| Author | Grunt Team |
| Maintainers | dancingplatypus |
| Keywords | gruntplugin |

## Links

- npm: https://www.npmjs.com/package/dp-grunt-contrib-copy
- Repository: https://github.com/gruntjs/grunt-contrib-copy
- Homepage: https://github.com/dancingplatypus/grunt-contrib-copy
- Issues: https://github.com/gruntjs/grunt-contrib-copy/issues
- npm.io page: https://npm.io/package/dp-grunt-contrib-copy

## Dependencies (1)

- [async](https://npm.io/package/async.md) ~0.2.5

## Recent versions

- 0.4.4 (latest) — 2013-02-27
- 0.4.5 — 2013-01-08
- 0.4.3 — 2013-01-08
- 0.4.2 — 2013-01-07
- 0.4.1 — 2013-01-07

## README

# dp-grunt-contrib-copy [![Build Status](https://secure.travis-ci.org/gruntjs/dp-grunt-contrib-copy.png?branch=master)](http://travis-ci.org/gruntjs/dp-grunt-contrib-copy)

> Copy files and folders. Forked from grunt-contrib-copy 0.4.1



## 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 dp-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('dp-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.

#### onlyIf
Type: `String` | `Function` Default 'always'

Controls whether or not the file will be copied.

If `onlyIf` is a function, is should have the signature: `fn(srcPath, destPath, srcStat, destStat)`
and it should return `true` if the file is to be copied, `false` otherwise.

If `onlyIf` is a string, then it must be one of:
* **always** -- the source will always be copied to the destination
* **newer** -- the source will only be copied if it is newer than the destination
* **modified** -- the source will be copied only if its timestamp is different than that of the destination
* **missing** -- the source will only be copied if there is no destination file

### 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 Wed Feb 27 2013 17:43:34.*

---
_Source: https://npm.io/package/dp-grunt-contrib-copy · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._