async-http-cache 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 923d97088cda9896dcec9c48c21b6142fc9002acfc15ae70a5cb6fac4eacf086
+  data.tar.gz: 9819dd06fa5f44a42c7b9f866477fa163df6e857ce0c5618306f5962f2bbfcc1
+SHA512:
+  metadata.gz: c1ffbd84fe0928014e500f0290a25720581e50ef688e30ad8161fd3b62ea7a6acc21fe2b40a12cf47ef0f3ec2e007e2613f63cb4fdf1518bf324ae88c63b58ad
+  data.tar.gz: e4ece204ed54c4d23c1e831d887ae2b7cb169e702b80e890f4bac5438f393fb31c15a873f494ac1ffcc1d3a88663b4eb12e0abb2c95c9fee4e4f030771158b8c

data/.github/workflows/development.yml

@@ -0,0 +1,34 @@
+name: Development
+
+on: [push, pull_request]
+
+jobs:
+  test:
+    strategy:
+      matrix:
+        os:
+          - ubuntu
+          - macos
+        
+        ruby:
+          - 2.4
+          - 2.5
+          - 2.6
+          - 2.7
+        
+        include:
+          - os: 'ubuntu'
+            ruby: '2.6'
+            env: COVERAGE=PartialSummary,Coveralls
+    
+    runs-on: ${{matrix.os}}-latest
+    
+    steps:
+    - uses: actions/checkout@v1
+    - uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: ${{matrix.ruby}}
+    - name: Install dependencies
+      run: bundle install
+    - name: Run tests
+      run: ${{matrix.env}} bundle exec rspec

data/.gitignore

@@ -0,0 +1,13 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status
+Gemfile.lock
+.covered.db

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--warnings
+--require spec_helper

data/Gemfile

@@ -0,0 +1,4 @@
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in async-http-cache.gemspec
+gemspec

data/README.md

