net 0.2.1 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 94f5c2590964e1f1ab8a22cb873744d0e89aa89d
-  data.tar.gz: b466aa24c5a794d03d23e04a5ebb52c9940d7f4c
+  metadata.gz: ef9c01ac982b2c9fbec6e80f15cea501d3064d64
+  data.tar.gz: 7be28d7fc0c74b4e93116e5d1e190c240f138f29
 SHA512:
-  metadata.gz: 62bf9f26740bba555471c6764fb169609ab1ede908bab4b91d9bd7d4a2a2b708177f0dc841942d38d322e2690926e5575027df4bd5707ca31aa25e3dfba222c2
-  data.tar.gz: cc36f803012a6d46d62153745e947a4158348abd0945c74c1be585e9d7d5c84ee0d70e0f654930122bff86d2b7c0aeee6994a3f85f1b62fed7cee199d51cfd96
+  metadata.gz: e24a7eeac08430f4c8ae2362ecfbffd5901b70e8b956e102f712cae4662d310ac76d3ea59796b499c6c7fc2a7c62beb0cb18f9ecabf0700afd3419576a88bc92
+  data.tar.gz: 6d218d97f9d5f6bdb6716f829c2532cd876d5aa5bb43bbbf7e3609b2064f05cefcd8f79c03491ae40b66f76f662f85c1112a13673e415f9e6c54b8c6ee1fb72a

data/CHANGELOG.md

