roles_for_mm 0.1.0

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,21 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## PROJECT::SPECIFIC

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Kristian Mandrup
+
+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.markdown

@@ -0,0 +1,168 @@
+# Roles for Mongo Mapper
+
+# Install
+
+<code>gem install roles_for_mm</code>
+
+# Usage
+
+The library comes with the following role models built-in:
+
+* Single inline role (string)
+* Multiple inline role (strings)
+* Multiple role relations (many relationship using array of object ids)
+
+Note: The following examples use RSpec to demonstrate usage scenarios.
+
+## Example : Admin flag
+
+Creates and uses a binary field 'admin', which when true signals that this user is an administrator and otherwise a normal user.
+
+<pre>
+require 'roles_for_mm'
+
+User.role_strategy :admin_flag
+
+before :each do
+  User.new(:name => 'Guest user', :role => 'guest').save
+  User.new(:name => 'Admin user', :role => 'admin').save
+end
+
+it "should return first user maching role" do
+  User.in_role('guest').first.name.should == 'Kristian'
+  User.in_role('admin').first.name.should == 'Admin user'
+end
+</pre>
+
+before :each do
+  User.new(:name => 'Guest user', :role => 'guest').save
+  User.new(:name => 'Admin user', :role => 'admin').save
+end
+
+it "should return first user maching role" do
+  User.in_role('guest').first.name.should == 'Guest user'
+  User.in_role('admin').first.name.should == 'Admin user'
+end
+</pre>
+
+## Example : Single inline role
+
+Creates and uses a single role name, a string
+
+<pre>
+User.role_strategy :inline_role
+
+# same as the previous admin_flag example
+... 
+</pre>
+
+## Example : Multiple inline roles
+
+Creates and uses an array of role names as strings
+
+<pre>
+User.role_strategy :inline_roles
+
+before :each do
+  guest_user = User.new(:name => 'Guest user', :roles => ['guest']).save
+  admin_user = User.new(:name => 'Admin user', :roles => ['admin']).save
+  author_user = User.new(:name => 'Author', :roles => ['author']).save
+end
+
+it "should return first user matching role" do
+  User.in_role('admin').first.name.should == 'Admin user'
+end
+
+it "should return all users matching any of the roles" do
+  User.in_roles(['guest', 'admin']).all.size.should == 2
+  User.in_roles('guest', 'admin').all.size.should == 2
+end
+</pre>
+    
+## Example : Multiple role relations
+
+Creates and uses a 1-M relation to a Role model, which the User model stores as an array of BSON ObjectIDs 
+
+<pre>
+require 'roles_for_mm'
+
+User.role_strategy :roles_relations
+
+before :each do
+  guest_user = User.new(:name => 'Guest user')
+  admin_user = User.new(:name => 'Admin user')
+  author_user = User.new(:name => 'Author')
+
+  guest_user.roles << Role.new(:name => 'guest')
+  guest_user.save      
+
+  admin_user.roles << Role.new(:name => 'admin')
+  admin_user.save      
+  
+  author_user.roles << Role.new(:name => 'author')
+  author_user.save      
+end    
+
+it "should return first user matching role" do
+  User.in_role('guest').first.name.should == 'Guest user'
+  User.in_role('admin').first.name.should == 'Admin user'
+end
+
+it "should return all users matching any of the roles" do
+  User.in_roles(['guest', 'admin']).all.size.should == 2
+  User.in_roles('guest', 'admin').all.size.should == 2 
+end
+</pre>
+
+## Example : Roles mask
+
+Creates and uses an inline Integer field in the User model called 'role_mask'  
+
+<pre>
+before :each do
+  User.available_roles = ['guest', 'admin', 'author']
+  
+  User.new(:name => 'Kristian', :roles => ['guest']).save
+  User.new(:name => 'Admin user', :roles => ['admin']).save
+  User.new(:name => 'Author', :roles => ['author']).save               
+end
+
+it "should return first user matching role" do
+  User.in_role('admin').first.name.should == 'Admin user'
+end
+
+it "should return all users matching any of the roles" do
+  User.in_roles(['guest', 'admin']).size.should == 2
+  User.in_roles('guest', 'admin').size.should == 2
+end
+</pre>
+
+## Rails generator
+
+The library comes with a Rails 3 generator that lets you populate a user model with a given role strategy 
+The following role strategies are included by default. Add your own by adding extra files inside the strategy folder, one file for each role strategy is recommended.
+
+* admin_flag
+* inline_role
+* inline_roles
+* role_relations
+* role_mask
+
+Example:
+
+<code>$ rails g mongo_mapper:roles user admin_flag</code>
+
+
+## Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+## Copyright
+
+Copyright (c) 2010 Kristian Mandrup. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,43 @@
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "roles_for_mm"
+    gem.summary = %Q{Faciliatates adding a role strategy to your Mongo Mapper user model}
+    gem.description = %Q{Faciliatates adding a role strategy to your Mongo Mapper user model}
+    gem.email = "kmandrup@gmail.com"
+    gem.homepage = "http://github.com/kristianmandrup/roles_for_mm"
+    gem.authors = ["Kristian Mandrup"]
+    gem.add_development_dependency "rspec", ">= 2.0.0.beta.19"
+    gem.add_dependency "mongo_mapper", ">= 0.8.2"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+# require 'spec/rake/spectask'
+# Spec::Rake::SpecTask.new(:spec) do |spec|
+#   spec.libs << 'lib' << 'spec'
+#   spec.spec_files = FileList['spec/**/*_spec.rb']
+# end
+# 
+# Spec::Rake::SpecTask.new(:rcov) do |spec|
+#   spec.libs << 'lib' << 'spec'
+#   spec.pattern = 'spec/**/*_spec.rb'
+#   spec.rcov = true
+# end
+# 
+# task :spec => :check_dependencies
+# 
+# task :default => :spec
+# 
+# require 'rake/rdoctask'
+# Rake::RDocTask.new do |rdoc|
+#   version = File.exist?('VERSION') ? File.read('VERSION') : ""
+# 
+#   rdoc.rdoc_dir = 'rdoc'
+#   rdoc.title = "roles_for_mm #{version}"
+#   rdoc.rdoc_files.include('README*')
+#   rdoc.rdoc_files.include('lib/**/*.rb')
+# end

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/lib/generators/mongo_mapper/roles/roles_generator.rb

