destiny-rails 0.0.8 → 0.0.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: d50f700397f25507ff740607629d8423ae613653
-  data.tar.gz: 8172af96c06e85e2aed7229d1bf8eeac10a2b9f8
+  metadata.gz: 82e0fb482a9edca20552d9f0ccfb0c6347bcf20f
+  data.tar.gz: d2445fe6d824947f555a5ef7e489daaa866ca2f5
 SHA512:
-  metadata.gz: 315fd8200e89aab2e4d27e28b442a3da378d28567982c91f306c29ee78a5d375e8ddf9ad527a5637f7ead11b59c164c274c3564cdf1f652d8f1267cd5724438d
-  data.tar.gz: 16f7ae13309213e4993ee037521eda0251d5f72c233d6942458ed89d2e82283a0047921654ee50b40aa21f813651c5c8463bc2538a4a9f41795b98d7cf6f0b64
+  metadata.gz: 0fdc6c8ebc179921ccaebf2ee4a460d0d2f4bbfa11115203b31113410fbc7a52729273dec8398220898df85d9f9b5f8095ef90811ef3e4f06aaee52cdcd35b32
+  data.tar.gz: 6265aaf5476cf150d3eec2532f0f838748379f0c4b452165e686d6056c3fabcb0dc00525e66310dd51f49eb8a4b3d42d8ef9fc29ebfe28e9da026a4febcc5d0f

data/README.md

@@ -1,12 +1,34 @@
 # Destiny
 Simple role managment system
 
-Roles persisted in the database. Role is as a composition of grants. Roles may be assigned to user.
+## Concepts
+
+Developer should be able to check permission of a user to perform an action.
+Grant is an opportunity to make a particular action with some class of objects. Role is an aggregation of grants.
+Roles persisted in the database.
+Any number of roles may be assigned to user.
 
 ## Installation
 
+### Gem
+In the command line
+```
+gem install destiny-rails
+```
+or in your Gemfile
+```
+gem 'destiny-rails'
+```
+
 ### Rails
 
 ```bash
 rails g destiny:install
 ```
+
+## Assumptions
+
+1. Your app has a user model called 'User'
+2. App's controller should have (integration purpose only)
+  * 'current_user' method returning instance of a user model
+  * 'access_denied' method which contains response logic in this case

data/app/models/concerns/destiny/role.rb

@@ -10,8 +10,17 @@ module Destiny
       data.to_hash
     end
 
-    def role_hash
-      to_hash
+    def grant(section_name, privilege)
+      data[section_name] ||= {}
+      data[section_name][privilege] = true
     end
+
+    def revoke(section_name, privilege)
+      if data.key? section_name
+        data[section_name].delete(privilege) if data[section_name].key? privilege
+        data.delete(section_name) if data[section_name].empty?
+      end
+    end
+
   end
 end

data/app/models/concerns/destiny/user.rb

@@ -6,12 +6,12 @@ module Destiny
       has_and_belongs_to_many :roles, join_table: :users_roles
     end
 
-    def has_grant?(section_name, grant_name)
+    def permitted?(section_name, privilege)
       return true if is_admin?
       return false unless role_hash[section_name]
-      return false unless role_hash[section_name].key? grant_name
+      return false unless role_hash[section_name].key? privilege
 
-      role_hash[section_name][grant_name]
+      role_hash[section_name][privilege]
     end
 
     def owner?(obj)
@@ -30,11 +30,12 @@ module Destiny
 
     # compatibility with The_Role gem
     alias_method :admin?, :is_admin?
-    alias_method :has_role?, :has_grant?
+    alias_method :has_role?, :permitted?
+    alias_method :has_grant?, :permitted?
 
     module ClassMethods
       def with_role(role_name)
-        ::Role.find_by_name(role_name).users
+        ::Role.find_by_name(role_name).try(:users)
       end
     end
 

data/lib/destiny/version.rb

@@ -1,3 +1,3 @@
 module Destiny
-  VERSION = '0.0.8'
+  VERSION = '0.0.9'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: destiny-rails
 version: !ruby/object:Gem::Version
-  version: 0.0.8
+  version: 0.0.9
 platform: ruby
 authors:
 - Pavel Zhukov
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-03-21 00:00:00.000000000 Z
+date: 2017-04-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler