legato 0.3.0 → 0.3.1

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    ODkwYmViYWE0MzY5MWQ5NTIxNThlYWMwMzU3ZjcyMmZhNGJmNmE0MA==
+  data.tar.gz: !binary |-
+    M2MxYTYzYzE1ZTJiZmU2YjEwNGJlMzYzNjI1M2JjN2UwMDlhY2MyMw==
+SHA512:
+  metadata.gz: !binary |-
+    MjVhMzdhNzZmOWM0M2I3NjNlY2RkYjk5NmQzYzU3ZDYzYWU0NWY0YzY0NWNi
+    Y2M0M2MyZmE0Zjc0MDk3ZTZmNDIyZDkxNTZkZWEzNzBmMjA0OTMyMjdlOTBl
+    MjQ4Yzc2Yzk5NjA2ZTBiOWI0MWYwNmNhYThkYWFlMDk0YzUyMTk=
+  data.tar.gz: !binary |-
+    YzcyNjI0Zjg0NDFiYTNhMzZhMmNlOTAxZWI5MTMzZDBhNTUwMGM4OGZiMjJh
+    ZGUyNTUwNDAxMzk4OTQwYmVhYTcyM2U5MDI1OTFlNGI2NjM1NWFhOWE5ODVm
+    MWRmYzk3MzUxMzIwNTUzMjk3YjlhMTM2MzhkZGE0NTQ2ODBmZmE=

data/.gitignore

