RubyGems - auto-session-timeout - Versions diffs - 0.5 - Mend

auto-session-timeout 0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (11) hide show

data/CHANGELOG +1 -0
data/MIT-LICENSE +16 -0
data/README +107 -0
data/Rakefile +9 -0
data/auto_session_timeout.gemspec +25 -0
data/init.rb +2 -0
data/lib/auto_session_timeout.rb +39 -0
data/lib/auto_session_timeout_helper.rb +13 -0
data/test/auto_session_timeout_test.rb +9 -0
data/test/test_helper.rb +5 -0
metadata +65 -0

data/CHANGELOG ADDED

	@@ -0,0 +1 @@
1	+ 4/22/09 - Initial import [Matthew Bass]

data/MIT-LICENSE ADDED

@@ -0,0 +1,16 @@
+Copyright (c) 2009 Matthew Bass (http://matthewbass.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.

data/README ADDED

@@ -0,0 +1,107 @@
+= auto-session-timeout
+Provides automatic session timeout in a Rails application. Very easy
+to install and configure. Have you ever wanted to force your users
+off your app if they go idle for a certain period of time? Many
+online banking sites use this technique. If your app is used on any
+kind of public computer system, this plugin is a necessity.
+== Installation
+Install the gem directly:
+  sudo gem install pelargir-auto-session-timeout --source=http://gems.github.com
+Or install the gem in your Rails project:
+  script/plugin install git://github.com/pelargir/auto-session-timeout.git
+Or clone the project:
+  git clone git://github.com/pelargir/auto-session-timeout.git
+== Usage
+After installing, tell your application controller to use auto timeout:
+  class ApplicationController < ActionController::Base
+    auto_session_timeout 1.hour
+    ...
+  end
+You will also need to insert this line inside the <body></body> tags in
+your views. The easiest way to do this is to insert it once inside your
+default or application-wide layout. Make sure you are only rendering
+it if the user is logged in, otherwise the plugin will attempt to force
+non-existent sessions to timeout, wreaking havoc:
+  <html>
+    <head>...</head>
+    <body>
+      <% if logged_in? -%>
+        <%= auto_session_timeout_js %>
+      <% end -%>
+      ...
+    </body>
+  </html>
+You need to setup two actions: one to return the session status and
+another that runs when the session times out. You can use the default
+actions included with the plugin by inserting this line in your target
+controller (most likely your user or session controller):
+class SessionsController < ApplicationController
+  auto_session_timeout_actions
+  ...
+end
+To customize the default actions, simply override them. You can call
+the render_session_status and render_session_timeout methods to use
+the default implementation from the plugin, or you can define the
+actions entirely with your own custom code:
+  class SessionsController < ApplicationController
+    def active
+     render_session_status
+    end
+    def timeout
+      render_session_timeout
+    end
+    ...
+  end
+In any of these cases, make sure to properly map the actions in
+your routes.rb file:
+  map.active '/active', :controller => 'sessions', :action => 'active'
+  map.timeout '/timeout', :controller => 'sessions', :action => 'timeout'
+You're done! Enjoy watching your sessions automatically timeout.
+== Additional Configuration
+By default, the JavaScript code checks the server every 60 seconds for
+active sessions. If you prefer that it check more frequently, pass a
+frequency attribute to the helper method. The frequency is given in
+seconds. The following example checks the server every 15 seconds:
+  <html>
+    <head>...</head>
+    <body>
+      <% if logged_in? -%>
+        <%= auto_session_timeout_js :frequency => 15 %>
+      <% end -%>
+      ...
+    </body>
+  </html>
+== Resources
+Repository: http://github.com/pelargir/auto-session-timeout/
+Blog: http://matthewbass.com
+Author: Matthew Bass

data/Rakefile ADDED

@@ -0,0 +1,9 @@
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+task :default => :test
+Rake::TestTask.new('test') do |t|
+  t.pattern = 'test/*_test.rb'
+end

data/auto_session_timeout.gemspec ADDED

@@ -0,0 +1,25 @@
+Gem::Specification.new do |s|
+  s.name     = "auto-session-timeout"
+  s.version  = "0.5"
+  s.date     = "2009-04-22"
+  s.summary  = "Provides automatic session timeout in a Rails application."
+  s.email    = "pelargir@gmail.com"
+  s.homepage = "http://github.com/pelargir/auto-session-timeout"
+  s.description = "Adds several handy expectations for testing ActiveRecord model validations."
+  s.has_rdoc = true
+  s.authors  = ["Matthew Bass"]
+  s.files    = [
+    "auto_session_timeout.gemspec",
+    "CHANGELOG",
+    "init.rb",
+    "lib/auto_session_timeout.rb",
+		"lib/auto_session_timeout_helper.rb",
+    "MIT-LICENSE",
+    "Rakefile",
+		"README",
+		"test/auto_session_timeout_test.rb",
+		"test/test_helper.rb"
+		]
+  s.rdoc_options = ["--main", "README"]
+  s.extra_rdoc_files = ["README"]
+end

data/init.rb ADDED

	@@ -0,0 +1,2 @@
1	+ require 'auto_session_timeout'
2	+ require 'auto_session_timeout_helper'

data/lib/auto_session_timeout.rb ADDED

@@ -0,0 +1,39 @@
+module AutoSessionTimeout
+  def self.included(controller)
+    controller.extend ClassMethods
+    controller.hide_action :render_auto_session_timeout
+  end
+  module ClassMethods
+    def auto_session_timeout(seconds)
+      prepend_before_filter do |c|
+        if c.session[:auto_session_expires_at] && c.session[:auto_session_expires_at] < Time.now
+          c.send :reset_session
+        else
+          unless c.send(:active_url) == c.url_for(c.params)
+            c.session[:auto_session_expires_at] = Time.now + seconds
+          end
+        end
+      end
+    end
+    def auto_session_timeout_actions
+      define_method(:active) { render_session_status }
+      define_method(:timeout) { render_session_timeout }
+    end
+  end
+  def render_session_status
+    response.headers["Etag"] = ""  # clear etags to prevent caching
+    render :text => logged_in?, :status => 200
+  end
+  def render_session_timeout
+    flash[:notice] = "Your session has timed out."
+    redirect_to "/login"
+  end
+end
+ActionController::Base.send :include, AutoSessionTimeout

data/lib/auto_session_timeout_helper.rb ADDED

@@ -0,0 +1,13 @@
+module AutoSessionTimeoutHelper
+  def auto_session_timeout_js(options={})
+    frequency = options[:frequency] || 60
+    code = <<JS
+new Ajax.PeriodicalUpdater('', '/active', {frequency:#{frequency}, method:'get', onSuccess: function(e) {
+	if (e.responseText == 'false') window.location.href = '/timeout';
+}});
+JS
+    javascript_tag(code)
+  end
+end
+ActionView::Base.send :include, AutoSessionTimeoutHelper

