bullet_train-roles 0.1.5 → 0.1.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 51bbbee558714e45bdff2dadf3735cf8a2fce88d7e7e3a8144880c245bb8e384
-  data.tar.gz: 419402bc1f7560bc932c202275091456e4a68ddd271ddf7382df57b7f4b21b1f
+  metadata.gz: 4fafcbc375644791ab3480a2bee1e43f19074e3efa30809d4770a27e80d25634
+  data.tar.gz: fc145307e762f0abc11839dd2710c5b11ed2747a9b514f5a32d4707268d35a21
 SHA512:
-  metadata.gz: 30bfee959c7c45e7dda23c7d4f71fa44a1efc9499e3bd5244e48e55895ff88e21fc26ade42def3591661c0aef1796762edae9a05625b1145822c5eb3a71cfc43
-  data.tar.gz: 6da43045a530531c8910f4c456f7c5b7211ac90f9cce69d05fc7a7456fedb664d099a951d0c5fdd131f4daa8f0784ac36add7837bfcc7760ff5193c22191c21c
+  metadata.gz: cf85bf3d3df4a12751b7ac55fedf7917ec2634956e7df9c2a4d8a43e65000ff36b8740f1f0974b97e6cba4929831ef54159035a4dd4f5504fa8ef359cab95ed6
+  data.tar.gz: e34a82313a0291b967222780dde2e60d7ab3c14131e97270c1c1dd5c20073758e3d9347d4046c56fcc26ece2581347438e82eded64e067a19ba9fe3fdd2e42e0

data/.circleci/config.yml

@@ -1,86 +1,124 @@
 version: 2.1
 orbs:
   ruby: circleci/ruby@0.1.2
-
+  browser-tools: circleci/browser-tools@1.1
 aliases:
   - &restore_bundler_cache
-    name: Restore Bundler cache
-    keys:
-      - gem-cache-v1-{{ .Branch }}-{{ checksum "Gemfile.lock" }}
-      - gem-cache-v1-{{ .Branch }}-
-      - gem-cache-v1-
+      name: Restore Bundler cache
+      keys:
+        - gem-cache-v1-{{ .Branch }}-{{ checksum "Gemfile.lock" }}
+        - gem-cache-v1-{{ .Branch }}-
+        - gem-cache-v1-
   - &restore_yarn_cache
-    name: Restore Yarn cache
-    keys:
-      - yarn-packages-v1-{{ .Branch }}-{{ checksum "yarn.lock" }}
-      - yarn-packages-v1-{{ .Branch }}-
-      - yarn-packages-
+      name: Restore Yarn cache
+      keys:
+        - yarn-packages-v1-{{ .Branch }}-{{ checksum "yarn.lock" }}
+        - yarn-packages-v1-{{ .Branch }}-
+        - yarn-packages-
   - &save_bundle_cache
-    name: Save Bundle cache
-    key: gem-cache-v1-{{ .Branch }}-{{ checksum "Gemfile.lock" }}
-    paths:
-      - vendor/bundle
+      name: Save Bundle cache
+      key: gem-cache-v1-{{ .Branch }}-{{ checksum "Gemfile.lock" }}
+      paths:
+        - vendor/bundle
   - &save_yarn_cache
-    name: Save Yarn cache
-    key: yarn-packages-v1-{{ .Branch }}-{{ checksum "yarn.lock" }}
-    paths:
-      - node_modules
-
+      name: Save Yarn cache
+      key: yarn-packages-v1-{{ .Branch }}-{{ checksum "yarn.lock" }}
+      paths:
+        - node_modules
+  - &ruby_node_browsers_docker_image
+      - image: cimg/ruby:3.1.2-browsers
+        environment:
+          PGHOST: localhost
+          PGUSER: untitled_application
+          RAILS_ENV: test
+  - &postgres_docker_image
+      - image: circleci/postgres
+        environment:
+          POSTGRES_HOST_AUTH_METHOD: trust
+          POSTGRES_DB: untitled_application_test
+          POSTGRES_USER: untitled_application
+  - &wait_for_docker
+      # We run this because the DB might not be available for a while due to a race condition.
+      run: dockerize -wait tcp://localhost:5432 -timeout 1m
 jobs:
-  'Standard Ruby':
+  'Local Minitest':
+    docker:
+      - <<: *ruby_node_browsers_docker_image
+      - <<: *postgres_docker_image
+      - image: circleci/redis
+    executor: ruby/default
+    steps:
+      - browser-tools/install-browser-tools
+      - checkout
+
+      # Install dependencies
+      - run: "bundle install"
+      - run: "bundle clean --force"
+      - run: "yarn install"
+      - *wait_for_docker
+      - run:
+          name: Run unit tests
+          command: bundle exec rails test
+
+  'Local Standard Ruby':
     docker:
