looker-sdk 0.0.5 → 0.1.1

data/examples/sdk_setup.rb

@@ -1,3 +1,27 @@
+############################################################################################
+# The MIT License (MIT)
+#
+# Copyright (c) 2018 Looker Data Sciences, 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.
+############################################################################################
+
 require 'rubygems'
 require 'bundler/setup'
 

data/examples/streaming_downloads.rb

@@ -1,3 +1,27 @@
+############################################################################################
+# The MIT License (MIT)
+#
+# Copyright (c) 2018 Looker Data Sciences, 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.
+############################################################################################
+
 require './sdk_setup'
 
 # This snippet shows how to download sdk responses using http streaming.

data/examples/users_with_credentials_email.rb

@@ -1,3 +1,27 @@
+############################################################################################
+# The MIT License (MIT)
+#
+# Copyright (c) 2018 Looker Data Sciences, 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.
+############################################################################################
+
 require './sdk_setup'
 
 users = sdk.all_users(:fields => 'id, is_disabled, credentials_email').

data/examples/users_with_credentials_embed.rb

@@ -0,0 +1,33 @@
+############################################################################################
+# The MIT License (MIT)
+#
+# Copyright (c) 2018 Looker Data Sciences, 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.
+############################################################################################
+
+require './sdk_setup'
+
+users = sdk.all_users(fields:'id, is_disabled, display_name, credentials_embed').map do |u|
+  next if u.is_diabled || u.credentials_embed.empty?
+  creds = u.credentials_embed.first
+  [u.id, u.display_name, creds.external_user_id, creds.external_group_id, creds.logged_in_at]
+end.compact
+
+users.each{|u| p u}

data/examples/users_with_credentials_google.rb

@@ -1,4 +1,26 @@
-# sdk.all_users(:fields => 'id,credentials_google').select{|u| u.credentials_google}.map{|u| u.id}
+############################################################################################
+# The MIT License (MIT)
+#
+# Copyright (c) 2018 Looker Data Sciences, 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.
+############################################################################################
 
 require './sdk_setup'
 

data/examples/users_with_credentials_google_without_credentials_email.rb

@@ -1,3 +1,27 @@
+############################################################################################
+# The MIT License (MIT)
+#
+# Copyright (c) 2018 Looker Data Sciences, 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.
+############################################################################################
+
 require './sdk_setup'
 
 users = sdk.all_users(:fields => 'id, is_disabled, credentials_email, credentials_google').

data/lib/looker-sdk/authentication.rb

@@ -1,3 +1,27 @@
+############################################################################################
+# The MIT License (MIT)
+#
+# Copyright (c) 2018 Looker Data Sciences, 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.
+############################################################################################
+
 module LookerSDK
 
   # Authentication methods for {LookerSDK::Client}
@@ -27,7 +51,8 @@ module LookerSDK
 
       set_access_token_from_params(nil)
       without_authentication do
-        post('/login', {}, :query => application_credentials)
+        encoded_auth = Faraday::Utils.build_query(application_credentials)
+        post("#{URI.parse(api_endpoint).path}/login", encoded_auth, header: {:'Content-Type' => 'application/x-www-form-urlencoded'})
         raise "login failure #{last_response.status}" unless last_response.status == 200
         set_access_token_from_params(last_response.data)
       end
@@ -46,7 +71,7 @@ module LookerSDK
 
     def logout
       without_authentication do
-        result = !!@access_token && ((delete('/logout') ; delete_succeeded?) rescue false)
+        result = !!@access_token && ((delete("#{URI.parse(api_endpoint).path}/logout") ; delete_succeeded?) rescue false)
         set_access_token_from_params(nil)
         result
       end

data/lib/looker-sdk/client/dynamic.rb

@@ -1,3 +1,27 @@
+############################################################################################
+# The MIT License (MIT)
+#
+# Copyright (c) 2018 Looker Data Sciences, 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.
+############################################################################################
+
 module LookerSDK
   class Client
 
@@ -25,19 +49,39 @@ module LookerSDK
       def load_swagger
         # We only need the swagger if we are going to be building our own 'operations' hash
         return if shared_swagger && @@sharable_operations[api_endpoint]
