consul 0.1.2 → 0.2.0

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: consul
 version: !ruby/object:Gem::Version 
-  hash: 31
+  hash: 23
   prerelease: 
   segments: 
   - 0
-  - 1
   - 2
-  version: 0.1.2
+  - 0
+  version: 0.2.0
 platform: ruby
 authors: 
 - Henning Koch
@@ -15,29 +15,131 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-07-07 00:00:00 Z
-dependencies: []
-
-description: Consul is a scope-based authorization solution for Ruby on Rails.
+date: 2012-02-28 00:00:00 +01:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  name: rails
+  version_requirements: *id001
+  type: :runtime
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  name: assignable_values
+  version_requirements: *id002
+  type: :runtime
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 5
+        segments: 
+        - 2
+        - 3
+        version: "2.3"
+  name: rails
+  version_requirements: *id003
+  type: :development
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 9
+        segments: 
+        - 1
+        - 3
+        version: "1.3"
+  name: rspec
+  version_requirements: *id004
+  type: :development
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 9
+        segments: 
+        - 1
+        - 3
+        version: "1.3"
+  name: rspec-rails
+  version_requirements: *id005
+  type: :development
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  requirement: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  name: shoulda-matchers
+  version_requirements: *id006
+  type: :development
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  requirement: &id007 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  name: sqlite3
+  version_requirements: *id007
+  type: :development
+description: A scope-based authorization solution for Ruby on Rails.
 email: henning.koch@makandra.de
 executables: []
 
 extensions: []
 
-extra_rdoc_files: 
-- README.rdoc
+extra_rdoc_files: []
+
 files: 
 - .gitignore
 - Gemfile
-- README.rdoc
+- README.md
 - Rakefile
-- VERSION
 - consul.gemspec
 - lib/consul.rb
+- lib/consul/active_record.rb
 - lib/consul/controller.rb
 - lib/consul/errors.rb
 - lib/consul/power.rb
 - lib/consul/spec/matchers.rb
+- lib/consul/version.rb
 - spec/app_root/app/controllers/application_controller.rb
 - spec/app_root/app/controllers/dashboards_controller.rb
 - spec/app_root/app/controllers/songs_controller.rb
@@ -61,6 +163,7 @@ files:
 - spec/app_root/lib/console_with_fixtures.rb
 - spec/app_root/log/.gitignore
 - spec/app_root/script/console
+- spec/consul/active_record_spec.rb
 - spec/consul/power_spec.rb
 - spec/controllers/dashboards_controller_spec.rb
 - spec/controllers/songs_controller_spec.rb
@@ -68,12 +171,15 @@ files:
 - spec/rcov.opts
 - spec/spec.opts
 - spec/spec_helper.rb
-homepage: http://github.com/makandra/consul
+- spec/support/spec.opts
+- spec/support/spec_candy.rb
+has_rdoc: true
+homepage: https://github.com/makandra/consul
 licenses: []
 
 post_install_message: 
-rdoc_options: 
-- --charset=UTF-8
+rdoc_options: []
+
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
@@ -97,33 +203,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: 
-rubygems_version: 1.7.2
+rubygems_version: 1.3.9.4
 signing_key: 
 specification_version: 3
-summary: Scope-based authorization solution for Rails
-test_files: 
-- spec/controllers/users_controller_spec.rb
-- spec/controllers/songs_controller_spec.rb
-- spec/controllers/dashboards_controller_spec.rb
-- spec/spec_helper.rb
-- spec/consul/power_spec.rb
-- spec/app_root/app/controllers/songs_controller.rb
-- spec/app_root/app/controllers/dashboards_controller.rb
-- spec/app_root/app/controllers/application_controller.rb
-- spec/app_root/app/controllers/users_controller.rb
-- spec/app_root/app/models/client.rb
-- spec/app_root/app/models/power.rb
-- spec/app_root/app/models/user.rb
-- spec/app_root/app/models/note.rb
-- spec/app_root/lib/console_with_fixtures.rb
-- spec/app_root/config/boot.rb
-- spec/app_root/config/routes.rb
-- spec/app_root/config/environments/mysql.rb
-- spec/app_root/config/environments/sqlite3.rb
-- spec/app_root/config/environments/in_memory.rb
-- spec/app_root/config/environments/postgresql.rb
-- spec/app_root/config/environments/sqlite.rb
-- spec/app_root/config/environment.rb
-- spec/app_root/db/migrate/001_create_users.rb
-- spec/app_root/db/migrate/002_create_clients.rb
-- spec/app_root/db/migrate/003_create_notes.rb
+summary: A scope-based authorization solution for Ruby on Rails.
+test_files: []
+

data/README.rdoc

