cream 0.6.1 → 0.6.3

data/VERSION

@@ -1 +1 @@
-0.6.1
+0.6.3

data/cream.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{cream}
-  s.version = "0.6.1"
+  s.version = "0.6.3"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Kristian Mandrup"]
-  s.date = %q{2010-09-26}
+  s.date = %q{2010-10-05}
   s.description = %q{Provides assistance for setting up Session, Role and Permission systems for a Rails 3 app. Support for multiple ORMs}
   s.email = %q{kmandrup@gmail.com}
   s.extra_rdoc_files = [
@@ -45,15 +45,18 @@ Gem::Specification.new do |s|
      "lib/cream/helper/host.rb",
      "lib/cream/helper/role.rb",
      "lib/cream/namespaces.rb",
+     "lib/cream/rails/config.rb",
      "lib/cream/role.rb",
      "lib/cream/view/host_area.rb",
      "lib/cream/view/role_area.rb",
      "lib/cream/view/user_action_menu.rb",
      "lib/generators/cream/config/DESIGN NOTES.markdown",
      "lib/generators/cream/config/config_generator.rb",
+     "lib/generators/cream/config/modules/app_config.rb",
      "lib/generators/cream/config/modules/cancan_config.rb",
      "lib/generators/cream/config/modules/cream_config.rb",
      "lib/generators/cream/config/modules/devise_config.rb",
+     "lib/generators/cream/config/modules/devise_users_config.rb",
      "lib/generators/cream/config/modules/helper.rb",
      "lib/generators/cream/config/modules/permits_config.rb",
      "lib/generators/cream/config/modules/roles_config.rb",
@@ -63,7 +66,10 @@ Gem::Specification.new do |s|
      "log/development.log",
      "sandbox/test.rb",
      "spec/configure_helper.rb",
-     "spec/cream/configure/rails_spec.rb",
+     "spec/cream/configure/cream_setup_spec.rb",
+     "spec/cream/configure/rails_custom_roles_spec.rb",
+     "spec/cream/configure/rails_role_spec.rb",
+     "spec/cream/configure/rails_user_roles_spec.rb",
      "spec/cream/helper/host_spec.rb",
      "spec/cream/helper/role_spec.rb",
      "spec/cream/view/host_area_spec.rb",
@@ -94,7 +100,10 @@ Gem::Specification.new do |s|
   s.summary = %q{Integrates Devise, Roles and CanCan with Permits for a Rails 3 app}
   s.test_files = [
     "spec/configure_helper.rb",
-     "spec/cream/configure/rails_spec.rb",
+     "spec/cream/configure/cream_setup_spec.rb",
+     "spec/cream/configure/rails_custom_roles_spec.rb",
+     "spec/cream/configure/rails_role_spec.rb",
+     "spec/cream/configure/rails_user_roles_spec.rb",
      "spec/cream/helper/host_spec.rb",
      "spec/cream/helper/role_spec.rb",
      "spec/cream/view/host_area_spec.rb",

data/lib/cream.rb

@@ -17,6 +17,7 @@ require 'cream/role'
 require_all File.dirname(__FILE__) + '/cream/controller'
 require_all File.dirname(__FILE__) + '/cream/helper'
 require_all File.dirname(__FILE__) + '/cream/view'
+require_all File.dirname(__FILE__) + '/cream/rails'
 
 require 'cream/configure'    
 

data/lib/cream/configure.rb

@@ -1,3 +1,12 @@
 require 'require_all'
 require 'cream/namespaces'
-require 'cream/configure/rails'
+require 'cream/configure/rails'
+
+module Cream
+  mattr_accessor :roles
+  @@roles = []
+    
+  def self.setup
+    yield self
+  end
+end

data/lib/cream/configure/rails.rb

@@ -18,5 +18,14 @@ Rails3::Plugin::Extender.new do
   
   after :initialize do   
     require_all File.dirname(__FILE__) + '/after_init'
-  end
+
+    Rails3.with_configuration do
+      autoload_paths += %W(#{Rails.root}/app/permits)
+    end
+
+    # set cream config object
+    # Rails3.with_configuration do
+    #   cream = Cream::Rails::Config.new :roles => Cream::Role.available
+    # end
+  end  
 end

data/lib/cream/controller/ability.rb

@@ -1,7 +1,8 @@
 module Cream::Controller
   module Ability
     def current_ability
-      @current_ability ||= Ability.new(current_user, request)
+      @current_ability ||= Permits::Ability.new(current_user, request)
     end
   end
-end
+end
+

data/lib/cream/rails/config.rb

@@ -0,0 +1,11 @@
+module Cream
+  module Rails
+    class Config      
+      attr_accessor :roles
+      
+      def initialize options = {}
+        self.roles ||= options[:roles] 
+      end
+    end
+  end
+end

data/lib/cream/role.rb

@@ -1,7 +1,16 @@
 module Cream
+  class << self
+    attr_accessor :available_roles  
+  end
+  
   module Role
     def self.available
-      ::Role.all.map(&:name).to_symbols
+      return Cream.available_roles if Cream.available_roles.present?
+      if defined? ::Role
+        ::Role.all.map(&:name).to_symbols
+      else
+        User.roles.to_symbols
+      end
     end
   end
 end

data/lib/generators/cream/config/DESIGN NOTES.markdown

@@ -11,6 +11,24 @@ Each of the following should be a module in its own right!
 * Include modules depending on options
 * For each module call the config_[module_name] method, which is responsible for configuring that module! 
 
+## App config
+
+in config/application.rb
+
+If not using Active Record, substitute
+<pre>
+  require 'rails/all'
+</pre>
+  
+  
+With  
+<pre>
+  require "action_controller/railtie"
+  require "action_mailer/railtie"
+  require "active_resource/railtie"
+  require "rails/test_unit/railtie"  
+</pre>
+
 ## Devise Configuration
 
 Gemfile

data/lib/generators/cream/config/config_generator.rb

@@ -20,10 +20,10 @@ module Cream::Generators
     source_root File.dirname(__FILE__)
 
     # Role Strategy
-    class_option  :strategy,          :type => :string,   :default => 'role_string',    :desc => "Role strategy to use", 
+    class_option  :strategy,          :type => :string,   :default => 'role_string',    :desc => "Role strategy to use"
 
     # Create Admin user
-    class_option :admin_user,         :type => :boolean,  :default => false,            :desc => "Create admin user",  
+    class_option :admin_user,         :type => :boolean,  :default => false,            :desc => "Create admin user"  
 
     # Roles
     class_option :default_roles,      :type => :boolean,  :default => true,             :desc => "Create default roles :admin and :guest"
@@ -42,20 +42,25 @@ module Cream::Generators
       configure_gems       
 
       MODULES.each do |name|
-        send :"configure_#{name}"
+        method = "configure_#{name}"
+        send method if respond_to?(method)
       end
     end
 
     # -----------------      
     protected
 
-    MODULES = [:devise] #, :cancan, :roles, :permits, :cream]
+    # configure which helper modules (from /modules subfolder) to include in this Generator!!!
+    
+    MODULES = [:app, :devise, :devise_users, :cancan, :roles, :permits, :cream]
 
-    includes Cream::Generators::Config, :helper, MODULES #, :cancan, :roles, :permits, :cream
+    includes Cream::Generators::Config, :helper, MODULES
 
     include Rails3::Assist::BasicLogger
 
-    use_helpers :model, :controller, :permit
+    # using helpers from rails3_artifactor gem. 
+    # A macro from rails3_assist loads appropriate modules into the class and makes various Rails 3 "mutation helper" methods available
+    use_helpers :model, :controller, :permit, :application
 
     def configure_logger
       logger.add_logfile :logfile => logfile
@@ -64,7 +69,8 @@ module Cream::Generators
 
     def configure_gems
       MODULES.each do |name|
-        send :"#{name}_gems"
+        method = "#{name}_gems"
+        send method if respond_to?(method)
       end
       run "bundle install"
     end

data/lib/generators/cream/config/modules/app_config.rb

@@ -0,0 +1,48 @@
+module Cream::Generators 
+  module Config
+    module CanCan
+      def configure_application
+        app_orm
+        app_routes
+        app_layout
+      end
+
+      def app_orm
+        return if orm == 'active_record'
+        File.replace_content_from config_file(:application),  :where => "require 'rails/all'" do 
+        %q{
+require "action_controller/railtie"
+require "action_mailer/railtie"
+require "active_resource/railtie"
+require "rails/test_unit/railtie"
+}
+      end
+       
+      def app_routes
+        routes = read_from config_file(:routes)
+        # if no :welcome controller
+        if !(routes =~ /root\s+:/)
+          # create one with an 'index' view.
+          insert_into config_file(:routes) :after => 'do', :content => 'root :to => "welcome#index"'          
+          execute "rails g controller Welcome index"
+        end
+      end
+      
+      # in 'app/views/layouts/application.html.erb'
+      # insert special flash msg displayers after opening <body> element
+      def app_layout
+        layout_content = read_view :application, :folder => 'layouts' #, :type => :erb
+
+        [:alert, :notice].each{|name| insert_flash_displayer name}
+      end
+      
+      def insert_flash_displayer name
+        return if layout_content =~ /<%=\s+#{name}\s+%>/          
+        insert_into_view :application, :folder => 'layouts', :after => '<body>' do
+          '<p class="alert"><%= alert %></p>'
+        end
+      end      
+    end
+  end
+end
+

data/lib/generators/cream/config/modules/cancan_config.rb

@@ -1,13 +1,18 @@
 module Cream::Generators 
   module Config
-    module CanCan
-      def configure_devise_gems
+    module CanCan  
+      def cancan_configure
+        configure_cancan_gems 
+        cancan_exception_handling
+      end
+      
+      def cancan_gems
         gem 'cancan'  
         gem 'cancan-rest-links'
       end
 
       # CanCan access denied exception handling
-      def configure_exception_handling         
+      def cancan_exception_handling
         insert_into_controller :application, :after => "ActionController::Base\n" do
           %{
   rescue_from CanCan::AccessDenied do |exception|

data/lib/generators/cream/config/modules/cream_config.rb

@@ -1,17 +1,30 @@
 module Cream::Generators 
   module Config
-    module Cream
+    module Cream 
+      def cream_configure
+        cream_gems
+        cream_initializer
+        cream_locale
+      end
+      
       def cream_gems
         gem_name = ORM_MAP[orm]      
         gem gem_name if gem_name        
         
-        gem 'devise'
-        gem 'cancan'          
         gem 'cream'
         run "bundle install"
       end      
+
+      def cream_initializer
+        create_initializer_file :cream do 
+          %Q{
+Cream.setup do |config|
+  config.roles = #{roles.inspect} 
+end
+}
+      end
       
-      def configure_locale
+      def cream_locale
         src = File.expand_path "config/locales/en.yml".path.up(2)
         # src = "config/locales/en.yml"
         logger.debug "configure_locale, copy from: #{src}"            

data/lib/generators/cream/config/modules/devise_config.rb

@@ -2,30 +2,13 @@ module Cream::Generators
   module Config
     module Devise        
 
-      def configure_devise
-        if !has_model? :user
-          # run devise generator to create User model
-          create_devise_model :user
-        end                           
-        
-        # if User model is NOT configured with devise strategy
-        if !has_devise_strategy? :user
-            insert_devise_strategy :user, :defaults
-          end    
-        end
-        
-        configure_admin_user if configure_admin_user?
+      def configure_devise        
+        initialize!
+        [Orm, Mailer, Protection].each{|m| m.configure!}
       end
 
-      def configure_admin_user        
-        # if app does NOT have a Admin model
-        if !has_model? :admin
-          create_admin_user
-        end
-        if has_model? :admin
-          # insert default devise Admin strategy    
-          insert_devise_strategy :user, :defaults            
-        end
+      def initialize!
+        rgen 'devise_install'        
       end
 
       def devise_gems
@@ -43,66 +26,33 @@ module Cream::Generators
           gem 'devise_couch'
           say "Please note that Couch DB does not currently have a Roles implementation. Feel free to provide one."
           say "Look at Roles DataMapper (roles_data_mapper) for an example ;)"
+        else
+          say "Orm #{orm} is not currently supported by Cream. You are most welcome to provide a Cream adapter for that ORM ;)"
         end
       end
-
-      def init_devise
-        execute 'devise_install'
-      end      
       
-      def devise_users?
-        has_user?(:user) && has_user?(:admin)
-      end
-
-      def handle_devise_users
-        return notify_create_users if !init_devise?
-        create_users 
-      end
-
-      def notify_create_users
-        logger.debug 'notify_create_users'
-        say "You must first run devise generators:"
-        say "rails g devise User"
-        say "rails g devise Admin" if admin_user?      
+      module Protection
+        def self.configure!
+          ## Add Devise protection to Application controller:
+          insert_into_controller :application do
+            "before_filter :authenticate_user!"
+          end
+        end
       end
 
-      def create_admin_user
-        logger.debug 'create_admin_user'      
-        create_model :admin          
-        # remove any current inheritance
-        remove_inheritance :admin            
-        # and make Admin model inherit from User model 
-        inherit_model :user => :admin
-      end 
-
-      def remove_inheritance user
-        File.remove_from model_file user, :content => /<\s*ActiveRecord::Base/
-      end  
-
-      def inherit_model hash                 
-        subclass    = hash.keys.first
-        superclass  = hash.values.first.to_s.camelize
-        File.replace_content_from model_file subclass, :where => /class Admin/, :with => "class Admin < #{superclass}"
-      end
-      
-      # Must be ORM specific!
-      def create_devise_model user
-        execute "rails g devise #{user}"
+      module Orm
+        # inside 'config/initializers/devise.rb' change to:
+        # require 'devise/orm/mongo_mapper'
+        def self.configure!
+          File.replace_content_from initializer_file(:devise),  :where => /devise\/orm\/w+/, :content =>  'devise/orm/mongo_mapper'
+        end
       end
 
-      def create_user user
-        execute "rails g model #{user}"
-      end  
-      
-      def has_user? user
-        return true if user == :admin && !admin_user?
-        begin
-          read_model(user) =~ /devise/
-        rescue Exception => e
-          logger.info "Exception for has_user? #{user}: #{e.message}"
-          false
+      module Mailer
+        def self.configure!
+          insert_application_config "action_mailer.default_url_options = { :host => 'localhost:3000' }"
         end
-      end          
+      end      
     end
   end
 end

data/lib/generators/cream/config/modules/devise_users_config.rb

@@ -0,0 +1,104 @@
+module Cream::Generators 
+  module Config
+    module DeviseUsers
+      attr_accessor :user_helper
+
+      def configure_devise_users
+        @user_helper = UserHelper.new user_generator
+        
+        devise_default_user if !has_model? :user
+        
+        # if User model is NOT configured with devise strategy
+        Strategy.insert_devise_strategy :user, :defaults if !has_devise_user? :user
+        
+        devise_admin_user if admin_user?
+      end
+      
+      def devise_default_user
+        user_helper.create_devise_model :user
+      end
+
+      def devise_admin_user
+        # if app does NOT have a Admin model
+        user_helper.create_admin_user if !has_model? :admin
+
+        # insert default devise Admin strategy
+        Strategy.insert_devise_strategy :admin, :defaults if has_model? :admin
+      end
+
+      def create_admin_user
+        logger.debug 'create_admin_user'
+        user_helper.create_user_model :admin
+        # remove any current inheritance
+        Inherit.remove_inheritance :admin
+        # and make Admin model inherit from User model 
+        Inherit.inherit_model :user => :admin
+      end 
+
+      # Helpers
+
+      class UserHelper
+        attr_accessor :user_generator
+        
+        def initialize user_gen
+          @user_generator = user_gen
+        end
+        
+        def create_user_model user = :user
+          rgen "#{user_generator} model #{user}"
+        end  
+
+        def devise_users?
+          has_user?(:user) && has_user?(:admin)
+        end
+
+        def has_devise_user? user
+          return true if user == :admin && !admin_user?
+          begin
+            read_model(user) =~ /devise/
+          rescue Exception => e
+            logger.info "Exception for has_user? #{user}: #{e.message}"
+            false
+          end
+        end
+
+        # Must be ORM specific!
+        def create_devise_model user = :user
+          rgen "#{user_generator} #{user}"
+        end
+      end   
+      
+      module Inherit
+        def self.remove_inheritance user
+          File.remove_from model_file user, :content => /<\s*ActiveRecord::Base/
+        end  
+
+        def self.inherit_model hash                 
+          subclass    = hash.keys.first
+          superclass  = hash.values.first.to_s.camelize
+          File.replace_content_from model_file subclass, :where => /class Admin/, :with => "class Admin < #{superclass}"
+        end
+      end
+      
+      module Strategy
+        self << class
+          extend Rails3::Assist::UseMacro        
+          use_helpers :model
+
+          def insert_devise_strategy model_name, *names
+            names = devise_default_strategies if names.first == :defaults        
+            insert_into_model model_name do
+              "devise #{*names}"
+            end
+          end
+          
+          def self.devise_default_strategies
+            [:database_authenticatable, :confirmable, :recoverable, :rememberable, :trackable, :validatable]
+          end          
+        end      
+      end
+    end
+  end  
+end
+
+

data/lib/generators/cream/config/modules/helper.rb

@@ -8,6 +8,11 @@ module Cream::Generators
         :mongoid      => 'rails3-mongoid-devise'                
       }
 
+      # rails generate ...
+      def rgen command
+        execute "rails g #{command}"
+      end        
+
       def execute command
         logger.debug command
         run command
@@ -21,18 +26,35 @@ module Cream::Generators
         options[:logfile]      
       end
 
-      def default_roles
-        options[:default_roles] ? '--default-roles' : '--no-default-roles'
+      def users 
+        extra_users = admin_user? ? :admin : nil
+        @users ||= ([:user] + extra_users).compact
       end
 
       def roles
-        options[:roles].join(' ')
+        @roles ||= options[:roles].join(' ')
+      end
+
+      def roles_generator
+        "#{orm}:roles"
+      end
+
+      def user_generator 
+        active_record? ? "#{orm}:devise" : 'devise'
+      end
+
+      def active_record? 
+        orm == 'active_record'
       end
 
       def orm
         options[:orm]
       end
 
+      def default_roles?
+        options[:default_roles]
+      end
+
       def roles_config?
         options[:roles_config]
       end

data/lib/generators/cream/config/modules/permits_config.rb

@@ -8,7 +8,7 @@ module Cream::Generators
       def configure_permits
         logger.debug "Configure Permits"
         # Run permits generator to generate permit for each role
-        execute "rails g permits --roles #{roles}"
+        rgen "permits --roles #{roles}"
       end           
     end
   end

data/lib/generators/cream/config/modules/roles_config.rb

@@ -1,14 +1,38 @@
 module Cream::Generators 
   module Config
     module Roles
-      def configure_roles_gems
+      def configure_roles
+        create_roles
+        set_valid_roles_cream
+        use_roles_strategy        
+      end      
+
+      def roles_gems
         gem "roles_#{orm}"
       end
 
-      def configure_roles
-        command = "rails g #{orm}:roles --strategy #{strategy} --roles #{roles} #{default_roles}"
-        logger.debug command
-        run command
+      def create_roles
+        rgen "#{roles_generator} --strategy #{strategy} --roles #{roles} #{default_roles}"        
+      end
+      
+      def set_valid_roles_cream
+        if initializer_file? :cream
+          replace_in_model_file :user, :where => /valid_roles_are\s+[(.*)]/, :with => 'valid_roles_are Cream.roles'
+        end          
+      end
+
+      def use_roles_strategy
+        unless read_model_file(:user) =~ /use_roles_strategy/
+          insert_into_model :user do 
+            "use_roles_strategy :admin_flag"
+          end
+        end        
+      end
+      
+      protected
+      
+      def default_roles
+        default_roles? ? '--default-roles' : '--no-default-roles'
       end      
     end
   end

data/spec/cream/configure/cream_setup_spec.rb

@@ -0,0 +1,5 @@
+Cream.setup do |config|
+  # ==> Mailer Configuration
+  # Configure the e-mail address which will be shown in DeviseMailer.
+  config.roles = [:guest, :admin]
+end

data/spec/cream/configure/rails_custom_roles_spec.rb

@@ -0,0 +1,30 @@
+require 'configure_helper'
+
+Cream.available_roles = [:guest, :admin]
+
+describe "Rails extension" do
+  describe 'Extensions' do
+    it "should extend Action View with Roles helper instance_methods and specific role methods" do
+      after_init :view do
+        :view.should be_extended_with Cream::View,    :role, :host, :user_action_menu
+        :view.should be_extended_with Cream::Helper,  :role, :auth_label
+      end
+      
+      init_app_railties :minimal, :view
+    end
+
+    it "should extend Action Controller" do
+      after_init :controller do
+        :controller.should be_extended_with Cream, :role
+        :controller.should be_extended_with Cream::Controller, :ability
+        :controller.should be_extended_with Cream::Helper, :role, :host, :auth_label
+      end            
+      
+      init_app_railties :minimal, :view
+    end   
+    
+    it "should work with safe_concat" do
+      "abc".html_safe.should == "abc"
+    end
+  end
+end

data/spec/cream/configure/rails_user_roles_spec.rb

@@ -0,0 +1,34 @@
+require 'configure_helper'
+
+class User
+  def self.roles
+    [:guest, :admin]
+  end
+end
+
+describe "Rails extension" do
+  describe 'Extensions' do
+    it "should extend Action View with Roles helper instance_methods and specific role methods" do
+      after_init :view do
+        :view.should be_extended_with Cream::View,    :role, :host, :user_action_menu
+        :view.should be_extended_with Cream::Helper,  :role, :auth_label
+      end
+      
+      init_app_railties :minimal, :view
+    end
+
+    it "should extend Action Controller" do
+      after_init :controller do
+        :controller.should be_extended_with Cream, :role
+        :controller.should be_extended_with Cream::Controller, :ability
+        :controller.should be_extended_with Cream::Helper, :role, :host, :auth_label
+      end            
+      
+      init_app_railties :minimal, :view
+    end   
+    
+    it "should work with safe_concat" do
+      "abc".html_safe.should == "abc"
+    end
+  end
+end

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 0
   - 6
-  - 1
-  version: 0.6.1
+  - 3
+  version: 0.6.3
 platform: ruby
 authors: 
 - Kristian Mandrup
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-09-26 00:00:00 +02:00
+date: 2010-10-05 00:00:00 +02:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -282,15 +282,18 @@ files:
 - lib/cream/helper/host.rb
 - lib/cream/helper/role.rb
 - lib/cream/namespaces.rb
+- lib/cream/rails/config.rb
 - lib/cream/role.rb
 - lib/cream/view/host_area.rb
 - lib/cream/view/role_area.rb
 - lib/cream/view/user_action_menu.rb
 - lib/generators/cream/config/DESIGN NOTES.markdown
 - lib/generators/cream/config/config_generator.rb
+- lib/generators/cream/config/modules/app_config.rb
 - lib/generators/cream/config/modules/cancan_config.rb
 - lib/generators/cream/config/modules/cream_config.rb
 - lib/generators/cream/config/modules/devise_config.rb
+- lib/generators/cream/config/modules/devise_users_config.rb
 - lib/generators/cream/config/modules/helper.rb
 - lib/generators/cream/config/modules/permits_config.rb
 - lib/generators/cream/config/modules/roles_config.rb
@@ -300,7 +303,10 @@ files:
 - log/development.log
 - sandbox/test.rb
 - spec/configure_helper.rb
-- spec/cream/configure/rails_spec.rb
+- spec/cream/configure/cream_setup_spec.rb
+- spec/cream/configure/rails_custom_roles_spec.rb
+- spec/cream/configure/rails_role_spec.rb
+- spec/cream/configure/rails_user_roles_spec.rb
 - spec/cream/helper/host_spec.rb
 - spec/cream/helper/role_spec.rb
 - spec/cream/view/host_area_spec.rb
@@ -357,7 +363,10 @@ specification_version: 3
 summary: Integrates Devise, Roles and CanCan with Permits for a Rails 3 app
 test_files: 
 - spec/configure_helper.rb
-- spec/cream/configure/rails_spec.rb
+- spec/cream/configure/cream_setup_spec.rb
+- spec/cream/configure/rails_custom_roles_spec.rb
+- spec/cream/configure/rails_role_spec.rb
+- spec/cream/configure/rails_user_roles_spec.rb
 - spec/cream/helper/host_spec.rb
 - spec/cream/helper/role_spec.rb
 - spec/cream/view/host_area_spec.rb