sixarm_ruby_sign_in 1.1.6

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 1f659858417539c4678e22ecba4172b21bbd4a0a
+  data.tar.gz: bd618ffe352b1a7629ae0c668e56c2f5ee242d61
+SHA512:
+  metadata.gz: 52cf29c31bf1418d9bf6e83eb8e483264d65cf1d3cc438477d3b8fbcb3bc0ea3e9e98cc71923d2a8911f06c4596fd618d2c72314cf3b1401d490b985232aa7b9
+  data.tar.gz: 96807e46ca5cdafd51bd7e40e9ac5efe8e47fee4530163d8ae5b78b3473f3ebeb57245a43345d08a0e92f629dbd3df6c22882a5b03ba0438cff2fba5c2effb17

data/CHANGES.md

@@ -0,0 +1,5 @@
+# Changes
+
+* 2015-07-07 1.1.6 Update gemspec to use file manifest
+* 2012-03-14 1.1.5 Update docs, tests
+* 2010-10-02 1.1.4 Update for Ruby 1.9

data/LICENSE.md

@@ -0,0 +1,28 @@
+# License
+
+You may choose any of these open source licenses:
+
+  * Apache License
+  * BSD License
+  * CreativeCommons License, Non-commercial Share Alike
+  * GNU Affero General Public License (AGPL)
+  * GNU General Public License Version (GPL)
+  * GNU Lesser General Public License (LGPL)
+  * MIT License
+  * Perl Artistic License
+  * Ruby License
+
+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.
+
+This license is for the included software that is created by SixArm.
+Some of the included software may have its own licenses, copyrights,
+authors, etc. and these may take precedence over the SixArm license.
+
+Copyright (c) Joel Parker Henderson

data/README.md

@@ -0,0 +1,94 @@
+# Ruby » <br> SignIn interface for typical Rails user sign in
+
+* Doc: <http://sixarm.com/sixarm_ruby_sign_in/doc>
+* Gem: <http://rubygems.org/gems/sixarm_ruby_sign_in>
+* Repo: <http://github.com/sixarm/sixarm_ruby_sign_in>
+* Email: Joel Parker Henderson, <joel@sixarm.com>
+
+
+## Introduction
+
+Sign In simple abstract framework.
+
+You can include this module in your application controller,
+then your controller can define any of these concrete methods. 
+
+For docs go to <http://sixarm.com/sixarm_ruby_sign_in/doc>
+
+Want to help? We're happy to get pull requests.
+
+
+## Install quickstart
+
+Install:
+
+    gem install sixarm_ruby_sign_in
+
+Bundler:
+
+    gem "sixarm_ruby_sign_in", "~>1.1.4"
+
+Require:
+
+    require "sixarm_ruby_sign_in"
+
+
+## Install with security (optional)
+
+To enable high security for all our gems:
+
+    wget http://sixarm.com/sixarm.pem
+    gem cert --add sixarm.pem
+    gem sources --add http://sixarm.com
+
+To install with high security:
+
+    gem install sixarm_ruby_sign_in --trust-policy HighSecurity
+
+
+## Details
+
+This provides one top-level method:
+
+    sign_in(options=nil) => true for success, false for failure
+
+The top level method will call mid-level methods
+that you will define in your own controller.
+
+sign_in calls:
+
+    sign_in_attempt(options=nil), e.g. authenticate and set current user
+    sign_in_success(options=nil), e.g. redirect to a welcome page
+    sign_in_failure(options=nil), e.g. flash notice help messesage
+
+
+## AuthLogic Example
+
+AuthLogic provides this example:
+
+    def create
+      # sign in attempt
+      @user_session = UserSession.new(params[:user_session])
+      if @user_session.save
+        # sign in success
+        redirect_to account_url
+      else
+        # sign in failure
+        render :action => :new
+      end
+    end
+
+AuthLogic example refactored for improved security and structure:
+
+    def sign_in_attempt
+      @user_session = UserSession.new(params[:user_session])
+      @user_session.save
+    end
+ 
+    def sign_in_success
+      redirect_to account_url
+    end
+
+    def sign_in_failure
+     render :action => :new
+    end

data/Rakefile

@@ -0,0 +1,8 @@
+# -*- coding: utf-8 -*-
+require "rake"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib' << 'test'
+  t.pattern = 'test/*.rb'
+end

data/VERSION

@@ -0,0 +1 @@
+1.1.4

data/lib/sixarm_ruby_sign_in.rb

