Add Readme and initial implementation

Readme.md

@@ -0,0 +1,16 @@
+# require-all
+
+An easy way to require all files within a directory.
+
+## Usage
+
+```js
+var controllers = require('require-all')({
+  directory: __dirname + '/controllers',
+  filter: /(.+Controller)\.js$/,
+});
+
+// controllers now is an object with references to all modules matching the filter
+// for example:
+// { HomeController: function HomeController() {...}, ...}
+```

index.js

@@ -0,0 +1,17 @@
+var fs    = require('fs');
+
+module.exports = function requireAll(options) {
+  var files = fs.readdirSync(options.dirname);
+  var modules = {};
+
+  files.forEach(function(file) {
+    var match = file.match(options.filter);
+    if (!match) return;
+
+    var moduleName      = match[1];
+    modules[moduleName] = require(options.dirname + '/' + moduleName);
+  });
+
+  return modules;
+};
+