Allow a person to be fetched with Person#find

src/person.js

+'use strict';
+
+var assert = require('assert');
+var _      = require('lodash');
+
+module.exports = function (client) {
+  function Person (data) {
+    _.extend(this, data);
+  }
+
+  Person.find = function (options) {
+    assert(options && options.email, 'An email must be provided');
+    return this.client.request(_.extend({
+      api: 'person',
+      path: '/people/email/' + options.email,
+      query: _.pick(options, 'subscribe', 'company')
+    }, options))
+    .bind(this)
+    .then(function (data) {
+      return new this(data);
+    });
+  };
+
+  Person.prototype.client = Person.client = client;
+
+  return Person;
+};
\ No newline at end of file

test/fixtures/person.json

+{
+  "id": "d54c54ad-40be-4305-8a34-0ab44710b90d",
+  "name": {
+    "fullName": "Alex MacCaw",
+    "givenName": "Alex",
+    "familyName": "MacCaw"
+  },
+  "email": "alex@alexmaccaw.com",
+  "gender": "male",
+  "location": "San Francisco",
+  "bio": "O'Reilly author, software engineer & traveller. Founder of https://clearbit.co",
+  "site": "http://alexmaccaw.com",
+  "avatar": "https://pbs.twimg.com/profile_images/1826201101/297606_10150904890650705_570400704_21211347_1883468370_n.jpeg",
+  "employment": {
+    "name": "Clearbit",
+    "title": "CEO",
+    "domain": "clearbit.co"
+  },
+  "facebook": {
+    "handle": "amaccaw"
+  },
+  "github": {
+    "handle": "maccman",
+    "avatar": "http://www.gravatar.com/avatar/baf018e2cc4616e4776d323215c7136c",
+    "company": "Freelance",
+    "blog": "http://alexmaccaw.com",
+    "followers": 2880,
+    "following": 94
+  },
+  "twitter": {
+    "handle": "maccaw",
+    "id": 2006261,
+    "bio": "O'Reilly author, software engineer & traveller. Founder of https://clearbit.co",
+    "followers": 14993,
+    "following": 1645,
+    "location": "San Francisco",
+    "site": "http://alexmaccaw.com",
+    "avatar": "https://pbs.twimg.com/profile_images/1826201101/297606_10150904890650705_570400704_21211347_1883468370_n.jpeg"
+  },
+  "linkedin": {
+    "handle": "pub/alex-maccaw/78/929/ab5"
+  },
+  "googleplus": {
+    "handle": null
+  },
+  "angellist": {
+    "handle": null,
+    "bio": null,
+    "blog": null,
+    "site": null,
+    "followers": null,
+    "avatar": null
+  },
+  "aboutme": {
+    "handle": "maccaw",
+    "bio": "Software engineer & traveller. Walker, skier, reader, tennis player, breather, ginger beer drinker, scooterer & generally enjoying things :)",
+    "avatar": "http://o.aolcdn.com/dims-global/dims/ABOUTME/5/803/408/80/http://d3mod6n032mdiz.cloudfront.net/thumb2/m/a/c/maccaw/maccaw-840x560.jpg"
+  },
+  "gravatar": {
+    "handle": "maccman",
+    "urls": [
+
+    ],
+    "avatar": "http://2.gravatar.com/avatar/994909da96d3afaf4daaf54973914b64",
+    "avatars": [
+      {
+        "url": "http://2.gravatar.com/avatar/994909da96d3afaf4daaf54973914b64",
+        "type": "thumbnail"
+      }
+    ]
+  }
+}
\ No newline at end of file

test/person.js

+'use strict';
+
+var expect = require('chai').expect;
+var nock   = require('nock');
+var Client = require('../src/client');
+
+describe('Person', function () {
+
+  var client = new Client({key: 'k'});
+  var Person = require('../src/person')(client);
+
+  var mock;
+  before(function () {
+    mock = nock('https://person.clearbit.co');
+  });
+  after(nock.cleanAll);
+  afterEach(function () {
+    mock.done();
+  });
+
+  describe('Person#find', function () {
+
+    it('can find a person by email', function () {
+      var alex = require('./fixtures/person');
+      mock
+        .get('/v1/people/email/alex@alexmaccaw.com')
+        .reply(200, alex);
+      return Person.find({email: 'alex@alexmaccaw.com'})
+        .then(function (person) {
+          expect(person)
+            .to.be.an.instanceOf(Person)
+            .and.have.property('id', alex.id);
+        });
+    });
+
+  });
+
+});
\ No newline at end of file