datarank 1.3.0 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ab1f0abb9f249d20f50fad6be8f4c2cb7ec60d39
-  data.tar.gz: 4a7a8cfef904a0c662db134946bc5804403fdaa8
+  metadata.gz: 33bf78620e65947c753e631edfa8a8a29f47b31c
+  data.tar.gz: 191b602cf612213a474815fd20012746bce61d23
 SHA512:
-  metadata.gz: 9248245439cc0e1a246a9d2fb084f5ad32913730dc6a3cda7a64596e237adc7ae61f807ce0bc9d69abe1d1cc6e555a166229f4965b51416df915626b1c4b6839
-  data.tar.gz: 0eebfc8ad51d9b6d2d16c5d77b942eccfeb57e01e33c42122627f18d451c5ce5ccf86d64cb1f36c4d2203b08d2081d3d648f0e0191d40130061298f1aa6fa2fb
+  metadata.gz: 57d914a37c6d2f8c6c2be4b9fa105f4991c66af53935ce8f4e491993c725cb337fad04dc938916aad5ac9bbd163347d460f56a9f62eb2ed60e9c994b7aff76c4
+  data.tar.gz: 972a41dd93cf315e5927cfbab511c1097f2134fee5dc913c7c205192669150483297d5bb76799b13b560340ae6714c9162b9ea79133205f58fb88e4e3fea6580

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    datarank (1.2.0)
+    datarank (1.3.0)
       hashie (>= 1.2.0)
       httparty (>= 0.8.3)
       json (>= 1.8.2)
@@ -39,12 +39,12 @@ GEM
     guard-yard (2.1.4)
       guard (>= 1.1.0)
       yard (>= 0.7.0)
-    hashie (3.4.0)
+    hashie (3.4.2)
     hitimes (1.2.2)
-    httparty (0.13.3)
+    httparty (0.13.5)
       json (~> 1.8)
       multi_xml (>= 0.5.2)
-    json (1.8.2)
+    json (1.8.3)
     listen (2.9.0)
       celluloid (>= 0.15.2)
       rb-fsevent (>= 0.9.3)
@@ -112,3 +112,6 @@ DEPENDENCIES
   vcr (~> 2.9.0)
   webmock (>= 1.18.0)
   yard
+
+BUNDLED WITH
+   1.10.5

data/datarank.gemspec

@@ -6,7 +6,7 @@ require 'datarank/version'
 Gem::Specification.new do |gem|
   gem.name          = "datarank"
   gem.version       = Datarank::Version.to_s
-  gem.authors       = ["Addam Hardy"]
+  gem.authors       = ["Addam Hardy","Evan Sitzes"]
   gem.email         = ["addam@datarank.com"]
   gem.description   = "Ruby Wrapper for the DataRank REST API"
   gem.summary       = [""]
@@ -23,4 +23,4 @@ Gem::Specification.new do |gem|
   gem.add_dependency "multi_json", ">= 1.3.4"
   gem.add_dependency "hashie", ">= 1.2.0"
   gem.add_dependency "json", ">= 1.8.2"
-end
+end

data/lib/datarank/client.rb

@@ -7,6 +7,8 @@ require 'securerandom'
 require "datarank/comments"
 require "datarank/datasources"
 require "datarank/fizzle"
+require "datarank/interaction"
+require "datarank/likes"
 require "datarank/live"
 require "datarank/locations"
 require "datarank/reach"
@@ -17,6 +19,8 @@ require "datarank/topics"
 require "datarank/volume"
 require "datarank/wordcloud"
 require "datarank/search"
+require "datarank/social_stats"
+
 
 module Datarank
   class Client
@@ -26,6 +30,8 @@ module Datarank
     include Datarank::Client::Comments
     include Datarank::Client::Datasources
     include Datarank::Client::Fizzle
+    include Datarank::Client::Interaction
+    include Datarank::Client::Likes
     include Datarank::Client::Live
     include Datarank::Client::Locations
     include Datarank::Client::Reach
