Improved interface for programmatically adding files

* Added Jasmine#addHelperFile
* Added more clearly named synonyms for Jasmine#addSpecFiles and
  Jasmine#addHelperFiles, and marked the old ones deprecated

Author: sgravrock

lib/jasmine.js

@@ -114,6 +114,16 @@ Jasmine.prototype.addSpecFile = function(filePath) {
   this.specFiles.push(filePath);
 };
 
+/**
+ * Adds a helper file to the list that will be loaded when the suite is executed.
+ * @function
+ * @name Jasmine#addHelperFile
+ * @param {string} filePath The path to the file to be loaded.
+ */
+Jasmine.prototype.addHelperFile = function(filePath) {
+  this.helperFiles.push(filePath);
+};
+
 /**
  * Add a custom reporter to the Jasmine environment.
  * @function
@@ -329,8 +339,48 @@ Jasmine.prototype.loadConfig = function(config) {
   }
 };
 
-Jasmine.prototype.addHelperFiles = addFiles('helperFiles');
-Jasmine.prototype.addSpecFiles = addFiles('specFiles');
+/**
+ * Adds files that match the specified patterns to the list of spec files.
+ * @function
+ * @name Jasmine#addMatchingSpecFiles
+ * @param {Array<string>} patterns An array of spec file paths
+ * or {@link https://github.com/isaacs/node-glob#glob-primer|globs} that match
+ * spec files. Each path or glob will be evaluated relative to the spec directory.
+ */
+Jasmine.prototype.addMatchingSpecFiles = addFiles('specFiles');
+/**
+ * Adds files that match the specified patterns to the list of helper files.
+ * @function
+ * @name Jasmine#addMatchingHelperFiles
+ * @param {Array<string>} patterns An array of helper file paths
+ * or {@link https://github.com/isaacs/node-glob#glob-primer|globs} that match
+ * helper files. Each path or glob will be evaluated relative to the spec directory.
+ */
+Jasmine.prototype.addMatchingHelperFiles = addFiles('helperFiles');
+
+
+// Deprecated synonyms for the above. These are confusingly named (addSpecFiles
+// doesn't just do N of what addSpecFile does) but they've been around a long
+// time and there might be quite a bit of code that uses them.
+
+/**
+ * Synonym for {@link Jasmine#addMatchingSpecFiles}
+ * @function
+ * @name Jasmine#addSpecFiles
+ * @deprecated Use {@link Jasmine#addMatchingSpecFiles|addMatchingSpecFiles},
+ * {@link Jasmine#loadConfig|loadConfig}, or {@link Jasmine#loadConfigFile|loadConfigFile}
+ * instead.
+ */
+Jasmine.prototype.addSpecFiles = Jasmine.prototype.addMatchingSpecFiles;
+/**
+ * Synonym for {@link Jasmine#addMatchingHelperFiles}
+ * @name Jasmine#addHelperFiles
+ * @function
+ * @deprecated Use {@link Jasmine#addMatchingHelperFiles|addMatchingHelperFiles},
+ * {@link Jasmine#loadConfig|loadConfig}, or {@link Jasmine#loadConfigFile|loadConfigFile}
+ * instead.
+ */
+Jasmine.prototype.addHelperFiles = Jasmine.prototype.addMatchingHelperFiles;
 
 Jasmine.prototype.addRequires = function(requires) {
   var jasmineRunner = this;

spec/jasmine_spec.js

@@ -35,21 +35,40 @@ describe('Jasmine', function() {
     });
   });
 
-  it('adds spec files', function() {
-    expect(this.testJasmine.specFiles).toEqual([]);
-    this.testJasmine.addSpecFile('some/file/path.js');
-    expect(this.testJasmine.specFiles).toEqual(['some/file/path.js']);
+  describe('#addSpecFile', function() {
+    it('adds the provided path to the list of spec files', function () {
+      expect(this.testJasmine.specFiles).toEqual([]);
+      this.testJasmine.addSpecFile('some/file/path.js');
+      expect(this.testJasmine.specFiles).toEqual(['some/file/path.js']);
+    });
+  });
+
+  describe('#addHelperFile', function() {
+    it('adds the provided path to the list of helper files', function () {
+      expect(this.testJasmine.helperFiles).toEqual([]);
+      this.testJasmine.addHelperFile('some/file/path.js');
+      expect(this.testJasmine.helperFiles).toEqual(['some/file/path.js']);
+    });
   });
 
   describe('Methods that specify files via globs', function() {
     describe('#addSpecFiles', function() {
       hasCommonFileGlobBehavior('addSpecFiles', 'specFiles');
     });
 
+    describe('#addMatchingSpecFiles', function() {
+      hasCommonFileGlobBehavior('addMatchingSpecFiles', 'specFiles');
+    });
+
     describe('#addHelperFiles', function() {
       hasCommonFileGlobBehavior('addHelperFiles', 'helperFiles');
     });
 
+    describe('#addMatchingHelperFiles', function() {
+      hasCommonFileGlobBehavior('addMatchingHelperFiles', 'helperFiles');
+    });
+
+
     function hasCommonFileGlobBehavior(method, destProp) {
       it('adds a file with an absolute path', function() {
         var aFile = path.join(this.testJasmine.projectBaseDir, this.testJasmine.specDir, 'spec/command_spec.js');