@@ -0,0 +1,65 @@
+# -*- coding: utf-8 -*-
+=begin rdoc
+Please see README
+=end
+
+
+module SignIn
+
+
+ # The sign_in method calls:
+ # - sign_in_attempt
+ # - sign_in_success (if sign_in_attempt returns true)
+ # - sign_in_failure (if sign_in_attempt returns false or raises a SecurityError)
+
+ def sign_in(options=nil)
+   begin
+    sign_in_attempt(options) or raise SecurityError
+    sign_in_success(options)
+    return true
+   rescue SecurityError
+    sign_in_failure(options)
+    return false
+   end
+ end
+
+
+ # The sign_in method calls this first.
+ #
+ # You override this method to e.g.:
+ # - get a username and password from params
+ # - find the user by username in the user model
+ # - authenticate the user by verifying the password
+ #
+ # If this method succeeds, then control goes to sign_in_success.
+ #
+ # If this method raises an error, then control goes to sign_in_failure.
+
+ def sign_in_attempt(options=nil)
+ end
+
+
+ # The sign_in method calls this second,
+ # iff sign_in_attempt succeeds.
+ #
+ # You override this method to e.g.:
+ # - show the user a flash notice message saying "Welcome..."
+ # - redirect to the user's home page
+ # - customize views based on the user's info
+
+ def sign_in_success(options=nil)
+ end
+
+
+ # The sign_in method calls this second,
+ # iff sign_in_attempt raises an exception.
+ #
+ # You override this method to e.g.:
+ # - show the user a flash warning message saying "Sorry..."
+ # - redirect to a help page
+ # - log the attempt and possibly see if it's a hacker
+
+ def sign_in_failure(options=nil)
+ end
+
+end

data/test/sixarm_ruby_sign_in_test.rb

@@ -0,0 +1,52 @@
+# -*- coding: utf-8 -*-
+require "minitest/autorun"
+require "simplecov"
+SimpleCov.start
+require "sixarm_ruby_sign_in"
+
+class SignInTest < Test::Unit::TestCase
+  
+  include SignIn
+  
+  RIGHT=:foo
+  WRONG=:bar
+  
+  def setup
+   @sign_in_attempt_seen=nil
+   @sign_in_success_seen=nil
+   @sign_in_failure_seen=nil
+ end
+  
+  def test_sign_in_right
+   user=RIGHT
+   x=sign_in(user)
+   assert( @sign_in_attempt_seen,"sign_in_attempt_seen user:#{user}")
+   assert( @sign_in_success_seen,"sign_in_success_seen user:#{user}")
+   assert(!@sign_in_failure_seen,"sign_in_failure_seen user:#{user}")
+   assert_equal(true,x,"sign_in x:#{x}")
+ end
+  
+  def test_sign_in_wrong
+   user=WRONG
+   x=sign_in(user)
+   assert( @sign_in_attempt_seen,"sign_in_attempt seen user:#{user}")
+   assert(!@sign_in_success_seen,"sign_in_success_seen user:#{user}")
+   assert( @sign_in_failure_seen,"sign_in_failure_seen user:#{user}")
+   assert_equal(false,x,"sign_in user:#{x}")
+  end
+  
+  def sign_in_attempt(options=nil)
+   @sign_in_attempt_seen=true
+   if options==WRONG then raise SecurityError end
+   return options==RIGHT
+  end
+
+  def sign_in_success(options=nil)
+    @sign_in_success_seen=true
+  end
+  
+  def sign_in_failure(options=nil)
+   @sign_in_failure_seen=true
+ end
+
+end

metadata

@@ -0,0 +1,92 @@
+--- !ruby/object:Gem::Specification
+name: sixarm_ruby_sign_in
+version: !ruby/object:Gem::Version
+  version: 1.1.6
+platform: ruby
+authors:
+- SixArm
+autorequire: 
+bindir: bin
+cert_chain:
+- |
+  -----BEGIN CERTIFICATE-----
+  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
+  n+ES/gQPOnvmVkLDGw==
+  -----END CERTIFICATE-----
+date: 2015-07-08 00:00:00.000000000 Z
+dependencies: []
+description: Sign In abstraction for a typical web app user
+email: sixarm@sixarm.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gemtest"
+- CHANGES.md
+- LICENSE.md
+- README.md
+- Rakefile
+- VERSION
+- lib/sixarm_ruby_sign_in.rb
+- test/sixarm_ruby_sign_in_test.rb
+homepage: http://sixarm.com/
+licenses:
+- BSD
+- GPL
+- MIT
+- PAL
+- Various
+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.4.8
+signing_key: 
+specification_version: 4
+summary: SixArm.com » Ruby » Sign In
+test_files:
+- test/sixarm_ruby_sign_in_test.rb