@@ -1,213 +0,0 @@
-= Consul - A scope-based authorization solution
-
-Consul is a authorization solution for Ruby on Rails that uses scopes to control what a user can see or edit.
-
-
-== Status of this project
-
-Consul is a new kind of authorization solution for Rails applications that are mainly driven by scopes.
-While Consul has been used in production code, we are still figuring out whether or not it is a good idea.
-Also documentation is still sparse.
-
-If you are looking for something less adventurous with a stable API and great documentation, checkout out our
-other authorization solution, {Aegis}[https://github.com/makandra/aegis].
-
-
-== Describing a power for your application
-
-You describe access to your application by putting a <tt>Power</tt> model into <tt>app/models/power.rb</tt>:
-
-  class Power
-    include Consul::Power
-
-    def initialize(user)
-      @user = user
-    end
-
-    power :notes do
-      Note.by_author(@user)
-    end
-
-    power :users do
-      User if @user.admin?
-    end
-
-    power :dashboard do
-      true # not a scope, but a boolean power. This is useful to control access to stuff that doesn't live in the database.
-    end
-
-  end
-
-
-== Querying a power
-
-Common things you might want from a power:
-
-1. Get its scope
-2. Ask whether it is there
-3. Raise an error unless it its there
-4. Ask whether a given record is included in its scope
-5. Raise an error unless a given record is included in its scope
-
-Here is how to do all of that:
-
-  power = Power.new(user)
-  power.notes # => returns an ActiveRecord::Scope
-  power.notes? # => returns true if Power#notes returns a scope
-  power.notes! # => raises Consul::Powerless unless Power#notes returns a scope
-  power.note?(Note.last) # => returns whether the given Note is in the Power#notes scope. Caches the result for subsequent queries.
-  power.note!(Note.last) # => raises Consul::Powerless unless the given Note is in the Power#notes scope
-
-You can also write power checks like this:
-
-  power.include?(:notes)
-  power.include!(:notes)
-  power.include?(:note, Note.last)
-  power.include!(:note, Note.last)
-
-
-== Boolean powers
-
-Boolean powers are useful to control access to stuff that doesn't live in the database:
-
-  class Power
-    ...
-
-    power :dashboard do
-      true
-    end
-
-  end
-
-You can query it like the other powers:
-
-  power.dashboard? # => true
-  power.dashboard! # => raises Consul::Powerless unless Power#dashboard? returns true
-
-
-== Role-based permissions
-
-Consul has no built-in support for role-based permissions, but you can easily implement it yourself. Let's say your <tt>User</tt> model has a string column <tt>role</tt> which can be <tt>"author"</tt> or "<tt>"admin"</tt>:
-
-  class Power
-    include Consul::Power
-
-    def initialize(user)
-      @user = user
-    end
-
-    power :notes do
-      case role
-        when :admin then Note
-        when :author then Note.by_author
-      end
-    end
-
-    private
-
-    def role
-      @user.role.to_sym
-    end
-
-  end
-
-
-== Controller integration
-
-It is convenient to expose a helper method <tt>current_power</tt> for your controllers and views:
-
-  class ApplicationController < ActionController::Base
-
-    private
-
-    def current_power
-      @current_power ||= Power.new(current_user)
-    end
-
-    helper_method :current_power
-
-  end
-
-You can now use power scopes to control access:
-
-  class NotesController < ApplicationController
-
-    def show
-      @note = current_power.notes.find(params[:id])
-    end
-
-  end
-
-Get convenient controller macros by including <tt>Consul::Controller</tt> in your application:
-
-  class ApplicationController < ActionController::Base
-    include Consul::Controller
-  end
-
-To make sure a power is given before every action in a controller:
-
-  class NotesController < ApplicationController
-    power :notes
-  end
-
-You can use <tt>:except</tt> and <tt>:only</tt> options like in before filters.
-
-You can also map different powers to different actions:
-
-  class NotesController < ApplicationController
-    power :notes, :map => { [:edit, :update, :destroy] => :changable_notes }
-  end
-
-It is often convenient to map a power scope to a private controller method:
-
-  class NotesController < ApplicationController
-
-    power :notes, :as => end_of_association_chain
-
-    def show
-      @note = end_of_association_chain.find(params[:id])
-    end
-
-  end
-
-This is especially useful when you are using a RESTful controller library like {resource_controller}[https://github.com/jamesgolick/resource_controller]. The mapped method is aware of the <tt>:map</tt> option.
-
-You can force yourself to use a <tt>power</tt> check in every controller. This will raise <tt>Consul::UncheckedPower</tt> if you ever forget it:
-
-  class ApplicationController < ActionController::Base
-    include Consul::Controller
-    require_power_check
-  end
-
-Should you for some obscure reason want to forego the power check:
-
-  class ApiController < ApplicationController
-    skip_power_check
-  end
-
-== Installation
-
-Add the following to your <tt>Gemfile</tt>:
-  gem 'consul'
-
-Now run
-  bundle install
-
-
-== Rails 3 compatibility
-
-We cannot guarantee Rails 3 compatibility at this point.
-
-
-== Development
-
-A Rails 2 test application lives in <tt>spec/app_root</tt>. You can run specs from the project root by saying:
-
-  bundle exec rake spec
-  
-
-== Credits
-
-Henning Koch
-
-{makandra.com}[http://makandra.com/]

data/VERSION

@@ -1 +0,0 @@
-0.1.2