@@ -35,6 +41,8 @@ module Datarank
     include Datarank::Client::Volume
     include Datarank::Client::Wordcloud
     include Datarank::Client::Search
+    include Datarank::Client::SocialStats
+
 
 
     BASE_URI = 'https://api.datarank.com'

data/lib/datarank/comments.rb

@@ -13,6 +13,13 @@ module Datarank
         get "/topics/#{slug}/comments", options
       end
 
+      # Query interface for top 20 comments correlated to a topic by datarank score
+      #
+      # @param slug [String] A topic's unique identifier slug
+      def comments_top(slug, options={})
+        get "/topics/#{slug}/comments/top", options
+      end
+
     end
 
   end

data/lib/datarank/interaction.rb

@@ -0,0 +1,45 @@
+module Datarank
+  class Client
+
+    # Module containing methods for interacting with a topic's interaction data
+    module Interaction
+      
+      # Fetch interaction for a topic grouped by a time interval
+      #
+      # @param slug [String] A topic's unique identifier slug
+      def interaction_secondly(slug, options={})
+        get "/topics/#{slug}/interaction/secondly", options
+      end
+
+      def interaction_minutely(slug, options={})
+        get "/topics/#{slug}/interaction/minutely", options
+      end
+
+      def interaction_hourly(slug, options={})
+        get "/topics/#{slug}/interaction/hourly", options
+      end
+
+      def interaction_daily(slug, options={})
+        get "/topics/#{slug}/interaction/daily", options
+      end
+
+      def interaction_weekly(slug, options={})
+        get "/topics/#{slug}/interaction/weekly", options
+      end
+
+      def interaction_monthly(slug, options={})
+        get "/topics/#{slug}/interaction/monthly", options
+      end
+
+      def interaction_quarterly(slug, options={})
+        get "/topics/#{slug}/interaction/quarterly", options
+      end
+
+      def interaction_yearly(slug, options={})
+        get "/topics/#{slug}/interaction/yearly", options
+      end
+
+    end
+    
+  end
+end

data/lib/datarank/likes.rb

@@ -0,0 +1,45 @@
+module Datarank
+  class Client
+
+    # Module containing methods for interacting with a topic's likes data
+    module Likes
+      
+      # Fetch likes for a topic grouped by a time interval
+      #
+      # @param slug [String] A topic's unique identifier slug
+      def likes_secondly(slug, options={})
+        get "/topics/#{slug}/likes/secondly", options
+      end
+
+      def likes_minutely(slug, options={})
+        get "/topics/#{slug}/likes/minutely", options
+      end
+
+      def likes_hourly(slug, options={})
+        get "/topics/#{slug}/likes/hourly", options
+      end
+
+      def likes_daily(slug, options={})
+        get "/topics/#{slug}/likes/daily", options
+      end
+
+      def likes_weekly(slug, options={})
+        get "/topics/#{slug}/likes/weekly", options
+      end
+
+      def likes_monthly(slug, options={})
+        get "/topics/#{slug}/likes/monthly", options
+      end
+
+      def likes_quarterly(slug, options={})
+        get "/topics/#{slug}/likes/quarterly", options
+      end
+
+      def likes_yearly(slug, options={})
+        get "/topics/#{slug}/likes/yearly", options
+      end
+
+    end
+    
+  end
+end

data/lib/datarank/locations.rb

@@ -4,18 +4,25 @@ module Datarank
     # Module containing methods for interacting with geocoded data
     module Locations
       
-      # Fetch geocoded comments for a topic
+      # Fetch location pins for a topic
       #
       # @param slug [String] A topic's unique identifier slug
-      def locations(slug, options={})
+      def location_pins(slug, options={})
         get "/topics/#{slug}/location/pins", options
       end
 
-      # Fetch average sentiment for topic broken down into provinces with counts
+      # Fetch location provinces data for a topic
       #
       # @param slug [String] A topic's unique identifier slug
