Project

memflash

0.01
Low commit activity in last 3 years
A long-lived project that still receives updates
Memflash is a gem which enables storing really long values in the Rails FlashHash without writing them to the session. Instead, it transparently uses `Rails.cache`, thus enabling the flash in your actions to contain large values, and still fit in a cookie-based session store
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

Runtime

>= 5.1, < 7.1
 Project Readme

Build Status

Memflash is a gem which enables storing really long values in the Rails FlashHash without writing them to the session. Instead, it transparently uses Rails.cache, thus enabling the flash in your actions to contain large values, and still fit in a cookie-based session store.

How do I use it?

Memflash is completely transparent -- requiring the gem automatically enhances FlashHash with caching-enabled reads and writes.

By default, any message that is over 300 characters long, will be saved in Rails.cache, and a pointer to it stored in the flash. You can change this anywhere in your app by:

Memflash.threshold = #{length-at-which-writing-to-the-cache-is-trigerred}

How does it work?

Memflash ties into the [] and []= methods of Rails's FlashHash. On writes, if the value being written has a length over Memflash.threshold, Memflash generates a pseudo-random key for it, writes the pseudo-random key and original value to Rails.cache, and stores the original key and pseudo-random key in the flash. Conceptually, when you write flash[:error] = "some message", this is equivalent to:

if "some message".length >=  Memflash.threshold
  # generate a psedudo-random key, memflash_key
  # write memflash_key, "some message" to Rails.cache
  # write :error, memflash_key to the flash
else
  # write :error, "some message" to the flash, as usual
end

On the flip side, reading from the flash, flash[:error] is conceptually equivalent to:

if the value for :error stored in the flash is a memflash key
  # read the original (large) value from Rails.cache
  # return the original (large) value
else
  # return the value stored in the flash, as usual
end

Author

Authored by Vladimir Andrijevik

Copyright and license

Copyright 2013 Zendesk

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

Unless required by applicable law or agreed to in writing, software distributed under the License 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.