troles 0.5.1 → 0.5.2

data/Design.textile

@@ -0,0 +1,68 @@
+h2. Status June 7, 2011 
+
+I'm now in the process of implementing TroleGroups! Finally a fully integrated role groups solution for Ruby and Rails ;)
+Due to the flexible design ot troles and trole, I can reuse the same infrastructure/design/architecture to implement trole_groups! 
+*Yiii...haaa!*   
+                 
+"A RoleGroup is simply another role_subject and can thus be configured with a given role strategy!" 
+
+Simple and Sweet :)
+
+h2. The Ruby Class Decorator (RCD) pattern is born!!!
+
+I realized a while ago that I had come upon a very cool kind of "class decorator" design pattern that can be generalized to any gem that "decorates" a class (or perhaps multiple classes) with certain behavior. Gems such as _act_as_xxx_ come to mind fx.
+
+I will soon try to generalize this pattern into a separate project and then have trole, troles and trole_groups all use this to leverage their functionality. Also, I will make use of an idea that I just had while taking a cold shower (try it sometime if you have a mind block!). 
+The idea is to have an internal default API, and an exposed API that by default is a reflection of the internal API. However the user is free to block parts of the API from being loaded or define his own external API that utilizes the inner API.
+
+Since this is a general purpose decorator pattern, there should also be a kind of Index where you can see which decorators have been applied to an object and what API each such decorator exposes! Cool stuff!!!!  
+
+Some example usage:
+<pre>
+return if !User.has_decorator?(:troles_group)
+# do some trole group stuff!!!
+
+# later ...
+
+# list all decorators currently applied to the User class
+puts User.decorators
+
+# print the methods of the public Write API for the :troles_group decorator :)
+puts User.decorator(:troles_group).public_api(:write).methods.sort
+
+# print the methods of the internal Write API for the :troles_group decorator :)
+puts User.decorator(:troles_group).internal_api(:write).methods.sort
+</pre>
+
+I will use the new Decorator API very soon... sth like this:
+
+<pre>
+User.decorator(:trole_groups).configure(:strategy) :ref_one do |strategy|
+  strategy.orm = :mongoid
+  strategy.auto_load = true
+end.configure!  
+</pre>
+
+Awesome!
+
+h3. Yard documentation
+
+I'm using "Yard":http://rubydoc.info/docs/yard/file/docs/GettingStarted.md for documentation.
+
+<pre>$ yard server
+
+From browser, go to: http://0.0.0.0:8808/  # then you can enjoy! the nice documentation :) 
+</pre>
+
+There is now support for Caching and invalidation of the _role_list_ when the roles change. 
+The specs now validate that caching works as it should.
+
+Please help out to finalize this project! :)
+
+h2. Bug hunting by running specs
+
+Run specs for at most one strategy at the time for now...
+
+@$ rspec spec/troles/strategies/bit_many_spec.rb@ 
+
+Please see the document _spec/Guide to running specs.textile_ where I advise on how best to do "bug hunting" to help get this project off the ground!

data/Gemfile

@@ -1,12 +1,13 @@
-source "http://rubygems.org"
+source :rubygems
 
-gem 'sugar-high',   '~> 0.4.4'
+gem 'sugar-high',   '>= 0.4.4'
+gem 'sweetloader',  '>= 0.1.0'
 gem 'require_all',  '~> 1.2.0'
-gem 'yard',         '>  0.6.1'
 
 group :development, :test do
-  gem 'rails',        '~> 3.1.0.rc1'
-  gem 'rspec-rails',  '> 2.4.0'
+  gem 'yard',         '>  0.6.1'
+  gem 'rails',        '>= 3.0.1'
+  gem 'rspec-rails',  '>= 2.4.0'
   gem 'sqlite3'
   gem 'capybara',     '> 0.4.0'
   gem 'shoulda'
@@ -16,11 +17,12 @@ group :development, :test do
 
   gem 'rake',         '~> 0.9.0'
   gem 'bundler',      '>= 1'
-  gem 'jeweler',      '>= 1.5'
+  gem 'jeweler',      '>= 1.6'
   gem 'rdoc',         '>= 3.6'
   gem 'rcov'
+  gem 'yard',         '>  0.6.1'
 
   # To use debugger (ruby-debug for Ruby 1.8.7+, ruby-debug19 for Ruby 1.9.2+)
   # gem 'ruby-debug'
   # gem 'ruby-debug19'
