permisi 0.0.1 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f4321f19a7a5c2ecbfa99d51c00a82d7fb1861007f52e6eab462c49df2c5b390
-  data.tar.gz: ed73932d3a013e89a3d6c49c79c3328fe84ecfb566f66cd53ac1a9d355de383c
+  metadata.gz: 47559ea904f406010a7979cd77de853bf8c3628c7e4c1020e45742ae439a7e06
+  data.tar.gz: b8c814331a90cbc7e4d2d3560cfb939419b001f1e88e731a3e67e9b180ead167
 SHA512:
-  metadata.gz: a9ada7b5c95dcfa0a9627a7606bf4909e516f2e291aac518f61d1cf1a422e904027bf6c95910fc7ddde9b47c61e88d2027e0e377261af06e0d2dac16dd78e43d
-  data.tar.gz: 421d311e27eb1f2663c6515c62623c3804ee77ee76bec16162b199370eb1619a4283acf5a79ae8eaca86da6daf7f32f5324c872ce9acc92a07b120f29cebe00c
+  metadata.gz: bdfbfbadcc257c15ded64521607e062d2d51ba3c9fc5209f4af273f69473df981e2bbbc74457e0bbd3cc0576e9c51e67895f66685bba7dada2e88d3b4513199c
+  data.tar.gz: a095961d001eb1495f7d084434f8bef182add89e86f9a147013a34f0b7c171cff4da65373798442e45e962264f03c6d0c07eb23f58ca520e742c61adbd94d8e6

data/.gitignore