-      def location_sentiment(slug, options={})
-        get "/topics/#{slug}/location/sentiment", options
+      def location_provinces(slug, options={})
+        get "/topics/#{slug}/location/provinces", options
+      end
+
+      # Fetch location heatmap data for a topic
+      #
+      # @param slug [String] A topic's unique identifier slug
+      def location_heatmap(slug, options={})
+        get "/topics/#{slug}/location/heatmap", options
       end
 
     end

data/lib/datarank/reach.rb

@@ -4,14 +4,42 @@ module Datarank
     # Module containing methods for interacting with a topic's reach data
     module Reach
       
-      # Fetch reach counts for topic by day
+      # Fetch reach for a topic grouped by a time interval
       #
       # @param slug [String] A topic's unique identifier slug
+      def reach_secondly(slug, options={})
+        get "/topics/#{slug}/reach/secondly", options
+      end
+
+      def reach_minutely(slug, options={})
+        get "/topics/#{slug}/reach/minutely", options
+      end
+
+      def reach_hourly(slug, options={})
+        get "/topics/#{slug}/reach/hourly", options
+      end
+
       def reach_daily(slug, options={})
         get "/topics/#{slug}/reach/daily", options
       end
 
-    end
+      def reach_weekly(slug, options={})
+        get "/topics/#{slug}/reach/weekly", options
+      end
 
+      def reach_monthly(slug, options={})
+        get "/topics/#{slug}/reach/monthly", options
+      end
+
+      def reach_quarterly(slug, options={})
+        get "/topics/#{slug}/reach/quarterly", options
+      end
+
+      def reach_yearly(slug, options={})
+        get "/topics/#{slug}/reach/yearly", options
+      end
+
+    end
+    
   end
 end

data/lib/datarank/sentiment.rb

@@ -4,14 +4,42 @@ module Datarank
     # Module containing methods for interacting with a topic's sentiment data
     module Sentiment
       
-      # Fetch sentiment for a topic grouped by day
+      # Fetch sentiment for a topic grouped by a time interval
       #
       # @param slug [String] A topic's unique identifier slug
+      def sentiment_secondly(slug, options={})
+        get "/topics/#{slug}/sentiment/secondly", options
+      end
+
+      def sentiment_minutely(slug, options={})
+        get "/topics/#{slug}/sentiment/minutely", options
+      end
+
+      def sentiment_hourly(slug, options={})
+        get "/topics/#{slug}/sentiment/hourly", options
+      end
+
       def sentiment_daily(slug, options={})
         get "/topics/#{slug}/sentiment/daily", options
       end
 
-    end
+      def sentiment_weekly(slug, options={})
+        get "/topics/#{slug}/sentiment/weekly", options
+      end
 
+      def sentiment_monthly(slug, options={})
+        get "/topics/#{slug}/sentiment/monthly", options
+      end
+
+      def sentiment_quarterly(slug, options={})
+        get "/topics/#{slug}/sentiment/quarterly", options
+      end
+
+      def sentiment_yearly(slug, options={})
+        get "/topics/#{slug}/sentiment/yearly", options
+      end
+
+    end
+    
   end
 end

data/lib/datarank/social_stats.rb

@@ -0,0 +1,17 @@
+module Datarank
+  class Client
+
+    # Module containing methods for interacting with a topic's social stats
+    module SocialStats
+      
+      # Fetch social stats correlated to a topic
+      #
+      # @param slug [String] A topic's unique identifier slug
+      def social_stats(slug, options={})
+        get "/topics/#{slug}/social/stats", options
+      end
+
+    end
+
+  end
+end

data/lib/datarank/themes.rb

@@ -7,23 +7,23 @@ module Datarank
       # Return themes assigned to a topic
       #
       # @param slug [String] A topic's unique identifier slug
