Skip to content
A Ruby on Rails roles solution.
Ruby HTML CSS JavaScript
Branch: master
Clone or download
MartinJNash Merge pull request #12 from evilmint/removes-deprecated-table-exists
Replaces deprecated table_exists with data_source_exists
Latest commit aa8e5bc Jun 8, 2017
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
lib Merge pull request #12 from evilmint/removes-deprecated-table-exists Jun 8, 2017
test
.gitignore Created new extension and added minitest for rails. Aug 17, 2014
Gemfile Created new extension and added minitest for rails. Aug 17, 2014
Gemfile.lock bumped version Sep 22, 2014
MIT-LICENSE Renamed everything to Royce. Aug 21, 2014
README.md added User.available_role_names to readme Sep 17, 2014
Rakefile Renamed everything to Royce. Aug 21, 2014
royce.gemspec Bumped version Sep 16, 2014

README.md

Gem Version

Royce

Roles in Rails.

Installation

Add this to your Gemfile.

gem 'royce'

Be sure to run bundle install.

Run this in your terminal.

rails g royce:install

And run rake db:migrate.

Add this to a model.

royce_roles %w[ owner editor administrator ]

In Depth

Adding royce to a model is super simple. The following code will add the roles user, admin, and editor to your model class. You can pass in an array of strings or symbols. You can even pass in a mixed array of strings and symbols.

class User < ActiveRecord::Base
  royce_roles %w[ user admin editor ] # array of strings
end

class Sailor < ActiveRecord::Base
  royce_roles [ :captain, :bosun, :quartermaster ] # array of symbols
end

class RockAndRoller < ActiveRecord::Base
  royce_roles [ :drummer, 'bassist', :editor ] # array of strings and symbols
end

Now instances of your user class have some roles methods. You can add, remove, query role status, and even ask if an instance can accept such a role.

user = User.create()

user.add_role :user
user.add_role 'user'
user.add_role Royce::Role.find_by(name: 'user')

user.remove_role :user
user.remove_role 'user'
user.remove_role Royce::Role.find_by(name: 'user')

user.has_role? :user
user.has_role? 'user'
user.has_role? Royce::Role.find_by(name: 'user')

user.allowed_role? 'user'
user.allowed_role? :user
user.allowed_role? Royce::Role.find_by(name: 'user')

You also get some conveneint methods to query if a user has a certain named role.

user.admin?
user.editor?
user.user?

You can easily add a role to your model object using our bang! methods.

user.user!
user.admin!
user.editor!

Get a list of roles that a particular user has

user.add_role :user
user.add_role :admin
user.role_list # => ['user', 'admin']

Get a list of all roles available to a class

User.available_role_names # => ['user', 'admin', 'editor']

Not enough. You also get named scopes on your models.

User.admins
User.editors
User.users

If you liked that, you'll LOVE this. We've added the ability to take a role, and return all instances of a class that have that role.

For Users it'll look like this:

admin_role = Royce::Role.find_by(name: 'admin')
admin_role.users.all # Array of user objects
You can’t perform that action at this time.