wrest 2.1.9 → 4.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 69a30e75377430e134d3be264b50b1e97e823152
-  data.tar.gz: f721a616192a527d21afa74c0adba3dd3dfd5b41
+SHA256:
+  metadata.gz: 07fc2ba6c267b466a0caa4366cb63e1657b5966a4140742ed386c6fd657df03f
+  data.tar.gz: f917474be39d0ab7d89a4ba5e652e76798bb51619339dff36ffb0e7453f9b118
 SHA512:
-  metadata.gz: 94db9fae0c8540e80497fb182b2d8634fbc6fdc8e7fd374fe13931b348244513ffaab8128c76369a92b2fb45bd018cbd7817d6529fc80b4ad5077f085fb47165
-  data.tar.gz: 1e411d00090ff33e317774678a9072b20689862f3e2879715f4b5d95baea7b90459a52d7a0e00e21a85b9ac9922d55305018dcf83d99c21ca0eca04e2d83a4ce
+  metadata.gz: 783b115e74659773e4a04de550d713c30a906ecd2e3de517d168d5535a588366164d440fd47782e975d3236aee8d0a66fe37e729f25440ee67592526ee4c89d7
+  data.tar.gz: 7b2ed5a8a9638cc5ead4ac39edbb27a54ac03e5a9da97ec627eaa0e322979ba4ffcf1e3e52bfc2ffe61055d6d2f788d445c242954969971a052989e3eeeecf1e

data/CHANGELOG

@@ -1,7 +1,13 @@
 Features under the section marked 'Current' are completed but pending release as a gem. If you need any of these, you'll need to use the latest source from the git repository.
 
+== Current
+ * Upgrade gems and fix build on Ruby 3.1.2
+
 Features under a numbered section are complete and available in the Wrest gem.
 
+== 2.2.0
+ * Add support for HTTP PATCH [Aditi Raveesh]
+
 == 2.1.9
  * Switch to using concurrent-ruby
 

data/LICENCE

@@ -1,4 +1,4 @@
-Copyright 2009 - 2010 Sidu Ponnappa
+Copyright 2009 - 2022 Sidu Ponnappa
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
 You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0

data/README.md