-      # normal ruby image is also sufficient here but we are using node-browsers so that we can make use of caching and speed up the process since other jobs are also using the same image
-      - image: circleci/ruby:3.0.2-node-browsers
+      - <<: *ruby_node_browsers_docker_image
     steps:
       - checkout
 
-      # Restore dependency caches
-      - restore_cache: *restore_bundler_cache
-      - restore_cache: *restore_yarn_cache
+      # TODO Figure out how to make these work for `tmp/starter`
+      # # Restore dependency caches
+      # - restore_cache: *restore_bundler_cache
+      # - restore_cache: *restore_yarn_cache
 
       # Install dependencies
       - ruby/bundle-install
       - run: bundle clean --force
       - run: yarn install
 
-      # Save dependency caches
-      # We only do this as part of this job, because it's time consuming and we don't want it to slow down test runners.
-      - save_cache: *save_bundle_cache
-      - save_cache: *save_yarn_cache
+      # # Save dependency caches
+      # # We only do this as part of this job, because it's time consuming and we don't want it to slow down test runners.
+      # - save_cache: *save_bundle_cache
+      # - save_cache: *save_yarn_cache
 
       - run:
           name: Check Standard Ruby
           command: bundle exec standardrb
 
-  'Minitest':
+  'Starter Repo Minitest':
     docker:
-      - image: circleci/ruby:3.0.2-node-browsers
-        environment:
-          PGHOST: localhost
-          PGUSER: bullet_train
-          RAILS_ENV: test
-      - image: circleci/postgres
-        environment:
-          POSTGRES_HOST_AUTH_METHOD: trust
-          POSTGRES_DB: bullet_train_test
-          POSTGRES_USER: bullet_train
+      - <<: *ruby_node_browsers_docker_image
+      - <<: *postgres_docker_image
+      - image: circleci/redis
     executor: ruby/default
     parallelism: 16
     steps:
+      - browser-tools/install-browser-tools
       - checkout
-      - restore_cache: *restore_bundler_cache
-      - restore_cache: *restore_yarn_cache
+      - run: "git clone https://github.com/bullet-train-co/bullet_train.git tmp/starter"
+
+      - run:
+          name: Link starter repository to the Ruby gem being tested.
+          command: "grep -v 'gem \"bullet_train-roles\"' tmp/starter/Gemfile > tmp/starter/Gemfile.tmp && mv tmp/starter/Gemfile.tmp tmp/starter/Gemfile && echo 'gem \"bullet_train-roles\", path: \"../..\"' >> tmp/starter/Gemfile"
+
+      # TODO Figure out how to make these work for `tmp/starter`
+      # - restore_cache: *restore_bundler_cache
+      # - restore_cache: *restore_yarn_cache
 
       # Install dependencies
-      - ruby/bundle-install
-      - run: bundle clean --force
+      - run: "cd tmp/starter && bundle install"
+      - run: "cd tmp/starter && bundle clean --force"
+      - run: "cd tmp/starter && bundle exec rake bt:link"
+      - run: "cd tmp/starter && yarn install"
+      - run: "cd tmp/starter && yarn build"
+      - run: "cd tmp/starter && yarn build:css"
 
-      # We run this because the DB might not be available for a while due to a race condition.
-      - run: dockerize -wait tcp://localhost:5432 -timeout 1m
+      - *wait_for_docker
 
       - run:
           name: Run tests with Knapsack Pro
           command: |
+            cd tmp/starter
             export RAILS_ENV=test
             bundle exec rails "knapsack_pro:queue:minitest[--verbose]"
           environment:
@@ -102,9 +140,48 @@ jobs:
       # - store_test_results:
       #     path: test/reports
 
+  'Starter Repo Minitest for Super Scaffolding':
+    docker:
+      - <<: *ruby_node_browsers_docker_image
+      - <<: *postgres_docker_image
+      - image: circleci/redis
+    executor: ruby/default
+    steps:
+      - browser-tools/install-browser-tools
+      - checkout
+      - run: "git clone https://github.com/bullet-train-co/bullet_train.git tmp/starter"
+
+      - run:
+          name: Link starter repository to the Ruby gem being tested.
+          command: "grep -v 'gem \"bullet_train-roles\"' tmp/starter/Gemfile > tmp/starter/Gemfile.tmp && mv tmp/starter/Gemfile.tmp tmp/starter/Gemfile && echo 'gem \"bullet_train-roles\", path: \"../..\"' >> tmp/starter/Gemfile"
+
+      # TODO Figure out how to make these work for `tmp/starter`
+      # # Restore dependency caches
+      # - restore_cache: *restore_bundler_cache
+      # - restore_cache: *restore_yarn_cache
+
+      # Install dependencies
+      - run: "cd tmp/starter && bundle install"
+      - run: "cd tmp/starter && bundle clean --force"
+      - run: "cd tmp/starter && bundle exec rake bt:link"
+      - run: "cd tmp/starter && yarn install"
+      - run: "cd tmp/starter && yarn build"
+      - run: "cd tmp/starter && yarn build:css"
+
+      - *wait_for_docker
+
+      - run:
+          name: 'Setup Super Scaffolding System Test'
+          command: "cd tmp/starter && bundle exec test/bin/setup-super-scaffolding-system-test"
+      - run:
+          name: 'Run Super Scaffolding Test'
+          command: "cd tmp/starter && bundle exec rails test test/system/super_scaffolding_test.rb"
+
 workflows:
   version: 2
   build:
     jobs:
-      - 'Standard Ruby'
-      - 'Minitest'
+      - 'Local Minitest'
+      - 'Local Standard Ruby'
+      - 'Starter Repo Minitest'
+      - 'Starter Repo Minitest for Super Scaffolding'

data/Gemfile.lock

@@ -9,7 +9,7 @@ GIT
 PATH
   remote: .
   specs:
-    bullet_train-roles (0.1.4)
+    bullet_train-roles (0.1.8)
       active_hash
       activesupport
       cancancan
@@ -79,7 +79,7 @@ GEM
     ast (2.4.2)
     builder (3.2.4)
     byebug (11.1.3)
-    cancancan (3.3.0)
+    cancancan (3.4.0)
     concurrent-ruby (1.1.9)
     crass (1.0.6)
     erubi (1.10.0)
@@ -106,6 +106,8 @@ GEM
     nio4r (2.5.8)
     nokogiri (1.12.5-arm64-darwin)
       racc (~> 1.4)
+    nokogiri (1.12.5-x86_64-darwin)
+      racc (~> 1.4)
     parallel (1.21.0)
     parser (3.0.3.2)
       ast (~> 2.4.1)
@@ -174,6 +176,7 @@ GEM
 PLATFORMS
   arm64-darwin-20
   arm64-darwin-21
+  x86_64-darwin-21
 
 DEPENDENCIES
   active_hash!

data/README.md

@@ -68,7 +68,7 @@ editor:
   manageable_roles:
     - editor
   models:
-    Project: manage
+    Project: crud
 
 billing:
   manageable_roles:
@@ -98,7 +98,8 @@ The following things are true given the example configuration above:
  - By default, users on a team are read-only participants.
  - Users with the `editor` role:
    - can give other users the `editor` role.
-   - can modify project details.
+   - can perform crud actions on project (create, read, update and destroy).
+   - cannot perform any custom controller actions the projects controller responds to
  - Users with the `billing` role:
    - can give other users the `billing` role.
    - can create and update billing subscriptions.

data/lib/bullet_train/roles/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Roles
-  VERSION = "0.1.5"
+  VERSION = "0.1.8"
 end

data/lib/models/role.rb

@@ -89,9 +89,9 @@ class Role < ActiveYaml::Base
     !default?
   end
 
-  def ability_generator(user, through, parent)
+  def ability_generator(user, through, parent, intermediary)
     models.each do |model_name, _|
-      ag = AbilityGenerator.new(self, model_name, user, through, parent)
+      ag = AbilityGenerator.new(self, model_name, user, through, parent, intermediary)
       yield(ag)
     end
   end
@@ -125,7 +125,7 @@ class Role < ActiveYaml::Base
   class AbilityGenerator
     attr_reader :model
 
-    def initialize(role, model_name, user, through, parent_name)
+    def initialize(role, model_name, user, through, parent_name, intermediary = nil)
       begin
         @model = model_name.constantize
       rescue NameError
@@ -137,6 +137,8 @@ class Role < ActiveYaml::Base
       @through = through
       @parent = user.send(through).reflect_on_association(parent_name)&.klass
       @parent_ids = user.parent_ids_for(@role, @through, parent_name) if @parent
+      @intermediary = intermediary
+      @intermediary_class = @model.reflect_on_association(intermediary)&.class_name&.constantize if @intermediary.present?
     end
 
     def valid?
@@ -145,9 +147,16 @@ class Role < ActiveYaml::Base
 
     def actions
       return @actions if @actions
-      actions = (@ability_data["actions"] if @ability_data.is_a?(Hash)) || @ability_data
-      actions = [actions] unless actions.is_a?(Array)
-      @actions = actions.map!(&:to_sym)
+      @actions = (@ability_data["actions"] if @ability_data.is_a?(Hash)) || @ability_data
+      # crud is a special value that we substitute for the 4 crud actions
+      # This is instead of :manage which covers all 4 actions _and_ any extra actions the controller may respond to
+      @actions = crud_actions if @actions.to_s.downcase == "crud"
+      @actions = [actions] unless actions.is_a?(Array)
+      @actions.map!(&:to_sym)
+    end
+
+    def crud_actions
+      [:create, :read, :update, :destroy]
     end
 
     def possible_parent_associations
@@ -167,15 +176,18 @@ class Role < ActiveYaml::Base
       if @model == @parent
         return @condition = {id: @parent_ids}
       end
-      parent_association = possible_parent_associations.find { |association| @model.method_defined?(association) || @model.method_defined?("#{association}_id") }
+      parent_association = possible_parent_associations.find { |association| @model.reflect_on_association(association) || @intermediary_class&.reflect_on_association(association) }
       return nil unless parent_association.present?
-      # If possible, use the team_id attribute because it saves us having to join all the way back to the sorce parent model
+      # If possible, use the team_id attribute because it saves us having to join all the way back to the source parent model
       # In some scenarios this may be quicker, or if the parent model is in a different database shard, it may not even
       # be possible to do the join
-      if @model.method_defined?("#{parent_association}_id")
-        @condition = {"#{parent_association}_id".to_sym => @parent_ids}
+      parent_with_id = "#{parent_association}_id"
+      @condition = if @model.column_names.include?(parent_with_id)
+        {parent_with_id.to_sym => @parent_ids}
+      elsif @intermediary.present? && @model.reflect_on_association(@intermediary)
+        {@intermediary.to_sym => {parent_with_id.to_sym => @parent_ids}}
       else
-        @condition = {parent_association => {id: @parent_ids}}
+        {parent_association => {id: @parent_ids}}
       end
     end
   end

data/lib/roles/permit.rb

@@ -2,7 +2,7 @@
 
 module Roles
   module Permit
-    def permit(user, through:, parent:, debug: false)
+    def permit(user, through:, parent:, debug: false, intermediary: nil)
       # Without this, you need to restart the server each time you make changes to the config/models/role.yml file
       Role.reload(true) if Rails.env.development?
 
@@ -13,14 +13,14 @@ module Roles
       user.send(through).map(&:roles).flatten.uniq.each do |role|
         unless added_roles.include?(role)
           output << "########### ROLE: #{role.key}"
-          output += add_abilities_for(role, user, through, parent)
+          output += add_abilities_for(role, user, through, parent, intermediary)
           added_roles << role
         end
 
         role.included_roles.each do |included_role|
           unless added_roles.include?(included_role)
             output << "############# INCLUDED ROLE: #{included_role.key}"
-            output += add_abilities_for(included_role, user, through, parent)
+            output += add_abilities_for(included_role, user, through, parent, intermediary)
           end
         end
       end
@@ -33,9 +33,9 @@ module Roles
       end
     end
 
-    def add_abilities_for(role, user, through, parent)
+    def add_abilities_for(role, user, through, parent, intermediary)
       output = []
-      role.ability_generator(user, through, parent) do |ag|
+      role.ability_generator(user, through, parent, intermediary) do |ag|
         if ag.valid?
           output << "can #{ag.actions}, #{ag.model}, #{ag.condition}"
           can(ag.actions, ag.model, ag.condition)

data/lib/roles/support.rb

@@ -71,7 +71,7 @@ module Roles
       end
 
       def roles=(roles)
-        self.role_ids = roles.map(&:key)
+        update(role_ids: roles.map(&:key))
       end
 
       def assignable_roles

data/lib/roles/user.rb

@@ -10,16 +10,19 @@ module Roles
       def parent_ids_for(role, through, parent)
         parent_id_column = "#{parent}_id"
         key = "#{role.key}_#{through}_#{parent_id_column}s"
+
+        @_parent_ids_for_cache ||= {}
+        return @_parent_ids_for_cache[key] if @_parent_ids_for_cache[key]
+
         # TODO Maybe we should make ability caching a default feature of the gem?
         # If we do that, we would just make it check whether `ability_cache` exists.
         # return ability_cache[key] if ability_cache && ability_cache[key]
         role = nil if role.default?
-        value = send(through).with_role(role).distinct.pluck(parent_id_column)
+        @_parent_ids_for_cache[key] = send(through).with_role(role).distinct.pluck(parent_id_column)
         # TODO Maybe we should make ability caching a default feature of the gem?
         # current_cache = ability_cache || {}
         # current_cache[key] = value
         # update_column :ability_cache, current_cache
-        value
       end
     end
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bullet_train-roles
 version: !ruby/object:Gem::Version
-  version: 0.1.5
+  version: 0.1.8
 platform: ruby
 authors:
 - Prabin Poudel
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-02-11 00:00:00.000000000 Z
+date: 2022-07-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: byebug