funky 0.2.16 → 0.2.17

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ca9e59faa72e0eb097bef057e1b91e548cdc013d
-  data.tar.gz: 24aa6cdd8306a6396205b844145dcd62b5027967
+  metadata.gz: da54bfb41c5753645c1a7c563b097bea1e95485a
+  data.tar.gz: 92fcb13e252a300a1d06b65bc776ae1b6edbd70e
 SHA512:
-  metadata.gz: b2426dcb4df32fa10e0615c889b9d1f642c331b68280c0d5cc89ad83860adff97c361a85fbfbbdc7ee4578e0c2d17d8aacdea7385575e1351efb5739ee7ea815
-  data.tar.gz: 7a0e74d6762a7bff04425b8a13c2dff867f54d58247ec848e7fa3e8dd97f504eb6dc1be61229e91bfd3dcfd5441eccdb92e4bd3826954c338fe3a6a21c540d5e
+  metadata.gz: f966f16d954f34554c4adbe39edae84683d259e9d59ea66e8c891d0747c00b4b77f4837716cefc7e04f4e7eded27d9bb7a2051b87180a43d4407e54ddaed14a3
+  data.tar.gz: 10e4b65adc153b6c884611ca281fe30e4a82bba35d3f9d8ceba9649549df8d813242e134b9db1f59203a2d8b190b175ecf8eab158eddfe2ad09c799b296c0081

data/CHANGELOG.md

@@ -6,6 +6,11 @@ For more information about changelogs, check
 [Keep a Changelog](http://keepachangelog.com) and
 [Vandamme](http://tech-angels.github.io/vandamme).
 
+## 0.2.17 - 2017/04/17
+
+* [FEATURE] Add `Funky::Page.find` class method to find a page by its page ID.
+* [FEATURE] Add `Funky::Page#videos` instance method to list all videos under a page fetched by API call.
+
 ## 0.2.16 - 2017/04/02
 
 * [ENHANCEMENT] Video.where(id: [..ids..]) now works even with more than 50 ids.

data/lib/funky/connections/api.rb

@@ -5,6 +5,21 @@ module Funky
   # @api private
   module Connection
     class API < Base
+      def self.fetch(path_query, is_array: false)
+        uri = URI "https://#{host}/v2.8/#{path_query}&limit=100&access_token=#{app_id}%7C#{app_secret}"
+        is_array ? fetch_multiple_pages(uri) : json_for(uri)
+      end
+
+      def self.fetch_multiple_pages(uri)
+        json = json_for(uri)
+        if json[:paging][:next]
+          next_paging_uri = URI json[:paging][:next]
+          json[:data] + fetch_multiple_pages(next_paging_uri)
+        else
+          json[:data]
+        end
+      end
+
       def self.request(id:, fields:)
         uri = URI::HTTPS.build host: host,
           path: "/v2.8/#{id}",

data/lib/funky/connections/base.rb

@@ -17,6 +17,15 @@ module Funky
       rescue SocketError => e
         raise ConnectionError, e.message
       end
+
+      def self.json_for(uri)
+        response = response_for(get_http_request(uri), uri)
+        if response.code == '200'
+          JSON.parse(response.body, symbolize_names: true)
+        else
+          raise ContentNotFound, "Error #{response.code}: #{response.body}"
+        end
+      end
     end
   end
 end

data/lib/funky/page.rb

@@ -1,6 +1,37 @@
 module Funky
   class Page < GraphRootNode
 
+    # Fetches the data from Facebook Graph API and returns a Funky::Page object.
+    # It accepts a page ID.
+    #
+    # @example Getting a page object
+    #   Funky::Page.find 'FullscreenInc' # or
+    #   Funky::Page.find '221406534569729'
+    #   # => #<Funky::Page @data={:name=>"Fullscreen", :id=>"221406534569729"}>
+    #
+    # @return [Funky::Page] containing the data fetched by Facebook Graph API.
+    def self.find(page_id)
+      page = Funky::Connection::API.fetch("#{page_id}?fields=name,username,location")
+      new(page)
+    end
+
+    # Fetches data from Facebook Graph API and returns an array of Funky::Video
+    # objects belong to the caller page.
+    #
+    # @example Getting videos under a page
+    #   page = Funky::Page.find 'FullscreenInc'
+    #   page.videos
+    #   # => [#<Funky::Video @data={...}>, #<Funky::Video @data={...}>]
+    #
+    # @return [Array<Funky::Video>] multiple Funky::Video objects containing data
+    #   fetched by Facebook Graph API.
+    def videos
+      videos = Funky::Connection::API.fetch(
+        "#{id}/videos?fields=id,title,description,created_time,length,comments.limit(0).summary(true),likes.limit(0).summary(true),reactions.limit(0).summary(true)",
+        is_array: true)
+      videos.map {|video| Video.new(video) }
+    end
+
     # @note
     #   For example, for www.facebook.com/platform the username is 'platform'.
     # @see https://developers.facebook.com/docs/graph-api/reference/page/

data/lib/funky/version.rb

@@ -1,3 +1,3 @@
 module Funky
-  VERSION = "0.2.16"
+  VERSION = "0.2.17"
 end

data/lib/funky/video.rb

@@ -26,6 +26,27 @@ module Funky
       data[:length]
     end
 
+    # @return [String] the title of the video.
+    def title
+      data[:title].to_s
+    end
+
+    # see https://developers.facebook.com/docs/graph-api/reference/video/
+    # @return [Integer] the total number of likes for the video.
+    def count_likes
+      data[:likes][:summary][:total_count]
+    end
+
+    # @return [Integer] the total number of comments for the video.
+    def count_comments
+      data[:comments][:summary][:total_count]
+    end
+
+    # @return [Integer] the total number of reactions for the video.
+    def count_reactions
+      data[:reactions][:summary][:total_count]
+    end
+
     # @return [String] the picture URL of the video.
     def picture
       data[:picture]

data/lib/funky.rb

@@ -1,7 +1,8 @@
 require 'date'
+require 'net/http'
+
 require "funky/version"
 require 'funky/errors'
-require 'net/http'
 require 'funky/connections/api'
 require 'funky/configuration'
 require "funky/graph_root_node"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: funky
 version: !ruby/object:Gem::Version
-  version: 0.2.16
+  version: 0.2.17
 platform: ruby
 authors:
 - Philip Nguyen
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-04-02 00:00:00.000000000 Z
+date: 2017-04-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler