monarchy 0.2.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: f93490c3902cf4b5f6a3c392da407d0ff72d1f27
+  data.tar.gz: 367daf68a7dcb3ea36fc5956cb005e466cd46b4e
+SHA512:
+  metadata.gz: 13671f970ef72842f9619f551e9ab20fd3c0a723f2da362389b01eea2635bbf8011f546326b5c160aa1d08601962d48390474f899ffb1b707cb2086108d5d365
+  data.tar.gz: 597b0cb30c74379abea9e8c6e4eb2895754ba0d4183279ef8315547a43e46e2f4e7bbf6ce4e0d14e8aedfafe732df566bbeeb7012e2461774658e682bf1af8b5

data/.gitignore

@@ -0,0 +1,12 @@
+.bundle/
+log/*.log
+pkg/
+spec/dummy/log/*.log
+spec/dummy/db/*.sqlite3
+spec/dummy/db/*.sqlite3-journal
+spec/dummy/log/*.log
+spec/dummy/tmp/
+spec/dummy/.sass-cache
+.DS_Store
+coverage/
+.lock-*

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.rubocop.yml

@@ -0,0 +1,19 @@
+AllCops:
+  TargetRubyVersion: 2.3
+  Exclude:
+   - 'spec/dummy/db/seeds.rb'
+   - 'spec/dummy/db/migrate/**'
+   - 'spec/dummy/db/schema.rb'
+   - 'lib/generators/templates/**/*'
+Documentation:
+  Enabled: false
+Metrics/LineLength:
+  Max: 120
+Style/CaseIndentation:
+  Enabled: false
+Style/StructInheritance:
+  Enabled: false
+Style/ClassAndModuleChildren:
+  Enabled: false
+Rails/HasAndBelongsToMany:
+  Enabled: false

data/.travis.yml

