Add Cloud Storage encryption samples and tests.

storage/encryption.js

@@ -59,7 +59,7 @@ function generateEncryptionKey () {
  * @param {string} srcFileName The local file to be uploaded.
  * @param {string} destFileName The name of the destination file.
  * @param {string} key The encryption key.
- * @param {function} key The callback function.
+ * @param {function} callback The callback function.
  */
 function uploadEncryptedFile (bucketName, srcFileName, destFileName, key, callback) {
   if (!bucketName) {
@@ -97,8 +97,8 @@ function uploadEncryptedFile (bucketName, srcFileName, destFileName, key, callba
  * file.
  *
  * @param {string} bucketName The bucket from which the file will be downloaded.
- * @param {string} srcFileName The local file to be downloaded.
- * @param {string} destFileName The name of the destination file.
+ * @param {string} srcFileName The name of the file to be downloaded.
+ * @param {string} destFileName The local path to which to save the file.
  * @param {string} key The encryption key.
  * @param {function} key The callback function.
  */

storage/system-test/encryption.test.js

@@ -27,21 +27,27 @@ var downloadFilePath = path.join(__dirname, '../resources/downloaded.txt');
 
 describe('storage:encryption', function () {
   var key;
+
   before(function (done) {
+    // Create an key to use throughout the test
     key = program.generateEncryptionKey();
+    // Create a test bucket
     storage.createBucket(bucketName, done);
   });
 
   after(function (done) {
     try {
+      // Delete the downloaded file
       fs.unlinkSync(downloadFilePath);
     } catch (err) {
       console.log(err);
     }
+    // Delete any files that were uploaded
     storage.bucket(bucketName).deleteFiles({ force: true }, function (err) {
       if (err) {
         return done(err);
       }
+      // Delete the test bucket
       storage.bucket(bucketName).delete(done);
     });
   });

storage/test/encryption.test.js

@@ -123,7 +123,7 @@ describe('storage:encryption', function () {
 
   describe('downloadEncryptedFile', function () {
     var fileName = 'test.txt';
-    it('should upload a file', function () {
+    it('should download a file', function () {
       var sample = getSample();
 
       sample.program.downloadEncryptedFile(bucketName, fileName, fileName, 'key', function (err) {
@@ -181,6 +181,7 @@ describe('storage:encryption', function () {
   });
 
   describe('rotateEncryptionKey', function () {
+    it('should be implemented');
     it('should rotate an encryption key', function () {
       var sample = getSample();