@@ -1,3 +1,4 @@
+/spec/support/db/*.db
 /.bundle/
 /.yardoc
 /_yardoc/
@@ -9,3 +10,6 @@
 
 # rspec failure tracking
 .rspec_status
+
+*.sublime-*
+.byebug_history

data/CHANGELOG.md

@@ -1,4 +1,13 @@
-0.0.0
-=====
+# Changelog
 
-- Reserve gem name.
+# 0.1.0
+
+Finished extraction work from my past projects.
+
+- Implemented ActiveRecord backend
+- Implemented `Actable` mixin
+- Implemented permissions hash sanitization and checking
+
+# 0.0.1
+
+Reserved the gem name: https://en.wiktionary.org/wiki/permisi

data/Gemfile

@@ -5,8 +5,9 @@ source "https://rubygems.org"
 # Specify your gem's dependencies in permisi.gemspec
 gemspec
 
+gem "byebug", "~> 11.1"
 gem "rake", "~> 13.0"
-
 gem "rspec", "~> 3.0"
-
-gem "rubocop", "~> 1.7"
+gem "rubocop", "~> 1.9"
+gem "simplecov", "~> 0.21.2"
+gem "sqlite3", "~> 1.4"

data/Gemfile.lock

@@ -1,13 +1,34 @@
 PATH
   remote: .
   specs:
-    permisi (0.0.0)
+    permisi (0.1.0)
+      activemodel (>= 3.2.0)
+      activerecord (>= 3.2.0)
+      activesupport (>= 3.2.0)
+      zeitwerk (~> 2.4, >= 2.4.2)
 
 GEM
   remote: https://rubygems.org/
   specs:
+    activemodel (6.1.2.1)
+      activesupport (= 6.1.2.1)
+    activerecord (6.1.2.1)
+      activemodel (= 6.1.2.1)
+      activesupport (= 6.1.2.1)
+    activesupport (6.1.2.1)
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      i18n (>= 1.6, < 2)
+      minitest (>= 5.1)
+      tzinfo (~> 2.0)
+      zeitwerk (~> 2.3)
     ast (2.4.2)
+    byebug (11.1.3)
+    concurrent-ruby (1.1.8)
     diff-lcs (1.4.4)
+    docile (1.3.5)
+    i18n (1.8.9)
+      concurrent-ruby (~> 1.0)
+    minitest (5.14.3)
     parallel (1.20.1)
     parser (3.0.0.0)
       ast (~> 2.4.1)
@@ -40,16 +61,29 @@ GEM
     rubocop-ast (1.4.1)
       parser (>= 2.7.1.5)
     ruby-progressbar (1.11.0)
+    simplecov (0.21.2)
+      docile (~> 1.1)
+      simplecov-html (~> 0.11)
+      simplecov_json_formatter (~> 0.1)
+    simplecov-html (0.12.3)
+    simplecov_json_formatter (0.1.2)
+    sqlite3 (1.4.2)
+    tzinfo (2.0.4)
+      concurrent-ruby (~> 1.0)
     unicode-display_width (2.0.0)
+    zeitwerk (2.4.2)
 
 PLATFORMS
   x86_64-linux
 
 DEPENDENCIES
+  byebug (~> 11.1)
   permisi!
   rake (~> 13.0)
   rspec (~> 3.0)
-  rubocop (~> 1.7)
+  rubocop (~> 1.9)
+  simplecov (~> 0.21.2)
+  sqlite3 (~> 1.4)
 
 BUNDLED WITH
    2.2.5

data/README.md

@@ -1,10 +1,37 @@
-# Permisi
-
-[![Gem Version](https://badge.fury.io/rb/permisi.svg)](https://badge.fury.io/rb/permisi)
-
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/permisi`. To experiment with that code, run `bin/console` for an interactive prompt.
-
-TODO: Delete this and the text above, and describe your gem
+<table>
+  <tr>
+    <th>
+      <a href="https://commons.wikimedia.org/wiki/File:Female_Chinese_Lion_Statue.jpg">
+        <img src="https://upload.wikimedia.org/wikipedia/commons/thumb/1/17/Female_Chinese_Lion_Statue.jpg/102px-Female_Chinese_Lion_Statue.jpg">
+      </a>
+    </th>
+    <th>
+      <h1>Permisi</h1>
+      <p><em>Simple and dynamic role-based access control for Rails</em></p>
+      <p>
+        <a href="https://badge.fury.io/rb/permisi"><img src="https://badge.fury.io/rb/permisi.svg" alt="Gem Version"></a>
+        <a href="https://codeclimate.com/github/ukazap/permisi/maintainability"><img src="https://api.codeclimate.com/v1/badges/0b1238302f2012b20740/maintainability" /></a>
+      </p>
+    </th>
+    <th>
+      <a href="https://commons.wikimedia.org/wiki/File:Male_Chinese_Lion_Statue.jpg">
+        <img src="https://upload.wikimedia.org/wikipedia/commons/thumb/1/14/Male_Chinese_Lion_Statue.jpg/98px-Male_Chinese_Lion_Statue.jpg">
+      </a>
+    </th>
+  </tr>
+</table>
+
+## Concept
+
+Permisi provides a way of dynamically declaring user rights (a.k.a. permissions) using a simple role-based access control scheme.
+
+This is not an alternative to CanCanCan/Pundit, instead it complement them with dynamic role definition and role membership.
+
+Permisi has three basic concepts:
+
+- Actor: a person, group of people, or an automated agent who interacts with the app
+- Role: a job function, job title, or rank which determines an actor's authority
+- Permission: the ability to perform an action
 
 ## Installation
 
@@ -17,14 +44,133 @@ gem 'permisi'
 And then execute:
 
     $ bundle install
+    $ rails g permisi:install
+
+## Configuring backend
+
+Set `config.backend` in the initializer to the backend of choice for storing and retrieving roles:
+
+```ruby
+# config/initializers/permisi.rb
+
+Permisi.init do |config|
+  #...
+  config.backend = :active_record
+  #...
+end
+```
+
+To use `:active_record`, run the generated migration from the installation step:
+
+    $ rails db:migrate
+
+Permisi only support `:active_record` backend at the moment. In the future, it will be possible to use `:mongoid`.
+
+## Configuring permissions
+
+First you have to predefine the permissions, which is basically a set of possible actions according to the app's use cases. The actions can be grouped in any way possible. For example, you might want to define actions around resource types.
+
+To define the available actions in the system, assign a hash to the `config.permissions` with the following format:
+
+```ruby
+# config/initializers/permisi.rb
+Permisi.init do |config|
+  # ...
+  config.permissions = {
+    # A symbol-array pair denotes a namespace.
+    # A common use of namespacing is for grouping
+    # available actions by resources.
+    authors: [
+      # Enclosed in the array are symbols
+      # denoting available actions in the namespace:
+      :list,
+      :view,
+      :create,
+      :edit,
+      :delete
+    ],
+    # You can also use the simplified %i[] notation:
+    publishers: %i[list view create edit delete],
+    # Besides actions, you can also have nested
+    # namespaces:
+    books: [
+      :list,
+      :view,
+      :create,
+      :edit,
+      :delete,
+      {
+        editions: [
+          :list, :view, :create, :edit, :delete, :archive
+        ]
+      }
+    ]
+  }
+  # ...
+end
+```
 
-Or install it yourself as:
+## Defining and managing roles
 
-    $ gem install permisi
+Once you have the predefined permissions, you can then define different roles with different level of access within the boundary of the predefined permissions. You can delete or create new roles according to organizational changes. You can also modify existing roles without a change in your code.
 
-## Usage
+You can create, edit, and destroy roles at runtime. You might also want to define preset roles via `db/seeds.rb`.
 
-TODO: Write usage instructions here
+```ruby
+# Interact with Permisi.roles as you would with ActiveRecord query interfaces:
+
+# List all roles
+Permisi.roles.all
+
+# Create a new role
+admin_role = Permisi.roles.create(slug: :admin, name: "Administrator", permissions: {
+  books: {
+    list: true,
+    view: true,
+    create: true,
+    edit: true
+  }
+})
+
+# Ask specific role permission
+admin_role.allows? "books.delete" # == false
+
+# Update existing role
+admin.permissions[:books].merge!({ delete: true })
+admin.save
+admin_role.allows? "books.delete" # == true
+```
+
+## Configuring actors
+
+You can then give or take multiple roles to an actor which will allow or prevent them to perform certain actions in a flexible manner. But before you can do that, you have to wire up your user model with Permisi.
+
+Permisi does not hold an assumption that a specific model is present (e.g. User model). Instead, it keeps track of "actors" internally. The goal is to support multiple use cases such as actor polymorphism, user _groups_, etc.
+
+For example, you can map your user model to Permisi's actor model by including the `Permisi::Actable` mixin like so:
+
+```ruby
+# app/models/user.rb
+
+class User < ApplicationRecord
+  include Permisi::Actable
+end
+```
+
+You can then interact with the new `#permisi` method:
+
+```ruby
+user = User.find_by_email "esther@example.com"
+user.permisi # => instance of Actor
+
+user.permisi.has_role? :admin # == false
+user.permisi.may? "books.delete" # == false
+
+user.permisi.roles << Permisi.roles.find_by_slug(:admin)
+
+user.permisi.has_role? :admin # == true
+user.permisi.may? "books.delete" # == true
+```
 
 ## Development
 
@@ -34,7 +180,7 @@ To install this gem onto your local machine, run `bundle exec rake install`. To
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/permisi. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/[USERNAME]/permisi/blob/master/CODE_OF_CONDUCT.md).
+Bug reports and pull requests are welcome on GitHub at https://github.com/ukazap/permisi. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/ukazap/permisi/blob/master/CODE_OF_CONDUCT.md).
 
 ## License
 
@@ -42,4 +188,4 @@ The gem is available as open source under the terms of the [MIT License](https:/
 
 ## Code of Conduct
 
-Everyone interacting in the Permisi project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/permisi/blob/master/CODE_OF_CONDUCT.md).
+Everyone interacting in the Permisi project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/ukazap/permisi/blob/master/CODE_OF_CONDUCT.md).

data/lib/generators/permisi/install_generator.rb

@@ -0,0 +1,33 @@
+require "rails/generators"
+require "rails/generators/migration"
+require "rails/generators/active_record"
+
+module Permisi
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      include Rails::Generators::Migration
+
+      source_root File.expand_path('../templates', __FILE__)
+
+      def self.next_migration_number(path)
+        ActiveRecord::Generators::Base.next_migration_number(path)
+      end
+
+      def create_initializer
+        template 'initializer.rb', 'config/initializers/permisi.rb'
+      end
+
+      def create_migrations
+        migration_template 'migration.rb', 'db/migrate/create_permisi_tables.rb', migration_version: migration_version
+      end
+
+      private
+
+      def migration_version
+        if ActiveRecord.version.version > '5'
+          "[#{ActiveRecord::VERSION::MAJOR}.#{ActiveRecord::VERSION::MINOR}]"
+        end
+      end
+    end
+  end
+end

data/lib/generators/permisi/templates/initializer.rb

@@ -0,0 +1,11 @@
+require "permisi"
+
+Permisi.init do |config|
+  # Define which backend to use
+  # See https://github.com/ukazap/permisi#configuring-backend
+  config.backend = :active_record
+
+  # Define all permissions available in the system
+  # See https://github.com/ukazap/permisi#configuring-permissions
+  config.permissions = {}
+end

data/lib/generators/permisi/templates/migration.rb

@@ -0,0 +1,28 @@
+class CreatePermisiTables < ActiveRecord::Migration<%= migration_version %>
+  def up
+    create_table :permisi_actors do |t|
+      t.references :aka, polymorphic: true
+      t.timestamps
+    end
+
+    add_index :permisi_actors, [:aka_type, :aka_id]
+
+    create_table :permisi_roles do |t|
+      t.string :slug, null: false, unique: true
+      t.string :name, null: false, unique: true
+      t.json :permissions
+      t.timestamps
+    end
+
+    create_table :permisi_actor_roles do |t|
+      t.belongs_to :actor
+      t.belongs_to :role
+    end
+  end
+
+  def down
+    drop_table :permisi_actor_roles
+    drop_table :permisi_roles
+    drop_table :permisi_actors
+  end
+end

data/lib/permisi.rb

@@ -1,8 +1,41 @@
 # frozen_string_literal: true
 
-require_relative "permisi/version"
+require "zeitwerk"
+$permisi_loader = Zeitwerk::Loader.for_gem
+$permisi_loader.ignore("#{__dir__}/generators")
+$permisi_loader.ignore("#{__dir__}/permisi/backend/mongoid.rb") # todo
+$permisi_loader.setup
 
 module Permisi
-  class Error < StandardError; end
-  # Your code goes here...
+  class << self
+    def init(&block)
+      yield config if block_given?
+    end
+
+    def config
+      @@config ||= Config.new
+    end
+
+    def actors
+      __backend.actors
+    end
+
+    def actor(aka)
+      __backend.findsert_actor(aka)
+    end
+
+    def roles
+      __backend.roles
+    end
+
+    private
+
+    def __backend
+      if config.backend.nil? || !(config.backend <= Backend::Base)
+        raise Backend::InvalidBackend
+      end
+
+      config.backend
+    end
+  end
 end

data/lib/permisi/actable.rb

@@ -0,0 +1,9 @@
+module Permisi
+  module Actable
+    def permisi_actor
+      @permisi_actor ||= Permisi.actor(self)
+    end
+
+    alias permisi permisi_actor
+  end
+end

data/lib/permisi/backend/active_record.rb

@@ -0,0 +1,23 @@
+require "active_record"
+
+module Permisi
+  class Backend::ActiveRecord < Backend::Base
+    class << self
+      def table_name_prefix
+        "permisi_"
+      end
+
+      def findsert_actor(aka)
+        Actor.find_or_create_by(aka: aka)
+      end
+
+      def actors
+        Actor.all
+      end
+
+      def roles
+        Role.all
+      end
+    end
+  end
+end

data/lib/permisi/backend/active_record/actor.rb

@@ -0,0 +1,15 @@
+module Permisi
+  class Backend::ActiveRecord::Actor < ::ActiveRecord::Base
+    belongs_to :aka, polymorphic: true
+    has_many :actor_roles
+    has_many :roles, through: :actor_roles
+
+    def has_role?(role_slug)
+      roles.load.any? { |role| role.slug == role_slug.to_s }
+    end
+
+    def may?(action_path)
+      roles.load.any? { |role| role.allows?(action_path) }
+    end
+  end
+end

data/lib/permisi/backend/active_record/actor_role.rb

@@ -0,0 +1,6 @@
+module Permisi
+  class Backend::ActiveRecord::ActorRole < ::ActiveRecord::Base
+    belongs_to :actor
+    belongs_to :role
+  end
+end

data/lib/permisi/backend/active_record/role.rb

@@ -0,0 +1,27 @@
+module Permisi
+  class Backend::ActiveRecord::Role < ::ActiveRecord::Base
+    has_many :actor_roles
+    has_many :actors, through: :actor_roles
+    has_many :akas, through: :actors
+
+    validates_presence_of :name, :slug
+    validates_uniqueness_of :name, :slug
+
+    after_initialize :set_default_permissions
+    before_validation :sanitize_permissions
+
+    serialize :permissions, Permisi::PermissionUtil::Serializer
+
+    def allows?(action_path)
+      Permisi::PermissionUtil.allows?(self.permissions, action_path)
+    end
+
+    def set_default_permissions
+      self.permissions ||= Permisi.config.default_permissions if self.new_record?
+    end
+
+    def sanitize_permissions
+      self.permissions = Permisi::PermissionUtil.sanitize_permissions(self.permissions)
+    end
+  end
+end

data/lib/permisi/backend/base.rb

@@ -0,0 +1,6 @@
+module Permisi
+  module Backend
+    class Base
+    end
+  end
+end

data/lib/permisi/backend/invalid_backend.rb

@@ -0,0 +1,9 @@
+module Permisi
+  module Backend
+    class InvalidBackend < StandardError
+      def initialize(message = "Please specify a backend. For details, check https://github.com/ukazap/permisi#configuring-backend")
+        super
+      end
+    end
+  end
+end

data/lib/permisi/backend/mongoid.rb

@@ -0,0 +1,5 @@
+module Permisi
+  class Backend::Mongoid < Backend::Base
+    raise "under construction"
+  end
+end

data/lib/permisi/config.rb

@@ -0,0 +1,29 @@
+require "active_support/core_ext/class/attribute_accessors"
+
+module Permisi
+  class Config
+    attr_accessor :backend, :permissions
+    attr_reader :default_permissions
+
+    def initialize
+      @permissions = ::HashWithIndifferentAccess.new
+      @default_permissions = ::HashWithIndifferentAccess.new
+    end
+
+    def backend=(chosen_backend)
+      if chosen_backend.is_a? Symbol
+        chosen_backend = "::Permisi::Backend::#{chosen_backend.to_s.classify}".constantize
+      end
+
+      @backend = chosen_backend
+    rescue NameError
+      raise Backend::InvalidBackend
+    end
+
+    def permissions=(permissions_hash)
+      permissions_hash = HashWithIndifferentAccess.new(permissions_hash)
+      @default_permissions = PermissionUtil.transform_namespace(permissions_hash)
+      @permissions = permissions_hash
+    end
+  end
+end

data/lib/permisi/permission_util.rb

@@ -0,0 +1,86 @@
+require "active_model/type"
+require "active_support/hash_with_indifferent_access"
+
+module Permisi
+  module PermissionUtil
+    class InvalidNamespace < StandardError; end
+
+    class << self
+      def allows?(hash, action_path)
+        return false unless hash.kind_of?(Hash)
+
+        action_path_arr = action_path.split(".")
+        (!Permisi.config.default_permissions.dig(*action_path_arr).nil? rescue false) &&
+          hash.dig(*action_path_arr) == true
+      end
+
+      def transform_namespace(namespace, current_path: nil)
+        HashWithIndifferentAccess.new.tap do |transformed|
+          namespace.each_pair do |key, value|
+            raise InvalidNamespace,
+                  "`#{[current_path, key].compact.join(".")}` should be an array" unless value.is_a? Array
+
+            value.each.with_index do |arr_v, arr_i|
+              if arr_v.is_a?(Symbol)
+                transformed[key] ||= ::HashWithIndifferentAccess.new
+                if transformed[key].has_key? arr_v
+                  raise InvalidNamespace, "duplicate entry: `#{[current_path, key, arr_v].compact.join(".")}`"
+                end
+
+                transformed[key][arr_v] = false
+              elsif arr_v.is_a?(Hash)
+                transform_namespace(arr_v,
+                                    current_path: [current_path, key].compact.join(".")).each_pair do |ts_k, ts_v|
+                  transformed[key] ||= ::HashWithIndifferentAccess.new
+                  if transformed[key].has_key? ts_k
+                    raise InvalidNamespace, "duplicate entry: `#{[current_path, key, ts_k].compact.join(".")}`"
+                  end
+
+                  transformed[key][ts_k] = ts_v
+                end
+              else
+                raise InvalidNamespace,
+                      "`#{[current_path, key].compact.join(".")}[#{arr_i}]` should be a symbol or a hash"
+              end
+            end
+          end
+        end
+      end
+
+      def sanitize_permissions(permission_hash)
+        __deeply_sanitize_permissions(permission_hash, template: Permisi.config.default_permissions)
+      end
+
+      private
+
+      def __deeply_sanitize_permissions(permission_hash, template: {})
+        HashWithIndifferentAccess.new.tap do |sanitized|
+          permission_hash.each_pair do |key, value|
+            next unless template.has_key?(key)
+
+            if value.is_a?(Hash)
+              sanitized[key] = __deeply_sanitize_permissions(value, template: template[key])
+            else
+              sanitized[key] = __cast_value_to_boolean(value)
+            end
+          end
+        end
+      end
+
+      def __cast_value_to_boolean(value)
+        bool = ActiveModel::Type::Boolean.new.cast(value)
+        bool ||= false
+      end
+    end
+
+    class Serializer
+      def self.dump(hash)
+        hash
+      end
+
+      def self.load(hash)
+        (hash.is_a?(Hash) ? hash : {}).with_indifferent_access
+      end
+    end
+  end
+end

data/lib/permisi/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Permisi
-  VERSION = "0.0.1"
+  VERSION = "0.1.0"
 end

data/permisi.gemspec

@@ -8,15 +8,21 @@ Gem::Specification.new do |spec|
   spec.authors       = ["Ukaza Perdana"]
   spec.email         = ["ukaza@hey.com"]
 
-  spec.summary       = "Simple and dynamic user roles and permissions scheme for Rails"
-  spec.description   = "Permisi provides a way of dynamically declaring user rights (a.k.a. permissions) using a simple role-based access control scheme. A user may be associated to multiple roles with a different set of rights in each role."
+  spec.summary       = "Simple and dynamic role-based access control for Rails"
+
+  spec.description   = <<~DESCRIPTION
+    Permisi provides a way of dynamically declaring user rights (a.k.a. permissions) using a simple role-based access control scheme.
+    A user may be associated to multiple roles with a different set of permissions in each role.
+    The roles and user-roles association can be dynamically defined and changed on runtime.
+  DESCRIPTION
+
   spec.homepage      = "https://github.com/ukazap/permisi"
   spec.license       = "MIT"
-  spec.required_ruby_version = Gem::Requirement.new(">= 2.4.0")
+  spec.required_ruby_version = Gem::Requirement.new(">= 2.4.4")
 
   spec.metadata["homepage_uri"] = spec.homepage
   spec.metadata["source_code_uri"] = spec.homepage
-  spec.metadata["changelog_uri"] = "https://github.com/ukazap/permisi/blob.main/CHANGELOG.md"
+  spec.metadata["changelog_uri"] = "#{spec.homepage}/blob/main/CHANGELOG.md"
 
   # Specify which files should be added to the gem when it is released.
   # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
@@ -27,8 +33,10 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
-  # Uncomment to register a new dependency of your gem
-  # spec.add_dependency "example-gem", "~> 1.0"
+  spec.add_dependency "activesupport", ">= 3.2.0"
+  spec.add_dependency "activerecord", ">= 3.2.0"
+  spec.add_dependency "activemodel", ">= 3.2.0"
+  spec.add_dependency "zeitwerk", ["~> 2.4", ">= 2.4.2"]
 
   # For more information and examples about making a new gem, checkout our
   # guide at: https://bundler.io/guides/creating_gem.html

metadata

@@ -1,18 +1,81 @@
 --- !ruby/object:Gem::Specification
 name: permisi
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.1.0
 platform: ruby
 authors:
 - Ukaza Perdana
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2021-02-04 00:00:00.000000000 Z
-dependencies: []
-description: Permisi provides a way of dynamically declaring user rights (a.k.a. permissions)
-  using a simple role-based access control scheme. A user may be associated to multiple
-  roles with a different set of rights in each role.
+date: 2021-02-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.2.0
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.2.0
+- !ruby/object:Gem::Dependency
+  name: activemodel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.2.0
+- !ruby/object:Gem::Dependency
+  name: zeitwerk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.4.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.4.2
+description: |
+  Permisi provides a way of dynamically declaring user rights (a.k.a. permissions) using a simple role-based access control scheme.
+  A user may be associated to multiple roles with a different set of permissions in each role.
+  The roles and user-roles association can be dynamically defined and changed on runtime.
 email:
 - ukaza@hey.com
 executables: []
@@ -32,7 +95,20 @@ files:
 - Rakefile
 - bin/console
 - bin/setup
+- lib/generators/permisi/install_generator.rb
+- lib/generators/permisi/templates/initializer.rb
+- lib/generators/permisi/templates/migration.rb
 - lib/permisi.rb
+- lib/permisi/actable.rb
+- lib/permisi/backend/active_record.rb
+- lib/permisi/backend/active_record/actor.rb
+- lib/permisi/backend/active_record/actor_role.rb
+- lib/permisi/backend/active_record/role.rb
+- lib/permisi/backend/base.rb
+- lib/permisi/backend/invalid_backend.rb
+- lib/permisi/backend/mongoid.rb
+- lib/permisi/config.rb
+- lib/permisi/permission_util.rb
 - lib/permisi/version.rb
 - permisi.gemspec
 homepage: https://github.com/ukazap/permisi
@@ -41,7 +117,7 @@ licenses:
 metadata:
   homepage_uri: https://github.com/ukazap/permisi
   source_code_uri: https://github.com/ukazap/permisi
-  changelog_uri: https://github.com/ukazap/permisi/blob.main/CHANGELOG.md
+  changelog_uri: https://github.com/ukazap/permisi/blob/main/CHANGELOG.md
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -50,7 +126,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.4.0
+      version: 2.4.4
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -60,5 +136,5 @@ requirements: []
 rubygems_version: 3.2.3
 signing_key: 
 specification_version: 4
-summary: Simple and dynamic user roles and permissions scheme for Rails
+summary: Simple and dynamic role-based access control for Rails
 test_files: []