RubyGems - cached_resource - Versions diffs - 8.0.0 → 9.0.0 - Mend

@@ -1,209 +0,0 @@
-# CachedResource ![Tests](https://github.com/mhgbrown/cached_resource/actions/workflows/ruby.yml/badge.svg)
-CachedResource is a Ruby gem whose goal is to increase the performance of interacting with web services via ActiveResource by caching responses based on request parameters.  It can help reduce the lag created by making repeated requests across a network.
-## Installation
-```ruby
-gem install cached_resource
-```
-## Compatibility
-CachedResource is designed to be framework agnostic, but will hook into Rails for caching and logging if available. CachedResource supports the following ActiveSupport/Rails (right) and Ruby (down) version combinations:
-| | 🛤️ 4.2 | 🛤️ 5.0 | 🛤️ 5.1 | 🛤️ 6.0 | 🛤️ 6.1 | 🛤️ 7.0 | 🛤️ 7.1 |
-|-------|-----|-----|-----|-----|-----|-----|-----|
-| 💎 2.3   | ✅   | ✅   | ✅   |     |     |     | |
-| 💎 2.4   | ✅   | ✅   | ✅   |     |     |     | |
-| 💎 2.5   | ✅   | ✅   | ✅   | ✅   | ✅   |     | |
-| 💎 2.6   |   ✅   |   ✅  |  ✅   |  ✅   |  ✅   | |
-| 💎 2.7   |     | ✅   | ✅   | ✅   | ✅   | ✅   |✅ |
-| 💎 3.0   |     |     |     | ✅   | ✅   | ✅   | ✅ |
-| 💎 3.1   |     |     |     | ✅   | ✅   | ✅   | ✅ |
-| 💎 3.2   |     |     |     | ✅   | ✅   | ✅   | ✅ |
-| 💎 3.3   |     |  ✅   | ✅    | ✅   | ✅   | ✅   | ✅ |
-## Limitations
-The following are limitations for ActiveResource/Rails versions
-| ActiveSupport Version |                             Limitation                                  |
-|---------------------- | ----------------------------------------------------------------------- |
-| 🛤️ 4.X                |  You cannot chain calls. Ie `Thing.where(fn: 'foo').where(ln: 'bar')`. <br> However, you can still access `original_params` and the `resource_class` and replicate it with <br>`call1 = Thing.where(fn: 'foo')`<br>`call1.resource_class.where(call1.original_params.merge(ln: 'bar'))`  |
-## Configuration
-**Set up CachedResource across all ActiveResources:**
-```ruby
-class ActiveResource::Base
-  cached_resource
-end
-```
-Or set up CachedResource for a single class:
-```ruby
-class MyActiveResource < ActiveResource::Base
-  cached_resource
-end
-```
-### Options
-CachedResource accepts the following options:
-* `:enabled` Default: `true`
-* `:cache_collections` Set to false to always remake a request for collections. Default: `true`
-* `:cache` The cache store that CacheResource should use. Default: The `Rails.cache` if available, or an `ActiveSupport::Cache::MemoryStore`
-* `:collection_arguments` The arguments that identify the principal collection request. Default: `[:all]`
-* `:collection_synchronize` Use collections to generate cache entries for individuals.  Update the existing cached principal collection when retrieving subsets of the principal collection or individuals.  Default: `false`
-* `:concurrent_write` Set to true to make concurrent writes to cache after successful API response. Default: `false`
-    * Requires the [concurrent-ruby](https://rubygems.org/gems/concurrent-ruby) gem
-* `:logger` The logger to which CachedResource messages should be written. Default: The `Rails.logger` if available, or an `ActiveSupport::Logger`
-* `:race_condition_ttl` The race condition ttl, to prevent [dog pile effect](https://en.wikipedia.org/wiki/Cache_stampede) or [cache stampede](https://en.wikipedia.org/wiki/Cache_stampede). Default: 86400
-* `:ttl_randomization_scale` A Range from which a random value will be selected to scale the ttl. Default: `1..2`
-* `:ttl_randomization` Enable ttl randomization. Default: `false`
-* `:ttl` The time in seconds until the cache should expire. Default: `604800`
-You can set them like this:
-```ruby
-cached_resource :cache => MyCacheStore.new, :ttl => 60, :collection_synchronize => true, :logger => MyLogger.new
-```
-You can also change them on the fly.
-Turn CachedResource off.  This will cause all responses to be retrieved normally (i.e. via the network). All responses will still be cached.
-```ruby
-  MyActiveResource.cached_resource.off!
-```
-Turn CachedResource on.
-```ruby
-MyActiveResource.cached_resource.on!
-```
-Set the cache expiry time to 60 seconds.
-```ruby
-MyActiveResource.cached_resource.ttl = 60
-```
-Enable cache expiry time randomization, allowing it to fall randomly between 60 and 120 seconds.
-```ruby
-MyActiveResource.cached_resource.ttl_randomization = true
-```
-Change the cache expiry time randomization scale so that the cache expiry time falls randomly between 30 and 180 seconds.
-```ruby
-MyActiveResource.cached_resource.ttl_randomization_scale = 0.5..3
-```
-Enable collection synchronization.  This will cause a call to `MyActiveResource.all` to also create cache entries for each of its members.  So, for example, a later call to `MyActiveResource.find(1)` will be read from the cache instead of requested from the remote service.
-```ruby
-MyActiveResource.cached_resource.collection_synchronize = true
-```
-Change the arguments that identify the principal collection request.  If for some reason you are concerned with a collection that is retrieved at a "non-standard" URL, you may specify the Ruby arguments that produce that URL.  When `collection_synchronize` is `true`, the collection returned from a request that matches these arguments will be cached and later updated when one of its members or a subset is retrieved.
-```ruby
-MyActiveResource.cached_resource.collection_arguments = [:all, :params => {:name => "Bob"}]
-```
-Set a different logger.
-```ruby
-MyActiveResource.cached_resource.logger = MyLogger.new
-```
-Set a different cache store.
-```ruby
-MyActiveResource.cached_resource.cache = MyCacheStore.new
-```
-### Caveats
-If you set up CachedResource across all ActiveResources or any subclass of ActiveResource that will be inherited by other classes and you want some of those others to have independent CachedResource configurations, then check out the example below:
-```ruby
-class ActiveResource::Base
-  cached_resource
-end
-```
-```ruby
-class MyActiveResource < ActiveResource::Base
-  self.cached_resource = CachedResource::Configuration.new(:collection_synchronize => true)
-end
-```
-## Usage
-Sit back and relax! If you need to reload a particular request you can pass `:reload => true` into the options hash like this:
-```ruby
-MyActiveResource.find(:all, :reload => true)
-```
-If you need to clear the entire cache just do the following:
-```ruby
-MyActiveResource.clear_cache
-```
----
-Sometimes you might have a case the resource pathing is non-unique per call. This can create a situation where your caching the same result for multiple calls:
-```ruby
-MyActiveResource.find(:one, from: "/admin/shop.json")
-```
-Since resources are cached with an argument based key, you may pass in extra data to be appended to the cache key:
-```ruby
-MyActiveResource.find(:one, from: "/admin/shop.json", uid: "unique value")
-```
-## Testing
-To test the Ruby + Rails combination configured by default:
-```bash
-$ rake
-```
-or to test all supported environments...you have to do a little more work...
-Switch your Ruby version to the desired version. This project's maintainer uses `asdf`, so switching to Ruby 3 looks like this:
-```bash
-$ asdf local ruby 3.0.5
-```
-If you have a `Gemfile.lock`, delete it:
-```bash
-$ rm Gemfile.lock
-```
-Then reinstall your dependencies:
-```bash
-$ bundle install
-```
-and finally, run the tests:
-```bash
-$ rake
-```
-If you want to test with a specific Rails version, start over and install dependencies with `TEST_RAILS_VERSION` set:
-```bash
-$ TEST_RAILS_VERSION=6.1 bundle install
-```
-## Credit/Inspiration
-* quamen and [this gist](http://gist.github.com/947734)
-* latimes and [this plugin](http://github.com/latimes/cached_resource)
-## Feedback/Problems
-Feedback is greatly appreciated! Check out this project's [issue tracker](https://github.com/Ahsizara/cached_resource/issues) if you've got anything to say.

@@ -1,7 +0,0 @@
-require "bundler/gem_tasks"
-require 'rspec/core/rake_task'
-desc "Run all examples"
-RSpec::Core::RakeTask.new(:spec)
-task :default => :spec

@@ -1,29 +0,0 @@
-# -*- encoding: utf-8 -*-
-$:.push File.expand_path("../lib", __FILE__)
-require "cached_resource/version"
-Gem::Specification.new do |s|
-  s.name        = "cached_resource"
-  s.version     = CachedResource::VERSION
-  s.authors     = "Morgan Brown"
-  s.email       = "cached_resource@email.mhgbrown.is"
-  s.homepage    = "https://github.com/mhgbrown/cached_resource"
-  s.summary     = %q{Caching for ActiveResource}
-  s.description = %q{Enables request-based caching for ActiveResource}
-  s.licenses    = ['MIT']
-  s.files         = `git ls-files`.split("\n")
-  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
-  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
-  s.require_paths = ["lib"]
-  s.required_ruby_version = '>= 1.9.0'
-  s.add_runtime_dependency "activeresource", ">= 4.0"
-  s.add_runtime_dependency "activesupport", ">= 4.0"
-  s.add_runtime_dependency "nilio", ">= 1.0"
-  s.add_development_dependency "rake"
-  s.add_development_dependency "rspec"
-  s.add_development_dependency "concurrent-ruby", '~> 1.2', '>= 1.2.3'
-end

@@ -1,6 +0,0 @@
-source "http://rubygems.org"
-gem "rails", "~> 4.2.0"
-# https://stackoverflow.com/questions/60226893/rails-nomethoderror-undefined-method-new-for-bigdecimalclass
-# gem "bigdecimal", "1.3.5"

@@ -1,29 +0,0 @@
-require 'spec_helper'
-RSpec.describe CachedResource do
-  before do
-    class BaseThing < ActiveResource::Base
-    end
-    class FirstChildThing < BaseThing
-      self.site = 'http://api.first-child-thing.com'
-      cached_resource
-    end
-    class SecondChildThing < BaseThing
-      self.site = 'http://api.second-child-thing.com'
-    end
-  end
-  after do
-    [:BaseThing, :FirstChildThing, :SecondChildThing].each do |klass|
-      Object.send(:remove_const, klass)
-    end
-  end
-  describe '.inherited' do
-    it 'should include descendants when calling .descendants' do
-      BaseThing.descendants.sort_by { |klass| klass.name }.should == [FirstChildThing, SecondChildThing]
-    end
-  end
-end

@@ -1,3 +0,0 @@
-source "http://rubygems.org"
-gem "rails", "~> 5.0.0"

cached_resource 8.0.0 → 9.0.0