@@ -1,25 +1,36 @@
-[![Build Status](https://travis-ci.org/c42/wrest.svg?branch=master)](https://travis-ci.org/c42/wrest)
-
-# Wrest 2.1.9
-
-(c) Copyright 2009-2016 [Sidu Ponnappa](http://twitter.com/ponnappa). All Rights Reserved.
-
-Wrest is a ruby REST/HTTP client library which
-
-* Allows you to use Net::HTTP
-* Allows you to pick your Ruby: use 2.x.x, JRuby 9.x.x
+# Wrest 4.0.0.dev
+
+<p align="center"><img src="docs/wrest-logo-320x320.png" width="320"></p>
+<p align="center">
+  <a href="https://rubygems.org/gems/wrest">
+    <img src="https://badge.fury.io/rb/wrest.svg" alt="Gem Version" height="18">
+  </a>
+  <a href="https://github.com/kaiwren/wrest/actions/workflows/ruby.yml">
+    <img src="https://github.com/kaiwren/wrest/actions/workflows/ruby.yml/badge.svg" alt="Ruby" style="max-width: 100%;">    
+  </a>
+  <a href="https://github.com/kaiwren/wrest/actions/workflows/jruby.yml">
+    <img src="https://github.com/kaiwren/wrest/actions/workflows/jruby.yml/badge.svg" alt="JRuby" style="max-width: 100%;">
+  </a>
+  <a href="https://codeclimate.com/github/kaiwren/wrest/maintainability">
+    <img src="https://api.codeclimate.com/v1/badges/dc0366a60000561951ab/maintainability" />
+  </a>
+</p>
+
+
+Wrest is a ruby REST/HTTP client library. It is currently in use at 10x🦄 scale across all Ruby/JRuby systems at [Gojek](https://twitter.com/GojekTech). 
+
+* Quick tool to wrangle APIs to powerful library to build complex production grade systems, Wrest does it all
+* Clean, object-oriented API with URLs as first class entities
 * Supports RFC 2616 based [caching](https://github.com/kaiwren/wrest/blob/caching/Caching.markdown)
-* Async http calls using Threads (reliable only on JRuby) or EventMachine
-* Allows you to quickly build object oriented wrappers around any web service
-* Is designed to be used as a library, not just a command line REST client (fewer class/static methods, more object oriented)
+* Async http calls using Threads (truly useful only on JRuby due to [GIL](https://en.wikipedia.org/wiki/Global_interpreter_lock) limitations on CRuby) or EventMachine
 * Is spec driven, strongly favours immutable objects and avoids class methods and setters making it better suited for use as a library, especially in multi-threaded environments
 * Provides convenient HTTP wrappers, redirect handling, serialisation, deserialisation and xpath based lookup
 
-To receive notifications whenever new features are added to Wrest, please subscribe to my [twitter feed](http://twitter.com/ponnappa).
+Wrest is currently undergoing a substantial clean-up of syntax and dendencies to bring it up to speed on Ruby 3.x and JRuby 9.3.x. This will be released shortly as version 4.0.0.
 
-##Examples
+## Examples
 
-For Facebook, Twitter, Delicious, GitHub and other API examples, see http://github.com/c42/wrest/tree/master/examples
+For Facebook, Twitter, Delicious, GitHub and other API examples, see http://github.com/kaiwren/wrest/tree/master/examples
 
 ### Basic Http Calls
 
@@ -28,16 +39,16 @@ For Facebook, Twitter, Delicious, GitHub and other API examples, see http://gith
 * Basic API calls
 
     ```
-    # Works with json and xml out of the box
+    # Works with json and xml out of the box to give you a hash
     # See lib/wrest/components/translators to add other formats
     
-    'https://api.github.com/repos/c42/wrest/issues'.to_uri.get.deserialize
+    'https://api.github.com/repos/rails/rails/issues'.to_uri.get.deserialize
     ```
 
 * Timeout support
 
     ```
-    'https://api.github.com/repos/c42/wrest/issues'.to_uri.get(timeout: 5).body
+    'https://api.github.com/repos/c42/wrest/issues'.to_uri(timeout: 5).get.body
     ```
 
 * Redirect support
@@ -53,8 +64,6 @@ For Facebook, Twitter, Delicious, GitHub and other API examples, see http://gith
 * Deserialise with XPath filtering
 
     ```
-    ActiveSupport::XmlMini.backend = 'REXML'
-
     'http://twitter.com/statuses/public_timeline.xml'.to_uri.get.deserialise(
                                                   xpath: '//user/name/text()'
                                                 )
@@ -137,7 +146,7 @@ Wrest supports caching with the following pluggable back-ends:
   - Memcached
   - Redis
 
-####Hash
+#### Hash
 
 Use the following method to enable caching for all requests, and set Hash as the default cache store.
 Note: Hash should NEVER be used in a production environment. It is unbounded and will keep increasing in size.
@@ -153,7 +162,7 @@ To use Hash as a cache store in an explicit request (without setting hash as def
     r1 = "http://c42.in".to_uri.using_hash.get
 ```
 
-####Memcached
+#### Memcached
 
 A Memcached based caching back-end is available in Wrest. You can get instructions on how to install Memcached on your system [here](http://code.google.com/p/memcached/wiki/NewInstallFromPackage).
 The Dalli gem is used by Wrest to interface with Memcached. Install dalli using 'gem install dalli'.
@@ -171,7 +180,7 @@ To use Memcached as a cache store in an explicit request (without setting memcac
     r2 = "http://c42.in".to_uri.using_memcached.get
 ```
 
-####Redis
+#### Redis
 
 Wrest also supports a Redis based caching back-end. Follow the guide [here](http://redis.io/topics/quickstart) to install Redis in your system.
 It uses [redis-rd](https://github.com/redis/redis-rb) to interface with Redis. Install redis-rb using `gem install redis`.
@@ -352,17 +361,6 @@ Detailed http debug logging can be turned on like so (DO NOT USE IN PRODUCTION!
     'https://api.github.com/repos/c42/wrest/issues'.to_uri(detailed_http_logging: $stdout).get.deserialize
     ```
 
-
-### Json Backend
-
-Wrest uses the multi_json gem to manage Json backends, allowing it to play nice with Rails 3.1. To change the backend used, you can do the following:
-
-```
-  MultiJson.engine = :json_gem
-```
-
-For more information, look up the [multi_json](http://github.com/intridea/multi_json) documentation.
-
 ### Build
 
 Standard options are available and can be listed using `rake -T`. Use rake:rcov for coverage and rake:rdoc to generate documentation. The link to the continuous integration build is over at the C42 Engineering [open source](http://c42.in/open_source) page.
@@ -396,24 +394,31 @@ You can launch the interactive Wrest shell by running bin/wrest if you have the
 
 Start the Sinatra test server for functional test. The dependencies for the test app are managed separately by a Gemfile under spec/sample_app.
 
+To start the sample application:
+
 ```
-  rake -f spec/sample_app/Rakefile  # runs on port 3000
+  cd spec/sample_app
+  bundle install
+  bundle exec rake  # runs sample app on port 3000
 ```
 
-Start a memcached daemon/process on port 11211
+Start a memcached daemon/process on port 11211 and redis on 6379 (both default ports)
 
 ```
-  /usr/local/bin/memcached
+  brew install memcached
+  brew install redis
+  brew services start memcached
+  brew services start redis
 ```
 
 Run the tests in a different terminal:
 
 ```
   # Run the normal test suite.
-  rake
+  bundle exec rake
 
   # Runs the functional test suite.
-  rake rspec:functional
+  bundle exec rake rspec:functional
 ```
 
 ## Contributors
@@ -427,3 +432,5 @@ Run the tests in a different terminal:
 * Jacques Crocker : [railsjedi](http://github.com/railsjedi)
 * Jasim A Basheer: [jasim](http://github.com/jasim)
 * Arvind Laxminarayan: [ardsrk](http://github.com/ardsrk)
+
+©️ Copyright 2009-2022 [Sidu Ponnappa](http://twitter.com/ponnappa). All Rights Reserved.

data/bin/wrest

@@ -1,3 +1,4 @@
 #!/usr/bin/env ruby
+# frozen_string_literal: true
 
-load(File.dirname(__FILE__)+'/wrest_shell.rb')
+load(File.join(__dir__, 'wrest_shell.rb'))

data/bin/wrest_shell.rb

@@ -1,21 +1,23 @@
+# frozen_string_literal: true
+
 puts "Ruby #{RUBY_VERSION}, #{RUBY_RELEASE_DATE}, #{RUBY_PLATFORM}"
 
-entry_point = File.expand_path "#{File.dirname(__FILE__)}/../lib/wrest.rb"
-version = File.expand_path "#{File.dirname(__FILE__)}/../lib/wrest/version.rb"
+entry_point = File.join(__dir__, '..', 'lib', 'wrest.rb')
+version_file = File.expand_path(File.join(__dir__, '..', 'lib', 'wrest', 'version.rb'))
 
 irb = RUBY_PLATFORM =~ /(:?mswin|mingw)/ ? 'irb.bat' : 'irb'
 
 require 'optparse'
-options = { :irb => irb }
+options = { irb: irb }
 OptionParser.new do |opt|
-  opt.banner = "Usage: console [options]"
+  opt.banner = 'Usage: console [options]'
   opt.on("--irb=[#{irb}]", 'Invoke a different irb.') { |v| options[:irb] = v }
   opt.parse!(ARGV)
 end
 
-libs =  " -r irb/completion"
-libs << " -r #{entry_point}"
+libs = ' -r irb/completion ' \
+       "-r #{entry_point}"
 
-require version
+require version_file
 puts "Loading Wrest #{Wrest::VERSION}"
-exec "#{options[:irb]} #{libs} --simple-prompt"
+exec "#{options[:irb]} #{libs} --simple-prompt"

data/lib/wrest/async_request/event_machine_backend.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Copyright 2009 Sidu Ponnappa
 
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -10,7 +12,7 @@
 begin
   gem 'eventmachine'
 rescue Gem::LoadError => e
-  Wrest.logger.debug "Eventmachine ~> 0.12.10 not found. Wrest uses Eventmachine to perform evented asynchronous requests"
+  Wrest.logger.debug 'Eventmachine ~> 0.12.10 not found. Wrest uses Eventmachine to perform evented asynchronous requests'
   raise e
 end
 

data/lib/wrest/async_request/thread_backend.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Copyright 2009 Sidu Ponnappa
 
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -13,14 +15,15 @@ module Wrest
     # Only recommended for production use on JRuby.
     class ThreadBackend
       attr_reader :thread_pool
+
       def initialize(number_of_threads = 5)
         @thread_pool = ThreadPool.new(number_of_threads)
       end
-      
+
       def execute(request)
         @thread_pool.execute_eventually(request)
       end
-      
+
       # Uses Thread#join to wait until all
       # background requests are completed.
       def wait_for_thread_pool!

data/lib/wrest/async_request/thread_pool.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Copyright 2009-2016 Sidu Ponnappa
 
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -13,12 +15,12 @@ module Wrest
       def initialize(number_of_threads)
         @pool = Concurrent::FixedThreadPool.new(number_of_threads)
       end
-      
+
       def execute_eventually(request)
         @pool.post { request.invoke }
         nil
       end
-      
+
       def join_pool_threads!
         @pool.wait_for_termination
       end

data/lib/wrest/async_request.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Copyright 2009 Sidu Ponnappa
 
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -7,12 +9,11 @@
 # is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 # See the License for the specific language governing permissions and limitations under the License.
 
-
 module Wrest
   module AsyncRequest
     # Loads Wrest eventmachine backend alongwith eventmachine gem
     def self.enable_em
-      require "wrest/async_request/event_machine_backend"
+      require 'wrest/async_request/event_machine_backend'
     end
 
     # Assign default backend to be used for asynchronous request. Default is to use threads
@@ -20,13 +21,13 @@ module Wrest
       @default_backend = backend
     end
 
-    # Assign default backend for asynchronous request to using eventmachine. 
+    # Assign default backend for asynchronous request to using eventmachine.
     def self.default_to_em!
-      self.enable_em
+      enable_em
       self.default_backend = Wrest::AsyncRequest::EventMachineBackend.new
     end
 
-    # Assign default backend for asynchronous request to using threads. 
+    # Assign default backend for asynchronous request to using threads.
     def self.default_to_threads!(number_of_threads = 5)
       self.default_backend = Wrest::AsyncRequest::ThreadBackend.new(number_of_threads)
     end
@@ -35,7 +36,7 @@ module Wrest
     def self.default_backend
       @default_backend || default_to_threads!
     end
-    
+
     # Uses Thread#join to wait until all background requests
     # are completed.
     #

data/lib/wrest/cache_proxy.rb

@@ -1,5 +1,6 @@
-module Wrest
+# frozen_string_literal: true
 
+module Wrest
   class CacheProxy
     class << self
       def new(get, cache_store)
@@ -15,20 +16,21 @@ module Wrest
       def initialize(get)
         @get = get
       end
+
       def get
         @get.invoke_without_cache_check
       end
     end
 
     class DefaultCacheProxy
-      HOP_BY_HOP_HEADERS = ["connection",
-                           "keep-alive",
-                           "proxy-authenticate",
-                           "proxy-authorization",
-                           "te",
-                           "trailers",
-                           "transfer-encoding",
-                           "upgrade"]
+      HOP_BY_HOP_HEADERS = %w[connection
+                              keep-alive
+                              proxy-authenticate
+                              proxy-authorization
+                              te
+                              trailers
+                              transfer-encoding
+                              upgrade].freeze
 
       def initialize(get, cache_store)
         @get         = get
@@ -36,19 +38,15 @@ module Wrest
       end
 
       def log_cached_response
-          Wrest.logger.debug "<*> (GET #{@get.hash}) #{@get.uri.protocol}://#{@get.uri.host}:#{@get.uri.port}#{@get.http_request.path}"
+        Wrest.logger.debug "<*> (GET #{@get.hash}) #{@get.uri.protocol}://#{@get.uri.host}:#{@get.uri.port}#{@get.http_request.path}"
       end
-      
+
       def get
         cached_response = @cache_store[@get.full_uri_string]
-        return get_fresh_response if cached_response.nil?
+        return fresh_get_response if cached_response.nil?
 
         if cached_response.expired?
-          if cached_response.can_be_validated?
-            get_validated_response_for(cached_response)
-          else
-            get_fresh_response
-          end
+          expired_cached_response(cached_response)
         else
           log_cached_response
           cached_response
@@ -57,15 +55,17 @@ module Wrest
 
       def update_cache_headers_for(cached_response, new_response)
         # RFC 2616 13.5.3 (Combining Headers)
-        cached_response.headers.merge!(new_response.headers.select {|key, value| not (HOP_BY_HOP_HEADERS.include? key.downcase)})
+        cached_response.headers.merge!(new_response.headers.reject do |key, _value|
+                                         (HOP_BY_HOP_HEADERS.include? key.downcase)
+                                       end)
       end
 
       def cache(response)
-        @cache_store[@get.full_uri_string] = response.clone if response && response.cacheable?
+        @cache_store[@get.full_uri_string] = response.clone if response&.cacheable?
       end
 
-      #:nodoc:
-      def get_fresh_response
+      # :nodoc:
+      def fresh_get_response
         @cache_store.delete @get.full_uri_string
 
         response = @get.invoke_without_cache_check
@@ -75,10 +75,10 @@ module Wrest
         response
       end
 
-      #:nodoc:
+      # :nodoc:
       def get_validated_response_for(cached_response)
         new_response = send_validation_request_for(cached_response)
-        if new_response.code == "304"
+        if new_response.code == '304'
           update_cache_headers_for(cached_response, new_response)
           log_cached_response
           cached_response
@@ -88,21 +88,32 @@ module Wrest
         end
       end
 
-      #:nodoc:
+      # :nodoc:
       # Send a cache-validation request to the server. This would be the actual Get request with extra cache-validation headers.
       # If a 304 (Not Modified) is received, Wrest would use the cached_response itself. Otherwise the new response is cached and used.
       def send_validation_request_for(cached_response)
         last_modified            = cached_response.last_modified
-        etag                     = cached_response.headers["etag"]
+        etag                     = cached_response.headers['etag']
 
         cache_validation_headers = {}
-        cache_validation_headers["if-modified-since"] = last_modified unless last_modified.nil?
-        cache_validation_headers["if-none-match"] = etag unless etag.nil?
+        cache_validation_headers['if-modified-since'] = last_modified unless last_modified.nil?
+        cache_validation_headers['if-none-match'] = etag unless etag.nil?
 
         new_request = @get.build_request_without_cache_store(cache_validation_headers)
 
         new_request.invoke
       end
+
+      private
+
+      # :nodoc:
+      def expired_cached_response(cached_response)
+        if cached_response.can_be_validated?
+          get_validated_response_for(cached_response)
+        else
+          fresh_get_response
+        end
+      end
     end
   end
-end
+end

data/lib/wrest/caching/memcached.rb

@@ -1,34 +1,37 @@
+# frozen_string_literal: true
+
 begin
   gem 'dalli', '~> 2'
 rescue Gem::LoadError => e
-  Wrest.logger.debug "Dalli ~> 2 not found. The Dalli gem is necessary to use the memcached caching back-end."
+  Wrest.logger.debug 'Dalli ~> 2 not found. The Dalli gem is necessary to use the memcached caching back-end.'
   raise e
 end
 
 require 'dalli'
 
-module Wrest::Caching
-  class Memcached
+module Wrest
+  module Caching
+    class Memcached
+      def initialize(server_urls = nil, options = {})
+        @memcached = Dalli::Client.new(server_urls, options)
+      end
 
-    def initialize(server_urls=nil, options={})
-      @memcached = Dalli::Client.new(server_urls, options)
-    end
+      def [](key)
+        @memcached.get(key)
+      end
 
-    def [](key)
-      @memcached.get(key)
-    end
+      def []=(key, value)
+        @memcached.set(key, value)
+      end
 
-    def []=(key, value)
-      @memcached.set(key, value)
-    end
+      # should be compatible with Hash - return value of the deleted element.
+      def delete(key)
+        value = self[key]
 
-    # should be compatible with Hash - return value of the deleted element.
-    def delete(key)
-      value = self[key]
-      
-      @memcached.delete key
+        @memcached.delete key
 
-      return value
+        value
+      end
     end
   end
 end

data/lib/wrest/caching/redis.rb

@@ -1,38 +1,38 @@
+# frozen_string_literal: true
+
 begin
   gem 'redis', '~> 3'
 rescue Gem::LoadError => e
-  Wrest.logger.debug "Redis ~> 3 not found. The Redis gem is necessary to use redis as a caching back-end."
+  Wrest.logger.debug 'Redis ~> 3 not found. The Redis gem is necessary to use redis as a caching back-end.'
   raise e
 end
 
 require 'redis'
 require 'yaml'
 
-module Wrest::Caching
-  class Redis
+module Wrest
+  module Caching
+    class Redis
+      def initialize(redis_options = {})
+        @redis = ::Redis.new(redis_options)
+      end
 
-    def initialize(redis_options = {})
-      @redis = ::Redis.new(redis_options)
-    end
+      def [](key)
+        value = @redis.get(key)
+        value.nil? ? nil : YAML.unsafe_load(value)
+      end
 
-    def [](key)
-      value = @redis.get(key)
-      unmarshalled_value = value.nil? ? nil : YAML::load(value)
-      unmarshalled_value
-    end
+      def []=(key, response)
+        marshalled_response = YAML.dump(response)
+        @redis.set(key, marshalled_response)
+        @redis.expire(key, response.freshness_lifetime) unless response.expired?
+      end
 
-    def []=(key, response)
-      marshalled_response = YAML::dump(response)
-      @redis.set(key, marshalled_response)
-      unless response.expired?
-        @redis.expire(key, response.freshness_lifetime)
+      def delete(key)
+        value = self[key]
+        @redis.del(key)
+        value
       end
     end
-    
-    def delete(key)
-      value = self[key]
-      @redis.del(key)
-      return value
-    end
   end
 end

data/lib/wrest/caching.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Copyright 2009 Sidu Ponnappa
 
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -9,42 +11,42 @@
 
 module Wrest
   module Caching
-    # Loads the Memcached caching back-end and the Dalli gem 
+    # Loads the Memcached caching back-end and the Dalli gem
     def self.enable_memcached
-      require "wrest/caching/memcached"
+      require 'wrest/caching/memcached'
     end
-    
-    # Loads the Redis caching back-end and the Redis gem 
+
+    # Loads the Redis caching back-end and the Redis gem
     def self.enable_redis
-      require "wrest/caching/redis"
+      require 'wrest/caching/redis'
     end
 
     # Configures Wrest to cache all requests. This will use a Ruby Hash.
-    # WARNING: This should NEVER be used in a real environment. The Hash will 
+    # WARNING: This should NEVER be used in a real environment. The Hash will
     # keep growing since Wrest does not limit the size of a cache store.
     #
     # Please switch to the memcached or redis back-end for production use.
     def self.default_to_hash!
-      self.default_store = Hash.new
+      self.default_store = ({})
     end
 
-    # Default Wrest to using memcached for caching requests. 
+    # Default Wrest to using memcached for caching requests.
     def self.default_to_memcached!
-      self.enable_memcached
-      self.default_store = Wrest::Caching::Memcached.new 
+      enable_memcached
+      self.default_store = Wrest::Caching::Memcached.new
     end
-    
+
     # Default Wrest to using redis for caching requests.
-    # 
+    #
     # Options to configuring the redis gem can be passed as arguments.
     def self.default_to_redis!(redis_options = {})
-      self.enable_redis
+      enable_redis
       self.default_store = Wrest::Caching::Redis.new(redis_options)
     end
 
     # Assign the default cache store to be used. Default is none.
     def self.default_store=(store)
-      @default_store = store 
+      @default_store = store
     end
 
     # Returns the default store for caching, if any is set.