Follow symlinks

* Removed `getStats` function.
* Added a `resolveSymlinks` function that exposes a `stat` property on
  file object as a side effect (making `getStats` obsolete).
* Added tests.
* Fixes #39.

lib/src/index.js

@@ -9,7 +9,7 @@ var merge = require('merge-stream');
 
 var filterSince = require('./filterSince');
 var getContents = require('./getContents');
-var getStats = require('./getStats');
+var resolveSymlinks = require('./resolveSymlinks');
 
 function createFile(globFile, enc, cb) {
   cb(null, new File(globFile));
@@ -37,8 +37,8 @@ function src(glob, opt) {
   var globStream = gs.create(glob, options);
 
   var outputStream = globStream
-    .pipe(through.obj(createFile))
-    .pipe(getStats(options));
+    .pipe(resolveSymlinks())
+    .pipe(through.obj(createFile));
 
   if (options.since) {
     outputStream = outputStream

lib/src/resolveSymlinks.js

@@ -0,0 +1,38 @@
+'use strict';
+
+var through2 = require('through2');
+var fs = require('graceful-fs');
+var path = require('path');
+
+function resolveSymlinks() {
+  return through2.obj(resolveFile);
+}
+
+// a stat property is exposed on file objects as a (wanted) side effect
+function resolveFile(globFile, enc, cb) {
+  fs.lstat(globFile.path, function (err, stat) {
+    if (err) {
+      return cb(err);
+    }
+
+    globFile.stat = stat;
+
+    if (!stat.isSymbolicLink()) {
+      return cb(null, globFile);
+    }
+
+    fs.realpath(globFile.path, function (err, filePath) {
+      if (err) {
+        return cb(err);
+      }
+
+      globFile.base = path.dirname(filePath);
+      globFile.path = filePath;
+
+      // recurse to get real file stat
+      resolveFile(globFile, enc, cb);
+    });
+  });
+}
+
+module.exports = resolveSymlinks;

test/fixtures/test-symlink

@@ -0,0 +1 @@
+test.coffee

test/fixtures/test-symlink-dir

@@ -0,0 +1 @@
+wow

test/src.js

@@ -397,4 +397,24 @@ describe('source stream', function() {
     stream1.pipe(stream2).pipe(bufferStream);
   });
 
+  it('should follow file symlinks', function(done) {
+    var expectedPath = path.join(__dirname, './fixtures/test.coffee');
+
+    var stream = vfs.src('./fixtures/test-symlink', {cwd: __dirname});
+    stream.on('data', function(file){
+      file.path.should.equal(expectedPath);
+      done();
+    });
+  });
+
+  it('should follow dir symlinks', function(done) {
+    var expectedPath = path.join(__dirname, './fixtures/wow');
+
+    var stream = vfs.src('./fixtures/test-symlink-dir', {cwd: __dirname});
+    stream.on('data', function(file){
+      file.path.should.equal(expectedPath);
+      done();
+    });
+  });
+
 });