the_role_api 3.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: c6feb8f1b2ac1d6ff4f3431e798270b81a417384
+  data.tar.gz: d2462e9c3e33a78ebbff6ac81a1d7db24d2bc9a1
+SHA512:
+  metadata.gz: 8ff2519a6720381adbab46b1e38b3cc6300c17f1aa28e8412892ca6c28d76a3b4b025a762ceeefb39957e956bb9d92e0e970c3096bf666834d06dd12a52e3a05
+  data.tar.gz: 881695e000bce52d937db5928e817d2c2b3c59b9a878d43d5b677c9cf7da9bd9762f1d7b0f7e4d1598aac81bccb208a3f90745761c0d4c8b90d618c94c134d48

data/.gitignore

@@ -0,0 +1,33 @@
+*.gem
+*.rbc
+
+.bundle
+.config
+.yardoc
+
+.rvmrc
+.ruby-gemset
+.ruby-version
+
+_yardoc
+coverage
+Gemfile.lock
+InstalledFiles
+lib/bundler/man
+spec/dummy_app/public/assets
+
+tmp
+doc
+pkg
+rdoc
+
+test/tmp
+spec/reports
+test/version_tmp
+
+.DS_Store
+.LSOverride
+.AppleDouble
+.idea
+
+# find . -name ".DS_Store" -delete

data/Gemfile

@@ -0,0 +1,5 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in the_role.gemspec
+gemspec
+

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2015 Ilya N. Zykin
+
+MIT License
+
+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.md

