net 0.2.3 → 0.3.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: d8a3c1afcfb291edd890db93ce4f1191cd99882e
-  data.tar.gz: a99341b7f15fd8548eec7a19839e8ce6ee5f5297
+  metadata.gz: f2cebbc60522f17c0dcbe932441712682b262dec
+  data.tar.gz: ed85fb15cbd70c14983bf52012d38cd763297756
 SHA512:
-  metadata.gz: 0c10bba9639036f46e272cc250b30c7f930aff01925b3bbbca43ed38cc30314c4c753da085383a8d9bb1a3ab174a9969c776392a0412ae2f005742b8be25e522
-  data.tar.gz: b4d18255d9a2e48f48f180e129064e2aa74a89ab490e1fe3015fe595f9577aff0bc91dced2ce5cdfc8605b51e0c0983c4346632f7cff3e02895197601fec4b43
+  metadata.gz: 25d08b443a193ce046fd97ae8442e24a8c0807b0e28318b44e976a948dea6ea382d68a8afd7ecd37e9d5fca1c30c552892770e3b235c024c4d8be6b7dd978be6
+  data.tar.gz: c2cba985e441c8c27b8a9766809b7a65da5e6ce717e6a4c912840d0a00a5eb36a0f9456d841e770c58702752305773bafc05eec62f8e89cffbeaa913f73f623e

data/.ruby-version

@@ -0,0 +1 @@
+2.2.2

data/CHANGELOG.md