@@ -26,3 +26,7 @@ If it does, then replace your calls to `followers_count` with `follower_count` (
 ## 0.2.1 - 2014-10-20
 
 * [ENHANCEMENT] Requiring 'net' auto-loads Net::Twitter and Net::Instagram
+
+## 0.2.2 - 2015-08-04
+
+* [FEATURE] Add `Facebook::Page` supporting `find_by` and `find_by!`.

data/README.md

@@ -1,7 +1,7 @@
 Net - a Ruby client for social networks API
 ===========================================
 
-Net helps you write apps that need to interact with Twitter and Instagram.
+Net helps you write apps that need to interact with Twitter, Instagram and Facebook.
 
 
 After [configuring your Twitter app](#configuring-your-twitter-app), you can run commands like:
@@ -19,6 +19,14 @@ user.username #=> "fullscreen_inc"
 user.follower_count #=> 7025
 ```
 
+After [configuring your Facebook app](#configuring-your-facebook-app), you can run commands like:
+
+```ruby
+page = Net::Facebook::Page.find_by username: 'fullscreeninc'
+page.username #=> "fullscreeninc"
+page.likes #=> 30094
+```
+
 How to install
 ==============
 
@@ -28,7 +36,7 @@ To install on your system, run
 
 To use inside a bundled Ruby project, add this line to the Gemfile:
 
-    gem 'net', '~> 0.1.1'
+    gem 'net', '~> 0.2.1'
 
 Since the gem follows [Semantic Versioning](http://semver.org),
 indicating the full version in your Gemfile (~> *major*.*minor*.*patch*)
@@ -73,6 +81,21 @@ user.follower_count #=> 7025
 
 *The methods above require a configured Instagram app (see below).*
 
+Net::Facebook::Page
+--------------------
+
+Use [Net::Facebook::Page]() to:
+
+* retrieve a Facebook page by username
+* access the number of likes of a Facebook user
+
+```ruby
+page = Net::Facebook::Page.find_by username: 'fullscreeninc'
+page.likes #=> 7025
+```
+
+*The methods above require a configured Facebook app (see below).*
+
 Configuring your Twitter app
 ============================
 
@@ -147,6 +170,45 @@ end
 so use the approach that you prefer.
 If a variable is set in both places, then `Net::Instagram.configure` takes precedence.
 
+Configuring your Facebook app
+============================
+
+In order to use Net you must create an app in the [Facebook Application Manager](https://developers.facebook.com/apps/).
+
+Once the app is created, copy the API key and secret and add them to your
+code with the following snippet of code (replacing with your own key and secret)
+:
+
+```ruby
+Net::Facebook.configure do |config|
+  config.client_id = 'abcdefg'
+  config.client_secret = 'abcdefg'
+end
+```
+
+Configuring with environment variables
+--------------------------------------
+
+As an alternative to the approach above, you can configure your app with
+variables. Setting the following environment variables:
+
+```bash
+export FACEBOOK_CLIENT_ID='abcd'
+export FACEBOOK_CLIENT_SECRET='efgh'
+```
+
+is equivalent to configuring your app with the initializer:
+
+```ruby
+Net::Facebook.configure do |config|
+  config.client_id = 'abcd'
+  config.client_secret = 'efgh'
+end
+```
+
+so use the approach that you prefer.
+If a variable is set in both places, then `Net::Facebook.configure` takes precedence.
+
 How to test
 ===========
 

data/lib/net.rb

@@ -1,6 +1,7 @@
 require "net/version"
 require "net/twitter"
 require "net/instagram"
+require "net/facebook"
 
 module Net
 end

data/lib/net/facebook.rb

@@ -0,0 +1,11 @@
+require 'net/facebook/config'
+require 'net/facebook/models'
+require 'net/facebook/errors'
+
+module Net
+  module Facebook
+    extend Config
+    include Errors
+    include Models
+  end
+end

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

@@ -0,0 +1,14 @@
+module Net
+  module Facebook
+    module Api
+      class Configuration
+        attr_accessor :client_id, :client_secret
+
+        def initialize
+          @client_id = ENV['FACEBOOK_CLIENT_ID']
+          @client_secret = ENV['FACEBOOK_CLIENT_SECRET']
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,60 @@
+require 'net/facebook/errors/response_error'
+require 'active_support'
+require 'active_support/core_ext'
+
+module Net
+  module Facebook
+    module Api
+      class Request
+        def initialize(attrs = {})
+          @host = 'graph.facebook.com'
+          @query = attrs[:params] if attrs[:params]
+          @path = attrs.fetch :path, "/v2.3/#{@query}"
+          @method = attrs.fetch :method, :get
+        end
+
+        def run
+          case response = run_http_request
+          when Net::HTTPOK
+            JSON.parse(response.body)
+          else
+            raise Errors::ResponseError, response
+          end
+        end
+
+      private
+        def run_http_request
+          Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
+            http.request http_request
+          end
+        end
+
+        def http_request
+          http_class = "Net::HTTP::#{@method.capitalize}".constantize
+          @http_request ||= http_class.new(uri.request_uri)
+        end
+
+        def uri
+          @uri ||= URI::HTTPS.build host: @host, path: @path, query: query
+        end
+
+        def query
+          {}.tap do |query|
+            query.merge! access_token: "#{Net::Facebook.configuration.client_id}|#{Net::Facebook.configuration.client_secret}"
+          end.to_param
+        end
+
+        def as_curl
+          'curl'.tap do |curl|
+            curl <<  " -X #{http_request.method}"
+            http_request.each_header do |name, value|
+              curl << %Q{ -H "#{name}: #{value}"}
+            end
+            curl << %Q{ -d '#{http_request.body}'} if http_request.body
+            curl << %Q{ "#{@uri.to_s}"}
+          end
+        end
+      end
+    end
+  end
+end

data/lib/net/facebook/config.rb

@@ -0,0 +1,16 @@
+require 'net/facebook/api/configuration'
+
+module Net
+  module Facebook
+    module Config
+      def configure
+        yield configuration if block_given?
+      end
+
+      def configuration
+        @configuration ||= Api::Configuration.new
+      end
+    end
+  end
+end
+

data/lib/net/facebook/errors.rb

@@ -0,0 +1,2 @@
+require 'net/facebook/errors/response_error'
+require 'net/facebook/errors/unknown_user'

data/lib/net/facebook/errors/response_error.rb

@@ -0,0 +1,14 @@
+module Net
+  module Facebook
+    module Errors
+      class ResponseError < StandardError
+        attr_reader :response
+
+        def initialize(response = {})
+          @response = response
+          super response
+        end
+      end
+    end
+  end
+end

data/lib/net/facebook/errors/unknown_user.rb

@@ -0,0 +1,11 @@
+module Net
+  module Facebook
+    module Errors
+      class UnknownUser < StandardError
+        def message
+          'Unknown user'
+        end
+      end
+    end
+  end
+end

data/lib/net/facebook/models.rb

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

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

@@ -0,0 +1,55 @@
+require 'net/facebook/api/request'
+require 'net/facebook/errors'
+
+module Net
+  module Facebook
+    module Models
+      class Page
+        attr_reader :username, :likes
+
+        def initialize(attrs = {})
+          @username = attrs['username']
+          @likes = attrs['likes']
+        end
+
+
+        # Returns the existing Facebook page matching the provided attributes or
+        # nil when the page is not found.
+        #
+        # @return [Net::Facebook::Models::Page] the Facebook page.
+        # @ return [nil] when the page cannot be found.
+        # @param [Hash] params the attributes to find a page by.
+        # @option params [String] :username The Facebook page’s username
+        #   (case-insensitive).
+        def self.find_by(params = {})
+          find_by! params
+        rescue Errors::UnknownUser
+          nil
+        end
+
+        # Returns the existing Facebook page matching the provided attributes or
+        # raises an error when the page is not found.
+        #
+        # @return [Net::Facebook::Models::Page] the Facebook page.
+        # @param [Hash] params the attributes to find a page by.
+        # @option params [String] :username The Facebook page’s username
+        #   (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
+          new request.run
+        rescue Errors::ResponseError => error
+          case error.response
+            when Net::HTTPNotFound then raise Errors::UnknownUser
+          end
+        end
+      end
+    end
+  end
+end

data/lib/net/version.rb

@@ -1,3 +1,3 @@
 module Net
-  VERSION = "0.2.1"
+  VERSION = "0.2.2"
 end

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

@@ -0,0 +1,42 @@
+require 'spec_helper'
+
+describe Net::Facebook::Page do
+  let(:unknown_username) { 'qeqwe09qlkmhkjh' }
+  let(:existing_username) { 'Fullscreeninc' }
+
+  describe '.find_by' do
+    subject(:page) { Net::Facebook::Page.find_by username: username }
+
+    context 'given an existing (case-insensitive) username' do
+      let (:username) { existing_username }
+
+      it 'returns an object representing the page for that user' do
+        expect(page.username).to eq 'fullscreeninc'
+        expect(page.likes).to be_an Integer
+      end
+    end
+
+    context 'given an unknown username' do
+      let(:username) { unknown_username }
+      it { expect(page).to be_nil }
+    end
+  end
+
+  describe '.find_by!' do
+    subject(:page) { Net::Facebook::Page.find_by! username: username }
+
+    context 'given an existing (case-insensitive) username' do
+      let(:username) { existing_username }
+
+      it 'returns an object representing the page for that user' do
+        expect(page.username).to eq 'fullscreeninc'
+        expect(page.likes).to be_an Integer
+      end
+    end
+
+    context 'given an unknown username' do
+      let(:username) { unknown_username }
+      it { expect{page}.to raise_error Net::Facebook::UnknownUser }
+    end
+  end
+end

data/spec/support/vcr.rb

@@ -20,4 +20,5 @@ VCR.configure do |c|
       interaction.response.headers['X-Rate-Limit-Reset'].first
     end
   end
+  c.ignore_hosts 'graph.facebook.com'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: net
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.2
 platform: ruby
 authors:
 - Jeremy Cohen Hoffing
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-10-20 00:00:00.000000000 Z
+date: 2015-08-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -139,6 +139,15 @@ files:
 - README.md
 - Rakefile
 - lib/net.rb
+- lib/net/facebook.rb
+- lib/net/facebook/api/configuration.rb
+- lib/net/facebook/api/request.rb
+- lib/net/facebook/config.rb
+- lib/net/facebook/errors.rb
+- lib/net/facebook/errors/response_error.rb
+- lib/net/facebook/errors/unknown_user.rb
+- lib/net/facebook/models.rb
+- lib/net/facebook/models/page.rb
 - lib/net/instagram.rb
 - lib/net/instagram/api/configuration.rb
 - lib/net/instagram/api/request.rb
@@ -162,6 +171,7 @@ files:
 - lib/net/twitter/models/user.rb
 - lib/net/version.rb
 - net.gemspec
+- spec/net/facebook/models/pages_spec.rb
 - spec/net/instagram/models/user_spec.rb
 - spec/net/twitter/models/user_spec.rb
 - spec/spec_helper.rb
@@ -207,6 +217,7 @@ signing_key:
 specification_version: 4
 summary: An API Client for social networks
 test_files:
+- spec/net/facebook/models/pages_spec.rb
 - spec/net/instagram/models/user_spec.rb
 - spec/net/twitter/models/user_spec.rb
 - spec/spec_helper.rb