fb-core 1.0.0.beta3 → 1.0.0.beta4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: be4280ee1403156598600751f314cd45cc5db0ac
-  data.tar.gz: f9a2b017df66583e09c77d50c8b976dcce8b34cc
+  metadata.gz: 2b9ebc24b6cab3ece4e96f94f96d71642650481b
+  data.tar.gz: '02519ca1e385d8e2ccffbfe362054403c19474ea'
 SHA512:
-  metadata.gz: d8ae8810c7687e7e1ff82a80ac49d430872aa6fcea0bbeb317dd27c12668ebdad4ba19ee0b92d621e433a12d703ed8b900a88bf9b06e7f56a1f9aace40b0f12d
-  data.tar.gz: 5b00b91a0c702fc6c3fd2d7fd391a13ccf2fa948740a655c2781b9ef7df857759c3749ebd3f00d6477e509b2002f844e45d6808d0b8a1c9d49bd875b9ce9e29a
+  metadata.gz: d0ebb9ad99986cc132c771a24372a398564765c5ea06c269ebf18780092ab31c7be2b815f7c9519325d74ce18f35d1fde87289d1decc3eef27a232bba6c9a1ba
+  data.tar.gz: fb888f906838ae8df5880442439d7bb48be88bd6de443632e4aff2cc445d9abee177711443a5a656a441b59f7f704cc0cb8bcf2fface332be59d6d71e27c7f7b

data/CHANGELOG.md

@@ -6,6 +6,10 @@ For more information about changelogs, check
 [Keep a Changelog](http://keepachangelog.com) and
 [Vandamme](http://tech-angels.github.io/vandamme).
 
+## 1.0.0.beta4  - 2018/03/27
+
+* [FEATURE] Add `Fb::Page#insights_with_date_range` and `Fb::Page#posts_with_time_range`.
+
 ## 1.0.0.beta3  - 2018/03/14
 
 * [FEATURE] Add `video_avg_time_watched` to `Fb::Post` for length of average time watched.

data/README.md

@@ -147,7 +147,7 @@ metric, period, and options (since & until). Refer to
 for a list of available metrics and periods.
 
 **Ensure that the period that you are using is supported by the metric**.
-For example, `page_views_total` (page views) is available for `week`, `week`, and `days_28`
+For example, `page_views_total` (page views) is available for `day`, `week`, and `days_28`
 whereas `page_fans` (page likes) is only available as `lifetime`.
 
 `metric_insights` returns a hash of Dates mapped to values. Passing `since` only return dates ahead

data/fb-core.gemspec

@@ -24,10 +24,10 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
-  spec.add_dependency 'fb-support', '~> 1.0.0.alpha1'
+  spec.add_dependency 'fb-support', '~> 1.0.0.alpha4'
   spec.add_development_dependency 'bundler', '~> 1.15'
   spec.add_development_dependency 'rake', '~> 10.0'
   spec.add_development_dependency 'rspec', '~> 3.0'
-  spec.add_development_dependency 'yard', '~> 0.9.9'
+  spec.add_development_dependency 'yard', '~> 0.9.12'
   spec.add_development_dependency 'coveralls'
 end

data/lib/fb/core/version.rb

@@ -3,6 +3,6 @@ module Fb
   class Core
     # @return [String] the SemVer-compatible gem version.
     # @see http://semver.org
-    VERSION = '1.0.0.beta3'
+    VERSION = '1.0.0.beta4'
   end
 end

data/lib/fb/page.rb

@@ -23,7 +23,7 @@ module Fb
       @access_token = options[:access_token]
     end
 
-    # @return [Hash<Date, Integer>]  a hash of Dates mapped to their values.
+    # @return [Hash<Date, Integer>] a hash of Dates mapped to their values.
     # @param [String] :metric the metric to fetch.
     # @param [<String, Symbol>] :period the aggregate period (day, week, days_28).
     # @option [Date] :since only return dates ahead to this date (lower bound).
@@ -42,8 +42,24 @@ module Fb
     def weekly_insights(metrics, options = {})
       since_date = options.fetch :until, Date.today - 1
       params = {period: :week, since: since_date, until: since_date + 2}
-      metrics = page_insights Array(metrics), params
-      metrics.map {|m| [m['name'].to_sym, m['values'].last.fetch('value', 0)]}.to_h
+      insights = page_insights Array(metrics), params
+      insights.map {|m| [m['name'].to_sym, m['values'].last.fetch('value', 0)]}.to_h
+    end
+
+    # @return [Hash] a hash of metrics mapped to their values.
+    # @param [Array<String, Symbol>] :metrics the metrics to fetch.
+    # @option [Time] :since sum the date period after this date.
+    # @option [Time] :until sum the period before this date.
+    def insights_with_date_range(metrics, options = {})
+      date_params = {since: options[:since].to_date - 1, until: options.fetch(:until, Date.today).to_date + 1}
+      params = {period: :day}.merge date_params
+      insights = page_insights Array(metrics), params
+      insights.map do |m|
+        [
+          m['name'].to_sym,
+          m['values'].sum {|value| value.fetch('value', 0)}
+        ]
+      end.to_h
     end
 
     # @return [Integer] the number of views of the page.
@@ -77,6 +93,17 @@ module Fb
       end
     end
 
+    # @return [Array<Fb::Post>] the posts published on the page.
+    # @option [Time] :since only return posts ahead of this time.
+    # @option [Time] :until only return posts previous to this time.
+    # @option [Boolean] :with_metrics whether to include insights for the posts.
+    def posts_with_time_range(options = {})
+      time_params = {since: options[:since], until: options[:until]}
+      request = PaginatedRequest.new path: "/v2.9/#{@id}/posts", params: posts_params.merge(time_params)
+      data = request.run.body['data']
+      options[:with_metrics] ? posts_with_metrics_from(data) : posts_from(data)
+    end
+
     # @return [Array<Fb::Video>] the uploaded videos for the page.
     def videos
       @videos ||= begin

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fb-core
 version: !ruby/object:Gem::Version
-  version: 1.0.0.beta3
+  version: 1.0.0.beta4
 platform: ruby
 authors:
 - Claudio Baccigalupo
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2018-03-14 00:00:00.000000000 Z
+date: 2018-03-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: fb-support
@@ -17,14 +17,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.0.0.alpha1
+        version: 1.0.0.alpha4
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.0.0.alpha1
+        version: 1.0.0.alpha4
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -73,14 +73,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.9.9
+        version: 0.9.12
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.9.9
+        version: 0.9.12
 - !ruby/object:Gem::Dependency
   name: coveralls
   requirement: !ruby/object:Gem::Requirement