-        # Try to load w/o authenticating. Else, authenticate and try again.
-        @swagger ||= without_authentication {try_load_swagger} || try_load_swagger
+        # First, try to load swagger.json w/o authenticating
+        @swagger ||= without_authentication { try_load_swagger }
+
+        unless @swagger
+          # try again, this time with authentication
+          @swagger = try_load_swagger
+        end
+
+        # in unit tests, @swagger may be nil and last_response nil because no HTTP request was made
+        if @swagger.nil?
+          if @last_error
+            raise @last_error
+          else
+            raise "Load of swagger.json failed."
+          end
+        end
+
+        @swagger
       end
 
       def operations
         return @@sharable_operations[api_endpoint] if shared_swagger && @@sharable_operations[api_endpoint]
 
+        if !@swagger && @lazy_swagger
+          load_swagger
+        end
+
         return nil unless @swagger
         @operations ||= Hash[
           @swagger[:paths].map do |path_name, path_info|
             path_info.map do |method, route_info|
               route = @swagger[:basePath].to_s + path_name.to_s
-              [route_info[:operationId], {:route => route, :method => method, :info => route_info}]
+              [route_info[:operationId].to_sym, {:route => route, :method => method, :info => route_info}]
             end
           end.reduce(:+)
         ].freeze
@@ -70,7 +114,7 @@ module LookerSDK
       private
 
       def find_entry(method_name)
-        operations && operations[method_name.to_s] if dynamic
+        operations && operations[method_name.to_sym] if dynamic
       end
 
       def invoke_remote(entry, method_name, *args, &block)
@@ -85,19 +129,25 @@ module LookerSDK
           raise ArgumentError.new("wrong number of arguments (#{params_passed} for #{params_required}) in call to '#{method_name}'. See '#{method_link(entry)}'")
         end
 
-        # substitute the actual params into the route template
-        params.each {|param| route.sub!("{#{param[:name]}}", args.shift.to_s) }
+        # substitute the actual params into the route template, encoding if needed
+        params.each do |param|
+          value = args.shift.to_s
+          if value == CGI.unescape(value)
+            value = CGI.escape(value)
+          end
+          route.sub!("{#{param[:name]}}", value)
+        end
 
         a = args.length > 0 ? args[0] : {}
         b = args.length > 1 ? args[1] : {}
 
         method = entry[:method].to_sym
         case method
-        when :get     then get(route, a, &block)
-        when :post    then post(route, a, merge_content_type_if_body(a, b), &block)
-        when :put     then put(route, a, merge_content_type_if_body(a, b), &block)
-        when :patch   then patch(route, a, merge_content_type_if_body(a, b), &block)
-        when :delete  then delete(route, a) ; @raw_responses ? last_response : delete_succeeded?
+        when :get     then get(route, a, true, &block)
+        when :post    then post(route, a, merge_content_type_if_body(a, b), true, &block)
+        when :put     then put(route, a, merge_content_type_if_body(a, b), true, &block)
+        when :patch   then patch(route, a, merge_content_type_if_body(a, b), true, &block)
+        when :delete  then delete(route, a, true) ; @raw_responses ? last_response : delete_succeeded?
         else raise "unsupported method '#{method}' in call to '#{method_name}'. See '#{method_link(entry)}'"
         end
       end

data/lib/looker-sdk/client.rb

@@ -1,3 +1,27 @@
+############################################################################################
+# The MIT License (MIT)
+#
+# Copyright (c) 2018 Looker Data Sciences, 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.
+############################################################################################
+
 require 'sawyer'
 require 'ostruct'
 require 'looker-sdk/sawyer_patch'
@@ -34,7 +58,9 @@ module LookerSDK
       @original_options = options.dup
 
       load_credentials_from_netrc unless application_credentials?
-      load_swagger
+      if !@lazy_swagger
+        load_swagger
+      end
       self.dynamic = true
     end
 
@@ -65,11 +91,12 @@ module LookerSDK
     #
     # @param url [String] The path, relative to {#api_endpoint}
     # @param options [Hash] Query and header params for request
