looker-sdk 0.1.1 → 0.1.4

data/{readme.md → 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)
+[![Gem Version](https://badge.fury.io/rb/looker-sdk.svg)](https://badge.fury.io/rb/looker-sdk)[![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

data/Rakefile

@@ -1,7 +1,7 @@
 ############################################################################################
 # The MIT License (MIT)
 #
-# Copyright (c) 2018 Looker Data Sciences, Inc.
+# Copyright (c) 2022 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
@@ -25,6 +25,10 @@
 require "bundler/gem_tasks"
 
 require "rake/testtask"
+require 'ci/reporter/rake/minitest'
+
+task :minitest => 'ci:setup:minitest'
+task test: 'minitest'
 Rake::TestTask.new do |t|
   t.libs << "test"
   t.test_files = FileList["test/**/test_*.rb"]

data/examples/add_delete_users.rb

@@ -1,7 +1,7 @@
 ############################################################################################
 # The MIT License (MIT)
 #
-# Copyright (c) 2018 Looker Data Sciences, Inc.
+# Copyright (c) 2022 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

data/examples/change_credentials_email_address_for_users.rb

@@ -1,7 +1,7 @@
 ############################################################################################
 # The MIT License (MIT)
 #
-# Copyright (c) 2018 Looker Data Sciences, Inc.
+# Copyright (c) 2022 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

data/examples/convert_look_to_lookless_tile.rb

@@ -1,7 +1,7 @@
 ############################################################################################
 # The MIT License (MIT)
 #
-# Copyright (c) 2018 Looker Data Sciences, Inc.
+# Copyright (c) 2022 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
@@ -31,7 +31,7 @@ sdk = LookerSDK::Client.new(
   :client_id => ENV['KEY'],
   :client_secret => ENV['SECRET'],
 
-  # API 3.1 URL would look like: https://myhost.com:19999/api/3.1
+  # API 4.0 URL would look like: https://myhost.com:19999/api/4.0
   :api_endpoint => ENV['URL']
 )
 #Set the dashboard here.

data/examples/create_credentials_email_for_users.rb

@@ -1,7 +1,7 @@
 ############################################################################################
 # The MIT License (MIT)
 #
-# Copyright (c) 2018 Looker Data Sciences, Inc.
+# Copyright (c) 2022 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

data/examples/delete_all_user_sessions.rb

@@ -1,7 +1,7 @@
 ############################################################################################
 # The MIT License (MIT)
 #
-# Copyright (c) 2018 Looker Data Sciences, Inc.
+# Copyright (c) 2022 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

data/examples/delete_credentials_google_for_users.rb

@@ -1,7 +1,7 @@
 ############################################################################################
 # The MIT License (MIT)
 #
-# Copyright (c) 2018 Looker Data Sciences, Inc.
+# Copyright (c) 2022 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

data/examples/errors.rb

@@ -0,0 +1,47 @@
+############################################################################################
+# The MIT License (MIT)
+#
+# Copyright (c) 2022 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'
+
+begin
+  puts sdk.validate_theme({}).inspect
+rescue LookerSDK::Error => e
+  puts e
+end
+
+puts "\n\n"
+
+begin
+  puts sdk.connection("foo").inspect
+rescue LookerSDK::Error => e
+  puts e
+end
+
+puts "\n\n"
+
+begin
+  puts sdk.run_look(1,"foo").inspect
+rescue LookerSDK::Error => e
+  puts e
+end

data/examples/generate_password_reset_tokens_for_users.rb

@@ -1,7 +1,7 @@
 ############################################################################################
 # The MIT License (MIT)
 #
-# Copyright (c) 2018 Looker Data Sciences, Inc.
+# Copyright (c) 2022 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

data/examples/ldap_roles_test.rb

@@ -1,7 +1,7 @@
 ############################################################################################
 # The MIT License (MIT)
 #
-# Copyright (c) 2018 Looker Data Sciences, Inc.
+# Copyright (c) 2022 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

data/examples/me.rb

@@ -1,7 +1,7 @@
 ############################################################################################
 # The MIT License (MIT)
 #
-# Copyright (c) 2018 Looker Data Sciences, Inc.
+# Copyright (c) 2022 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

data/examples/refresh_user_notification_addresses.rb

@@ -1,7 +1,7 @@
 ############################################################################################
 # The MIT License (MIT)
 #
-# Copyright (c) 2018 Looker Data Sciences, Inc.
+# Copyright (c) 2022 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

data/examples/roles_and_users_with_permission.rb

@@ -1,7 +1,7 @@
 ############################################################################################
 # The MIT License (MIT)
 #
-# Copyright (c) 2018 Looker Data Sciences, Inc.
+# Copyright (c) 2022 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

data/examples/sdk_setup.rb

@@ -1,7 +1,7 @@
 ############################################################################################
 # The MIT License (MIT)
 #
-# Copyright (c) 2018 Looker Data Sciences, Inc.
+# Copyright (c) 2022 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
@@ -36,10 +36,10 @@ def sdk
 
     # use my local looker with self-signed cert
     :connection_options => {:ssl => {:verify => false}},
-    :api_endpoint => "https://localhost:19999/api/3.0",
+    :api_endpoint => "https://localhost:19999/api/4.0",
 
     # use a real looker the way you are supposed to!
     # :connection_options => {:ssl => {:verify => true}},
-    # :api_endpoint => "https://mycoolcompany.looker.com:19999/api/3.0",
+    # :api_endpoint => "https://mycoolcompany.looker.com:19999/api/4.0",
   )
 end

data/examples/streaming_downloads.rb

@@ -1,7 +1,7 @@
 ############################################################################################
 # The MIT License (MIT)
 #
-# Copyright (c) 2018 Looker Data Sciences, Inc.
+# Copyright (c) 2022 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

data/examples/users_with_credentials_email.rb

@@ -1,7 +1,7 @@
 ############################################################################################
 # The MIT License (MIT)
 #
-# Copyright (c) 2018 Looker Data Sciences, Inc.
+# Copyright (c) 2022 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

data/examples/users_with_credentials_embed.rb

@@ -1,7 +1,7 @@
 ############################################################################################
 # The MIT License (MIT)
 #
-# Copyright (c) 2018 Looker Data Sciences, Inc.
+# Copyright (c) 2022 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

data/examples/users_with_credentials_google.rb

@@ -1,7 +1,7 @@
 ############################################################################################
 # The MIT License (MIT)
 #
-# Copyright (c) 2018 Looker Data Sciences, Inc.
+# Copyright (c) 2022 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

data/examples/users_with_credentials_google_without_credentials_email.rb

@@ -1,7 +1,7 @@
 ############################################################################################
 # The MIT License (MIT)
 #
-# Copyright (c) 2018 Looker Data Sciences, Inc.
+# Copyright (c) 2022 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

data/lib/looker-sdk/authentication.rb

@@ -1,7 +1,7 @@
 ############################################################################################
 # The MIT License (MIT)
 #
-# Copyright (c) 2018 Looker Data Sciences, Inc.
+# Copyright (c) 2022 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

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

@@ -1,7 +1,7 @@
 ############################################################################################
 # The MIT License (MIT)
 #
-# Copyright (c) 2018 Looker Data Sciences, Inc.
+# Copyright (c) 2022 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

data/lib/looker-sdk/client.rb

@@ -1,7 +1,7 @@
 ############################################################################################
 # The MIT License (MIT)
 #
-# Copyright (c) 2018 Looker Data Sciences, Inc.
+# Copyright (c) 2022 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

data/lib/looker-sdk/configurable.rb

@@ -1,7 +1,7 @@
 ############################################################################################
 # The MIT License (MIT)
 #
-# Copyright (c) 2018 Looker Data Sciences, Inc.
+# Copyright (c) 2022 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

data/lib/looker-sdk/default.rb

@@ -1,7 +1,7 @@
 ############################################################################################
 # The MIT License (MIT)
 #
-# Copyright (c) 2018 Looker Data Sciences, Inc.
+# Copyright (c) 2022 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

data/lib/looker-sdk/error.rb

@@ -1,7 +1,7 @@
 ############################################################################################
 # The MIT License (MIT)
 #
-# Copyright (c) 2018 Looker Data Sciences, Inc.
+# Copyright (c) 2022 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
@@ -76,6 +76,40 @@ module LookerSDK
       response_message
     end
 
+    # Error Doc URL
+    #
+    # @return [String]
+    def error_doc_url(documentation_url)
+      return nil unless documentation_url
+      regexp = Regexp.new("https://(?<redirector>docs\.looker\.com\|cloud\.google\.com/looker/docs)/r/err/(?<api_version>.*)/(?<status_code>\\d{3})(?<api_path>.*)", Regexp::IGNORECASE)
+      match_data = regexp.match documentation_url
+      return nil unless match_data
+
+      key = "#{match_data[:status_code]}#{match_data[:api_path].gsub(/\/:([^\/]+)/,"/{\\1}")}"
+      error_doc = error_docs[key] || error_docs[match_data[:status_code]]
+      return nil unless error_doc
+
+      return "https://marketplace-api.looker.com/errorcodes/#{error_doc[:url]}"
+    end
+
+    def error_docs
+      @error_docs ||=
+        begin
+          sawyer_options = {
+            :links_parser => Sawyer::LinkParsers::Simple.new,
+            :serializer  => LookerSDK::Client::Serializer.new(JSON),
+            :faraday => Faraday.new
+          }
+
+          agent = Sawyer::Agent.new("https://marketplace-api.looker.com", sawyer_options) do |http|
+            http.headers[:accept] = 'application/json'
+            #http.headers[:user_agent] = conn_hash[:user_agent]
+          end
+          response = agent.call(:get,"/errorcodes/index.json")
+          response.data || []
+        end
+    end
+
     # Returns most appropriate error for 401 HTTP status code
     # @private
     def self.error_for_401(headers)
@@ -142,6 +176,10 @@ module LookerSDK
     def response_error_summary
       return nil unless data.is_a?(Hash) && !Array(data[:errors]).empty?
 
+      data[:errors].each do |e|
+        edu = error_doc_url(e[:documentation_url])
+        e[:error_doc_url] = edu if edu
+      end
       summary = "\nError summary:\n"
       summary << data[:errors].map do |hash|
         hash.map { |k,v| "  #{k}: #{v}" }
@@ -159,7 +197,8 @@ module LookerSDK
       message << "#{response_message}" unless response_message.nil?
       message << "#{response_error}" unless response_error.nil?
       message << "#{response_error_summary}" unless response_error_summary.nil?
-      message << " // See: #{documentation_url}" unless documentation_url.nil?
+      message << "\n // See: #{documentation_url}" unless documentation_url.nil?
+      message << "\n // And: #{error_doc_url(documentation_url)}" unless error_doc_url(documentation_url).nil?
       message
     end
 

data/lib/looker-sdk/rate_limit.rb

@@ -1,7 +1,7 @@
 ############################################################################################
 # The MIT License (MIT)
 #
-# Copyright (c) 2018 Looker Data Sciences, Inc.
+# Copyright (c) 2022 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

data/lib/looker-sdk/response/raise_error.rb

@@ -1,7 +1,7 @@
 ############################################################################################
 # The MIT License (MIT)
 #
-# Copyright (c) 2018 Looker Data Sciences, Inc.
+# Copyright (c) 2022 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

data/lib/looker-sdk/sawyer_patch.rb

@@ -1,7 +1,7 @@
 ############################################################################################
 # The MIT License (MIT)
 #
-# Copyright (c) 2018 Looker Data Sciences, Inc.
+# Copyright (c) 2022 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

data/lib/looker-sdk/version.rb

@@ -1,7 +1,7 @@
 ############################################################################################
 # The MIT License (MIT)
 #
-# Copyright (c) 2018 Looker Data Sciences, Inc.
+# Copyright (c) 2022 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
@@ -26,6 +26,6 @@ module LookerSDK
 
   # Current version
   # @return [String]
-  VERSION = "0.1.1"
+  VERSION = "0.1.4"
 
 end

data/lib/looker-sdk.rb

@@ -1,7 +1,7 @@
 ############################################################################################
 # The MIT License (MIT)
 #
-# Copyright (c) 2018 Looker Data Sciences, Inc.
+# Copyright (c) 2022 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
@@ -30,20 +30,23 @@ require 'faraday'
 # 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'
+# NOTE: This is not required for Faraday 2+
+if Gem.loaded_specs['faraday'].version < Gem::Version.new('2.0')
+  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'
+end
 
 #require 'rack'
 #require 'rack/mock_response'

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 = '>= 2.5'
+  s.required_ruby_version = '>= 2.7'
   s.requirements = 'Looker version 4.0 or later'  # informational
 
   s.files         = `git ls-files`.split("\n")
@@ -24,5 +24,7 @@ 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', ['>= 1.2', '< 2.0']
+  s.add_dependency 'faraday', ['>= 1.2', '< 3.0']
+  s.add_development_dependency 'ci_reporter_minitest', '~> 1.0'
+  s.add_development_dependency 'faraday', '~> 1.10'
 end

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,7 +1,7 @@
 ############################################################################################
 # The MIT License (MIT)
 #
-# Copyright (c) 2018 Looker Data Sciences, Inc.
+# Copyright (c) 2022 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
@@ -40,11 +40,11 @@ def sdk
     # Support self-signed cert *and* set longer timeout to allow for long running queries.
     :connection_options => {:ssl => {:verify => false}, :request => {:timeout => 60 * 60, :open_timeout => 30}},
 
-    :api_endpoint => "https://localhost:19999/api/3.0",
+    :api_endpoint => "https://localhost:19999/api/4.0",
 
     # Customize to use your specific looker instance
     # :connection_options => {:ssl => {:verify => true}},
-    # :api_endpoint => "https://looker.mycoolcompany.com:19999/api/3.0",
+    # :api_endpoint => "https://looker.mycoolcompany.com:19999/api/4.0",
   )
 end
 