data/test/auto_session_timeout_test.rb ADDED

@@ -0,0 +1,9 @@
+require File.dirname(__FILE__) + '/test_helper'
+class AutoSessionTimeoutTest < Test::Unit::TestCase
+  def test_something
+    assert true
+  end
+end

data/test/test_helper.rb ADDED

@@ -0,0 +1,5 @@
+require 'rubygems'
+require 'test/unit'
+require 'action_controller'
+require File.expand_path(File.dirname(__FILE__) + '/../lib/auto_session_timeout')

metadata ADDED

@@ -0,0 +1,65 @@
+--- !ruby/object:Gem::Specification
+name: auto-session-timeout
+version: !ruby/object:Gem::Version
+  version: "0.5"
+platform: ruby
+authors:
+- Matthew Bass
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2009-04-22 00:00:00 -04:00
+default_executable:
+dependencies: []
+description: Adds several handy expectations for testing ActiveRecord model validations.
+email: pelargir@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- README
+files:
+- auto_session_timeout.gemspec
+- CHANGELOG
+- init.rb
+- lib/auto_session_timeout.rb
+- lib/auto_session_timeout_helper.rb
+- MIT-LICENSE
+- Rakefile
+- README
+- test/auto_session_timeout_test.rb
+- test/test_helper.rb
+has_rdoc: true
+homepage: http://github.com/pelargir/auto-session-timeout
+licenses: []
+post_install_message:
+rdoc_options:
+- --main
+- README
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: "0"
+  version:
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: "0"
+  version:
+requirements: []
+rubyforge_project:
+rubygems_version: 1.3.4
+signing_key:
+specification_version: 3
+summary: Provides automatic session timeout in a Rails application.
+test_files: []