looker-sdk 0.0.6 → 0.1.2

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
 
@@ -272,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

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

data/lib/looker-sdk/error.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 Error < StandardError
 
@@ -21,6 +45,7 @@ module LookerSDK
                   when 409      then LookerSDK::Conflict
                   when 415      then LookerSDK::UnsupportedMediaType
                   when 422      then LookerSDK::UnprocessableEntity
+                  when 429      then LookerSDK::RateLimitExceeded
                   when 400..499 then LookerSDK::ClientError
                   when 500      then LookerSDK::InternalServerError
                   when 501      then LookerSDK::NotImplemented
@@ -211,6 +236,9 @@ module LookerSDK
   # Raised when Looker returns a 422 HTTP status code
   class UnprocessableEntity < ClientError; end
 
+  # Raised when Looker returns a 429 HTTP status code
+  class RateLimitExceeded < ClientError; end
+
   # Raised on errors in the 500-599 range
   class ServerError < Error; end
 

data/lib/looker-sdk/rate_limit.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 for API Rate Limit info

data/lib/looker-sdk/response/raise_error.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 'faraday'
 require 'looker-sdk/error'
 
@@ -6,9 +30,7 @@ module LookerSDK
   module Response
 
     # HTTP status codes returned by the API
-    class RaiseError < Faraday::Response::Middleware
-
-      private
+    class RaiseError < Faraday::Middleware
 
       def on_complete(response)
         if error = LookerSDK::Error.from_response(response)

data/lib/looker-sdk/sawyer_patch.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.
+############################################################################################
+
 # Make Sawyer decode the body lazily.
 # This is a temp monkey-patch until sawyer has: https://github.com/lostisland/sawyer/pull/31
 # At that point we can remove this and update our dependency to the new Sawyer release version.
@@ -30,4 +54,4 @@ module Sawyer
     end
 
   end
-end
+end

data/lib/looker-sdk/version.rb

@@ -1,7 +1,31 @@
+############################################################################################
+# 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
 
   # Current version
   # @return [String]
-  VERSION = "0.0.6"
+  VERSION = "0.1.2"
 
 end

data/lib/looker-sdk.rb

@@ -1,3 +1,53 @@
+############################################################################################
+# 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 'faraday'
+# The Faraday autoload scheme is supposed to work to load other dependencies on demand.
+# It does work, but there are race condition problems upon first load of a given file
+# that have caused intermittent failures in our ruby and integration tests - and could bite in production.
+# The simple/safe solution is to just pre-require these parts that are actually used
+# by the looker-sdk to prevent a race condition later.
+# See https://github.com/lostisland/faraday/issues/181
+# and https://bugs.ruby-lang.org/issues/921
+require 'faraday/autoload'
+require 'faraday/adapter'
+require 'faraday/adapter/rack'
+require 'faraday/adapter/net_http'
+require 'faraday/connection'
+require 'faraday/error'
+require 'faraday/middleware'
+require 'faraday/options'
+require 'faraday/parameters'
+require 'faraday/rack_builder'
+require 'faraday/request'
+require 'faraday/request/authorization'
+require 'faraday/response'
+require 'faraday/utils'
+
+#require 'rack'
+#require 'rack/mock_response'
+
 require 'looker-sdk/client'
 require 'looker-sdk/default'
 

data/looker-sdk.gemspec

@@ -7,15 +7,15 @@ Gem::Specification.new do |s|
   s.version     = LookerSDK::VERSION
   s.date        = "#{Time.now.strftime('%F')}"
   s.authors     = ['Looker']
-  s.email       = 'opensource+sdkruby@looker.com'
-  s.homepage    = 'https://github.com/looker/looker-sdk-ruby'
+  s.email       = 'drstrangelove@google.com'
+  s.homepage    = 'https://github.com/looker-open-source/looker-sdk-ruby'
   s.summary     = %q{Looker Ruby SDK}
   s.description = 'Use this SDK to access the Looker API. The Looker API provides functions to perform administrative '+
       'tasks such as provisioning users, configuring database connections, and so on. It also enables you to leverage '+
       'the Looker data analytics engine to fetch data or render visualizations defined in your Looker data models. '+
       'For more information, see https://looker.com.'
   s.license     = 'MIT'
-  s.required_ruby_version = '>= 1.9.3'
+  s.required_ruby_version = '>= 2.5'
   s.requirements = 'Looker version 4.0 or later'  # informational
 
   s.files         = `git ls-files`.split("\n")
@@ -24,5 +24,5 @@ Gem::Specification.new do |s|
   s.require_paths = %w(lib)
   s.add_dependency 'jruby-openssl' if s.platform == :jruby
   s.add_dependency 'sawyer', '~> 0.8'
-  s.add_dependency 'faraday', ['>= 0.9.0', '< 1.0']
+  s.add_dependency 'faraday', ['>= 1.2', '< 2.0']
 end

data/readme.md

