0.01
The project is in a healthy, maintained state
Local Memoization Pattern to store complex and repeated computations in memory until the next hour/day/week
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
 Project Readme

MemoizeUntil

This gem is an extension to the standard memoization pattern for storing expensive computations or network calls in-memory. Unlike other memoization extensions which expire after a pre-defined interval, this gem provides a consistent memoization behavior across multiple processes/servers i.e. keys expire simultaneously across all processes.

Usage:

gem install memoize_until
> irb
irb:> require 'memoize_until'
irb:> result = MemoizeUntil.day(:default) do
irb:> 	# PerformSomeComplexOperation
irb:> end # memoizes(until the end of the day) and returns the result of #PerformSomeComplexOperation
irb:> p result.inspect

The default API that the gem provides is: MemoizeUntil#min, MemoizeUntil#hour, MemoizeUntil#day, MemoizeUntil#week, MemoizeUntil#month with default purposes(keys).

To add new purposes during run_time, you can also leverage the add_to API:

irb:> MemoizeUntil.add_to(:day, :runtime_key) 
irb:> result = MemoizeUntil.day(:runtime_key) do
irb:> 	# PerformSomeComplexRuntimeOperation
irb:> end # memoizes(until the end of the day) and returns the result of #PerformSomeComplexOperation
irb:> p result.inspect

The same can be done for other default kinds as well: min, hour, week, month

Rails

To use this gem in a rails application, add the following line to your Gemfile and you are good to go.

gem 'memoize_until'

For most use cases, the list of purposes that come will not suffice. You can define your custom list of config purposes that you wish to memoize for, by including a config/memoize_until.yml in the root directory of your application. Here is an example to help you with the file structure.

Testing

To clear the currently memoized value for a purpose, you can use the clear_now API.

irb:> MemoizeUntil.day(:default) { 1 } # 1
irb:> MemoizeUntil.clear_now_for(:day, :default) 
irb:> MemoizeUntil.day(:default) { 2 } # 2

Note: This API only clears the currently memoized value in the current running process and will not mitigate to other processes in a multiprocess world. This is recommended to be used only for testing setup.

Contributing

To run test cases,

bundle install
ruby -Ilib:test test/memoize_until_test.rb

This project is Licensed under the MIT License. Further details can be found here.