@@ -0,0 +1,46 @@
+module MongoMapper 
+  module Generators
+    class RolesGenerator < Rails::Generators::NamedBase
+      desc "Generate roles model for User" 
+      
+      argument :role_strategy, :type => :string, :aliases => "-r", :default => 'inline_role', :desc => "Create roles model for user"
+
+      hook_for :orm
+            
+      def self.source_root
+        @source_root ||= File.expand_path("../../templates", __FILE__)
+      end
+
+      def apply_role_strategy   
+        insert_into_model('user', role_strategy_statement)
+      end 
+      
+      protected                  
+
+      def match_expr
+        /include MongoMapper::Document/
+      end
+
+      def role_strategy_statement 
+        "role_strategy #{role_strategy}"        
+      end
+
+      def role_strategy
+        options[:role_strategy]                
+      end
+      
+      def model_file(name)                          
+        File.join(Rails.root, "app/models/#{name}.rb")        
+      end
+        
+      def insert_into_model(model_name, insert_text)
+        model_name = model_name.to_s
+        file = File.new(model_file(model_name))
+        return if (file.read =~ /#{insert_text}/) 
+        gsub_file model_file(model_name), match_expr do |match|
+          match << insert_text
+        end
+      end              
+    end
+  end
+end

data/lib/roles_for_mm.rb

@@ -0,0 +1 @@
+require 'roles_for_mm/user'

data/lib/roles_for_mm/role.rb

@@ -0,0 +1,4 @@
+class Role
+  include MongoMapper::Document
+  key :name, String
+end  

data/lib/roles_for_mm/strategies/admin_flag.rb

@@ -0,0 +1,20 @@
+module MongoMapper
+  module AdminFlag
+        
+    def self.included base
+      base.extend ClassMethods
+      base.key :admin, Boolean      
+    end
+
+    module ClassMethods      
+      def in_role(role_name) 
+        case role_name.downcase.to_sym
+        when :admin
+          where(:admin => true)
+        else
+          where(:admin => false)
+        end          
+      end
+    end
+  end
+end

data/lib/roles_for_mm/strategies/inline_role.rb

@@ -0,0 +1,8 @@
+module MongoMapper
+  module InlineRole
+    def self.included base
+      base.key :role, String
+      base.scope :in_role,  lambda { |role_name| base.where(:role => role_name) }  
+    end
+  end
+end

data/lib/roles_for_mm/strategies/inline_roles.rb

@@ -0,0 +1,15 @@
+module MongoMapper
+  module InlineRoles
+    def self.included base
+      base.extend ClassMethods      
+      base.key :roles, Array
+      base.scope :in_role,   lambda { |role_name|  base.where(:roles => [role_name]) }
+    end
+
+    module ClassMethods
+      def in_roles(*roles)
+        where(:roles => roles.flatten)
+      end
+    end
+  end
+end

data/lib/roles_for_mm/strategies/role_relations.rb

@@ -0,0 +1,23 @@
+require 'roles_for_mm/role'
+
+module MongoMapper
+  module RoleRelations
+    def self.included base
+      base.extend ClassMethods      
+      base.key :role_ids, Array, :index => true, :typecast => 'ObjectId'
+      base.many :roles, :in => :role_ids
+    end
+
+    module ClassMethods    
+      def in_role(role_name)                          
+        role = Role.where(:name => role_name).first
+        all(:role_ids => role.id)
+      end
+
+      def in_roles(*roles)                          
+        role_ids = Role.where(:name => roles.flatten).map{|role| role.id}
+        where(:role_ids => role_ids)
+      end
+    end
+  end
+end

data/lib/roles_for_mm/strategies/roles_mask.rb

@@ -0,0 +1,52 @@
+module MongoMapper
+  module RolesMask
+    def self.included base
+      base.extend ClassMethods      
+      base.key :roles_mask, Integer
+    end
+
+    module ClassMethods
+      attr_accessor :available_roles    
+  
+      def in_role(role)     
+        mask = calc_index(role.to_s)
+        all.select do |user| 
+          (user.roles_mask & mask) > 0
+        end
+      end    
+
+      def in_roles(*roles)
+        all.select do |user| 
+          roles.flatten.any? do |role|
+            mask = calc_index(role.to_s)
+            (user.roles_mask & mask) > 0
+          end
+        end
+      end    
+  
+      def calc_index(r)
+        2**available_roles.index(r)
+      end      
+    end
+
+    def available_roles
+      self.class.available_roles    
+    end
+
+    def calc_index(r)
+      self.class.calc_index(r)
+    end
+
+    def roles=(*roles)    
+      self.roles_mask = (roles.flatten & available_roles).map { |r| calc_index(r) }.sum
+    end
+
+    def roles
+      self.available_roles.reject { |r| ((roles_mask || 0) & self.calc_index(r)).zero? }
+    end
+
+    def role?(role)
+      roles.include?(role.to_s)
+    end
+  end
+end

data/lib/roles_for_mm/user.rb

@@ -0,0 +1,12 @@
+require 'require_all'
+require 'active_support/inflector'
+
+class User    
+  include MongoMapper::Document
+  
+  def self.role_strategy type
+    include "MongoMapper::#{type.to_s.camelize}".constantize    
+  end
+end
+
+require_all File.dirname(__FILE__) + '/strategies'

data/spec/roles_for_mm/user_admin_field_spec.rb

@@ -0,0 +1,24 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+
+User.role_strategy :admin_flag
+
+describe "Roles for MongoMapper" do
+  describe "Inline admin field" do
+
+    after :each do
+      Database.teardown
+    end
+
+    before :each do
+      guest_user = User.new :name => 'Kristian', :admin => false
+      admin_user = User.new :name => 'Admin user', :admin => true
+      admin_user.save                                        
+      guest_user.save
+    end
+
+    it "should return first user maching role" do
+      User.in_role('guest').first.name.should == 'Kristian'
+      User.in_role('admin').first.name.should == 'Admin user'
+    end
+  end
+end

data/spec/roles_for_mm/user_inline_role_spec.rb

@@ -0,0 +1,24 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+
+User.role_strategy :inline_role
+
+describe "Roles for MongoMapper" do
+  describe "Inline role" do
+
+    after :each do
+      Database.teardown
+    end
+
+    before :each do
+      guest_user = User.new :name => 'Kristian', :role => 'guest'
+      admin_user = User.new :name => 'Admin user', :role => 'admin' 
+      admin_user.save                                        
+      guest_user.save
+    end
+
+    it "should return first user maching role" do
+      User.in_role('guest').first.name.should == 'Kristian'
+      User.in_role('admin').first.name.should == 'Admin user'
+    end
+  end
+end

data/spec/roles_for_mm/user_inline_roles_spec.rb

@@ -0,0 +1,27 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+
+User.role_strategy :inline_roles
+
+describe "Roles for MongoMapper" do
+  describe "Inline roles" do
+
+    after :each do
+      Database.teardown
+    end
+
+    before :each do
+      guest_user = User.new(:name => 'Kristian', :roles => ['guest']).save
+      admin_user = User.new(:name => 'Admin user', :roles => ['admin']).save
+      author_user = User.new(:name => 'Author', :roles => ['author']).save
+    end
+
+    it "should return first user matching role" do
+      User.in_role('admin').first.name.should == 'Admin user'
+    end
+
+    it "should return all users matching any of the roles" do
+      User.in_roles(['guest', 'admin']).all.size.should == 2
+      User.in_roles('guest', 'admin').all.size.should == 2
+    end
+  end
+end

data/spec/roles_for_mm/user_role_relations_spec.rb

@@ -0,0 +1,37 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+
+User.role_strategy :role_relations
+
+describe "Roles for MongoMapper" do  
+  
+  after :each do
+    Database.teardown
+  end
+
+  before :each do
+    guest_user = User.new(:name => 'Kristian')
+    admin_user = User.new(:name => 'Admin user')
+    author_user = User.new(:name => 'Author')
+
+    guest_user.roles << Role.new(:name => 'guest')
+    guest_user.save      
+
+    admin_user.roles << Role.new(:name => 'admin')
+    admin_user.save      
+    
+    author_user.roles << Role.new(:name => 'author')
+    author_user.save      
+  end    
+  
+  describe "Role relations" do
+    it "should return first user matching role" do
+      User.in_role('guest').first.name.should == 'Kristian'
+      User.in_role('admin').first.name.should == 'Admin user'
+    end
+    
+    it "should return all users matching any of the roles" do
+      User.in_roles(['guest', 'admin']).all.size.should == 2
+      User.in_roles('guest', 'admin').all.size.should == 2 
+    end    
+  end
+end  

data/spec/roles_for_mm/user_roles_mask_spec.rb

@@ -0,0 +1,29 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+
+User.role_strategy :roles_mask
+
+describe "Roles for MongoMapper" do
+  describe "Inline roles" do
+
+    after :each do
+      Database.teardown
+    end
+
+    before :each do
+      User.available_roles = ['guest', 'admin', 'author']
+      
+      User.new(:name => 'Kristian', :roles => ['guest']).save
+      User.new(:name => 'Admin user', :roles => ['admin']).save
+      User.new(:name => 'Author', :roles => ['author']).save               
+    end
+
+    it "should return first user matching role" do
+      User.in_role('admin').first.name.should == 'Admin user'
+    end
+
+    it "should return all users matching any of the roles" do
+      User.in_roles(['guest', 'admin']).size.should == 2
+      User.in_roles('guest', 'admin').size.should == 2
+    end
+  end
+end

data/spec/spec.opts

@@ -0,0 +1 @@
+--color

data/spec/spec_helper.rb

@@ -0,0 +1,21 @@
+require 'rspec'
+require 'rspec/autorun'
+require 'mongo_mapper'
+require 'roles_for_mm'
+                 
+MongoMapper.database = 'roles_for_mm'
+
+module Database
+  def self.teardown
+    # MongoMapper.database.collections.each {|collection| collection.drop }    
+    MongoMapper.database.collections.each do |coll|
+      coll.drop unless coll.name =~ /(.*\.)?system\..*/
+    end    
+  end
+end
+
+RSpec.configure do |config|
+  
+end
+
+

metadata

@@ -0,0 +1,122 @@
+--- !ruby/object:Gem::Specification 
+name: roles_for_mm
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Kristian Mandrup
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-08-02 00:00:00 +02:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        - 0
+        - 0
+        - beta
+        - 19
+        version: 2.0.0.beta.19
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: mongo_mapper
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 8
+        - 2
+        version: 0.8.2
+  type: :runtime
+  version_requirements: *id002
+description: Faciliatates adding a role strategy to your Mongo Mapper user model
+email: kmandrup@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.markdown
+files: 
+- .document
+- .gitignore
+- LICENSE
+- README.markdown
+- Rakefile
+- VERSION
+- lib/generators/mongo_mapper/roles/roles_generator.rb
+- lib/roles_for_mm.rb
+- lib/roles_for_mm/role.rb
+- lib/roles_for_mm/strategies/admin_flag.rb
+- lib/roles_for_mm/strategies/inline_role.rb
+- lib/roles_for_mm/strategies/inline_roles.rb
+- lib/roles_for_mm/strategies/role_relations.rb
+- lib/roles_for_mm/strategies/roles_mask.rb
+- lib/roles_for_mm/user.rb
+- spec/roles_for_mm/user_admin_field_spec.rb
+- spec/roles_for_mm/user_inline_role_spec.rb
+- spec/roles_for_mm/user_inline_roles_spec.rb
+- spec/roles_for_mm/user_role_relations_spec.rb
+- spec/roles_for_mm/user_roles_mask_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://github.com/kristianmandrup/roles_for_mm
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Faciliatates adding a role strategy to your Mongo Mapper user model
+test_files: 
+- spec/roles_for_mm/user_admin_field_spec.rb
+- spec/roles_for_mm/user_inline_role_spec.rb
+- spec/roles_for_mm/user_inline_roles_spec.rb
+- spec/roles_for_mm/user_role_relations_spec.rb
+- spec/roles_for_mm/user_roles_mask_spec.rb
+- spec/spec_helper.rb