millas 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: b5775286af7b48d9b93680c4d128276e5e74f7db
+  data.tar.gz: aa96ba109df7f26e791aa803a99c3ec0046f3f94
+SHA512:
+  metadata.gz: 9497e7485318d25654645c183eb8b15a6920492476e9d7f1c5bf25537126ba3f9e31cf8c1efe574fd516658006e8ef869332fbe52730793939c2dc946e4aa039
+  data.tar.gz: ea44da53d1f8d4b74ca0836ba4aac8016a9afaf0f6b58b8471c5220a6d6f560525383ba6f441d62efd6ddb1e33ceff862c3f5ea7a0f8f5f859758ba01d2e9771

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2017 Takuya Okuhara
+
+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/README.md

@@ -0,0 +1,88 @@
+# Millas
+
+Millas is a simple cache mechanism. In this mechanism, cached values are dispersed and layered in time.
+
+By the way, Millas is a magic cake which becomes 3 layers when baked once. And it is traditional sweets in Landes (France).
+
+![compressed_thumbnail_square_small](https://user-images.githubusercontent.com/4189626/27506204-9d02d5f0-58ee-11e7-8517-8b16a003fd42.png)
+
+## Mechanism
+
+### Dispersed cache
+
+Cached values whose key is appended random and specified number to the end.
+
+### Layered in time
+
+Expiration time of cached values is Layered.
+
+## Usage
+
+It is not conscious of Milas.
+
+```ruby
+cache = ActiveSupport::Cache::DalliStore.new
+
+cache.write('millas', 'cake', expires_in: 1.minutes)
+# Cache write: millas-1 ({:expires_in=>60 seconds})
+# Cache write: millas-2 ({:expires_in=>120 seconds})
+# Cache write: millas-3 ({:expires_in=>180 seconds})
+=> 90916417477541888
+
+cache.read('millas')
+# Cache read: millas-2
+=> "cake"
+
+cache.exist?('millas')
+# Cache exist: millas-1
+=> true
+
+cache.delete('millas')
+# Cache delete: millas-1
+# Cache delete: millas-2
+# Cache delete: millas-3
+=> true
+```
+
+## Installation
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'dalli'
+gem 'millas'
+```
+
+Or install it yourself as:
+```bash
+$ gem install dalli
+$ gem install millas
+```
+
+## Configuration
+
+```ruby
+Millas.configure do |config|
+  config.dispersion_number = 5 # default
+  config.perform_dispersing = true # default
+  config.second_intervals = 60 # default
+end
+```
+
+If this mechanism is adopted only for a specific part, it should do as follows.
+
+```ruby
+Millas.config.perform_dispersing = false
+
+cache.write('millas', 'cake', expires_in: 1.minutes)
+# Cache write: millas ({:expires_in=>60 seconds})
+=> 883549951894749184
+
+cache.write('millas', 'cake', expires_in: 1.minutes, dispersed: true)
+# Cache write: millas-1 ({:expires_in=>60 seconds})
+# Cache write: millas-2 ({:expires_in=>120 seconds})
+# Cache write: millas-3 ({:expires_in=>180 seconds})
+=> 15366844878541553664
+```
+
+## Copyright
+Copyright (c) 2017 Takuya Okuhara. Licensed under the  [MIT License](http://opensource.org/licenses/MIT).

data/Rakefile

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

data/lib/millas/version.rb

@@ -0,0 +1,3 @@
+module Millas
+  VERSION = '0.0.1'
+end

data/lib/millas.rb

@@ -0,0 +1,99 @@
+require "millas/version"
+require 'active_support'
+require 'active_support/cache/dalli_store'
+require 'active_support/configurable'
+
+module Millas
+  def self.configure(&block)
+    yield @config ||= Millas::Configuration.new
+  end
+
+  def self.config
+    @config
+  end
+
+  class Configuration
+    include ActiveSupport::Configurable
+    config_accessor :dispersion_number, :perform_dispersing, :second_intervals
+  end
+
+  configure do |config|
+    config.dispersion_number = 5
+    config.perform_dispersing = true
+    config.second_intervals = 60
+  end
+end
+
+class ActiveSupport::Cache::DalliStore
+  # monkey patch
+  alias_method :__read__, :read
+  alias_method :__write__, :write
+  alias_method :"__exist?__", :exist?
+  alias_method :__delete__, :delete
+  private :__read__, :__write__, :"__exist?__", :__delete__
+
+  def read(name, options = {})
+    dispersed = options.delete(:dispersed)
+    name = decorated_name(name) if dispersing?(dispersed)
+    __read__(name, options)
+  end
+
+  def write(name, value, options = {})
+    dispersed = options.delete(:dispersed)
+    if dispersing?(dispersed)
+      expires_in = options[:expires_in]
+      dispersions.map do |n|
+        options.merge!({ expires_in: advanced_expires_in(expires_in, n) }) if expires_in
+        __write__(decorated_name(name, n), value, options)
+      end.sample
+    else
+      __write__(name, value, options)
+    end
+  end
+
+  def exist?(name, options = {})
+    dispersed = options.delete(:dispersed)
+    name = decorated_name(name) if dispersing?(dispersed)
+    send("__exist?__", name, options)
+  end
+
+  def delete(name, options = {})
+    dispersed = options.delete(:dispersed)
+    if dispersing?(dispersed)
+      dispersions.map do |n|
+        __delete__(decorated_name(name, n), options)
+      end.sample
+    else
+      __delete__(name, options)
+    end
+  end
+
+  private
+  def dispersion_number
+    number = Millas.config.dispersion_number.try(:to_i)
+    number = 1 if !number || number <= 0
+    number
+  end
+
+  def dispersions
+    [*1..dispersion_number]
+  end
+
+  def dispersing?(dispersed)
+    b = Millas.config.perform_dispersing
+    b = !!dispersed unless dispersed.nil?
+    b
+  end
+
+  def second_intervals
+    (Millas.config.second_intervals || 0).seconds
+  end
+
+  def decorated_name(name, num = nil)
+    "#{name}-#{num || dispersions.sample}"
+  end
+
+  def advanced_expires_in(expires_in, n)
+    expires_in + second_intervals*(n-1)
+  end
+end

metadata

@@ -0,0 +1,105 @@
+--- !ruby/object:Gem::Specification
+name: millas
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Takuya Okuhara
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-06-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  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: dalli
+  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: 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'
+- !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'
+description: Simple and dispersed cache mechanism.
+email:
+- work.okutaku0507@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- MIT-LICENSE
+- README.md
+- Rakefile
+- lib/millas.rb
+- lib/millas/version.rb
+homepage: https://github.com/okutaku0507
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.1
+signing_key: 
+specification_version: 4
+summary: Simple and dispersed cache mechanism.
+test_files: []