@@ -34,3 +34,8 @@ If it does, then replace your calls to `followers_count` with `follower_count` (
 ## 0.2.3 - 2015-08-12
 
 * [FEATURE] Add `find_by id: [Integer] and find_by! id: [Integer] to Instagram::User`.
+
+## 0.3.3 - 2015-09-02
+
+* [FEATURE] - Add `Facebook::User` supporting `find_by` and `find_by!`
+            - Add `pages` method for `Facebook::User` to return list of Facebook Pages

data/README.md

@@ -97,6 +97,25 @@ page = Net::Facebook::Page.find_by username: 'fullscreeninc'
 page.likes #=> 7025
 ```
 
+Net::Facebook::User
+--------------------
+
+Use [Net::Facebook::User]() to:
+
+* retrieve a Facebook user by username
+
+```ruby
+user = Net::Facebook::User.find_by username: '10100829454613149'
+user.first_name #=> Jeremy
+```
+
+* Include a Facebook access_token parameter in order to access pages information for a certain user
+
+```ruby
+user = Net::Facebook::User.find_by username: '10100829454613149', access_token: 'abc123'
+user.pages #=> [{"name"=>"Jeremy Video Game", "id"=>"1627249647512991"}, {"name"=>"Influencer Plus", "id"=>"629655227132365"}]
+```
+
 *The methods above require a configured Facebook app (see below).*
 
 Configuring your Twitter app

data/lib/net/facebook/api/request.rb

@@ -8,12 +8,14 @@ module Net
       class Request
         def initialize(attrs = {})
           @host = 'graph.facebook.com'
-          @query = attrs[:params] if attrs[:params]
+          @query = attrs[:username] if attrs[:username]
+          @access_token = attrs[:access_token] if attrs[:access_token]
           @path = attrs.fetch :path, "/v2.3/#{@query}"
           @method = attrs.fetch :method, :get
         end
 
         def run
+          #print "#{as_curl}\n"
           case response = run_http_request
           when Net::HTTPOK
             JSON.parse(response.body)
@@ -35,12 +37,16 @@ module Net
         end
 
         def uri
-          @uri ||= URI::HTTPS.build host: @host, path: @path, query: query
+          @uri ||= URI::HTTPS.build host: @host, path: @path, query: access_token
         end
 
-        def query
-          {}.tap do |query|
-            query.merge! access_token: "#{Net::Facebook.configuration.client_id}|#{Net::Facebook.configuration.client_secret}"
+        def access_token
+          @access_token ? { access_token: @access_token }.to_param : fb_app_key_params
+        end
+
+        def fb_app_key_params
+          {}.tap do |keys|
+            keys.merge! access_token: "#{Net::Facebook.configuration.client_id}|#{Net::Facebook.configuration.client_secret}"
           end.to_param
         end
 

data/lib/net/facebook/models.rb

@@ -1 +1,2 @@
 require 'net/facebook/models/page'
+require 'net/facebook/models/user'

data/lib/net/facebook/models/page.rb

@@ -36,13 +36,7 @@ module Net
         #   (case-insensitive).
         # @raise [Net::Errors::UnknownUser] if the page cannot be found.
         def self.find_by!(params = {})
-          find_by_username! params[:username]
-        end
-
-      private
-
-        def self.find_by_username!(username)
-          request = Api::Request.new params: username
+          request = Api::Request.new params
           new request.run
         rescue Errors::ResponseError => error
           case error.response

data/lib/net/facebook/models/user.rb

@@ -0,0 +1,66 @@
+require 'net/facebook/api/request'
+require 'net/facebook/errors'
+
+module Net
+  module Facebook
+    module Models
+      class User
+        attr_reader :id, :email, :gender, :first_name, :last_name, :access_token
+
+        def initialize(attrs = {})
+          @id = attrs['id']
+          @email = attrs['email']
+          @gender = attrs['gender']
+          @first_name = attrs['first_name']
+          @last_name = attrs['last_name']
+          @access_token = attrs['access_token']
+        end
+
+        def pages
+          request = Api::Request.new access_token: @access_token, path: "/v2.3/#{@id}/accounts"
+          page_json = request.run
+          page_json['data'].map { |h| h.slice("name", "id") } if page_json['data'].any?
+        end
+
+        # Returns the existing Facebook user matching the provided attributes or
+        # nil when the user is not found.
+        #
+        # @return [Net::Facebook::Models::User] the Facebook user.
+        # @ return [nil] when the user cannot be found.
+        # @param [Hash] params the attributes to find a user by.
+        # @option params [String] :username The Facebook user's username
+        #   (case-insensitive).
+        # @option params [String] :access_token The Facebook user's access_token
+        #   (case-insensitive).
+        def self.find_by(params = {})
+          find_by! params
+        rescue Errors::UnknownUser
+          nil
+        end
+
+        # Returns the existing Facebook user matching the provided attributes or
+        # raises an error when the user is not found.
+        #
+        # @return [Net::Facebook::Models::User] the Facebook user.
+        # @param [Hash] params the attributes to find a user by.
+        # @option params [String] :username The Facebook user's username
+        #   (case-insensitive).
+        # @option params [String] :access_token The Facebook user's access_token
+        #   (case-insensitive).
+        # @raise [Net::Errors::UnknownUser] if the user cannot be found.
+        def self.find_by!(params = {})
+          request = Api::Request.new params
+          if params[:access_token]
+            new request.run.merge!({"access_token" => params[:access_token]})
+          else
+            new request.run
+          end
+        rescue Errors::ResponseError => error
+          case error.response
+            when Net::HTTPNotFound then raise Errors::UnknownUser
+          end
+        end
+      end
+    end
+  end
+end

data/lib/net/instagram/api/request.rb

@@ -15,6 +15,7 @@ module Net
         end
 
         def run
+          #print "#{as_curl}\n"
           case response = run_http_request
           when Net::HTTPOK
             JSON(response.body)['data']

data/lib/net/twitter/api/request.rb

@@ -15,7 +15,7 @@ module Net
         end
 
         def run
-          print "#{as_curl}\n"
+          #print "#{as_curl}\n"
 
           case response = run_http_request
           when Net::HTTPOK

data/lib/net/version.rb

@@ -1,3 +1,3 @@
 module Net
-  VERSION = "0.2.3"
+  VERSION = "0.3.3"
 end

data/spec/net/facebook/models/users_spec.rb

@@ -0,0 +1,44 @@
+require 'spec_helper'
+
+describe Net::Facebook::User do
+  let(:unknown_username) { 'qeqwe09qlkmhkjh' }
+  let(:existing_username) { '1453280268327112' }
+
+  describe '.find_by' do
+    subject(:user) { Net::Facebook::User.find_by username: username }
+
+    context 'given an existing (case-insensitive) username' do
+      let (:username) { existing_username }
+
+      it 'returns an object representing the user' do
+        expect(user.first_name).to eq 'Jeremy'
+        expect(user.last_name).to eq 'Dev'
+        expect(user.gender).to eq 'male'
+      end
+    end
+
+    context 'given an unknown username' do
+      let(:username) { unknown_username }
+      it { expect(user).to be_nil }
+    end
+  end
+
+  describe '.find_by!' do
+    subject(:user) { Net::Facebook::User.find_by! username: username }
+
+    context 'given an existing (case-insensitive) username' do
+      let(:username) { existing_username }
+
+      it 'returns an object representing the user' do
+        expect(user.first_name).to eq 'Jeremy'
+        expect(user.last_name).to eq 'Dev'
+        expect(user.gender).to eq 'male'
+      end
+    end
+
+    context 'given an unknown username' do
+      let(:username) { unknown_username }
+      it { expect{user}.to raise_error Net::Facebook::UnknownUser }
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: net
 version: !ruby/object:Gem::Version
-  version: 0.2.3
+  version: 0.3.3
 platform: ruby
 authors:
 - Jeremy Cohen Hoffing
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-08-13 00:00:00.000000000 Z
+date: 2015-09-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -133,6 +133,7 @@ extra_rdoc_files: []
 files:
 - ".gitignore"
 - ".rspec"
+- ".ruby-version"
 - CHANGELOG.md
 - Gemfile
 - MIT-LICENSE
@@ -148,6 +149,7 @@ files:
 - lib/net/facebook/errors/unknown_user.rb
 - lib/net/facebook/models.rb
 - lib/net/facebook/models/page.rb
+- lib/net/facebook/models/user.rb
 - lib/net/instagram.rb
 - lib/net/instagram/api/configuration.rb
 - lib/net/instagram/api/request.rb
@@ -172,6 +174,7 @@ files:
 - lib/net/version.rb
 - net.gemspec
 - spec/net/facebook/models/pages_spec.rb
+- spec/net/facebook/models/users_spec.rb
 - spec/net/instagram/models/user_spec.rb
 - spec/net/twitter/models/user_spec.rb
 - spec/spec_helper.rb
@@ -218,6 +221,7 @@ specification_version: 4
 summary: An API Client for social networks
 test_files:
 - spec/net/facebook/models/pages_spec.rb
+- spec/net/facebook/models/users_spec.rb
 - spec/net/instagram/models/user_spec.rb
 - spec/net/twitter/models/user_spec.rb
 - spec/spec_helper.rb