+    # @param encoded [Boolean] true: url already encoded, false: url needs encoding
     # @param &block [Block] Block to be called with |response, chunk| for each chunk of the body from
     #   the server. The block must return true to continue, or false to abort streaming.
     # @return [Sawyer::Resource]
-    def get(url, options = {}, &block)
-      request :get, url, nil, parse_query_and_convenience_headers(options), &block
+    def get(url, options = {}, encoded=false, &block)
+      request :get, url, nil, parse_query_and_convenience_headers(options), encoded, &block
     end
 
     # Make a HTTP POST request
@@ -77,11 +104,12 @@ module LookerSDK
     # @param url [String] The path, relative to {#api_endpoint}
     # @param data [String|Array|Hash] Body and optionally header params for request
     # @param options [Hash] Optional header params for request
+    # @param encoded [Boolean] true: url already encoded, false: url needs encoding
     # @param &block [Block] Block to be called with |response, chunk| for each chunk of the body from
     #   the server. The block must return true to continue, or false to abort streaming.
     # @return [Sawyer::Resource]
-    def post(url, data = {}, options = {}, &block)
-      request :post, url, data, parse_query_and_convenience_headers(options), &block
+    def post(url, data = {}, options = {}, encoded=false, &block)
+      request :post, url, data, parse_query_and_convenience_headers(options), encoded, &block
     end
 
     # Make a HTTP PUT request
@@ -89,11 +117,12 @@ module LookerSDK
     # @param url [String] The path, relative to {#api_endpoint}
     # @param data [String|Array|Hash] Body and optionally header params for request
     # @param options [Hash] Optional header params for request
+    # @param encoded [Boolean] true: url already encoded, false: url needs encoding
     # @param &block [Block] Block to be called with |response, chunk| for each chunk of the body from
     #   the server. The block must return true to continue, or false to abort streaming.
     # @return [Sawyer::Resource]
-    def put(url, data = {}, options = {}, &block)
-      request :put, url, data, parse_query_and_convenience_headers(options), &block
+    def put(url, data = {}, options = {}, encoded=false, &block)
+      request :put, url, data, parse_query_and_convenience_headers(options), encoded, &block
     end
 
     # Make a HTTP PATCH request
@@ -101,29 +130,32 @@ module LookerSDK
     # @param url [String] The path, relative to {#api_endpoint}
     # @param data [String|Array|Hash] Body and optionally header params for request
     # @param options [Hash] Optional header params for request
+    # @param encoded [Boolean] true: url already encoded, false: url needs encoding
     # @param &block [Block] Block to be called with |response, chunk| for each chunk of the body from
     #   the server. The block must return true to continue, or false to abort streaming.
     # @return [Sawyer::Resource]
-    def patch(url, data = {}, options = {}, &block)
-      request :patch, url, data, parse_query_and_convenience_headers(options), &block
+    def patch(url, data = {}, options = {}, encoded=false, &block)
+      request :patch, url, data, parse_query_and_convenience_headers(options), encoded, &block
     end
 
     # Make a HTTP DELETE request
     #
     # @param url [String] The path, relative to {#api_endpoint}
     # @param options [Hash] Query and header params for request
+    # @param encoded [Boolean] true: url already encoded, false: url needs encoding
     # @return [Sawyer::Resource]
-    def delete(url, options = {}, &block)
-      request :delete, url, nil, parse_query_and_convenience_headers(options)
+    def delete(url, options = {}, encoded=false, &block)
+      request :delete, url, nil, parse_query_and_convenience_headers(options), encoded, &block
     end
 
     # Make a HTTP HEAD request
     #
     # @param url [String] The path, relative to {#api_endpoint}
     # @param options [Hash] Query and header params for request
+    # @param encoded [Boolean] true: url already encoded, false: url needs encoding
     # @return [Sawyer::Resource]
-    def head(url, options = {}, &block)
-      request :head, url, nil, parse_query_and_convenience_headers(options)
+    def head(url, options = {}, encoded=false, &block)
+      request :head, url, nil, parse_query_and_convenience_headers(options), encoded
     end
 
     # Make one or more HTTP GET requests, optionally fetching
