https://github.com/sixarm/sixarm_ruby_sign_in

SixArm.com » Ruby » SignIn abstract interface for apps
https://github.com/sixarm/sixarm_ruby_sign_in

authentication gem rails ruby

Last synced: about 2 months ago
JSON representation

SixArm.com » Ruby » SignIn abstract interface for apps

• Host: GitHub
• URL: https://github.com/sixarm/sixarm_ruby_sign_in
• Owner: SixArm
• License: other
• Created: 2010-05-25T04:48:02.000Z (about 16 years ago)
• Default Branch: main
• Last Pushed: 2025-04-14T09:21:08.000Z (about 1 year ago)
• Last Synced: 2025-09-05T05:16:20.428Z (10 months ago)
• Topics: authentication, gem, rails, ruby
• Language: Ruby
• Homepage: http://sixarm.com
• Size: 306 KB
• Stars: 1
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGES.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.md
  • Code of conduct: CODE_OF_CONDUCT.md
  • Citation: CITATION.cff
  • Codeowners: CODEOWNERS

Awesome Lists containing this project

README

          
# SixArm.com → Ruby → 
 SignIn abstract interface for apps

[![Gem Version](https://badge.fury.io/rb/sixarm_ruby_sign_in.svg)](http://badge.fury.io/rb/sixarm_ruby_sign_in)

[![Build Status](https://travis-ci.org/SixArm/sixarm_ruby_sign_in.png)](https://travis-ci.org/SixArm/sixarm_ruby_sign_in)

[![Code Climate](https://api.codeclimate.com/v1/badges/cd93e8c3d46b55ca8cee/maintainability)](https://codeclimate.com/github/SixArm/sixarm_ruby_sign_in/maintainability)

* Git: 

* Doc: 

* Gem: 

* Contact: Joel Parker Henderson, 

* Project: [changes](CHANGES.md), [license](LICENSE.md), [contributing](CONTRIBUTING.md).

## Introduction

SignIn is a simple abstract framework for apps.

You can include this module in a Rails application controller,

then your controller can define any of these concrete methods.

For docs go to 

Want to help? We're happy to get pull requests.

## Install

### Gem

To install this gem in your shell or terminal:

    gem install sixarm_ruby_sign_in

### Gemfile

To add this gem to your Gemfile:

    gem 'sixarm_ruby_sign_in'

### Require

To require the gem in your code:

    require 'sixarm_ruby_sign_in'

## 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