-end
+end

data/Gemfile.lock

@@ -1,108 +1,107 @@
 GIT
   remote: git://github.com/kristianmandrup/database_cleaner.git
-  revision: f1947e0a2c4e9086490d7c975b21ed1a3d70b3a8
+  revision: 1215a0631ca1fd17087e8609eff40cabea960eb8
   specs:
     database_cleaner (0.6.8)
 
 GEM
   remote: http://rubygems.org/
   specs:
-    actionmailer (3.1.0.rc1)
-      actionpack (= 3.1.0.rc1)
+    actionmailer (3.1.0)
+      actionpack (= 3.1.0)
       mail (~> 2.3.0)
-    actionpack (3.1.0.rc1)
-      activemodel (= 3.1.0.rc1)
-      activesupport (= 3.1.0.rc1)
+    actionpack (3.1.0)
+      activemodel (= 3.1.0)
+      activesupport (= 3.1.0)
       builder (~> 3.0.0)
       erubis (~> 2.7.0)
-      i18n (~> 0.6.0beta1)
-      rack (~> 1.3.0.beta2)
-      rack-cache (~> 1.0.1)
-      rack-mount (~> 0.8.1)
-      rack-test (~> 0.6.0)
-      sprockets (~> 2.0.0.beta.5)
-      tzinfo (~> 0.3.27)
-    activemodel (3.1.0.rc1)
-      activesupport (= 3.1.0.rc1)
-      bcrypt-ruby (~> 2.1.4)
+      i18n (~> 0.6)
+      rack (~> 1.3.2)
+      rack-cache (~> 1.0.3)
+      rack-mount (~> 0.8.2)
+      rack-test (~> 0.6.1)
+      sprockets (~> 2.0.0)
+    activemodel (3.1.0)
+      activesupport (= 3.1.0)
+      bcrypt-ruby (~> 3.0.0)
       builder (~> 3.0.0)
-      i18n (~> 0.6.0beta1)
-    activerecord (3.1.0.rc1)
-      activemodel (= 3.1.0.rc1)
-      activesupport (= 3.1.0.rc1)
-      arel (~> 2.1.1)
-      tzinfo (~> 0.3.27)
-    activeresource (3.1.0.rc1)
-      activemodel (= 3.1.0.rc1)
-      activesupport (= 3.1.0.rc1)
-    activesupport (3.1.0.rc1)
+      i18n (~> 0.6)
+    activerecord (3.1.0)
+      activemodel (= 3.1.0)
+      activesupport (= 3.1.0)
+      arel (~> 2.2.1)
+      tzinfo (~> 0.3.29)
+    activeresource (3.1.0)
+      activemodel (= 3.1.0)
+      activesupport (= 3.1.0)
+    activesupport (3.1.0)
       multi_json (~> 1.0)
-    arel (2.1.1)
-    bcrypt-ruby (2.1.4)
+    arel (2.2.1)
+    bcrypt-ruby (3.0.1)
     builder (3.0.0)
-    capybara (0.4.1.2)
-      celerity (>= 0.7.9)
-      culerity (>= 0.2.4)
+    capybara (1.1.1)
       mime-types (>= 1.16)
       nokogiri (>= 1.3.3)
       rack (>= 1.0.0)
       rack-test (>= 0.5.4)
-      selenium-webdriver (>= 0.0.27)
-      xpath (~> 0.1.3)
-    celerity (0.8.9)
-    childprocess (0.1.9)
+      selenium-webdriver (~> 2.0)
+      xpath (~> 0.1.4)
+    childprocess (0.2.2)
       ffi (~> 1.0.6)
-    culerity (0.2.15)
-    diff-lcs (1.1.2)
+    diff-lcs (1.1.3)
     erubis (2.7.0)
-    factory_girl (1.3.3)
-    factory_girl_rails (1.0.1)
-      factory_girl (~> 1.3)
+    factory_girl (2.1.2)
+      activesupport
+    factory_girl_rails (1.2.0)
+      factory_girl (~> 2.1.0)
       railties (>= 3.0.0)
     ffi (1.0.9)
     git (1.2.5)
-    hike (1.0.0)
+    hike (1.2.1)
     i18n (0.6.0)
-    jeweler (1.6.2)
+    jeweler (1.6.4)
       bundler (~> 1.0)
       git (>= 1.2.5)
       rake