@@ -168,7 +200,7 @@ module LookerSDK
       Sawyer::Agent.new(api_endpoint, options) do |http|
         http.headers[:accept] = default_media_type
         http.headers[:user_agent] = user_agent
-        http.authorization('token', @access_token) if token_authenticated?
+        http.headers[:authorization] = "token #{@access_token}" if token_authenticated?
       end
     end
 
@@ -190,10 +222,34 @@ module LookerSDK
     #
     # @return http status code
     def alive
-      get '/alive'
+      without_authentication do
+        get '/alive'
+      end
       last_response.status
     end
 
+    # Are we connected to the server? - Does not attempt to authenticate.
+    def alive?
+      begin
+        without_authentication do
+          get('/alive')
+        end
+        true
+      rescue
+        false
+      end
+    end
+
+    # Are we connected and authenticated to the server?
+    def authenticated?
+      begin
+        ensure_logged_in
+        true
+      rescue
+        false
+      end
+    end
+
     # Response for last HTTP request
     #
     # @return [Sawyer::Response]
@@ -248,12 +304,16 @@ module LookerSDK
       @agent = nil
     end
 
-    def request(method, path, data, options, &block)
+    def request(method, path, data, options, encoded, &block)
       ensure_logged_in
       begin
+        path = path.to_s
+        if !encoded
+          path = URI::Parser.new.escape(path)
+        end
         @last_response = @last_error = nil
         return stream_request(method, path, data, options, &block) if block_given?
-        @last_response = response = agent.call(method, URI::Parser.new.escape(path.to_s), data, options)
+        @last_response = response = agent.call(method, path, data, options)
         @raw_responses ? response : response.data
       rescue StandardError => e
         @last_error = e
@@ -365,15 +425,20 @@ module LookerSDK
 
       # slight modification to the base class' decode_hash_value function to
       # less permissive when decoding time values.
+      # also prevent conversion from non-string types to Time e.g. integer/float timestamp
       #
       # See https://github.com/looker/looker-sdk-ruby/issues/53 for more details
       #
       # Base class function that we're overriding: https://github.com/lostisland/sawyer/blob/master/lib/sawyer/serializer.rb#L101-L121
       def decode_hash_value(key, value)
-        if time_field?(key, value) && value.is_a?(String)
-          begin
-            Time.iso8601(value)
-          rescue ArgumentError
+        if time_field?(key, value)
+          if value.is_a?(String)
+            begin
+              Time.iso8601(value)
+            rescue ArgumentError
+              value
+            end
+          else
             value
           end
         else

data/lib/looker-sdk/configurable.rb

@@ -1,3 +1,27 @@
+############################################################################################
+# The MIT License (MIT)
+#
+# Copyright (c) 2018 Looker Data Sciences, 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.
+############################################################################################
+
 module LookerSDK
 
   # Configuration options for {Client}, defaulting to values
@@ -42,7 +66,8 @@ module LookerSDK
     attr_accessor :access_token, :auto_paginate, :client_id,
                   :client_secret, :default_media_type, :connection_options,
                   :middleware, :netrc, :netrc_file,
-                  :per_page, :proxy, :user_agent, :faraday, :swagger, :shared_swagger, :raw_responses
+                  :per_page, :proxy, :user_agent, :faraday, :swagger, :shared_swagger, :raw_responses,
+                  :lazy_swagger
     attr_writer :web_endpoint, :api_endpoint
 
     class << self
@@ -68,7 +93,8 @@ module LookerSDK
           :shared_swagger,
           :swagger,
           :raw_responses,
-          :web_endpoint
+          :web_endpoint,
+          :lazy_swagger,
         ]
       end
     end

data/lib/looker-sdk/default.rb

@@ -1,3 +1,27 @@
+############################################################################################
+# The MIT License (MIT)
+#
+# Copyright (c) 2018 Looker Data Sciences, 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.
+############################################################################################
+
 require 'looker-sdk/response/raise_error'
 require 'looker-sdk/version'
 
@@ -101,6 +125,12 @@ module LookerSDK
         false
       end
 
+      # Default behavior for loading swagger during initialization or at first call
+      # @return [Boolean]
+      def lazy_swagger
+        false
+      end
+
       def raw_responses
         false
       end