@@ -4,4 +4,5 @@ Gemfile.lock
 pkg/*
 lib/demo.rb
 .rvmrc
-coverage
+coverage
+.DS_Store

data/.travis.yml

@@ -3,4 +3,14 @@ rvm:
   - 1.8.7
   - 1.9.2
   - 1.9.3
-script: bundle exec rspec spec
+  - 2.0.0
+  - 2.1.0
+script: bundle exec rspec spec
+notifications:
+  webhooks:
+    urls:
+      - "https://pitaleerb.slack.com/services/hooks/travis?token=wNtbVP9B3j1npZkLzK4bpq8Q"
+      - "https://webhooks.gitter.im/e/064c90f277ac13f3dd7c"
+    on_success: change  # options: [always|never|change] default: always
+    on_failure: always  # options: [always|never|change] default: always
+    on_start: false     # default: false

data/CHANGELOG.md

@@ -1,3 +1,9 @@
+## Legato 0.3.1 ##
+
+*   Fixes `realtime` on query to change the `tracking_scope` to 'rt' and return `self`, a `Query`
+
+    *Tony Pitale*
+
 ## Legato 0.3.0 ##
 
 *   Adds Management Goal under Profile

data/README.md

@@ -1,8 +1,19 @@
-# Legato: Google Analytics Model/Mapper #
+# Legato: Ruby Client for the Google Analytics Core Reporting and Management API #
+
+[![Gem Version](https://badge.fury.io/rb/legato.png)](http://badge.fury.io/rb/legato)
 [![Build Status](https://travis-ci.org/tpitale/legato.png)](https://travis-ci.org/tpitale/legato)
+[![Code Climate](https://codeclimate.com/github/tpitale/legato.png)](https://codeclimate.com/github/tpitale/legato)
 
 ## [Check out the Wiki!](https://github.com/tpitale/legato/wiki) ##
 
+**Feel free to open an issue if you have a question that is not answered in the [Wiki](https://github.com/tpitale/legato/wiki)**
+
+## Chat! ##
+
+We're trying out chat using Gitter Chat. I'll try to be in there whenever I'm at my computer.
+
+[![Gitter chat](https://badges.gitter.im/tpitale/legato.png)](https://gitter.im/tpitale/legato)
+
 If you've come here from Garb, welcome! There are a few changes from Garb, so you'll want to check out:
 
 * [Model Data](https://github.com/tpitale/legato/wiki/Model-Data)
@@ -15,48 +26,64 @@ If you're not able to upgrade quite yet, Garb has been maintained https://github
 
 1. Get an OAuth2 Access Token from Google, Read about [OAuth2](https://github.com/tpitale/legato/wiki/OAuth2-and-Google)
 
-        access_token = OAuth2 Access Token # from Google
+```ruby
+access_token = OAuth2 Access Token # from Google
+```
 
 2. Create a New User with the Access Token
 
-        user = Legato::User.new(access_token)
+```ruby
+user = Legato::User.new(access_token)
+```
 
 3. List the Accounts and Profiles of the first Account
 
-        user.accounts
-        user.accounts.first.profiles
+```ruby
+user.accounts
+user.accounts.first.profiles
+```
 
 4. List all the Profiles the User has Access to
 
-        user.profiles
+```ruby
+user.profiles
+```
 
 5. Get a Profile
 
-        profile = user.profiles.first
+```ruby
+profile = user.profiles.first
+```
 
 6. The Profile Carries the User
 
-        profile.user == user #=> true
+```ruby
+profile.user == user #=> true
+```
 
 
 ## Google Analytics Model ##
 
-    class Exit
-      extend Legato::Model
+```ruby
+class Exit
+  extend Legato::Model
 
-      metrics :exits, :pageviews
-      dimensions :page_path, :operating_system, :browser
-    end
+  metrics :exits, :pageviews
+  dimensions :page_path, :operating_system, :browser
+end
 
-    profile.exits #=> returns a Legato::Query
-    profile.exits.each {} #=> any enumerable kicks off the request to GA
+profile.exit #=> returns a Legato::Query
+profile.exit.each {} #=> any enumerable kicks off the request to GA
+```
 
 ## Metrics & Dimensions ##
 
 http://code.google.com/apis/analytics/docs/gdata/dimsmets/dimsmets.html
 
-    metrics :exits, :pageviews
-    dimensions :page_path, :operating_system, :browser
+```ruby
+metrics :exits, :pageviews
+dimensions :page_path, :operating_system, :browser
+```
 
 ## Filtering ##
 
@@ -66,54 +93,78 @@ Here's what google has to say: http://code.google.com/apis/analytics/docs/gdata/
 
 ### Examples ###
 
+Inside of any `Legato::Model` class, the method `filter` is available (like `metrics` and `dimensions`).
+
 Return entries with exits counts greater than or equal to 2000
 
-    filter :high_exits, &lambda {gte(:exits, 2000)}
+```ruby
+filter :high_exits, &lambda {gte(:exits, 2000)}
+```
 
 Return entries with pageview metric less than or equal to 200
 
-    filter :low_pageviews, &lambda {lte(:pageviews, 200)}
+```ruby
+filter :low_pageviews, &lambda {lte(:pageviews, 200)}
+```
 
 Filters with dimensions
 
-    filter :for_browser, &lambda {|browser| matches(:browser, browser)}
+```ruby
+filter :for_browser, &lambda {|browser| matches(:browser, browser)}
+```
 
 Filters with OR
 
-    filter :browsers, &lambda {|*browsers| browsers.map {|browser| matches(:browser, browser)}}
+```ruby
+filter :browsers, &lambda {|*browsers| browsers.map {|browser| matches(:browser, browser)}}
+```
 
 
 ## Using and Chaining Filters ##
 
 Pass the profile as the first or last parameter into any filter.
 
-    Exit.for_browser("Safari", profile)
+```ruby
+Exit.for_browser("Safari", profile)
+```
 
 Chain two filters.
 
-    Exit.high_exits.low_pageviews(profile)
+```ruby
+Exit.high_exits.low_pageviews(profile)
+```
 
 Profile gets a method for each class extended by Legato::Model
 
-    Exit.results(profile) == profile.exit
+```ruby
+Exit.results(profile) == profile.exit
+```
 
 We can chain off of that method, too.
 
-    profile.exit.high_exits.low_pageviews.by_pageviews
+```ruby
+profile.exit.high_exits.low_pageviews.by_pageviews
+```
 
 Chaining order doesn't matter. Profile can be given to any filter.
 
-    Exit.high_exits(profile).low_pageviews == Exit.low_pageviews(profile).high_exits
+```ruby
+Exit.high_exits(profile).low_pageviews == Exit.low_pageviews(profile).high_exits
+```
 
 Be sure to pass the appropriate number of arguments matching the lambda for your filter.
 
 For a filter defined like this:
 
-    filter :browsers, &lambda {|*browsers| browsers.map {|browser| matches(:browser, browser)}}
+```ruby
+filter :browsers, &lambda {|*browsers| browsers.map {|browser| matches(:browser, browser)}}
+```
 
 We can use it like this, passing any number of arguments:
 
-    Exit.browsers("Firefox", "Safari", profile)
+```ruby
+Exit.browsers("Firefox", "Safari", profile)
+```
 
 ## Google Analytics Supported Filtering Methods ##
 
@@ -140,9 +191,9 @@ Operators on dimensions:
     substring        => '=@',
     not_substring    => '!@'
 
-## Dynamic Segment
+## Session-level Segments
 
-Your query can have a dynamic segment, which works with filter expressions. It
+Your query can have a session-level segment, which works with filter expressions. It
 works like an [advanced
 segment](https://support.google.com/analytics/answer/1033017?hl=en), except you
 don't have to create it beforehand, you can just specify it at query time.
@@ -156,35 +207,44 @@ Some metrics and dimensions are not allowed for segments, see the [API
 documentation](https://developers.google.com/analytics/devguides/reporting/core/v3/reference#segment)
 for more details.
 
+**Note**: Legato does _not_ support [Users vs Sessions](https://developers.google.com/analytics/devguides/reporting/core/v3/segments#users-vs-sessions), yet. The default will be sessions (the equivalent of the earlier, now removed, dynamic segments).
+
 ### Defining, using and chaining filters
 
 Return entries with exits counts greater than or equal to 2000
 
-    segment :high_exits do
-      gte(:exits, 2000)
-    end
+```ruby
+segment :high_exits do
+  gte(:exits, 2000)
+end
+```
 
 Return entries with pageview metric less than or equal to 200
 
-    segment :low_pageviews do
-      lte(:pageviews, 200)
-    end
+```ruby
+segment :low_pageviews do
+  lte(:pageviews, 200)
+end
+```
 
 You can chain them
 
-    Exit.high_exits.low_pageviews(profile)
+```ruby
+Exit.high_exits.low_pageviews(profile)
+```
 
 and call them directly on the profile
 
-    profile.exit.high_exits.low_pageviews
-
-
+```ruby
+profile.exit.high_exits.low_pageviews
+```
 ## Accounts, WebProperties, Profiles, and Goals ##
 
-    > Legato::Management::Account.all(user)
-    > Legato::Management::WebProperty.all(user)
-    > Legato::Management::Profile.all(user)
-
+```ruby
+Legato::Management::Account.all(user)
+Legato::Management::WebProperty.all(user)
+Legato::Management::Profile.all(user)
+```
 ## Other Parameters Can be Passed to a call to #results ##
 
   * :start_date - The date of the period you would like this report to start
@@ -193,12 +253,26 @@ and call them directly on the profile
   * :offset - The starting index
   * :sort - metric/dimension to sort by
   * :quota_user - any arbitrary string that uniquely identifies a user (40 characters max)
+  * :sampling_level - 'FASTER' or 'HIGHER_PRECISION' https://developers.google.com/analytics/devguides/reporting/core/v3/reference#samplingLevel
+
+## Real Time Reporting ##
+
+https://developers.google.com/analytics/devguides/reporting/realtime/v3/
+https://developers.google.com/analytics/devguides/reporting/realtime/dimsmets/
+
+GA provides an endpoint to do **basic** reporting in near-realtime. Please read the above documentation to know which features (and dimentsion/metrics) are or are _not_ available. It is also only available in **beta** so you must already have access.
+
+Inside of Legato, you can simply add `realtime` to your query, like this:
+
+```ruby
+Exit.realtime.results(profile)
+```
 
 ## License ##
 
   (The MIT License)
 
-  Copyright (c) 2012 Tony Pitale
+  Copyright (c) 2011-2014 Tony Pitale
 
   Permission is hereby granted, free of charge, to any person obtaining
   a copy of this software and associated documentation files (the

data/lib/legato.rb

@@ -16,12 +16,12 @@ module Legato
   module Management
   end
 
-  def self.to_ga_string(str)
-    "#{$1}ga:#{$2}" if str.to_s.camelize(:lower) =~ /^(-)?(.*)$/
+  def self.to_ga_string(str, tracking_scope = "ga")
+    "#{$1}#{tracking_scope}:#{$2}" if str.to_s.camelize(:lower) =~ /^(-)?(.*)$/
   end
 
   def self.from_ga_string(str)
-    str.gsub("ga:", '')
+    str.gsub(/ga:|mcf:|rt:/, '')
   end
 
   def self.format_time(t)

data/lib/legato/filter.rb

@@ -1,6 +1,6 @@
 module Legato
   class Filter
-    attr_accessor :field, :operator, :value, :join_character
+    attr_accessor :field, :operator, :value, :join_character, :tracking_scope
 
     OPERATORS = {
       # metrics
@@ -21,15 +21,16 @@ module Legato
       # :descending => '-'
     }
 
-    def initialize(field, operator, value, join_character)
+    def initialize(field, operator, value, join_character, tracking_scope = "ga")
       self.field = field
       self.operator = operator
       self.value = value
       self.join_character = join_character # if nil, will be overridden by Query#apply_filter
+      self.tracking_scope = tracking_scope
     end
 
     def google_field
-      Legato.to_ga_string(field)
+      Legato.to_ga_string(field, tracking_scope)
     end
 
     def google_operator
@@ -45,7 +46,7 @@ module Legato
     end
 
     def to_param
-      "#{google_field}#{google_operator}#{escaped_value}"
+      [google_field, google_operator, escaped_value].join
     end
 
     def join_with(param)

data/lib/legato/list_parameter.rb

@@ -1,11 +1,12 @@
 module Legato
   class ListParameter
 
-    attr_reader :name, :elements
+    attr_reader :name, :elements, :tracking_scope
 
-    def initialize(name, elements=[])
+    def initialize(name, elements=[], tracking_scope = "ga")
       @name = name
       @elements = Array.wrap(elements)
+      @tracking_scope = tracking_scope
     end
 
     def name
@@ -18,7 +19,7 @@ module Legato
     end
 
     def to_params
-      value = elements.map{|element| Legato.to_ga_string(element)}.join(',')
+      value = elements.map{|element| Legato.to_ga_string(element, tracking_scope)}.join(',')
       value.empty? ? {} : {name => value}
     end
 

data/lib/legato/model.rb

@@ -4,13 +4,23 @@ module Legato
       ProfileMethods.add_profile_method(base)
     end
 
+    # Adds metrics to the class for retrieval from GA
+    #
+    # @param *fields [Symbol] the names of the fields to retrieve
+    # @return [ListParameter] the set of all metrics
     def metrics(*fields)
-      @metrics ||= ListParameter.new(:metrics)
+      fields, options = options_from_fields(fields)
+      @metrics ||= ListParameter.new(:metrics, [], options.fetch(:tracking_scope, "ga"))
       @metrics << fields
     end
 
+    # Adds dimensions to the class for retrieval from GA
+    #
+    # @param *fields [Symbol] the names of the fields to retrieve
+    # @return [ListParameter] the set of all dimensions
     def dimensions(*fields)
-      @dimensions ||= ListParameter.new(:dimensions)
+      fields, options = options_from_fields(fields)
+      @dimensions ||= ListParameter.new(:dimensions, [], options.fetch(:tracking_scope, "ga"))
       @dimensions << fields
     end
 
@@ -18,6 +28,12 @@ module Legato
       @filters ||= {}
     end
 
+    # Define a filter
+    #
+    # @param name [Symbol] the class method name for the resulting filter
+    # @param block the block which contains filter methods to define the
+    #   parameters used for filtering the request to GA
+    # @return [Proc] the body of newly defined method
     def filter(name, &block)
       filters[name] = block
 
@@ -30,6 +46,12 @@ module Legato
       @segments ||= {}
     end
 
+    # Define a segment
+    #
+    # @param name [Symbol] the class method name for the resulting segment
+    # @param block the block which contains filter methods to define the
+    #   parameters used for segmenting the request to GA
+    # @return [Proc] the body of newly defined method
     def segment(name, &block)
       segments[name] = block
 
@@ -38,6 +60,11 @@ module Legato
       end
     end
 
+    # Set the class used to make new instances of returned results from GA
+    # 
+    # @param klass [Class] any class that accepts a hash of attributes to
+    #   initialize the values of the class
+    # @return the original class given
     def set_instance_klass(klass)
       @instance_klass = klass
     end
@@ -46,9 +73,28 @@ module Legato
       @instance_klass || OpenStruct
     end
 
+    # Builds a `query` to get results from GA
+    # 
+    # @param profile [Legato::Management::Profile] the profile to query GA against
+    # @param options [Hash] options:
+    #   * start_date
+    #   * end_date
+    #   * limit
+    #   * offset
+    #   * sort
+    #   * quota_user
+    # @return [Query] a new query with all the filters/segments defined on the
+    #   model, allowing for chainable behavior before kicking of the request
+    #   to Google Analytics which returns the result data
     def results(profile, options = {})
+      # TODO: making tracking scope configurable when results are querried.  not sure how to do this.
       Query.new(self).results(profile, options)
     end
 
+    def options_from_fields(fields)
+      options = fields.pop if fields.last.is_a?(Hash)
+      [fields, (options || {})]
+    end
+
   end
-end
+end

data/lib/legato/profile_methods.rb

@@ -3,7 +3,8 @@ module Legato
     def self.add_profile_method(klass)
       # demodulize leaves potential to redefine
       # these methods given different namespaces
-      method_name = klass.name.to_s.demodulize.underscore
+      method_name = method_name_from_klass(klass)
+
       return unless method_name.length > 0
 
       class_eval <<-CODE
@@ -12,5 +13,9 @@ module Legato
         end
       CODE
     end
+
+    def self.method_name_from_klass(klass)
+      klass.name.to_s.gsub(":", "_").demodulize.underscore
+    end
   end
 end

data/lib/legato/query.rb

@@ -29,16 +29,18 @@ module Legato
 
     attr_reader :parent_klass
     attr_accessor :profile, :start_date, :end_date
-    attr_accessor :sort, :limit, :offset, :quota_user #, :segment # individual, overwritten
+    attr_accessor :sort, :limit, :offset, :quota_user, :sampling_level #, :segment # individual, overwritten
     attr_accessor :filters, :segment_filters # combined, can be appended to
+    attr_accessor :tracking_scope
 
-    def initialize(klass)
+    def initialize(klass, tracking_scope = "ga")
       @loaded = false
       @parent_klass = klass
       self.filters = FilterSet.new
       self.segment_filters = FilterSet.new
       self.start_date = Time.now - MONTH
       self.end_date = Time.now
+      self.tracking_scope = tracking_scope
 
       klass.filters.each do |name, block|
         define_filter(name, &block)
@@ -89,7 +91,7 @@ module Legato
     end
 
     def apply_basic_options(options)
-      [:sort, :limit, :offset, :start_date, :end_date, :quota_user].each do |key| #:segment
+      [:sort, :limit, :offset, :start_date, :end_date, :quota_user, :sampling_level].each do |key| #:segment
         self.send("#{key}=".to_sym, options[key]) if options.has_key?(key)
       end
     end
@@ -180,11 +182,11 @@ module Legato
     end
 
     def sort=(arr)
-      @sort = Legato::ListParameter.new(:sort, arr)
+      @sort = Legato::ListParameter.new(:sort, arr, tracking_scope)
     end
 
     def segment
-      "dynamic::#{segment_filters.to_params}" if segment_filters.any?
+      "sessions::condition::#{segment_filters.to_params}" if segment_filters.any?
     end
 
     # def segment_id
@@ -195,6 +197,11 @@ module Legato
       profile && Legato.to_ga_string(profile.id)
     end
 
+    def realtime
+      self.tracking_scope = 'rt'
+      self
+    end
+
     def to_params
       params = {
         'ids' => profile_id,

data/lib/legato/user.rb

@@ -2,39 +2,63 @@ module Legato
   class User
     attr_accessor :access_token, :api_key
 
+    VALID_TRACKING_SCOPES = {
+      'ga' => 'ga',
+      'mcf' => 'mcf',
+      'rt' => 'realtime'
+    }
+
     def initialize(token, api_key = nil)
       self.access_token = token
       self.api_key = api_key
     end
 
-    URL = "https://www.googleapis.com/analytics/v3/data/ga"
-
+    # TODO: refactor into request object again
     def request(query)
+      url = url_for(query)
+
       raw_response = if api_key
         # oauth 1 + api key
         query_string = URI.escape(query.to_query_string, '<>') # may need to add !~@
 
-        access_token.get(URL + query_string + "&key=#{api_key}")
+        access_token.get(url + query_string + "&key=#{api_key}")
       else
         # oauth 2
-        access_token.get(URL, :params => query.to_params)
+        access_token.get(url, :params => query.to_params)
       end
 
       Response.new(raw_response, query.instance_klass)
     end
 
-    # Management
+    # Management Associations
+
+    # All the `Account` records available to this user
     def accounts
       Management::Account.all(self)
     end
 
+    # All the `WebProperty` records available to this user
     def web_properties
       Management::WebProperty.all(self)
     end
 
+    # All the `Profile` records available to this user
     def profiles
       Management::Profile.all(self)
     end
 
+    def url_for(query)
+      raise "invalid tracking_scope" unless tracking_scope_valid?(query.tracking_scope)
+
+      endpoint = VALID_TRACKING_SCOPES[query.tracking_scope]
+
+      "https://www.googleapis.com/analytics/v3/data/#{endpoint}"
+    end
+
+    private
+
+    def tracking_scope_valid?(tracking_scope)
+      VALID_TRACKING_SCOPES.keys.include?(tracking_scope)
+    end
   end
 end

data/lib/legato/version.rb

@@ -1,3 +1,3 @@
 module Legato
-  VERSION = "0.3.0"
+  VERSION = "0.3.1"
 end

data/spec/lib/legato/filter_spec.rb

@@ -1,6 +1,21 @@
 require 'spec_helper'
 
 describe Legato::Filter do
+  context "a Filter instance with mcf" do
+    before :each do
+      @filter = Legato::Filter.new(:exits, :lt, 1000, nil, "mcf")
+    end
+
+    it 'represents itself as a parameter' do
+      @filter.to_param.should == "mcf:exits<1000"
+    end
+
+    it 'joins with another filter' do
+      filter2 = Legato::Filter.new(:pageviews, :gt, 1000, ',', "mcf")
+      filter2.join_with(@filter.to_param).should == "mcf:exits<1000,mcf:pageviews>1000"
+    end
+  end
+
   context "a Filter instance" do
     before :each do
       @filter = Legato::Filter.new(:exits, :lt, 1000, nil)

data/spec/lib/legato/legato_spec.rb

@@ -0,0 +1,17 @@
+require 'spec_helper'
+
+describe Legato do
+  context 'to_ga_string' do
+    it 'converts a string to google syntax' do
+      Legato.to_ga_string("whatever").should == "ga:whatever"
+      Legato.to_ga_string("whatever", "mcf").should == "mcf:whatever"
+    end
+  end
+
+  context 'from_ga_string' do
+    it 'converts a string google syntax' do
+      Legato.from_ga_string("ga:whatever").should == "whatever"
+      Legato.from_ga_string("mcf:whatever").should == "whatever"
+    end
+  end
+end

data/spec/lib/legato/management/legato_spec.rb

@@ -0,0 +1,13 @@
+require 'spec_helper'
+
+describe Legato do
+  context 'to_ga_string' do
+    it 'returns the correct dimesion with the ga namespace' do
+      Legato.to_ga_string("dimension").should == "ga:dimension"
+    end
+
+    it 'returns the correct dimesion with the Multi-Channel Funnels namespace (mcf)' do
+      Legato.to_ga_string("dimension", "mcf").should == "mcf:dimension"
+    end
+  end
+end

data/spec/lib/legato/query_spec.rb

@@ -384,11 +384,11 @@ describe Legato::Query do
         @query.to_params['filters'].should == 'filter set parameters'
       end
 
-      it 'includes the dynamic segment' do
-        segment_filters = stub(:to_params => 'segment parameter', :any? => true)
+      it 'includes the session level conditional segment' do
+        segment_filters = stub(:to_params => 'ga::parameter', :any? => true)
         @query.stubs(:segment_filters).returns(segment_filters)
 
-        @query.to_params['segment'].should == 'dynamic::segment parameter'
+        @query.to_params['segment'].should == 'sessions::condition::ga::parameter'
       end
 
       it 'includes metrics' do

data/spec/lib/legato/user_spec.rb

@@ -1,21 +1,46 @@
 require 'spec_helper'
 
 describe Legato::User do
+  context "an instance of Legato::User with the scope set" do
+    let(:user) {user = Legato::User.new(@access_token, nil)}
+
+    before :each do
+      @access_token = stub
+    end
+
+    it 'raises when an invalid scope is passed in' do
+      expect { user.url_for(stub(:tracking_scope => "what"))}.to raise_error
+    end
+
+    it 'sets the correct endpoint url' do
+      user.url_for(stub(:tracking_scope => 'mcf')).should == "https://www.googleapis.com/analytics/v3/data/mcf"
+    end
+  end
+
   context "an instance of Legato::User" do
     before :each do
       @access_token = stub
       @user = Legato::User.new(@access_token)
     end
 
+    it 'has the correct api endpoint' do
+      @user.url_for(stub(:tracking_scope => 'ga')).should == "https://www.googleapis.com/analytics/v3/data/ga"
+    end
+
+    it 'has the realtime api endpoint' do
+      @user.url_for(stub(:tracking_scope => 'rt')).should == "https://www.googleapis.com/analytics/v3/data/realtime"
+    end
+
     it 'returns a response for a given query' do
       klass = Class.new
       @access_token.stubs(:get).returns('a response')
       Legato::Response.stubs(:new)
+      @user.stubs(:url_for).returns("the_api_url")
 
       @user.request(stub(:to_params => "params", :instance_klass => klass))
 
       Legato::Response.should have_received(:new).with('a response', klass)
-      @access_token.should have_received(:get).with(Legato::User::URL, :params => "params")
+      @access_token.should have_received(:get).with("the_api_url", :params => "params")
     end
 
     it 'has accounts' do
@@ -36,4 +61,4 @@ describe Legato::User do
       Legato::Management::Profile.should have_received(:all).with(@user)
     end
   end
-end
+end

metadata

@@ -1,20 +1,18 @@
 --- !ruby/object:Gem::Specification
 name: legato
 version: !ruby/object:Gem::Version
-  version: 0.3.0
-  prerelease: 
+  version: 0.3.1
 platform: ruby
 authors:
 - Tony Pitale
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-01-08 00:00:00.000000000 Z
+date: 2014-06-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
@@ -22,7 +20,6 @@ dependencies:
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
@@ -30,7 +27,6 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
@@ -38,7 +34,6 @@ dependencies:
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
@@ -46,7 +41,6 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: mocha
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
@@ -54,7 +48,6 @@ dependencies:
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
@@ -62,7 +55,6 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: bourne
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
@@ -70,7 +62,6 @@ dependencies:
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
@@ -78,7 +69,6 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: vcr
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - '='
       - !ruby/object:Gem::Version
@@ -86,7 +76,6 @@ dependencies:
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - '='
       - !ruby/object:Gem::Version
@@ -94,7 +83,6 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: fakeweb
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
@@ -102,7 +90,6 @@ dependencies:
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
@@ -110,7 +97,6 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
@@ -118,7 +104,6 @@ dependencies:
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
@@ -126,7 +111,6 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: multi_json
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
@@ -134,7 +118,6 @@ dependencies:
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
@@ -187,9 +170,11 @@ files:
 - spec/integration/management_spec.rb
 - spec/integration/model_spec.rb
 - spec/lib/legato/filter_spec.rb
+- spec/lib/legato/legato_spec.rb
 - spec/lib/legato/list_parameter_spec.rb
 - spec/lib/legato/management/account_spec.rb
 - spec/lib/legato/management/goal_spec.rb
+- spec/lib/legato/management/legato_spec.rb
 - spec/lib/legato/management/profile_spec.rb
 - spec/lib/legato/management/segment_spec.rb
 - spec/lib/legato/management/web_property_spec.rb
@@ -202,27 +187,26 @@ files:
 - spec/support/macros/oauth.rb
 homepage: http://github.com/tpitale/legato
 licenses: []
+metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: 1.8.7
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: legato
-rubygems_version: 1.8.23
+rubygems_version: 2.1.11
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: Access the Google Analytics API with Ruby
 test_files:
 - spec/cassettes/management/accounts.json
@@ -234,9 +218,11 @@ test_files:
 - spec/integration/management_spec.rb
 - spec/integration/model_spec.rb
 - spec/lib/legato/filter_spec.rb
+- spec/lib/legato/legato_spec.rb
 - spec/lib/legato/list_parameter_spec.rb
 - spec/lib/legato/management/account_spec.rb
 - spec/lib/legato/management/goal_spec.rb
+- spec/lib/legato/management/legato_spec.rb
 - spec/lib/legato/management/profile_spec.rb
 - spec/lib/legato/management/segment_spec.rb
 - spec/lib/legato/management/web_property_spec.rb