-      def themes slug
-        get "/topics/#{slug}/themes"
+      def themes(slug, options={})
+        get "/topics/#{slug}/themes", options
       end
 
       # Return trend for a specific theme on a topic
       #
       # @param slug [String] A topic's unique identifier slug
       # @param theme_id [Integer] Unique ID of theme
-      def themes_trend slug, theme_id
-        get "/topics/#{slug}/themes/trend/#{theme_id}"
+      def themes_trend(slug, theme_id, options={})
+        get "/topics/#{slug}/themes/trend/#{theme_id}", options
       end
 
       # Return table for correlation between all themes on a topic
       #
       # @param slug [String] A topic's unique identifier slug
-      def themes_correlation slug
-        get "/topics/#{slug}/themes/correlation"
+      def themes_correlation(slug, options={})
+        get "/topics/#{slug}/themes/correlation", options
       end
 
     end

data/lib/datarank/version.rb

@@ -2,7 +2,7 @@ module Datarank
   # A class for managing Datarank's Version
   class Version
     MAJOR = 1
-    MINOR = 3
+    MINOR = 4
     PATCH = 0
 
     class << self

data/lib/datarank/volume.rb

@@ -4,13 +4,62 @@ module Datarank
     # Module containing methods for interacting with topics
     module Volume
      
-      # Return volume for a topic grouped by day
-      #
+      # Return volume for a topic grouped by a time interval
+      # 
       # @param slug [String] A topic's unique identifier slug
+      def volume_secondly(slug, options={})
+        get "/topics/#{slug}/volume/secondly", options
+      end
+
+      def volume_minutely(slug, options={})
+        get "/topics/#{slug}/volume/minutely", options
+      end
+
+      def volume_hourly(slug, options={})
+        get "/topics/#{slug}/volume/hourly", options
+      end
+
       def volume_daily(slug, options={})
         get "/topics/#{slug}/volume/daily", options
       end
 
+      def volume_weekly(slug, options={})
+        get "/topics/#{slug}/volume/weekly", options
+      end
+
+      def volume_monthly(slug, options={})
+        get "/topics/#{slug}/volume/monthly", options
+      end
+
+      def volume_quarterly(slug, options={})
+        get "/topics/#{slug}/volume/quarterly", options
+      end
+
+      def volume_yearly(slug, options={})
+        get "/topics/#{slug}/volume/yearly", options
+      end
+
+      # Return hourly average volume for a topic
+      #
+      # @param slug [String] A topic's unique identifier slug
+      def volume_hourly_average(slug, options={})
+        get "/topics/#{slug}/volume/hourly/average", options
+      end
+
+      # Return day-of-week volume for a topic
+      #
+      # @param slug [String] A topic's unique identifier slug
+      def volume_weekday(slug, options={})
+        get "/topics/#{slug}/volume/weekday", options
+      end
+
+      # Return hourly day-of-week heatmap information for a topic
+      #
+      # @param slug [String] A topic's unique identifier slug
+      def volume_weekday_heatmap_hourly(slug, options={})
+        get "/topics/#{slug}/volume/weekday/heatmap/hourly", options
+      end
+
     end
 
   end

metadata

@@ -1,14 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: datarank
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 1.4.0
 platform: ruby
 authors:
 - Addam Hardy
+- Evan Sitzes
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-05-22 00:00:00.000000000 Z
+date: 2015-09-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -103,12 +104,15 @@ files:
 - lib/datarank/comments.rb
 - lib/datarank/datasources.rb
 - lib/datarank/fizzle.rb
+- lib/datarank/interaction.rb
+- lib/datarank/likes.rb
 - lib/datarank/live.rb
 - lib/datarank/locations.rb
 - lib/datarank/reach.rb
 - lib/datarank/retailers.rb
 - lib/datarank/search.rb
 - lib/datarank/sentiment.rb
+- lib/datarank/social_stats.rb
 - lib/datarank/themes.rb
 - lib/datarank/topics.rb
 - lib/datarank/version.rb