data/shell.nix

@@ -0,0 +1,38 @@
+let
+  nixpkgs = import (builtins.fetchTarball {
+    name = "nixpkgs-21.05";
+    url =
+      "https://github.com/nixos/nixpkgs/archive/f7574a5c8fefd86b50def1827eadb9b8cb266ffd.tar.gz";
+    sha256 = "0pksag38bjdqwvmcxgyc5a31hfz1z201za21v3hb7mqd9b99lnr3";
+  }) { };
+in
+with nixpkgs;
+with stdenv;
+with lib;
+let ruby' = ruby_2_6.withPackages(ps: with ps; [bundler rake]);
+in
+mkShell {
+  name = "cucu-shell";
+  buildInputs = [ ruby' lzma zlib libxml2 ];
+
+  # Looker expects this as the default encoding otherwise does not start
+  LANG = "en_US.UTF-8";
+
+  # https://nixos.org/nixpkgs/manual/#locales
+  LOCALE_ARCHIVE =
+      optionalString isLinux "${glibcLocales}/lib/locale/locale-archive";
+
+  shellHook = ''
+      # FIXME: SSH or tooling that requires libnss-cache (https://github.com/google/libnss-cache)
+      # seems to fail since the library is not present. When I have a better understanding of Nix
+      # let's fix this.
+      # https://github.com/NixOS/nixpkgs/issues/64665#issuecomment-511411309
+      [[ ! -f /lib/x86_64-linux-gnu/libnss_cache.so.2 ]] || export LD_PRELOAD=/lib/x86_64-linux-gnu/libnss_cache.so.2:$LD_PRELOAD
+
+      export GEM_USER_DIR=$(pwd)/.gem
+      export GEM_DEFAULT_DIR=$(${ruby'}/bin/ruby -e 'puts Gem.default_dir')
+      export GEM_PATH=$GEM_DEFAULT_DIR:$GEM_PATH
+      export GEM_HOME=$GEM_USER_DIR
+      export PATH=$GEM_HOME/bin:$PATH
+     '';
+}