@@ -0,0 +1,88 @@
+<h2 align="center" class='center' style="text-align:center">
+  TheRole::Api. Role model and general API methods
+</h2>
+
+<p align="center" class='center' style="text-align:center">
+  <b>Authorization gem for Ruby on Rails</b><br>
+  <i>with <a href="https://github.com/TheRole/TheRoleManagementPanelBootstrap3">Management Panel</a></i>
+</p>
+
+<p align="center" class='center' style="text-align:center">
+  <img src="https://raw.githubusercontent.com/TheRole/docs/master/images/the_role.png" alt="TheRole. Authorization gem for Ruby on Rails with Administrative interface">
+</p>
+
+<p align="center" class='center' style="text-align:center">
+  <b>Semantic. Flexible. Lightweigh</b>
+</p>
+
+<div align="center" class='center' style="text-align:center">
+
+<a href="http://badge.fury.io/rb/the_role"><img src="https://badge.fury.io/rb/the_role.svg" alt="Gem Version" height="18"></a>
+&nbsp;
+<a href="https://travis-ci.org/TheRole/DummyApp"><img src="https://travis-ci.org/TheRole/DummyApp.svg?branch=master" alt="Build Status" height="18"></a>
+&nbsp;
+<a href="https://codeclimate.com/github/TheRole/TheRoleApi"><img src="https://codeclimate.com/github/TheRole/TheRoleApi/badges/gpa.svg" /></a>
+&nbsp;
+<a href="https://www.ruby-toolbox.com/categories/rails_authorization">ruby-toolbox</a>
+</div>
+
+<hr>
+
+<div align="center" class='center' style="text-align:center">
+  <a href="https://github.com/TheRole/docs/blob/master/TheRoleAPI.md">
+    <img src="https://raw.githubusercontent.com/TheRole/docs/master/images/api.png" alt="TheRole API">
+  </a>
+</div>
+
+<div align="center" class='center' style="text-align:center">
+  <a href="https://github.com/TheRole/docs/blob/master/TheRoleAPI.md">
+    <img src="https://raw.githubusercontent.com/TheRole/docs/master/images/install.png?2" alt="TheRole. Installation">
+  </a>
+</div>
+
+<div align="center" class='center' style="text-align:center">
+  <a href="https://github.com/TheRole/docs/blob/master/IntegrationWithRailsControllers.md">
+    <img src="https://raw.githubusercontent.com/TheRole/docs/master/images/int_ctrl.png" alt="Integration with Rails controllers">
+  </a>
+</div>
+
+<div align="center" class='center' style="text-align:center">
+  <a href="https://github.com/TheRole/docs/blob/master/IntegrationWithRailsViews.md">
+    <img src="https://raw.githubusercontent.com/TheRole/docs/master/images/int_views.png" alt="Integration with Rails views">
+  </a>
+</div>
+
+<div align="center" class='center' style="text-align:center">
+  <a href="https://github.com/TheRole/docs/blob/master/UsingWithStrongParameters.md">
+    <img src="https://raw.githubusercontent.com/TheRole/docs/master/images/int_params.png" alt="Using with Strong Parameters">
+  </a>
+</div>
+
+<div align="center" class='center' style="text-align:center">
+  <a href="https://github.com/TheRole/docs/blob/master/TheRoleGuiInstallation.md">
+    <img src="https://raw.githubusercontent.com/TheRole/docs/master/images/install_gui.png" alt="TheRole GUI. Installation">
+  </a>
+</div>
+
+<div align="center" class='center' style="text-align:center">
+  <a href="https://github.com/the-teacher/the_role">
+    <img src="https://raw.githubusercontent.com/TheRole/docs/master/images/main.png" alt="gem TheRole">
+  </a>
+</div>
+
+<hr>
+
+### MIT License
+
+[MIT License](https://github.com/TheRole/docs/blob/master/LICENSE.md)
+Copyright (c) 2012-2015 [Ilya N.Zykin](https://github.com/the-teacher)
+
+#### Maintainers
+
+[@the-teacher](https://github.com/the-teacher),
+[@sedx](https://github.com/sedx),
+[@seuros](https://github.com/seuros)
+
+#### Contributors
+
+@igmarin, @doabit, @linjunpop, @egb3

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/app/controllers/concerns/the_role/controller.rb

@@ -0,0 +1,53 @@
+module TheRole
+  module Controller
+    def login_required
+      send TheRole.config.login_required_method
+    end
+
+    def role_access_denied
+      access_denied_method = TheRole.config.access_denied_method
+      return send(access_denied_method) if access_denied_method && respond_to?(access_denied_method)
+
+      the_role_default_access_denied_response
+    end
+
+    private
+
+    def for_ownership_check obj
+      @owner_check_object = obj
+    end
+
+    def role_required
+      role_access_denied unless current_user.try(:has_role?, controller_path, action_name)
+    end
+
+    def owner_required
+      role_access_denied unless current_user.try(:owner?, @owner_check_object)
+    end
+
+    def the_role_default_access_denied_response
+      access_denied_msg = t(:access_denied, scope: :the_role)
+
+      if request.xhr?
+        render json: {
+          errors: { the_role: [ access_denied_msg ] },
+
+          controller_name:      controller_path,
+          action_name:          action_name,
+          has_access_to_action: current_user.try(:has_role?, controller_path, action_name),
+
+          current_user: { id: current_user.try(:id) },
+
+          owner_check_object: {
+            owner_check_object_id:    @owner_check_object.try(:id),
+            owner_check_object_class: @owner_check_object.try(:class).try(:to_s)
+          },
+
+          has_access_to_object: current_user.try(:owner?, @owner_check_object)
+        }, status: 401
+      else
+        redirect_to :back, flash: { error: access_denied_msg }
+      end
+    end
+  end
+end

data/app/models/_templates_/role.rb

@@ -0,0 +1,3 @@
+class Role < ActiveRecord::Base
+  include TheRole::Api::Role
+end

data/app/models/concerns/the_role/api/base_methods.rb

@@ -0,0 +1,46 @@
+module TheRole
+  module Api
+    module BaseMethods
+      def has_section? section_name
+        hash         =  role_hash
+        section_name =  section_name.to_slug_param(sep: '_')
+        return true  if hash[section_name]
+
+        false
+      end
+
+      def has_role? section_name, rule_name
+        hash         =  role_hash
+        section_name =  section_name.to_slug_param(sep: '_')
+        rule_name    =  rule_name.to_slug_param(sep: '_')
+
+        return true  if hash.try(:[], 'system').try(:[], 'administrator')
+        return true  if hash.try(:[], 'moderator').try(:[], section_name)
+
+        return false unless hash[section_name]
+        return false unless hash[section_name].key? rule_name
+
+        hash[section_name][rule_name]
+      end
+
+      def any_role? roles_hash = {}
+        roles_hash.each_pair do |section, rules|
+          return false unless[ Array, String, Symbol ].include?(rules.class)
+          return has_role?(section, rules) if [ String, Symbol ].include?(rules.class)
+          rules.each{ |rule| return true if has_role?(section, rule) }
+        end
+
+        false
+      end
+
+      def moderator? section_name
+        section_name = section_name.to_slug_param(sep: '_')
+        has_role? section_name, 'any_crazy_name'
+      end
+
+      def admin?
+        has_role? 'any_crazy_name', 'any_crazy_name'
+      end
+    end
+  end
+end

data/app/models/concerns/the_role/api/role.rb

@@ -0,0 +1,168 @@
+module TheRole
+  module Api
+    module Role
+      extend ActiveSupport::Concern
+
+      include TheRole::Api::BaseMethods
+
+      def the_role= val
+        self[:the_role] = _jsonable val
+      end
+
+      def role_hash;
+        to_hash;
+      end
+
+      alias_method :has?, :has_role?
+      alias_method :any?, :any_role?
+
+      def has_section? section_name
+        to_hash.key? section_name.to_slug_param(sep: '_')
+      end
+
+      included do
+        attr_accessor :based_on_role
+
+        has_many  :users, dependent: TheRole.config.destroy_strategy
+        validates :name,  presence: true, uniqueness: true
+        validates :title, presence: true, uniqueness: true
+        validates :description, presence: true
+
+        private
+
+        before_save do
+          self.name = name.to_slug_param(sep: '_')
+
+          rules_set     = self.the_role
+          self.the_role = {}.to_json        if rules_set.blank?
+          self.the_role = rules_set.to_json if rules_set.is_a?(Hash)
+        end
+
+        after_create do
+          unless based_on_role.blank?
+            if base_role = self.class.where(id: based_on_role).first
+              update_role base_role.to_hash
+            end
+          end
+        end
+      end
+
+      module ClassMethods
+        def with_name name
+          ::Role.where(name: name).first
+        end
+      end
+
+      # C
+      def _jsonable val
+        val.is_a?(Hash) ? val.to_json : val.to_s
+      end
+
+      def create_section section_name = nil
+        return false unless section_name
+
+        role         = to_hash
+        section_name = section_name.to_slug_param(sep: '_')
+
+        return false if section_name.blank?
+        return true  if role[section_name]
+
+        role[section_name] = {}
+        update_attribute(:the_role, _jsonable(role))
+      end
+
+      def create_rule section_name, rule_name
+        return false if     rule_name.blank?
+        return false unless create_section(section_name)
+
+        role         = to_hash
+        rule_name    = rule_name.to_slug_param(sep: '_')
+        section_name = section_name.to_slug_param(sep: '_')
+
+        return true if role[section_name][rule_name]
+
+        role[section_name][rule_name] = false
+        update_attribute(:the_role,  _jsonable(role))
+      end
+
+      # R
+
+      def to_hash
+        begin JSON.load(the_role) rescue {} end
+      end
+
+      def to_json
+        the_role
+      end
+
+      # U
+
+      # source_hash will be reset to false
+      # except true items from new_role_hash
+      # all keys will become 'strings'
+      # look at lib/the_role/hash.rb to find definition of *underscorify_keys* method
+      def update_role new_role_hash
+        new_role_hash = new_role_hash.try(:to_hash) || {}
+
+        new_role = new_role_hash.underscorify_keys
+        role     = to_hash.underscorify_keys.deep_reset(false)
+
+        role.deep_merge! new_role
+        update_attribute(:the_role,  _jsonable(role))
+      end
+
+      def rule_on section_name, rule_name
+        role         = to_hash
+        rule_name    = rule_name.to_slug_param(sep: '_')
+        section_name = section_name.to_slug_param(sep: '_')
+
+        return false unless role[section_name]
+        return false unless role[section_name].key? rule_name
+        return true  if     role[section_name][rule_name]
+
+        role[section_name][rule_name] = true
+        update_attribute(:the_role,  _jsonable(role))
+      end
+
+      def rule_off section_name, rule_name
+        role         = to_hash
+        rule_name    = rule_name.to_slug_param(sep: '_')
+        section_name = section_name.to_slug_param(sep: '_')
+
+        return false unless role[section_name]
+        return false unless role[section_name].key? rule_name
+        return true  unless role[section_name][rule_name]
+
+        role[section_name][rule_name] = false
+        update_attribute(:the_role,  _jsonable(role))
+      end
+
+      # D
+
+      def delete_section section_name = nil
+        return false unless section_name
+
+        role = to_hash
+        section_name = section_name.to_slug_param(sep: '_')
+
+        return false if section_name.blank?
+        return false unless role[section_name]
+
+        role.delete section_name
+        update_attribute(:the_role,  _jsonable(role))
+      end
+
+      def delete_rule section_name, rule_name
+        role         = to_hash
+        rule_name    = rule_name.to_slug_param(sep: '_')
+        section_name = section_name.to_slug_param(sep: '_')
+
+        return false unless role[section_name]
+        return false unless role[section_name].key? rule_name
+
+        role[section_name].delete rule_name
+        update_attribute(:the_role,  _jsonable(role))
+      end
+    end
+  end
+end

data/app/models/concerns/the_role/api/user.rb

@@ -0,0 +1,60 @@
+module TheRole
+  module Api
+    module User
+      extend ActiveSupport::Concern
+
+      include TheRole::Api::BaseMethods
+
+      included do
+        belongs_to :role
+        before_validation :set_default_role, on: :create
+        after_save { |user| user.instance_variable_set(:@role_hash, nil) }
+      end
+
+      module ClassMethods
+        def with_role name
+          ::Role.where(name: name).first.users
+        end
+      end
+
+      def role_hash;
+        @role_hash ||= role.try(:to_hash) || {}
+      end
+
+      # FALSE if object is nil
+      # If object is a USER - check for youself
+      # Check for owner field - :user_id
+      # Check for owner _object_ if owner field is not :user_id
+      def owner? obj
+        return false unless obj
+        return true  if admin?
+
+        section_name = obj.class.to_s.tableize
+        return true if moderator?(section_name)
+
+        # obj is User, simple way to define user_id
+        return id == obj.id if obj.is_a?(self.class)
+
+        # few ways to define user_id
+        return id == obj.user_id     if obj.respond_to? :user_id
+        return id == obj[:user_id]   if obj[:user_id]
+        return id == obj[:user][:id] if obj[:user]
+
+        false
+      end
+
+      private
+
+      def set_default_role
+        unless role
+          default_role = ::Role.find_by_name(TheRole.config.default_user_role)
+          self.role = default_role if default_role
+        end
+
+        if self.class.count.zero? && TheRole.config.first_user_should_be_admin
+          self.role = TheRole.create_admin_role!
+        end
+      end
+    end
+  end
+end

data/config/initializers/the_role.rb

@@ -0,0 +1,18 @@
+# TheRole.config.param_name => value
+
+TheRole.configure do |config|
+  # [ Devise => :authenticate_user! | Sorcery => :require_login ]
+  # config.login_required_method = :authenticate_user!
+
+  # layout for Management panel
+  # config.layout = :the_role_management_panel
+
+  # config.default_user_role          = nil
+  # config.first_user_should_be_admin = false
+  # config.access_denied_method       = :access_denied
+
+  # Dependent of Rails::VERSION
+  #
+  # [ :destroy, :delete_all, :nullify, :restrict, :restrict_with_exception, :restrict_with_error ]
+  # config.destroy_strategy = nil
+end

data/config/locales/en.the_role.yml

@@ -0,0 +1,3 @@
+en:
+  the_role:
+    access_denied: "Access Denied"

data/config/locales/es.the_role.yml

@@ -0,0 +1,3 @@
+es:
+  the_role:
+    access_denied: "Access Denied"

data/config/locales/nl.the_role.yml

@@ -0,0 +1,3 @@
+nl:
+  the_role:
+    access_denied: "Toegang geweigerd"

data/config/locales/pl.the_role.yml

@@ -0,0 +1,3 @@
+pl:
+  the_role:
+    access_denied: "Odmowa dostępu"

data/config/locales/pt_BR.the_role.yml

@@ -0,0 +1,3 @@
+pt-BR:
+  the_role:
+    access_denied: "Acesso negado"

data/config/locales/ru.the_role.yml

@@ -0,0 +1,12 @@
+ru:
+  activerecord:
+    models:
+      role: Роль
+    attributes:
+      role:
+        name: Название роли
+        title: Заголовок роли
+        description: Описание роли
+
+  the_role:
+    access_denied: "Доступ запрещен"

data/config/locales/zh_CN.the_role.yml

@@ -0,0 +1,3 @@
+zh_CN:
+  the_role:
+    access_denied: "Access Denied"

data/db/migrate/20111025025129_create_roles.rb

@@ -0,0 +1,16 @@
+class CreateRoles < ActiveRecord::Migration
+  def self.up
+    create_table :roles do |t|
+      t.string :name,        null: false
+      t.string :title,       null: false
+      t.text   :description, null: false
+      t.text   :the_role,    null: false
+
+      t.timestamps
+    end
+  end
+
+  def self.down
+    drop_table :roles
+  end
+end

data/gem_version.rb

@@ -0,0 +1,3 @@
+module TheRoleApi
+  VERSION = "3.0.1"
+end

data/lib/generators/the_role/USAGE

@@ -0,0 +1,40 @@
+---------------------------------------
+TheRole
+---------------------------------------
+
+!!! Description:
+
+  This generators helps to install TheRole gem into your Application
+
+!!! This text:
+
+  > bundle exec rails g the_role help
+
+!!! Generators:
+
+  > bundle exec rails g the_role install
+  - Install config file and models
+
+  > bundle exec rails g the_role config
+  - Install config file
+
+  > bundle exec rails g the_role models
+  - Install models
+
+  > bundle exec rails g the_role controllers
+  - Install controllers
+
+  > bundle exec rails g the_role locales
+  - Install locales
+
+!!! Rake Tasks:
+
+  > rake db:the_role:admin
+  - Create Admin Role
+
+!!! Migrations:
+  > bundle exec rake the_role_engine:install:migrations
+
+---------------------------------------
+~ TheRole
+---------------------------------------

data/lib/generators/the_role/the_role_generator.rb

@@ -0,0 +1,55 @@
+class TheRoleGenerator < Rails::Generators::NamedBase
+  source_root File.expand_path('../../../../', __FILE__)
+  # argument :xname, type: :string, default: :xname
+
+  # bundle exec rails g the_role NAME
+  def generate_controllers
+    if gen_name == 'install'
+      cp_models
+      cp_config
+    elsif gen_name == 'config'
+      cp_config
+    elsif gen_name == 'models'
+      cp_models
+    elsif gen_name == 'controllers'
+      cp_controllers
+    elsif gen_name == 'locales'
+      cp_locales
+    elsif gen_name == 'help'
+      cp_help
+    else
+      puts 'TheRole Generator - wrong Name'
+      puts 'Try to use install'
+    end
+  end
+
+  private
+
+  def gen_name
+    name.to_s.downcase
+  end
+
+  def cp_config
+    copy_file 'config/initializers/the_role.rb',
+              'config/initializers/the_role.rb'
+  end
+
+  def cp_models
+    copy_file 'app/models/_templates_/role.rb',
+              'app/models/role.rb'
+  end
+
+  def cp_controllers
+    directory 'app/controllers',
+              'app/controllers'
+  end
+
+  def cp_locales
+    directory 'config/locales',
+              'config/locales'
+  end
+
+  def cp_help
+    puts File.read "#{ TheRoleGenerator.source_root }/lib/generators/the_role/USAGE"
+  end
+end

data/lib/tasks/the_role.rake

@@ -0,0 +1,16 @@
+namespace :db do
+  namespace :the_role do
+
+    # rake db:the_role:admin
+    desc 'create Admin Role'
+    task :admin => :environment do
+      unless Role.with_name(:admin)
+        TheRole.create_admin!
+        puts "TheRole >>> Admin role created"
+      else
+        puts "TheRole >>> Admin role exists"
+      end
+    end
+
+  end
+end

data/lib/the_role_api/activerecord.rb

@@ -0,0 +1,13 @@
+module TheRole
+  module Api
+    module ActiveRecord
+      def has_the_role
+        include TheRole::Api::User
+      end
+
+      def acts_as_the_role
+        include TheRole::Api::Role
+      end
+    end
+  end
+end

data/lib/the_role_api/config.rb

@@ -0,0 +1,30 @@
+module TheRole
+  def self.configure(&block)
+    yield @config ||= TheRole::Configuration.new
+  end
+
+  def self.config
+    @config
+  end
+
+  # Configuration class
+  class Configuration
+    include ActiveSupport::Configurable
+    config_accessor :layout,
+                    :destroy_strategy,
+                    :default_user_role,
+                    :access_denied_method,
+                    :login_required_method,
+                    :first_user_should_be_admin
+  end
+
+  configure do |config|
+    config.layout = :application
+
+    config.default_user_role          = nil
+    config.access_denied_method       = nil
+    config.login_required_method      = nil
+    config.destroy_strategy           = nil
+    config.first_user_should_be_admin = false
+  end
+end

data/lib/the_role_api/hash.rb

@@ -0,0 +1,60 @@
+# load 'the_role/hash.rb' - UPDATE, BUT NOT RELOAD [for console testing]
+class Hash
+
+  # deep_transform_keys
+  # deep_stringify_keys
+  # underscorify_keys
+  # deep_reset
+
+  unless {}.respond_to?(:deep_transform_keys)
+    def deep_transform_keys(&block)
+      result = {}
+      each do |key, value|
+        result[yield(key)] = value.is_a?(Hash) ? value.deep_transform_keys(&block) : value
+      end
+      result
+    end
+
+    def deep_transform_keys!(&block)
+      keys.each do |key|
+        value = delete(key)
+        self[yield(key)] = value.is_a?(Hash) ? value.deep_transform_keys!(&block) : value
+      end
+      self
+    end
+  end
+
+  unless {}.respond_to?(:deep_stringify_keys)
+    def deep_stringify_keys
+      deep_transform_keys{ |key| key.to_s }
+    end
+
+    def deep_stringify_keys!
+      deep_transform_keys!{ |key| key.to_s }
+    end
+  end
+
+  unless {}.respond_to?(:underscorify_keys)
+    def underscorify_keys
+      deep_transform_keys{ |key| key.to_slug_param(sep: '_') }
+    end
+
+    def underscorify_keys!
+      replace underscorify_keys
+    end
+  end
+
+  unless {}.respond_to?(:deep_reset)
+    def deep_reset(default = nil)
+      hash = dup
+      hash.each do |key, value|
+        hash[key] = hash[key].is_a?(Hash) ? hash[key].deep_reset(default) : default
+      end
+      hash
+    end
+
+    def deep_reset!(default = nil)
+      replace deep_reset(default)
+    end
+  end
+end

data/lib/the_role_api/trash/the_class_exists.rb

@@ -0,0 +1,8 @@
+# the_class_exists? :User => true | flase
+# the_class_exists? :Role => true | flase
+def the_class_exists?(class_name)
+  klass = Module.const_get(class_name)
+  return klass.is_a?(Class)
+rescue NameError
+  return false
+end

data/lib/the_role_api/version.rb

@@ -0,0 +1 @@
+require_relative '../../gem_version'

data/lib/the_role_api.rb

@@ -0,0 +1,78 @@
+require 'the_role_api/hash'
+require 'the_role_api/config'
+require 'the_role_api/version'
+
+require 'multi_json'
+require 'the_string_to_slug'
+
+module TheRole
+  module Api; end
+
+  class << self
+    def create_admin!
+      admin_role = ::Role.where(name: :admin).first_or_create!(
+        name:        :admin,
+        title:       "Role for admin",
+        description: "This user can do anything"
+      )
+      admin_role.create_rule(:system, :administrator)
+      admin_role.rule_on(:system, :administrator)
+      admin_role
+    end
+  end
+
+  class Engine < Rails::Engine
+    # Right now I don't know why, but autoload_paths doesn't work here
+    # Patch it, if you know how
+    if Rails::VERSION::MAJOR == 3
+      app = "#{ config.root }/app"
+      require_dependency "#{ app }/controllers/concerns/the_role/controller.rb"
+      %w[ base_methods role user ].each do |file|
+        require_dependency "#{ app }/models/concerns/the_role/api/#{ file }.rb"
+      end
+    end
+
+    if Rails::VERSION::MAJOR == 4
+      config.autoload_paths << "#{ config.root }/app/models/concerns/**"
+      config.autoload_paths << "#{ config.root }/app/controllers/concerns/**"
+    end
+
+    if Rails::VERSION::MAJOR == 5
+      raise Exception.new("TheRole 3. Version for Rails 5 not tested yet")
+    end
+
+    initializer "the_role_precompile_hook", group: :all do |app|
+      app.config.assets.precompile += %w(
+        the_role_management_panel.js
+        the_role_management_panel.css
+      )
+    end
+  end
+end
+
+# ==========================================================================================
+# Just info
+# ==========================================================================================
+#
+# http://stackoverflow.com/questions/6279325/adding-to-rails-autoload-path-from-gem
+# config.to_prepare do; end
+#
+# ==========================================================================================
+#
+# require 'the_role_api/active_record'
+#
+# if defined?(ActiveRecord::Base)
+#   ActiveRecord::Base.extend TheRole::Api::ActiveRecord
+# end
+#
+# ==========================================================================================
+#
+# A note on Decorators and Loading Code # http://guides.rubyonrails.org/engines.html
+#
+# config.to_prepare do
+#   Dir.glob(Rails.root + "app/decorators/**/*_decorator*.rb").each do |c|
+#     require_dependency(c)
+#   end
+# end
+#
+# ==========================================================================================

data/the_role_api.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "the_role_api/version"
+
+Gem::Specification.new do |s|
+  s.name        = "the_role_api"
+  s.version     = TheRoleApi::VERSION
+  s.authors     = ["Ilya N. Zykin [the-teacher]"]
+  s.email       = ["zykin-ilya@ya.ru"]
+  s.homepage    = "https://github.com/TheRole/the_role_api"
+  s.summary     = %q{Authorization for Rails}
+  s.description = %q{Authorization for Rails with Web Interface}
+
+  s.files         = `git ls-files`.split("\n").select{ |file_name| !(file_name =~ /^spec/) }
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+  s.license       = "MIT"
+
+  s.add_dependency 'multi_json'
+  s.add_dependency 'the_string_to_slug', '~> 1.2'
+  s.add_runtime_dependency 'rails', ['>= 3.2', '< 5']
+end

metadata

@@ -0,0 +1,122 @@
+--- !ruby/object:Gem::Specification
+name: the_role_api
+version: !ruby/object:Gem::Version
+  version: 3.0.1
+platform: ruby
+authors:
+- Ilya N. Zykin [the-teacher]
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-02-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: the_string_to_slug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.2'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.2'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '5'
+description: Authorization for Rails with Web Interface
+email:
+- zykin-ilya@ya.ru
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- app/controllers/concerns/the_role/controller.rb
+- app/models/_templates_/role.rb
+- app/models/concerns/the_role/api/base_methods.rb
+- app/models/concerns/the_role/api/role.rb
+- app/models/concerns/the_role/api/user.rb
+- config/initializers/the_role.rb
+- config/locales/en.the_role.yml
+- config/locales/es.the_role.yml
+- config/locales/nl.the_role.yml
+- config/locales/pl.the_role.yml
+- config/locales/pt_BR.the_role.yml
+- config/locales/ru.the_role.yml
+- config/locales/zh_CN.the_role.yml
+- db/migrate/20111025025129_create_roles.rb
+- gem_version.rb
+- lib/generators/the_role/USAGE
+- lib/generators/the_role/the_role_generator.rb
+- lib/tasks/the_role.rake
+- lib/the_role_api.rb
+- lib/the_role_api/activerecord.rb
+- lib/the_role_api/config.rb
+- lib/the_role_api/hash.rb
+- lib/the_role_api/trash/the_class_exists.rb
+- lib/the_role_api/version.rb
+- the_role_api.gemspec
+homepage: https://github.com/TheRole/the_role_api
+licenses:
+- MIT
+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.2.2
+signing_key: 
+specification_version: 4
+summary: Authorization for Rails
+test_files: []