@@ -1,4 +1,5 @@
-# [Looker](http://looker.com/) SDK for Ruby [![Build Status](https://travis-ci.org/looker/looker-sdk-ruby.svg)](https://travis-ci.org/looker/looker-sdk-ruby)
+[![Ruby-CI](https://github.com/looker-open-source/looker-sdk-ruby/actions/workflows/ruby-ci.yml/badge.svg?branch=main)](https://github.com/looker-open-source/looker-sdk-ruby/actions/workflows/ruby-ci.yml)
+# [Looker](http://looker.com/) SDK for Ruby
 ### Overview
 This SDK supports secure/authenticated access to the Looker RESTful API. The SDK binds dynamically to the Looker API and builds mappings for the sets of API methods that the Looker instance exposes. This allows for writing straightforward Ruby scripts to interact with the Looker API. And, it allows the SDK to provide access to new Looker API features in each Looker release without requiring an update to the SDK each time.
 
@@ -14,7 +15,7 @@ When trying to access a resource with the API that the current user is not allow
 
 ### Installation
 ```bash
-$ git clone git@github.com:looker/looker-sdk-ruby.git looker-sdk
+$ git clone git@github.com:looker-open-source/looker-sdk-ruby.git looker-sdk
 $ cd looker-sdk
 $ gem install bundle
 $ bundle install
@@ -23,10 +24,13 @@ $ rake install
 
 ### Development
 
+Rename test/fixtures/.netrc.template to test/fixtures/.netrc and add API3
+credentials for tests to pass.
+Comment out coverage configuration in test/helper.rb for debugging.
 ```bash
 $ bundle install
 $ rake test # run the test suite
-$ rake test:all # run the test suite on all supported Rubies
+$ make install test # run the test suite on all supported Rubies
 ```
 
 ### Basic Usage
@@ -39,7 +43,7 @@ require 'looker-sdk'
 sdk = LookerSDK::Client.new(
   :client_id => "4CN7jzm7yrkcy2MC4CCG",
   :client_secret => "Js3rZZ7vHfbc2hBynSj7zqKh",
-  :api_endpoint => "https://mygreatcompany.looker.com:19999/api/3.0"
+  :api_endpoint => "https://mygreatcompany.looker.com:19999/api/4.0"
 )
 
 # If you don't want to provide explicit credentials: (trust me you don't)
@@ -53,7 +57,7 @@ sdk = LookerSDK::Client.new(
 sdk = LookerSDK::Client.new(
   :netrc      => true,
   :netrc_file => "~/.net_rc",
-  :api_endpoint => "https://mygreatcompany.looker.com:19999/api/3.0",
+  :api_endpoint => "https://mygreatcompany.looker.com:19999/api/4.0",
 
   # Set longer timeout to allow for long running queries. The default is 60 seconds and can be problematic.
   :connection_options => {:request => {:timeout => 60 * 60, :open_timeout => 30}},

data/shell/Gemfile

@@ -2,5 +2,5 @@ source 'https://rubygems.org'
 
 gem 'pry', '~> 0.10.1'
 gem 'netrc', '~> 0.7.7'
-# gem 'looker-sdk',  :git => 'git@github.com:looker/looker-sdk-ruby.git'
+# gem 'looker-sdk',  :git => 'git@github.com:looker-open-source/looker-sdk-ruby.git'
 gem 'looker-sdk',  :path => '../'

data/shell/shell.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/test/helper.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 'simplecov'
 SimpleCov.formatter = SimpleCov::Formatter::MultiFormatter[
     SimpleCov::Formatter::HTMLFormatter
@@ -28,19 +52,45 @@ def fix_netrc_permissions(path)
   File.chmod(0600, path) unless s.mode.to_s(8)[3..5] == "0600"
 end
 
-fix_netrc_permissions(File.join(fixture_path, '.netrc'))
+begin
+  fix_netrc_permissions(File.join(fixture_path, '.netrc'))
+rescue => e
+  puts e
+end
 
 def setup_sdk
   LookerSDK.reset!
+
+  base_url = ENV['LOOKERSDK_BASE_URL'] || 'https://localhost:20000'
+  verify_ssl = case ENV['LOOKERSDK_VERIFY_SSL']
+               when /false/i
+                 false
+               when /f/i
+                 false
+               when '0'
+                 false
+               else
+                 true
+               end
+  api_version = ENV['LOOKERSDK_API_VERSION'] || '4.0'
+  client_id = ENV['LOOKERSDK_CLIENT_ID']
+  client_secret = ENV['LOOKERSDK_CLIENT_SECRET']
+
   LookerSDK.configure do |c|
-    c.connection_options = {:ssl => {:verify => false}}
-    c.netrc = true
-    c.netrc_file =  File.join(fixture_path, '.netrc')
+    c.lazy_swagger = true
+    c.connection_options = {:ssl => {:verify => false}} unless verify_ssl
+    if (client_id && client_secret) then
+      c.client_id = client_id
+      c.client_secret = client_secret
+      c.api_endpoint = "#{base_url}/api/#{api_version}"
+    else
+      c.netrc = true
+      c.netrc_file =  File.join(fixture_path, '.netrc')
+    end
   end
 end
 
 def teardown_sdk
+  setup_sdk  # put back initial config
   LookerSDK.logout
 end
-
-