thelinuxlich-aegis 1.1.8 → 1.1.9

data/README.rdoc

@@ -13,12 +13,49 @@ Alternatively, use
     sudo gem install thelinuxlich-aegis
 
 == Changes in this fork
-Now you can set the permission prefix with your locale(default is 'may')
+WARNING! Opinionated stuff!
+Now you can set the permission prefix, admin and crud verbs with your locale(default is 'may','admin','read','write','update' and 'destroy', respectively)
 Example: in locale/en.yml:
   aegis:
-    permission_prefix: 'should'
+    permission: 'should'
+    admin: 'manage'
+    read: 'access'
+    write: 'insert'
+    update: 'update'
+    destroy: 'delete'
+
+And then you can verify authorization with current_user.should_access_posts?
+
+Also, there is a class method you can put on ApplicationController(or anything that extends ActionController::Base) to automatically add before_filter to all REST actions verifying authorization:
+  authorize_first!(:current_user, options)
+  
+  First parameter is a string containing the method to access the current user on your favorite authentication gem, second parameter accepts :except => [ARRAY_OF_CONTROLLER_NAMES]
+
+The user class now can call has_role :special_permissions => true, and it will add a has_many association with special_permissions to really customize what every role can access.
+
+In Permissions class, you can add restful_permissions!(:except => [ARRAY_OF_CONTROLLER_NAMES]) and it will add the 4 crud verbs to verify permission with every role, first verifying if the current user has admin access then verifying in SpecialPermission association.
+Example: Imagine we have a controller called Posts. It will add the permission methods may_read_posts?, may_write_posts?, may_update_posts?, may_destroy_posts?, all customizable with locales.
+
+For special permissions, you'll also need a table for it. Create a migration like this:
+  class CreateSpecialPermissions < ActiveRecord::Migration
+    def self.up
+      create_table :special_permissions do |t|
+        t.integer :user_id
+        t.string :permission_module
+        t.boolean :permission_read, :default => false
+        t.boolean :permission_write, :default => false
+        t.boolean :permission_destroy, :default => false
+        t.boolean :permission_update, :default => false
+        t.timestamps
+      end
+    end
+  
+    def self.down
+      drop_table :special_permissions
+    end
+  end
 
-And then you can verify authorization with current_user.should_edit_posts?
+Until I fix the generator, the migration part is manual, unfortunately :(
 
 == Example 
 

data/VERSION

@@ -1 +1 @@
-1.1.8
+1.1.9

data/thelinuxlich-aegis.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{thelinuxlich-aegis}
-  s.version = "1.1.8"
+  s.version = "1.1.9"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["thelinuxlich"]
-  s.date = %q{2010-03-24}
+  s.date = %q{2010-03-29}
   s.description = %q{Aegis is a role-based permission system, where all users are given a role. It is possible to define detailed and complex permissions for each role very easily.}
   s.email = %q{thelinuxlich@gmail.com}
   s.extra_rdoc_files = [
@@ -17,7 +17,6 @@ Gem::Specification.new do |s|
   ]
   s.files = [
     ".gitignore",
-     ":test",
      "MIT-LICENSE",
      "README.rdoc",
      "Rakefile",

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 1
   - 1
-  - 8
-  version: 1.1.8
+  - 9
+  version: 1.1.9
 platform: ruby
 authors: 
 - thelinuxlich
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-03-24 00:00:00 -03:00
+date: 2010-03-29 00:00:00 -03:00
 default_executable: 
 dependencies: []
 
@@ -28,7 +28,6 @@ extra_rdoc_files:
 - README.rdoc
 files: 
 - .gitignore
-- ":test"
 - MIT-LICENSE
 - README.rdoc
 - Rakefile