datarank-v2 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: cbbd9653bcb72faad9457a9214f41d85e00330dd
+  data.tar.gz: 35472803e629c3474b0720e65853052f081bf88b
+SHA512:
+  metadata.gz: 92adfa552b18d5849acd5c3f05e26762763ffe661e8edc9d0d2028bc8e5e3b79af0e018904834d41fbaa9ddf9f222dcb21c11676f3b54a7e39cd87232e466563
+  data.tar.gz: e7bec3d0271f5d24922a7fa7d533db3000b6fd3ed0c2c66777d796e4ac6bac307fb7c6e17cf7c6aea292ec38dca6fef723d2ed6ac23a5bf312df51b3df1d56ae

data/.gitignore

@@ -0,0 +1,37 @@
+.idea
+
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/test/tmp/
+/test/version_tmp/
+/tmp/
+/vendor/
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalisation:
+/.bundle/
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+# Gemfile.lock
+# .ruby-version
+# .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc

data/.travis.yml

@@ -0,0 +1,7 @@
+language: ruby
+rvm:
+  - 1.9.3
+  - 2.0.0
+  - 2.1.0
+env:
+  global:

data/.yardopts

@@ -0,0 +1 @@
+--no-private

data/CHANGELOG.md

@@ -0,0 +1,3 @@
+0.1-0.2
+---
+Alpha release of DataRank Ruby Library

data/Gemfile

@@ -0,0 +1,19 @@
+source 'https://rubygems.org'
+
+group :development do
+  gem 'guard-rspec'
+  gem 'guard-yard'
+  gem 'pry'
+  gem 'yard'
+  gem 'rb-readline'
+end
+
+group :test do
+  gem 'rspec'
+  gem 'simplecov', :require => false
+  gem 'vcr', '~> 2.9.0'
+  gem 'webmock', '>= 1.18.0'
+  gem "codeclimate-test-reporter", require: nil
+end
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,117 @@
+PATH
+  remote: .
+  specs:
+    datarank (1.3.0)
+      hashie (>= 1.2.0)
+      httparty (>= 0.8.3)
+      json (>= 1.8.2)
+      multi_json (>= 1.3.4)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.3.7)
+    celluloid (0.16.0)
+      timers (~> 4.0.0)
+    codeclimate-test-reporter (0.4.7)
+      simplecov (>= 0.7.1, < 1.0.0)
+    coderay (1.1.0)
+    crack (0.4.2)
+      safe_yaml (~> 1.0.0)
+    diff-lcs (1.2.5)
+    docile (1.1.5)
+    ffi (1.9.8)
+    formatador (0.2.5)
+    guard (2.12.5)
+      formatador (>= 0.2.4)
+      listen (~> 2.7)
+      lumberjack (~> 1.0)
+      nenv (~> 0.1)
+      notiffany (~> 0.0)
+      pry (>= 0.9.12)
+      shellany (~> 0.0)
+      thor (>= 0.18.1)
+    guard-compat (1.2.1)
+    guard-rspec (4.5.0)
+      guard (~> 2.1)
+      guard-compat (~> 1.1)
+      rspec (>= 2.99.0, < 4.0)
+    guard-yard (2.1.4)
+      guard (>= 1.1.0)
+      yard (>= 0.7.0)
+    hashie (3.4.2)
+    hitimes (1.2.2)
+    httparty (0.13.5)
+      json (~> 1.8)
+      multi_xml (>= 0.5.2)
+    json (1.8.3)
+    listen (2.9.0)
+      celluloid (>= 0.15.2)
+      rb-fsevent (>= 0.9.3)
+      rb-inotify (>= 0.9)
+    lumberjack (1.0.9)
+    method_source (0.8.2)
+    multi_json (1.11.0)
+    multi_xml (0.5.5)
+    nenv (0.2.0)
+    notiffany (0.0.6)
+      nenv (~> 0.1)
+      shellany (~> 0.0)
+    pry (0.10.1)
+      coderay (~> 1.1.0)
+      method_source (~> 0.8.1)
+      slop (~> 3.4)
+    rake (10.4.2)
+    rb-fsevent (0.9.4)
+    rb-inotify (0.9.5)
+      ffi (>= 0.5.0)
+    rb-readline (0.5.2)
+    rspec (3.2.0)
+      rspec-core (~> 3.2.0)
+      rspec-expectations (~> 3.2.0)
+      rspec-mocks (~> 3.2.0)
+    rspec-core (3.2.2)
+      rspec-support (~> 3.2.0)
+    rspec-expectations (3.2.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.2.0)
+    rspec-mocks (3.2.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.2.0)
+    rspec-support (3.2.2)
+    safe_yaml (1.0.4)
+    shellany (0.0.1)
+    simplecov (0.9.2)
+      docile (~> 1.1.0)
+      multi_json (~> 1.0)
+      simplecov-html (~> 0.9.0)
+    simplecov-html (0.9.0)
+    slop (3.6.0)
+    thor (0.19.1)
+    timers (4.0.1)
+      hitimes
+    vcr (2.9.3)
+    webmock (1.20.4)
+      addressable (>= 2.3.6)
+      crack (>= 0.3.2)
+    yard (0.8.7.6)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  codeclimate-test-reporter
+  datarank!
+  guard-rspec
+  guard-yard
+  pry
+  rake
+  rb-readline
+  rspec
+  simplecov
+  vcr (~> 2.9.0)
+  webmock (>= 1.18.0)
+  yard
+
+BUNDLED WITH
+   1.10.5