-    json_pure (1.5.1)
+    json_pure (1.6.1)
     mail (2.3.0)
       i18n (>= 0.4.0)
       mime-types (~> 1.16)
       treetop (~> 1.4.8)
+    metaclass (0.0.1)
     mime-types (1.16)
-    mocha (0.9.12)
+    mocha (0.10.0)
+      metaclass (~> 0.0.1)
     multi_json (1.0.3)
-    nokogiri (1.4.4)
-    polyglot (0.3.1)
-    rack (1.3.0)
-    rack-cache (1.0.2)
+    nokogiri (1.5.0)
+    polyglot (0.3.2)
+    rack (1.3.3)
+    rack-cache (1.0.3)
       rack (>= 0.4)
-    rack-mount (0.8.1)
+    rack-mount (0.8.3)
       rack (>= 1.0.0)
     rack-ssl (1.3.2)
       rack
-    rack-test (0.6.0)
+    rack-test (0.6.1)
       rack (>= 1.0)
-    rails (3.1.0.rc1)
-      actionmailer (= 3.1.0.rc1)
-      actionpack (= 3.1.0.rc1)
-      activerecord (= 3.1.0.rc1)
-      activeresource (= 3.1.0.rc1)
-      activesupport (= 3.1.0.rc1)
+    rails (3.1.0)
+      actionmailer (= 3.1.0)
+      actionpack (= 3.1.0)
+      activerecord (= 3.1.0)
+      activeresource (= 3.1.0)
+      activesupport (= 3.1.0)
       bundler (~> 1.0)
-      railties (= 3.1.0.rc1)
-    railties (3.1.0.rc1)
-      actionpack (= 3.1.0.rc1)
-      activesupport (= 3.1.0.rc1)
+      railties (= 3.1.0)
+    railties (3.1.0)
+      actionpack (= 3.1.0)
+      activesupport (= 3.1.0)
       rack-ssl (~> 1.3.2)
       rake (>= 0.8.7)
+      rdoc (~> 3.4)
       thor (~> 0.14.6)
     rake (0.9.2)
-    rcov (0.9.9)
-    rdoc (3.6.1)
+    rcov (0.9.10)
+    rdoc (3.9.4)
     require_all (1.2.0)
     rspec (2.6.0)
       rspec-core (~> 2.6.0)
@@ -118,26 +117,31 @@ GEM
       railties (~> 3.0)
       rspec (~> 2.6.0)
     rubyzip (0.9.4)
-    selenium-webdriver (0.2.1)
-      childprocess (>= 0.1.7)
+    selenium-webdriver (2.7.0)
+      childprocess (>= 0.2.1)
       ffi (>= 1.0.7)
       json_pure
       rubyzip
     shoulda (2.11.3)
-    sprockets (2.0.0.beta.10)
-      hike (~> 1.0)
+    sprockets (2.0.1)
+      hike (~> 1.2)
       rack (~> 1.0)
       tilt (!= 1.3.0, ~> 1.1)
-    sqlite3 (1.3.3)
-    sugar-high (0.4.4.2)
+    sqlite3 (1.3.4)
+    sugar-high (0.6.0)
+      activesupport (>= 3.0.1)
+    sweetloader (0.1.0)
+      activesupport (>= 3.0.1)
+      i18n
     thor (0.14.6)
-    tilt (1.3.2)
-    treetop (1.4.9)
+    tilt (1.3.3)
+    treetop (1.4.10)
+      polyglot
       polyglot (>= 0.3.1)
-    tzinfo (0.3.27)
+    tzinfo (0.3.30)
     xpath (0.1.4)
       nokogiri (~> 1.3)
-    yard (0.7.1)
+    yard (0.7.2)
 
 PLATFORMS
   ruby
@@ -147,15 +151,16 @@ DEPENDENCIES
   capybara (> 0.4.0)
   database_cleaner (~> 0.6.8)!
   factory_girl_rails
-  jeweler (>= 1.5)
+  jeweler (>= 1.6)
   mocha
-  rails (~> 3.1.0.rc1)
+  rails (>= 3.0.1)
   rake (~> 0.9.0)
   rcov
   rdoc (>= 3.6)
   require_all (~> 1.2.0)
-  rspec-rails (> 2.4.0)
+  rspec-rails (>= 2.4.0)
   shoulda
   sqlite3
-  sugar-high (~> 0.4.4)
+  sugar-high (>= 0.4.4)
+  sweetloader (>= 0.1.0)
   yard (> 0.6.1)