https://github.com/kodius/userswitch

Avoid the pain of manual switching user roles while developing
https://github.com/kodius/userswitch

development rails tweaks

Last synced: about 2 months ago
JSON representation

Avoid the pain of manual switching user roles while developing

• Host: GitHub
• URL: https://github.com/kodius/userswitch
• Owner: kodius
• License: mit
• Created: 2017-03-31T07:23:07.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2017-04-11T09:05:30.000Z (almost 8 years ago)
• Last Synced: 2024-08-09T14:03:01.862Z (5 months ago)
• Topics: development, rails, tweaks
• Language: Ruby
• Homepage:
• Size: 733 KB
• Stars: 19
• Watchers: 5
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
# UserSwitch

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

User Switch is a Rails plugin for switching between commonly used roles and users. It's particularly useful for development and staging environments when you often need to switch between various accounts. It saves you from the hassle of logging in or out.

![alt](https://cloud.githubusercontent.com/assets/17185440/24801547/f2cb2c8a-1ba4-11e7-87a6-59911794d6c7.png)

## Example

By default, the gem will output a chain of buttons as follows

By clicking on a button, your Rails app will switch to a different user, that is, your session will change to that of a different account and save you the time you might otherwise spend clicking on logout links and filling in forms to log as a different user.

Different roles have different colors so as to be more noticeable. If we put mulitple "same role" users for testing, we can still see by color coding what role it belongs to.

![alt](https://cloud.githubusercontent.com/assets/17185440/24800120/04b1a614-1b9f-11e7-9584-3392ca40f125.gif)

## Requirements

```ruby

gem 'bootstrap'

gem 'devise'

```

## How to install

Add it to your app's Gemfile and run bundle

```ruby

gem 'userswitch'

```

or install it manually

```ruby

gem install userswitch

```

## How to use

Create userswitch.yml inside you config folder with:

```ruby

rake userswitch:install

```

Inside of your template/view, you can call users with (showing only users from your userswitch.yml file):

```ruby

Userswitch.users(current_user)

```

The above command will generate the required HTML output to make the user switching work.