data/Guardfile

@@ -0,0 +1,11 @@
+guard :rspec do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})     { |m| "spec/lib/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb')  { "spec" }
+end
+
+guard 'yard' do
+  watch(%r{lib/.+\.rb})
+  watch(%r{docs/.+\.md})
+  watch(%r{README\.md})
+end

data/LICENSE.md

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2014-2015 DataRank, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,63 @@
+# DataRank API Ruby Library
+
+[![Gem Version](https://badge.fury.io/rb/datarank.svg)](http://badge.fury.io/rb/datarank)
+[![Build Status](https://travis-ci.org/datarank/datarank-ruby.svg)](https://travis-ci.org/datarank/datarank-ruby/master)
+[![Code Climate](https://codeclimate.com/github/datarank/datarank-ruby/badges/gpa.svg)](https://codeclimate.com/github/datarank/
+datarank-ruby)
+
+## Documentation
+
+[http://www.rubydoc.info/github/datarank/datarank-ruby/master](http://www.rubydoc.info/github/datarank/datarank-ruby/master)
+
+## Installation
+
+` gem install datarank `
+
+## Getting Started
+
+
+**Instance method usage:**
+```ruby
+client = Datarank::Client.new(api_key, api_version)
+topics = client.all_topics
+```
+
+### Authentication
+
+```ruby
+client = Datarank::Client.new(api_key, api_version)
+```
+
+## More Examples
+
+**Fetch comments for a topic**
+
+```ruby
+client = Datarank::Client.new(api_key, api_version)
+comments = client.comments_search "tide-pods", {limit: 10}
+```
+
+
+## License
+
+The MIT License (MIT)
+
+Copyright (c) 2014-2015 DataRank, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/Rakefile

@@ -0,0 +1,9 @@
+require 'bundler'
+
+Bundler::GemHelper.install_tasks
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)
+
+task :test => :spec
+task :default => :spec

data/datarank.gemspec

@@ -0,0 +1,26 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'datarank/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "datarank-v2"
+  gem.version       = Datarank::Version.to_s
+  gem.authors       = ["Evan Sitzes"]
+  gem.email         = ["evan@simplymeasured.com"]
+  gem.description   = "Ruby Wrapper for the DataRank REST API"
+  gem.summary       = [""]
+  gem.homepage      = "https://github.com/datarank/datarank-ruby"
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+
+  gem.add_development_dependency "rake"
+
+  gem.add_dependency "httparty", ">= 0.8.3"
+  gem.add_dependency "multi_json", ">= 1.3.4"
+  gem.add_dependency "hashie", ">= 1.2.0"
+  gem.add_dependency "json", ">= 1.8.2"
+end

data/lib/datarank.rb

@@ -0,0 +1,27 @@
+require "json"
+require "datarank/version"
+require "datarank/client"
+
+module Datarank
+  class << self
+
+    # A Datarank::Client, used when calling methods on the Datarank module itself.
+    #
+    # @return [Datarank::Client]
+    def client(api_key=nil, api_version=nil, options={})
+      @client ||= Datarank::Client.new(api_key, api_version, options)
+    end
+
+    def respond_to?(method_name, include_private = false)
+      client.respond_to?(method_name, include_private) || super
+    end
+
+    # private
+
+    # def method_missing(method_name, *args, &block)
+    #   return super unless client.respond_to?(method_name)
+    #   client.send(method_name, *args, &block)
+    # end
+
+  end
+end

data/lib/datarank/client.rb

@@ -0,0 +1,116 @@
+require 'httparty'
+require 'multi_json'
+require 'hashie'
+require 'time'
+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"
+require "datarank/retailers"
+require "datarank/sentiment"
+require "datarank/themes"
+require "datarank/topic_administration"
+require "datarank/topics"
+require "datarank/volume"
+require "datarank/wordcloud"
+require "datarank/search"
+require "datarank/social_stats"
+
+
+module Datarank
+  class Client
+    include HTTParty
+
+    include Datarank::Client::Topics
+    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
+    include Datarank::Client::Retailers
+    include Datarank::Client::Sentiment
+    include Datarank::Client::Themes
+    include Datarank::Client::Volume
+    include Datarank::Client::Wordcloud
+    include Datarank::Client::Search
+    include Datarank::Client::SocialStats
+    include Datarank::Client::TopicAdministration
+
+    BASE_URI = 'https://api.datarank.com'
+
+    def initialize(api_key=nil, api_version=nil, options={})
+      @api_key = api_key
+      @api_version = api_version ? api_version : "v1";
+
+      # defaults
+      options[:base_uri] ||= BASE_URI
+      @base_uri = options[:base_uri]
+      options[:format]   ||= :json
+      options.each do |k,v|
+        self.class.send k, v
+      end
+    end
+
+    # Wrappers for the main HTTP verbs
+
+    def get(path, options={})
+      http_verb :get, path, options
+    end
+
+    def post(path, options={})
+      http_verb :post, path, options
+    end
+
+    def put(path, options={})
+      http_verb :put, path, options
+    end
+
+    def delete(path, options={})
+      http_verb :delete, path, options
+    end
+
+    def http_verb(verb, path, options={})
+
+      if [:get, :delete].include? verb
+        request_options = {}
+        path = "#{path}?#{URI.encode_www_form(options)}" if !options.empty?
+      else
+        request_options = {body: options.to_json}
+      end
+
+      headers = {
+        'Authorization' => "Bearer #{@api_key}",
+        "Content-Type" => "application/json",
+        "Accept" => "application/vnd.datarank.#{@api_version}+json"
+      }
+
+      request_options[:headers] = headers
+
+      r = self.class.send(verb, path, request_options)
+      # FIXME: raise errors on actual error packages
+      parsed_json = JSON.parse(r.body)
+      if parsed_json.is_a? Array
+        parsed_json = {objects: parsed_json}
+      end
+
+      hash = Hashie::Mash.new(parsed_json)
+      raise Error.new(hash.error) if hash.error
+      raise Error.new(hash.errors.join(", ")) if hash.errors
+      hash
+    end
+
+    class Error < StandardError; end
+
+    private
+
+  end
+end

data/lib/datarank/comments.rb

@@ -0,0 +1,26 @@
+module Datarank
+  class Client
+
+    # Module containing methods for interacting with comments
+    module Comments
+
+      # Query interface for comments correlated to a topic
+      #
+      # @param slug [String] A topic's unique identifier slug
+      # @option options [1..1000] :limit The number of items to return.
+      # @option options - all query options available in API docs
+      def comments_search(slug, options={})
+        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
+end

data/lib/datarank/datasources.rb

@@ -0,0 +1,24 @@
+module Datarank
+  class Client
+
+    # Module containing methods for interacting with datasources
+    module Datasources
+      
+      # Return unique datasources correlated to a topic
+      #
+      # @param slug [String] A topic's unique identifier slug
+      def datasources(slug, options={})
+        get "/topics/#{slug}/datasources", options
+      end
+
+      # Return unique datasources correlated to a topic grouped by type
+      #
+      # @param slug [String] A topic's unique identifier slug
+      def datasources_by_type(slug, options={})
+        get "/topics/#{slug}/datasources/types", options
+      end
+    
+    end
+
+  end
+end

data/lib/datarank/fizzle.rb

@@ -0,0 +1,34 @@
+module Datarank
+  class Client
+
+    module Fizzle
+
+      # Validate a fizzle query's syntax
+      #
+      # @param options [String] :q Fizzle Query
+      # @note Fizzle query requires 'fizzle: ' be prepended to query
+      def fizzle_validate query
+        post "/fizzle/validate", {q: query}
+      end
+
+      # Test a fizzle query against a given set of comments
+      #
+      # @param query [String] :q Fizzle Query
+      # @param query [Array< Hash{ comment: String } >] :comments Array of comments to match against
+      # @note Fizzle query requires 'fizzle: ' be prepended to query
+      def fizzle_match query
+        post "/fizzle/match", query
+      end
+
+      # Filter a 100,000 comment sample with a fizzle query
+      #
+      # @param query [String] :q Fizzle Query
+      # @note Fizzle query requires 'fizzle: ' be prepended to query
+      def fizzle_search query
+        post "/fizzle/search", {q: query}
+      end
+    
+    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/live.rb

@@ -0,0 +1,24 @@
+module Datarank
+  class Client
+
+    # Module containing methods for interacting with live search
+    module Live
+
+      # Query twitter data with a query string and return volume points grouped by day
+      #
+      # @param query [String] Phrase to search twitter
+      def twitter_volume_daily query
+        get "/search/twitter/volume/daily", {query: query}
+      end
+
+      # Query twitter data with a query string and return tweets
+      #
+      # @param query [String] Phrase to search twitter
+      def tweets query
+        get "/search/twitter", {query: query}
+      end
+
+    end
+
+  end
+end

data/lib/datarank/locations.rb

@@ -0,0 +1,31 @@
+module Datarank
+  class Client
+
+    # Module containing methods for interacting with geocoded data
+    module Locations
+      
+      # Fetch location pins for a topic
+      #
+      # @param slug [String] A topic's unique identifier slug
+      def location_pins(slug, options={})
+        get "/topics/#{slug}/location/pins", options
+      end
+
+      # Fetch location provinces data for a topic
+      #
+      # @param slug [String] A topic's unique identifier slug
+      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
+
+  end
+end

data/lib/datarank/reach.rb

@@ -0,0 +1,45 @@
+module Datarank
+  class Client
+
+    # Module containing methods for interacting with a topic's reach data
+    module Reach
+      
+      # 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
+
+      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/retailers.rb

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

data/lib/datarank/search.rb

@@ -0,0 +1,18 @@
+module Datarank
+  class Client
+
+    # Module containing methods raw search
+    module Search
+
+      # Return comments based on an elastic search json compliant query
+      #
+      # @param search_object [String] A JSON object compliant with Elastic Search query format
+      # @param slug [String] A topic's unique identifier slug
+      def search(topic_slug, search_object)
+        post "/topics/#{topic_slug}/search", search_object
+      end
+
+    end
+
+  end
+end

data/lib/datarank/sentiment.rb

@@ -0,0 +1,45 @@
+module Datarank
+  class Client
+
+    # Module containing methods for interacting with a topic's sentiment data
+    module Sentiment
+      
+      # 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
+
+      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

@@ -0,0 +1,32 @@
+module Datarank
+  class Client
+
+    # Module containing methods for interacting with a topic's themes
+    module Themes
+      
+      # Return themes assigned to a topic
+      #
+      # @param slug [String] A topic's unique identifier slug
+      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, 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, options={})
+        get "/topics/#{slug}/themes/correlation", options
+      end
+
+    end
+
+  end
+end

data/lib/datarank/topic_administration.rb

@@ -0,0 +1,22 @@
+module Datarank
+  class Client
+
+    # Module containing method for interacting with the topic CRUD endpoints
+    module TopicAdministration
+
+      def create_topic(options={})
+        post "/topics", options
+      end
+
+      def edit_topic(slug, options={})
+        put "/topics/#{slug}", options
+      end
+
+      def delete_topic(slug)
+        delete "/topics/#{slug}"
+      end
+
+    end
+
+  end
+end

data/lib/datarank/topics.rb

@@ -0,0 +1,24 @@
+module Datarank
+  class Client
+
+    # Module containing methods for interacting with topics
+    module Topics
+
+      # Return all topics
+      #
+      # @option options [1..1000] :limit The number of items to return.
+      def all_topics options={}
+        get '/topics', options
+      end
+
+      # Return single topic by slug
+      #
+      # @param slug [String] A topic's unique identifier slug
+      def find_topic(slug, options={})
+        get "/topics/#{slug}", options
+      end
+
+    end
+
+  end
+end

data/lib/datarank/version.rb

@@ -0,0 +1,14 @@
+module Datarank
+  # A class for managing Datarank's Version
+  class Version
+    MAJOR = 1
+    MINOR = 0
+    PATCH = 0
+
+    class << self
+      def to_s
+        [MAJOR, MINOR, PATCH].join('.')
+      end
+    end
+  end
+end

data/lib/datarank/volume.rb

@@ -0,0 +1,66 @@
+module Datarank
+  class Client
+
+    # Module containing methods for interacting with topics
+    module Volume
+     
+      # 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
+end

data/lib/datarank/wordcloud.rb

@@ -0,0 +1,18 @@
+module Datarank
+  class Client
+
+    # Module containing methods for interacting with a topic's word cloud
+    module Wordcloud
+    
+
+      # Return word cloud for a topic
+      #
+      # @param slug [String] A topic's unique identifier slug
+      def wordcloud(slug, options={})
+        get "/topics/#{slug}/wordcloud", options
+      end
+
+    end
+
+  end
+end

data/spec/datarank_spec.rb

@@ -0,0 +1,17 @@
+require 'spec_helper'
+
+describe Datarank do
+
+  it "returns a Datarank::Client" do
+    expect(Datarank.client).to be_kind_of Datarank::Client
+  end
+
+  # it "responds to methods on its client" do
+  #   expect(RedditKit.respond_to?(:username)).to be true
+  # end
+
+  # it "forwards methods to its client" do
+  #   expect { RedditKit.username }.not_to raise_error
+  # end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,45 @@
+require "codeclimate-test-reporter"
+CodeClimate::TestReporter.start
+require 'simplecov'
+
+SimpleCov.formatter = SimpleCov::Formatter::MultiFormatter[SimpleCov::Formatter::HTMLFormatter]
+SimpleCov.start
+
+# require 'dotenv'
+# Dotenv.load
+
+require 'datarank'
+require 'rspec'
+require 'webmock/rspec'
+require 'vcr'
+
+VCR.configure do |c|
+  c.configure_rspec_metadata!
+
+  c.cassette_library_dir = 'spec/cassettes'
+  c.hook_into :webmock
+  c.default_cassette_options = { :record => :new_episodes }
+end
+
+# The API key for use during testing
+#
+# @return The account's username.
+def datarank_apikey
+  ENV.fetch 'DATARANK_AUTHORIZATION_KEY'
+end
+
+# The API Version for testing
+#
+# @return The account's username.
+def datarank_api_version
+  ENV.fetch 'DATARANK_API_VERSION'
+end
+
+# An Datarank object
+#
+# @return The authenticated client.
+def authenticated_client
+  VCR.use_cassette('authenticated_client') do
+    Datarank::Client.new datarank_apikey, datarank_api_version
+  end
+end

metadata

@@ -0,0 +1,148 @@
+--- !ruby/object:Gem::Specification
+name: datarank-v2
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Evan Sitzes
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-05-04 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 0.8.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 0.8.3
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 1.3.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 1.3.4
+- !ruby/object:Gem::Dependency
+  name: hashie
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 1.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 1.2.0
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 1.8.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 1.8.2
+description: Ruby Wrapper for the DataRank REST API
+email:
+- evan@simplymeasured.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .travis.yml
+- .yardopts
+- CHANGELOG.md
+- Gemfile
+- Gemfile.lock
+- Guardfile
+- LICENSE.md
+- README.md
+- Rakefile
+- datarank.gemspec
+- lib/datarank.rb
+- lib/datarank/client.rb
+- 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/topic_administration.rb
+- lib/datarank/topics.rb
+- lib/datarank/version.rb
+- lib/datarank/volume.rb
+- lib/datarank/wordcloud.rb
+- spec/datarank_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/datarank/datarank-ruby
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.14.1
+signing_key: 
+specification_version: 4
+summary: '[""]'
+test_files:
+- spec/datarank_spec.rb
+- spec/spec_helper.rb