tests and documentation for copy option

Gruntfile.js

@@ -51,6 +51,24 @@ module.exports = function (grunt) {
         },
         src: ['test/fixtures/file.png', 'test/fixtures/another.png'],
         dest: 'test/tmp'
+      },
+      withCopyTrue: {
+        options: {
+          algorithm: 'sha1',
+          length: 4,
+          copy: 1
+        },
+        src: ['test/tmp/another.png'],
+        dest: 'test/tmp'
+      },
+      withCopyFalse: {
+        options: {
+          algorithm: 'sha1',
+          length: 4,
+          copy: 0
+        },
+        src: ['test/tmp/movedfile.png'],
+        dest: 'test/tmp/copyfalse'
       }
     },
     simplemocha: {

README.md

@@ -61,6 +61,14 @@ Default: `8`
 
 The number of characters of the file hash to prefix the file name with.
 
+#### options.copy
+
+Type: `Boolean`  
+Default: `null`
+
+Flag controlling whether the original file is copied or moved. If not set, 
+other parameters, such as setting a [destination](#destination) control the behaviour.
+
 ### Destination
 
 It will overwrite the `src` files if you don't specify a `dest`:

test/filerev_test.js

@@ -26,4 +26,20 @@ describe('filerev', function () {
     var revisioned= fs.statSync('test/tmp/expand/file.a0539763.png').size;
     assert(revisioned === original);
   });
+
+  it('should copy the file when copy option is true', function () {
+    var original = fs.statSync('test/fixtures/another.png').size;
+    var revisioned= fs.statSync('test/tmp/another.37ba.png').size;
+    assert(revisioned === original);
+    var fileExists = fs.existsSync('test/tmp/another.png');
+    assert(fileExists === true);
+  });
+
+  it('should move the file when copy option is false', function () {
+    var original = fs.statSync('test/fixtures/movedfile.png').size;
+    var revisioned= fs.statSync('test/tmp/copyfalse/movedfile.37ba.png').size;
+    assert(revisioned === original);
+    var fileExists = fs.existsSync('test/tmp/movedfile.png');
+    assert(fileExists === false);
+  });
 });