@@ -0,0 +1,4 @@
+language: ruby
+rvm:
+  - 2.3.0
+before_install: gem install bundler -v 1.10.6

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,13 @@
+# Contributor Code of Conduct
+
+As contributors and maintainers of this project, we pledge to respect all people who contribute through reporting issues, posting feature requests, updating documentation, submitting pull requests or patches, and other activities.
+
+We are committed to making participation in this project a harassment-free experience for everyone, regardless of level of experience, gender, gender identity and expression, sexual orientation, disability, personal appearance, body size, race, ethnicity, age, or religion.
+
+Examples of unacceptable behavior by participants include the use of sexual language or imagery, derogatory comments or personal attacks, trolling, public or private harassment, insults, or other unprofessional conduct.
+
+Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct. Project maintainers who do not follow the Code of Conduct may be removed from the project team.
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by opening an issue or contacting one or more of the project maintainers.
+
+This Code of Conduct is adapted from the [Contributor Covenant](http://contributor-covenant.org), version 1.0.0, available at [http://contributor-covenant.org/version/1/0/0/](http://contributor-covenant.org/version/1/0/0/)

data/Gemfile

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+source 'https://rubygems.org'
+ruby '2.3.0'
+
+# Declare your gem's dependencies in monarchy.gemspec.
+# Bundler will treat runtime dependencies like base dependencies, and
+# development dependencies will be added by default to the :development group.
+gemspec
+
+# Declare any dependencies that are still in development here instead of in
+# your gemspec. These might include edge Rails or gems from your path or
+# Git. Remember to move these dependencies to your gemspec before releasing
+# your gem to rubygems.org.
+
+# To use a debugger
+# gem 'byebug', group: [:development, :test]
+
+gem 'configurations', '~> 2.2.0'
+
+group :development, :test do
+  gem 'sqlite3'
+  gem 'rubocop'
+  gem 'pry-rails', '0.3.4'
+  gem 'shoulda-matchers'
+  gem 'rspec-rails'
+  gem 'factory_girl_rails', '4.5.0'
+  gem 'ffaker', '2.1.0'
+  gem 'database_cleaner', '1.4.1'
+end
+
+gem 'simplecov', require: false, group: :test

data/Gemfile.lock

@@ -0,0 +1,190 @@
+PATH
+  remote: .
+  specs:
+    monarchy (0.2.1)
+      closure_tree (= 6.0.0)
+      configurations (= 2.2.0)
+      rails (~> 4.2, >= 4.2.4)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    actionmailer (4.2.6)
+      actionpack (= 4.2.6)
+      actionview (= 4.2.6)
+      activejob (= 4.2.6)
+      mail (~> 2.5, >= 2.5.4)
+      rails-dom-testing (~> 1.0, >= 1.0.5)
+    actionpack (4.2.6)
+      actionview (= 4.2.6)
+      activesupport (= 4.2.6)
+      rack (~> 1.6)
+      rack-test (~> 0.6.2)
+      rails-dom-testing (~> 1.0, >= 1.0.5)
+      rails-html-sanitizer (~> 1.0, >= 1.0.2)
+    actionview (4.2.6)
+      activesupport (= 4.2.6)
+      builder (~> 3.1)
+      erubis (~> 2.7.0)
+      rails-dom-testing (~> 1.0, >= 1.0.5)
+      rails-html-sanitizer (~> 1.0, >= 1.0.2)
+    activejob (4.2.6)
+      activesupport (= 4.2.6)
+      globalid (>= 0.3.0)
+    activemodel (4.2.6)
+      activesupport (= 4.2.6)
+      builder (~> 3.1)
+    activerecord (4.2.6)
+      activemodel (= 4.2.6)
+      activesupport (= 4.2.6)
+      arel (~> 6.0)
+    activesupport (4.2.6)
+      i18n (~> 0.7)
+      json (~> 1.7, >= 1.7.7)
+      minitest (~> 5.1)
+      thread_safe (~> 0.3, >= 0.3.4)
+      tzinfo (~> 1.1)
+    arel (6.0.3)
+    ast (2.2.0)
+    builder (3.2.2)
+    closure_tree (6.0.0)
+      activerecord (>= 4.1.0)
+      with_advisory_lock (>= 3.0.0)
+    coderay (1.1.1)
+    concurrent-ruby (1.0.1)
+    configurations (2.2.0)
+    database_cleaner (1.4.1)
+    diff-lcs (1.2.5)
+    docile (1.1.5)
+    erubis (2.7.0)
+    factory_girl (4.5.0)
+      activesupport (>= 3.0.0)
+    factory_girl_rails (4.5.0)
+      factory_girl (~> 4.5.0)
+      railties (>= 3.0.0)
+    ffaker (2.1.0)
+    globalid (0.3.6)
+      activesupport (>= 4.1.0)
+    i18n (0.7.0)
+    json (1.8.3)
+    loofah (2.0.3)
+      nokogiri (>= 1.5.9)
+    mail (2.6.4)
+      mime-types (>= 1.16, < 4)
+    method_source (0.8.2)
+    mime-types (3.0)
+      mime-types-data (~> 3.2015)
+    mime-types-data (3.2016.0221)
+    mini_portile2 (2.0.0)
+    minitest (5.8.4)
+    nokogiri (1.6.7.2)
+      mini_portile2 (~> 2.0.0.rc2)
+    parser (2.3.0.7)
+      ast (~> 2.2)
+    powerpack (0.1.1)
+    pry (0.10.3)
+      coderay (~> 1.1.0)
+      method_source (~> 0.8.1)
+      slop (~> 3.4)
+    pry-rails (0.3.4)
+      pry (>= 0.9.10)
+    rack (1.6.4)
+    rack-test (0.6.3)
+      rack (>= 1.0)
+    rails (4.2.6)
+      actionmailer (= 4.2.6)
+      actionpack (= 4.2.6)
+      actionview (= 4.2.6)
+      activejob (= 4.2.6)
+      activemodel (= 4.2.6)
+      activerecord (= 4.2.6)
+      activesupport (= 4.2.6)
+      bundler (>= 1.3.0, < 2.0)
+      railties (= 4.2.6)
+      sprockets-rails
+    rails-deprecated_sanitizer (1.0.3)
+      activesupport (>= 4.2.0.alpha)
+    rails-dom-testing (1.0.7)
+      activesupport (>= 4.2.0.beta, < 5.0)
+      nokogiri (~> 1.6.0)
+      rails-deprecated_sanitizer (>= 1.0.1)
+    rails-html-sanitizer (1.0.3)
+      loofah (~> 2.0)
+    railties (4.2.6)
+      actionpack (= 4.2.6)
+      activesupport (= 4.2.6)
+      rake (>= 0.8.7)
+      thor (>= 0.18.1, < 2.0)
+    rainbow (2.1.0)
+    rake (10.5.0)
+    rspec (0.9.4)
+    rspec-core (3.4.4)
+      rspec-support (~> 3.4.0)
+    rspec-expectations (3.4.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.4.0)
+    rspec-mocks (3.4.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.4.0)
+    rspec-rails (3.4.2)
+      actionpack (>= 3.0, < 4.3)
+      activesupport (>= 3.0, < 4.3)
+      railties (>= 3.0, < 4.3)
+      rspec-core (~> 3.4.0)
+      rspec-expectations (~> 3.4.0)
+      rspec-mocks (~> 3.4.0)
+      rspec-support (~> 3.4.0)
+    rspec-support (3.4.1)
+    rubocop (0.39.0)
+      parser (>= 2.3.0.7, < 3.0)
+      powerpack (~> 0.1)
+      rainbow (>= 1.99.1, < 3.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (~> 1.0, >= 1.0.1)
+    ruby-progressbar (1.7.5)
+    shoulda-matchers (3.1.1)
+      activesupport (>= 4.0.0)
+    simplecov (0.11.2)
+      docile (~> 1.1.0)
+      json (~> 1.8)
+      simplecov-html (~> 0.10.0)
+    simplecov-html (0.10.0)
+    slop (3.6.0)
+    sprockets (3.6.0)
+      concurrent-ruby (~> 1.0)
+      rack (> 1, < 3)
+    sprockets-rails (3.0.4)
+      actionpack (>= 4.0)
+      activesupport (>= 4.0)
+      sprockets (>= 3.0.0)
+    sqlite3 (1.3.11)
+    thor (0.19.1)
+    thread_safe (0.3.5)
+    tzinfo (1.2.2)
+      thread_safe (~> 0.1)
+    unicode-display_width (1.0.3)
+    with_advisory_lock (3.0.0)
+      activerecord (>= 3.2)
+      thread_safe
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.10)
+  configurations (~> 2.2.0)
+  database_cleaner (= 1.4.1)
+  factory_girl_rails (= 4.5.0)
+  ffaker (= 2.1.0)
+  monarchy!
+  pry-rails (= 0.3.4)
+  rake (~> 10.0)
+  rspec (~> 0)
+  rspec-rails
+  rubocop
+  shoulda-matchers
+  simplecov
+  sqlite3
+
+BUNDLED WITH
+   1.12.0

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Maciej Kwaśniak
+
+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/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2016 Maciej Kwaśniak
+
+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,18 @@
+[![Build Status](https://travis-ci.org/Exelord/Monarchy.svg?branch=master)](https://travis-ci.org/Exelord/Monarchy)
+![Monarchy Logo](monarchy.png?raw=true)
+
+## Documentation
+There is existing fully documentation for that project in our Wiki. Take a look at [Monarchy Documentation] (https://github.com/Exelord/Monarchy/wiki)
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/exelord/Monarchy. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](contributor-covenant.org) code of conduct.
+
+## Development
+Gem dependencies:
+- https://github.com/mceachen/closure_tree
+- https://github.com/beatrichartz/configurations
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/app/models/monarchy/hierarchy.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+class Monarchy::Hierarchy < ActiveRecord::Base
+  self.table_name = 'monarchy_hierarchies'
+  acts_as_hierarchy
+end

data/bin/console

@@ -0,0 +1,12 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'bundler/setup'
+require 'monarchy'
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+require 'pry'
+Pry.start

data/bin/setup

@@ -0,0 +1,7 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/generators/monarchy/resource_generator.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+require 'rails/generators/active_record'
+
+module Monarchy
+  class ResourceGenerator < Rails::Generators::NamedBase
+    include Rails::Generators::Migration
+
+    desc 'This generator creates a resourcify model'
+    source_root File.expand_path('../../templates', __FILE__)
+
+    def create_resource_file
+      template 'models/resource.rb', "app/models/#{file_name}.rb"
+      migration_template 'migrations/resource.rb', "db/migrate/create_#{file_name}_resource.rb"
+    end
+
+    def self.next_migration_number(dirname)
+      ActiveRecord::Generators::Base.next_migration_number(dirname)
+    end
+  end
+end

data/lib/generators/monarchy/setup_generator.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+require 'rails/generators/active_record'
+
+module Monarchy
+  class SetupGenerator < Rails::Generators::Base
+    include Rails::Generators::Migration
+
+    desc 'This generator setups Monarchy'
+    source_root File.expand_path('../../templates', __FILE__)
+
+    def setup_monarchy
+      template 'config.rb', 'config/initializers/monarchy.rb'
+      template 'models/user.rb', 'app/models/user.rb'
+      template 'models/hierarchy.rb', 'app/models/monarchy/hierarchy.rb'
+
+      migration_template 'migrations/hierarchy.rb', 'db/migrate/monarchy_create_hierarchies.rb'
+      migration_template 'migrations/membership.rb', 'db/migrate/monarchy_create_memberships.rb'
+      migration_template 'migrations/user.rb', 'db/migrate/monarchy_create_users.rb'
+    end
+
+    def self.next_migration_number(dirname)
+      ActiveRecord::Generators::Base.next_migration_number(dirname)
+    end
+  end
+end

data/lib/generators/templates/config.rb

@@ -0,0 +1,5 @@
+Monarchy.configure do |config|
+  config.default_role.name = :guest
+  config.default_role.level = 0
+  config.default_role.inherited = false
+end

data/lib/generators/templates/migrations/hierarchy.rb

@@ -0,0 +1,23 @@
+class MonarchyCreateHierarchies < ActiveRecord::Migration
+  def change
+    create_table :monarchy_hierarchies do |t|
+      t.integer :parent_id
+      t.integer :resource_id, null: false
+      t.string :resource_type, null: false
+      t.timestamps null: false
+    end
+
+
+    create_table :monarchy_hierarchy_hierarchies, id: false do |t|
+      t.integer :ancestor_id, null: false
+      t.integer :descendant_id, null: false
+      t.integer :generations, null: false
+    end
+
+    add_index :monarchy_hierarchy_hierarchies, [:ancestor_id, :descendant_id, :generations],
+              unique: true,
+              name: 'hierarchy_anc_desc_idx'
+
+    add_index :monarchy_hierarchy_hierarchies, [:descendant_id], name: 'hierarchy_desc_idx'
+  end
+end

data/lib/generators/templates/migrations/membership.rb

@@ -0,0 +1,26 @@
+class MonarchyCreateMemberships < ActiveRecord::Migration
+  def change
+    create_table :monarchy_members do |t|
+      t.belongs_to :user
+      t.belongs_to :hierarchy
+      t.timestamps null: false
+    end
+
+    create_table :monarchy_roles do |t|
+      t.string :name, null: false
+      t.integer :level, default: 0, null: false
+      t.boolean :inherited, default: false, null: false
+      t.timestamps null: false
+    end
+
+    add_index :monarchy_roles, :name, unique: true
+
+    create_table :monarchy_members_roles do |t|
+      t.belongs_to :role
+      t.belongs_to :member
+      t.timestamps null: false
+    end
+
+    add_index :monarchy_members_roles, [:role_id, :member_id], unique: true
+  end
+end

data/lib/generators/templates/migrations/resource.rb

@@ -0,0 +1,8 @@
+class Create<%= class_name %>Resource < ActiveRecord::Migration
+  def change
+    create_table :<%= file_name.pluralize %> do |t|
+      t.string :name
+      t.timestamps null: false
+    end
+  end
+end

data/lib/generators/templates/migrations/user.rb

@@ -0,0 +1,7 @@
+class MonarchyCreateUsers < ActiveRecord::Migration
+  def change
+    create_table :users do |t|
+      t.timestamps null: false
+    end
+  end
+end

data/lib/generators/templates/models/hierarchy.rb

@@ -0,0 +1,4 @@
+class Monarchy::Hierarchy < ActiveRecord::Base
+  self.table_name = 'monarchy_hierarchies'
+  acts_as_hierarchy
+end

data/lib/generators/templates/models/resource.rb

@@ -0,0 +1,3 @@
+class <%= class_name %> < ActiveRecord::Base
+  acts_as_resource
+end

data/lib/generators/templates/models/user.rb

@@ -0,0 +1,3 @@
+class User < ActiveRecord::Base
+  acts_as_user
+end

data/lib/monarchy/acts_as_hierarchy.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+module Monarchy
+  module ActsAsHierarchy
+    extend ActiveSupport::Concern
+
+    module ClassMethods
+      def acts_as_hierarchy
+        has_closure_tree dependent: :destroy
+
+        has_many :members, class_name: 'Monarchy::Member'
+        belongs_to :resource, polymorphic: true, dependent: :destroy
+
+        validates :resource, presence: true
+
+        include Monarchy::ActsAsHierarchy::InstanceMethods
+      end
+    end
+
+    module InstanceMethods
+      def memberless_ancestors_for(user)
+        ancestors.joins('LEFT JOIN monarchy_members on monarchy_hierarchies.id = monarchy_members.hierarchy_id')
+                 .where("monarchy_members.user_id != #{user.id} OR monarchy_members.id IS NULL")
+      end
+    end
+  end
+end
+
+ActiveRecord::Base.send :include, Monarchy::ActsAsHierarchy

data/lib/monarchy/acts_as_resource.rb

@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+module Monarchy
+  module ActsAsResource
+    extend ActiveSupport::Concern
+
+    module ClassMethods
+      def acts_as_resource(options = {})
+        parent_as(options[:parent_as]) if options[:parent_as]
+
+        after_create :ensure_hierarchy
+
+        has_many :members, through: :hierarchy
+        has_one :hierarchy, as: :resource, dependent: :destroy, class_name: 'Monarchy::Hierarchy'
+
+        include_scopes
+
+        include Monarchy::ActsAsResource::InstanceMethods
+      end
+
+      private
+
+      def parent_as(name)
+        define_method "#{name}=" do |value|
+          super(value)
+          self.parent = value
+        end
+      end
+
+      # rubocop:disable MethodLength
+      def include_scopes
+        scope :in, (lambda do |resource|
+          joins(:hierarchy).where(monarchy_hierarchies: { parent_id: resource.hierarchy.id })
+        end)
+
+        scope :accessible_for, (lambda do |user|
+          joins(:hierarchy)
+            .joins('INNER JOIN "monarchy_hierarchy_hierarchies" ON '\
+              '"monarchy_hierarchies"."id" = "monarchy_hierarchy_hierarchies"."ancestor_id"')
+            .joins('INNER JOIN "monarchy_members" ON '\
+              '"monarchy_members"."hierarchy_id" = "monarchy_hierarchy_hierarchies"."descendant_id"')
+            .where(monarchy_members: { user_id: user.id }).uniq
+        end)
+      end
+    end
+    # rubocop:enable MethodLength
+
+    module InstanceMethods
+      def parent
+        @parent = hierarchy.try(:parent).try(:resource) || @parent
+      end
+
+      def parent=(resource)
+        if hierarchy
+          hierarchy.update(parent: resource.try(:hierarchy))
+        else
+          @parent = resource
+        end
+      end
+
+      def children
+        @children ||= children_resources
+      end
+
+      def children=(array)
+        hierarchy.update(children: hierarchies_for(array)) if hierarchy
+
+        @children = array
+      end
+
+      private
+
+      def ensure_hierarchy
+        self.hierarchy ||= Monarchy::Hierarchy.create(
+          resource: self,
+          parent: parent.try(:hierarchy),
+          children: hierarchies_for(children)
+        )
+      end
+
+      def children_resources
+        c = hierarchy.try(:children)
+        return nil if c.nil?
+        c.includes(:resource).map(&:resource)
+      end
+
+      def hierarchies_for(array)
+        Array(array).map(&:hierarchy)
+      end
+    end
+  end
+end
+
+ActiveRecord::Base.send :include, Monarchy::ActsAsResource

data/lib/monarchy/acts_as_user.rb

@@ -0,0 +1,98 @@
+# frozen_string_literal: true
+module Monarchy
+  module ActsAsUser
+    extend ActiveSupport::Concern
+
+    module ClassMethods
+      def acts_as_user
+        has_many :members, class_name: 'Monarchy::Member'
+
+        include Monarchy::ActsAsUser::InstanceMethods
+      end
+    end
+
+    module InstanceMethods
+      def role_for(resource)
+        ancestors_ids = resource.hierarchy.self_and_ancestors_ids
+        Monarchy::Role.joins(:members)
+                      .where("((monarchy_roles.inherited = 't' "\
+                       "AND monarchy_members.hierarchy_id IN (#{ancestors_ids.join(',')})) "\
+                       "OR (monarchy_members.hierarchy_id = #{resource.hierarchy.id})) "\
+                       "AND monarchy_members.user_id = #{id}")
+                      .order(level: :desc).first
+      end
+
+      def grant(role_name, resource)
+        ActiveRecord::Base.transaction do
+          Monarchy::Member.create(build_members(resource.hierarchy.memberless_ancestors_for(self)))
+          grant_or_create_member(role_name, resource)
+        end
+      end
+
+      def member_for(resource)
+        resource.hierarchy.members.where("monarchy_members.user_id": id).first
+      end
+
+      def revoke_access(resource)
+        self_and_descendant_ids = resource.hierarchy.self_and_descendant_ids
+
+        ActiveRecord::Base.transaction do
+          members_roles_for(self_and_descendant_ids).destroy_all
+          try_revoke_ancestors_for(resource)
+        end
+      end
+
+      def revoke_role(role_name, resource)
+        members_roles = member_for(resource).members_roles
+
+        if only_this_role(members_roles, role_name)
+          revoke_access(resource)
+        else
+          members_roles.joins(:role).where("monarchy_roles.name": role_name).destroy_all
+        end
+      end
+
+      private
+
+      def grant_or_create_member(role_name, resource)
+        role = Monarchy::Role.find_by(name: role_name)
+        member = member_for(resource)
+
+        if member
+          Monarchy::MembersRole.create(member: member, role: role)
+        else
+          member = Monarchy::Member.create(build_members(resource.hierarchy, [role])).first
+        end
+
+        member
+      end
+
+      def build_members(hierarchies, roles = [])
+        Array(hierarchies).map { |hierarchy| { user: self, hierarchy: hierarchy, roles: roles } }
+      end
+
+      def equal_role_name?(role, role_name)
+        role.name == role_name.to_s
+      end
+
+      def only_this_role(members_roles, role_name = nil)
+        role_name ||= Monarchy.configuration.default_role.name.to_s
+        members_roles.count == 1 && equal_role_name?(members_roles.first.role, role_name)
+      end
+
+      def members_roles_for(hierarchy_ids)
+        Monarchy::MembersRole.joins(:member)
+                             .where(monarchy_members: { hierarchy_id: hierarchy_ids, user_id: id })
+      end
+
+      def try_revoke_ancestors_for(resource)
+        resource.hierarchy.ancestors.each do |hierarchy|
+          members_roles = members_roles_for(hierarchy.self_and_descendant_ids)
+          only_this_role(members_roles) ? members_roles.destroy_all : break
+        end
+      end
+    end
+  end
+end
+
+ActiveRecord::Base.send :include, Monarchy::ActsAsUser

data/lib/monarchy/engine.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+module Monarchy
+  class Engine < Rails::Engine
+    isolate_namespace Monarchy
+  end
+end

data/lib/monarchy/membership.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+module Monarchy
+  class Member < ActiveRecord::Base
+    self.table_name = 'monarchy_members'
+
+    has_many :members_roles, dependent: :destroy
+    has_many :roles, through: :members_roles
+
+    belongs_to :user
+    belongs_to :hierarchy
+
+    delegate :resource, to: :hierarchy
+    delegate :resource=, to: :hierarchy
+
+    validates :user_id, uniqueness: { scope: :hierarchy_id }
+    validates :user, presence: true
+    validates :hierarchy, presence: true
+
+    before_create :set_default_role
+
+    private
+
+    def set_default_role
+      roles = self.roles
+      roles << Monarchy::Role.find_or_create_by(
+        name: Monarchy.configuration.default_role.name,
+        inherited: Monarchy.configuration.default_role.inherited,
+        level: Monarchy.configuration.default_role.level)
+      self.roles = roles.uniq
+    end
+  end
+
+  class Role < ActiveRecord::Base
+    self.table_name = 'monarchy_roles'
+
+    has_many :members_roles, dependent: :destroy
+    has_many :members, through: :members_roles
+  end
+
+  class MembersRole < ActiveRecord::Base
+    self.table_name = 'monarchy_members_roles'
+
+    belongs_to :member
+    belongs_to :role
+
+    validates :role_id, uniqueness: { scope: :member_id }
+  end
+end

data/lib/monarchy/version.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+module Monarchy
+  VERSION = '0.2.1'
+end

data/lib/monarchy.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+require 'closure_tree'
+require 'configurations'
+
+require 'monarchy/acts_as_hierarchy'
+require 'monarchy/acts_as_resource'
+require 'monarchy/acts_as_user'
+require 'monarchy/membership'
+require "monarchy/engine"
+
+module Monarchy
+  include Configurations
+
+  not_configured do |prop|
+    raise NoMethodError, "#{prop} must be configured"
+  end
+end

data/lib/tasks/monarchy_tasks.rake

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+# desc "Explaining what the task does"
+# task :monarchy do
+#   # Task goes here
+# end

data/monarchy.gemspec

@@ -0,0 +1,35 @@
+# coding: utf-8
+# frozen_string_literal: true
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'monarchy/version'
+
+# Describe your gem and declare its dependencies:
+Gem::Specification.new do |s|
+  s.name        = 'monarchy'
+  s.version     = Monarchy::VERSION
+  s.authors     = ['Exelord']
+  s.email       = ['']
+  s.homepage    = 'https://github.com/Exelord/Monarchy'
+  s.summary     = 'Hierarchical access management system with roles inheritance.'
+  s.description = s.summary
+  s.license     = 'MIT'
+
+  s.files = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  s.test_files = Dir['test/**/*']
+
+  raise 'RubyGems 2.0 or newer is required to protect against public gem pushes.' unless s.respond_to?(:metadata)
+  s.metadata['allowed_push_host'] = 'https://rubygems.org'
+
+  s.bindir        = 'exe'
+  s.executables   = s.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  s.require_paths = ['lib']
+
+  s.add_runtime_dependency 'rails', '~> 4.2', '>= 4.2.4'
+  s.add_dependency 'closure_tree', '6.0.0'
+  s.add_dependency 'configurations', '2.2.0'
+
+  s.add_development_dependency 'bundler', '~> 1.10'
+  s.add_development_dependency 'rake', '~> 10.0'
+  s.add_development_dependency 'rspec', '~> 0'
+end

metadata

@@ -0,0 +1,170 @@
+--- !ruby/object:Gem::Specification
+name: monarchy
+version: !ruby/object:Gem::Version
+  version: 0.2.1
+platform: ruby
+authors:
+- Exelord
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2016-05-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.2.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.2.4
+- !ruby/object:Gem::Dependency
+  name: closure_tree
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 6.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 6.0.0
+- !ruby/object:Gem::Dependency
+  name: configurations
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.2.0
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Hierarchical access management system with roles inheritance.
+email:
+- ''
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".lock-ClosureTreeMonarchyHierarchy-1609118677"
+- ".rspec"
+- ".rubocop.yml"
+- ".travis.yml"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- MIT-LICENSE
+- README.md
+- Rakefile
+- app/models/monarchy/hierarchy.rb
+- bin/console
+- bin/setup
+- lib/generators/monarchy/resource_generator.rb
+- lib/generators/monarchy/setup_generator.rb
+- lib/generators/templates/config.rb
+- lib/generators/templates/migrations/hierarchy.rb
+- lib/generators/templates/migrations/membership.rb
+- lib/generators/templates/migrations/resource.rb
+- lib/generators/templates/migrations/user.rb
+- lib/generators/templates/models/hierarchy.rb
+- lib/generators/templates/models/resource.rb
+- lib/generators/templates/models/user.rb
+- lib/monarchy.rb
+- lib/monarchy/acts_as_hierarchy.rb
+- lib/monarchy/acts_as_resource.rb
+- lib/monarchy/acts_as_user.rb
+- lib/monarchy/engine.rb
+- lib/monarchy/membership.rb
+- lib/monarchy/version.rb
+- lib/tasks/monarchy_tasks.rake
+- monarchy.gemspec
+- monarchy.png
+homepage: https://github.com/Exelord/Monarchy
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+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.5.1
+signing_key: 
+specification_version: 4
+summary: Hierarchical access management system with roles inheritance.
+test_files: []