@@ -0,0 +1,68 @@
+# Async::HTTP::Cache
+
+Provides a cache middleware for `Async::HTTP` clients and servers.
+
+[![Development](https://github.com/socketry/async-http-cache/workflows/Development/badge.svg?branch=master)](https://github.com/socketry/async-http-cache/actions?workflow=Development)
+
+## Usage
+
+### Client Side
+
+```ruby
+require 'async'
+require 'async/http'
+require 'async/http/cache'
+
+endpoint = Async::HTTP::Endpoint.parse("https://www.oriontransfer.co.nz")
+client = Async::HTTP::Client.new(endpoint)
+cache = Async::HTTP::Cache::General.new(client)
+
+Async do
+	2.times do
+		response = cache.get("/products/index")
+		puts response.inspect
+		# <Async::HTTP::Protocol::HTTP2::Response ...>
+		# <Async::HTTP::Cache::Response ...>
+		response.finish
+	end
+ensure
+	cache.close
+end
+```
+
+## Vary
+
+The `vary` header creates a headache for proxy implementations, because it creates a combinatorial explosion of cache keys, even if the content is the same. Try to avoid it unless absolutely necessary.
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+
+## License
+
+Released under the MIT license.
+
+Copyright, 2018, by [Samuel G. D. Williams](http://www.codeotaku.com/samuel-williams).
+
+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.

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/async-http-cache.gemspec

@@ -0,0 +1,33 @@
+
+require_relative 'lib/async/http/cache/version'
+
+Gem::Specification.new do |spec|
+	spec.name = "async-http-cache"
+	spec.version = Async::HTTP::Cache::VERSION
+	spec.authors = ["Samuel Williams"]
+	spec.email = ["samuel.williams@oriontransfer.co.nz"]
+	
+	spec.summary = "Standard-compliant cache for async-http."
+	spec.homepage = "https://github.com/socketry/async-http-cache"
+	spec.license = "MIT"
+	
+	spec.required_ruby_version = Gem::Requirement.new(">= 2.3.0")
+	
+	# Specify which files should be added to the gem when it is released.
+	# The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+	spec.files = Dir.chdir(File.expand_path('..', __FILE__)) do
+		`git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+	end
+	
+	spec.require_paths = ["lib"]
+	
+	spec.add_dependency "async-http"
+	spec.add_dependency "protocol-http", "~> 0.14.4"
+	
+	spec.add_development_dependency "async-rspec", "~> 1.10"
+	
+	spec.add_development_dependency "covered"
+	spec.add_development_dependency "bundler"
+	spec.add_development_dependency "rspec"
+	spec.add_development_dependency "rake"
+end

data/lib/async/http/cache.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+# Copyright, 2020, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# 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_relative "cache/version"
+require_relative "cache/general"

data/lib/async/http/cache/body.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+#
+# Copyright, 2020, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# 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 'protocol/http/body/rewindable'
+require 'protocol/http/body/streamable'
+
+module Async
+	module HTTP
+		module Cache
+			module Body
+				def self.wrap(message, &block)
+					if body = message.body
+						# Create a rewindable body wrapping the message body:
+						rewindable = ::Protocol::HTTP::Body::Rewindable.new(body)
+						
+						# Set the message body to the rewindable body:
+						message.body = rewindable
+						
+						# Wrap the message with the callback:
+						::Protocol::HTTP::Body::Streamable.wrap(message) do |error|
+							if error
+								Async.logger.error(self) {error}
+							else
+								yield message, rewindable.buffered
+							end
+						end
+					else
+						yield message, nil
+					end
+					
+					return message
+				end
+			end
+		end
+	end
+end

data/lib/async/http/cache/general.rb

@@ -0,0 +1,126 @@
+# frozen_string_literal: true
+
+# Copyright, 2020, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# 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 'protocol/http/middleware'
+
+require_relative 'body'
+require_relative 'response'
+require_relative 'store'
+
+module Async
+	module HTTP
+		module Cache
+			class General < ::Protocol::HTTP::Middleware
+				CACHE_CONTROL  = 'cache-control'
+				CONTENT_TYPE = 'content-type'
+				AUTHORIZATION = 'authorization'
+				COOKIE = 'cookie'
+				
+				def initialize(app, store: Store.default)
+					super(app)
+					
+					@count = 0
+					
+					@store = store
+				end
+				
+				attr :count
+				attr :store
+				
+				def close
+					@store.close
+				ensure
+					super
+				end
+				
+				def key(request)
+					@store.normalize(request)
+					
+					[request.authority, request.method, request.path]
+				end
+				
+				def cacheable?(request)
+					# We don't support caching requests which have a body:
+					if request.body
+						return false
+					end
+					
+					# We can't cache upgraded requests:
+					if request.protocol
+						return false
+					end
+					
+					# We only support caching GET and HEAD requests:
+					unless request.method == 'GET' || request.method == 'HEAD'
+						return false
+					end
+					
+					if request.headers[AUTHORIZATION]
+						return false
+					end
+					
+					if request.headers[COOKIE]
+						return false
+					end
+					
+					# Otherwise, we can cache it:
+					return true
+				end
+				
+				def wrap(key, request, response)
+					if response.status != 200
+						return response
+					end
+					
+					return Body.wrap(response) do |message, body|
+						Async.logger.debug(self) {"Updating cache for #{key}..."}
+						@store.insert(key, request, Response.new(message, body))
+					end
+				end
+				
+				def call(request)
+					key = self.key(request)
+					
+					cache_control = request.headers[CACHE_CONTROL]
+					
+					unless cache_control&.no_cache?
+						if response = @store.lookup(key, request)
+							Async.logger.debug(self) {"Cache hit for #{key}..."}
+							@count += 1
+							
+							# Create a dup of the response:
+							return response
+						end
+					end
+					
+					unless cache_control&.no_store?
+						if cacheable?(request)
+							return wrap(key, request, super)
+						end
+					end
+					
+					return super
+				end
+			end
+		end
+	end
+end

data/lib/async/http/cache/response.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+# Copyright, 2020, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# 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 'protocol/http/response'
+require 'async/clock'
+
+module Async
+	module HTTP
+		module Cache
+			class Response < ::Protocol::HTTP::Response
+				CACHE_CONTROL = 'cache-control'
+				SET_COOKIE = 'set-cookie'
+				
+				def initialize(response, body)
+					@generated_at = Async::Clock.now
+					
+					super(
+						response.version,
+						response.status,
+						response.headers.dup,
+						body,
+						response.protocol
+					)
+					
+					@max_age = @headers[CACHE_CONTROL]&.max_age
+				end
+				
+				attr :generated_at
+				
+				def cachable?
+					if cache_control = @headers[CACHE_CONTROL]
+						if cache_control.private? || !cache_control.public?
+							return false
+						end
+					end
+					
+					if set_cookie = @headers[SET_COOKIE]
+						Async.logger.warn(self) {"Cannot cache response with set-cookie header!"}
+						return false
+					end
+					
+					return true
+				end
+				
+				def age
+					Async::Clock.now - @generated_at
+				end
+				
+				def expired?
+					self.age > @max_age
+				end
+				
+				def dup
+					dup = super
+					
+					dup.body = @body.dup
+					dup.headers = @headers.dup
+					
+					return dup
+				end
+			end
+		end
+	end
+end

data/lib/async/http/cache/store.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+# Copyright, 2020, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# 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_relative 'store/memory'
+require_relative 'store/vary'
+
+module Async
+	module HTTP
+		module Cache
+			module Store
+				def self.default
+					Vary.new(Memory.new)
+				end
+			end
+		end
+	end
+end

data/lib/async/http/cache/store/memory.rb

@@ -0,0 +1,109 @@
+# frozen_string_literal: true
+
+# Copyright, 2020, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# 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 Async
+	module HTTP
+		module Cache
+			module Store
+				class Memory
+					def initialize(limit: 1024)
+						@index = {}
+						@limit = limit
+						
+						@hit = 0
+						@miss = 0
+						@pruned = 0
+						
+						@gardener = Async do |task|
+							while true
+								task.sleep(60)
+								
+								pruned = self.prune
+								@pruned += pruned
+								
+								Async.logger.debug(self) do |buffer|
+									if pruned > 0
+										buffer.puts "Pruned #{pruned} entries."
+									end
+									
+									buffer.puts "Hits: #{@hit} Misses: #{@miss} Pruned: #{@pruned} Ratio: #{(100.0*@hit/@miss).round(2)}%"
+									
+									body_usage = @index.sum{|key, value| value.body.length}
+									buffer.puts "Index size: #{@index.size} Memory usage: #{(body_usage / 1024.0**2).round(2)}MiB"
+									
+									# @index.each do |key, value|
+									# 	buffer.puts "#{key.join('-')}: #{value.body.length}B"
+									# end
+								end
+							end
+						end
+					end
+					
+					def close
+						@gardener.stop
+					end
+					
+					attr :index
+					
+					def lookup(key, request)
+						if response = @index[key]
+							if response.expired?
+								@index.delete(key)
+								
+								@pruned += 1
+								
+								return nil
+							end
+							
+							@hit += 1
+							
+							return response.dup
+						else
+							@miss += 1
+							
+							return nil
+						end
+					end
+					
+					def insert(key, request, response)
+						if @index.size < @limit
+							if response.body.length < 1024*64
+								@index[key] = response
+							end
+						end
+					end
+					
+					# @return [Integer] the number of pruned entries.
+					def prune
+						initial_count = @index.size
+						
+						@index.delete_if do |key, value|
+							value.expired?
+						end
+						
+						return initial_count - @index.size
+					end
+				end
+			end
+		end
+	end
+end

data/lib/async/http/cache/store/vary.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+# Copyright, 2020, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# 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 Async
+	module HTTP
+		module Cache
+			module Store
+				VARY = 'vary'
+				ACCEPT_ENCODING = 'accept-encoding'
+				
+				class Vary
+					def initialize(delegate, vary = {})
+						@delegate = delegate
+						@vary = vary
+					end
+					
+					def close
+						@delegate.close
+					end
+					
+					attr :delegate
+					
+					def normalize(request)
+						if accept_encoding = request.headers[ACCEPT_ENCODING]
+							if accept_encoding.include?("gzip")
+								request.headers.set(ACCEPT_ENCODING, "gzip")
+							else
+								request.headers.delete(ACCEPT_ENCODING)
+							end
+						end
+					end
+					
+					def key_for(headers, vary)
+						vary.map{|key| headers[key]}
+					end
+					
+					def lookup(key, request)
+						if vary = @vary[key]
+							# We should provide user-supported normalization here:
+							key = key + key_for(request.headers, vary)
+						end
+						
+						return @delegate.lookup(key, request)
+					end
+					
+					def insert(key, request, response)
+						if vary = response.headers[VARY]&.sort
+							@vary[key] = vary
+							
+							key = key + key_for(request.headers, vary)
+						end
+						
+						@delegate.insert(key, request, response)
+					end
+				end
+			end
+		end
+	end
+end

data/lib/async/http/cache/version.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+# Copyright, 2020, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# 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 Async
+	module HTTP
+		module Cache
+			VERSION = "0.1.1"
+		end
+	end
+end

metadata

@@ -0,0 +1,156 @@
+--- !ruby/object:Gem::Specification
+name: async-http-cache
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Samuel Williams
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2020-03-12 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: async-http
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: protocol-http
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.14.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.14.4
+- !ruby/object:Gem::Dependency
+  name: async-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+- !ruby/object:Gem::Dependency
+  name: covered
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: 
+email:
+- samuel.williams@oriontransfer.co.nz
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".github/workflows/development.yml"
+- ".gitignore"
+- ".rspec"
+- Gemfile
+- README.md
+- Rakefile
+- async-http-cache.gemspec
+- lib/async/http/cache.rb
+- lib/async/http/cache/body.rb
+- lib/async/http/cache/general.rb
+- lib/async/http/cache/response.rb
+- lib/async/http/cache/store.rb
+- lib/async/http/cache/store/memory.rb
+- lib/async/http/cache/store/vary.rb
+- lib/async/http/cache/version.rb
+homepage: https://github.com/socketry/async-http-cache
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.3.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.2
+signing_key: 
+specification_version: 4
+summary: Standard-compliant cache for async-http.
+test_files: []