activeadmin 0.1.1 → 0.2.0

data/features/support/paths.rb

@@ -0,0 +1,48 @@
+module NavigationHelpers
+  # Maps a name to a path. Used by the
+  #
+  #   When /^I go to (.+)$/ do |page_name|
+  #
+  # step definition in web_steps.rb
+  #
+  def path_to(page_name)
+    case page_name
+
+    when /the home\s?page/
+      '/'
+    when /the dashboard/
+      "/admin"
+
+    # the index page for posts in the root namespace
+    # the index page for posts in the user_admin namespace
+    when /^the index page for (.*) in the (.*) namespace$/
+      if $2 != 'root'
+        send(:"#{$2}_#{$1}_path")
+      else
+        send(:"#{$1}_path")
+      end
+
+    # same as above, except defaults to admin namespace
+    when /^the index page for (.*)$/
+      send(:"admin_#{$1}_path")
+
+    # Add more mappings here.
+    # Here is an example that pulls values out of the Regexp:
+    #
+    #   when /^(.*)'s profile page$/i
+    #     user_profile_path(User.find_by_login($1))
+
+    else
+      begin
+        page_name =~ /the (.*) page/
+        path_components = $1.split(/\s+/)
+        self.send(path_components.push('path').join('_').to_sym)
+      rescue Object => e
+        raise "Can't find mapping from \"#{page_name}\" to a path.\n" +
+          "Now, go and add a mapping in #{__FILE__}"
+      end
+    end
+  end
+end
+
+World(NavigationHelpers)

data/features/users/logging_in.feature

@@ -0,0 +1,34 @@
+Feature: User Logging In
+
+  Logging in to the system as an admin user
+
+  Background:
+    Given a configuration of:
+    """
+      ActiveAdmin.register Post
+    """
+    And I am logged out
+    And an admin user "admin@example.com" exists
+    When I go to the dashboard
+
+  Scenario: Logging in Successfully
+    When I fill in "Email" with "admin@example.com"
+    And I fill in "Password" with "password"
+    And I press "Login"
+    Then I should be on the the dashboard
+    And I should see "Logout"
+    And I should see "admin@example.com"
+
+  Scenario: Attempting to log in with an incorrent email address
+    When I fill in "Email" with "not-an-admin@example.com"
+    And I fill in "Password" with "not-my-password"
+    And I press "Login"
+    Then I should see "Login"
+    And I should see "Invalid email or password."
+
+  Scenario: Attempting to log in with an incorrect password
+    When I fill in "Email" with "admin@example.com"
+    And I fill in "Password" with "not-my-password"
+    And I press "Login"
+    Then I should see "Login"
+    And I should see "Invalid email or password."

data/features/users/logging_out.feature

@@ -0,0 +1,13 @@
+Feature: User Logging out
+
+  Logging out of the system as an admin user
+
+  Scenario: Logging out successfully
+    Given a configuration of:
+    """
+      ActiveAdmin.register Post
+    """
+    And I am logged in
+    When I go to the dashboard
+    And I follow "Logout"
+    Then I should see "Login"

data/lib/active_admin.rb

@@ -1,77 +1,105 @@
 require 'meta_search'
+require 'devise'
+require 'will_paginate'
+require 'sass'
+require 'active_admin/arbre'
 
 module ActiveAdmin
-  
-  autoload :VERSION,              'active_admin/version'
-  autoload :Namespace,            'active_admin/namespace'
-  autoload :Resource,             'active_admin/resource'
-  autoload :ResourceController,   'active_admin/resource_controller'
-  autoload :Dashboards,           'active_admin/dashboards'
-  autoload :Renderer,             'active_admin/renderer'
-  autoload :TableBuilder,         'active_admin/table_builder'
-  autoload :FormBuilder,          'active_admin/form_builder'
-  autoload :TabsRenderer,         'active_admin/tabs_renderer'
-  autoload :ViewHelpers,          'active_admin/view_helpers'
-  autoload :Breadcrumbs,          'active_admin/breadcrumbs'
-  autoload :Filters,              'active_admin/filters'
-  autoload :PageConfig,           'active_admin/page_config'
-  autoload :Pages,                'active_admin/pages'
-  autoload :Sidebar,              'active_admin/sidebar'
-  autoload :ActionItems,          'active_admin/action_items'
-  autoload :AssetRegistration,    'active_admin/asset_registration'
-  autoload :Menu,                 'active_admin/menu'
-  autoload :MenuItem,             'active_admin/menu_item'
-  autoload :ActionBuilder,        'active_admin/action_builder'
 
-  extend AssetRegistration
-
-  # The default namespace to put controllers and routes inside. Set this
-  # in config/initializers/active_admin.rb using:
-  # 
-  #   ActiveAdmin.default_namespace = :super_admin
-  #
-  @@default_namespace = :admin
-  mattr_accessor :default_namespace
-
-  # The default number of resources to display on index pages
-  @@default_per_page = 30
-  mattr_accessor :default_per_page
-
-  # The default sort order for index pages
-  @@default_sort_order = 'id_desc'
-  mattr_accessor :default_sort_order
-
-  # A hash of all the registered namespaces
-  @@namespaces = {}
-  mattr_accessor :namespaces
-
-  # The title which get's displayed in the main layout
-  @@site_title = ""
-  mattr_accessor :site_title
-
-  # Load paths for admin configurations. Add folders to this load path
-  # to load up other resources for administration. External gems can
-  # include thier paths in this load path to provide active_admin UIs
-  @@load_paths = [File.expand_path('app/admin', Rails.root)]
-  mattr_accessor :load_paths
-
-  # Stores if everything has been loaded or we need to reload
-  @@loaded = false
+  autoload :VERSION,                  'active_admin/version'
+  autoload :ActionItems,              'active_admin/action_items'
+  autoload :AssetRegistration,        'active_admin/asset_registration'
+  autoload :Breadcrumbs,              'active_admin/breadcrumbs'
+  autoload :Callbacks,                'active_admin/callbacks'
+  autoload :Component,                'active_admin/component'
+  autoload :ControllerAction,         'active_admin/controller_action'
+  autoload :Dashboards,               'active_admin/dashboards'
+  autoload :Devise,                   'active_admin/devise'
+  autoload :DSL,                      'active_admin/dsl'
+  autoload :Event,                    'active_admin/event'
+  autoload :FormBuilder,              'active_admin/form_builder'
+  autoload :Iconic,                   'active_admin/iconic'
+  autoload :Menu,                     'active_admin/menu'
+  autoload :MenuItem,                 'active_admin/menu_item'
+  autoload :Namespace,                'active_admin/namespace'
+  autoload :PageConfig,               'active_admin/page_config'
+  autoload :Resource,                 'active_admin/resource'
+  autoload :ResourceController,       'active_admin/resource_controller'
+  autoload :Renderer,                 'active_admin/renderer'
+  autoload :Scope,                    'active_admin/scope'
+  autoload :Sidebar,                  'active_admin/sidebar'
+  autoload :TableBuilder,             'active_admin/table_builder'
+  autoload :ViewFactory,              'active_admin/view_factory'
+  autoload :ViewHelpers,              'active_admin/view_helpers'
+  autoload :Views,                    'active_admin/views'
+
+  module Configuration
+
+    # The default namespace to put controllers and routes inside. Set this
+    # in config/initializers/active_admin.rb using:
+    # 
+    #   config.default_namespace = :super_admin
+    #
+    @@default_namespace = :admin
+    mattr_accessor :default_namespace
+
+    # The default number of resources to display on index pages
+    @@default_per_page = 30
+    mattr_accessor :default_per_page
+
+    # The default sort order for index pages
+    @@default_sort_order = 'id_desc'
+    mattr_accessor :default_sort_order
+
+    # A hash of all the registered namespaces
+    @@namespaces = {}
+    mattr_accessor :namespaces
+
+    # The title which get's displayed in the main layout
+    @@site_title = ""
+    mattr_accessor :site_title
+
+    # Load paths for admin configurations. Add folders to this load path
+    # to load up other resources for administration. External gems can
+    # include thier paths in this load path to provide active_admin UIs
+    @@load_paths = [File.expand_path('app/admin', Rails.root)]
+    mattr_accessor :load_paths
+
+    # The view factory to use to generate all the view classes. Take
+    # a look at ActiveAdmin::ViewFactory
+    @@view_factory = ActiveAdmin::ViewFactory.new
+    mattr_accessor :view_factory
+
+    # Whether or not to use admin comments
+    @@admin_notes = true
+    mattr_accessor :admin_notes
+    
+    # The method to call in controllers to get the current user
+    @@current_user_method = :current_admin_user
+    mattr_accessor :current_user_method
+
+    # The method to call in the controllers to ensure that there
+    # is a currently authenticated admin user
+    @@authentication_method = :authenticate_admin_user!
+    mattr_accessor :authentication_method
+
+    # Active Admin makes educated guesses when displaying objects, this is
+    # the list of methods its tries calling in order
+    @@display_name_methods = [:display_name, :full_name, :name, :username, :login, :title, :email, :to_s]
+    mattr_accessor :display_name_methods
 
-  # A hash containing a menu for each of our namespaces
-  @@menus = {}
-  mattr_accessor :menus
+  end
 
-  # The class to use to render the tabs in the interface
-  @@tabs_renderer = ActiveAdmin::TabsRenderer
-  mattr_accessor :tabs_renderer
+  extend Configuration
+  extend AssetRegistration
 
   class << self
 
+
     # Get's called within the initializer
     def setup
       # Register the default assets
-      register_stylesheet 'active_admin.css'
+      register_stylesheet 'admin/active_admin.css'
       register_javascript 'active_admin_vendor.js'
       register_javascript 'active_admin.js'
 
@@ -80,6 +108,9 @@ module ActiveAdmin
       # If not, file nameing becomes very important and can cause clashes.
       ActiveSupport::Dependencies.autoload_paths.reject!{|path| load_paths.include?(path) }
 
+      # Add the Active Admin view path to the rails view path
+      ActionController::Base.append_view_path File.expand_path('../active_admin/views/templates', __FILE__)
+
       # Don't eagerload our configs, we'll deal with them ourselves
       Rails.application.config.eager_load_paths = Rails.application.config.eager_load_paths.reject do |path| 
         load_paths.include?(path)
@@ -89,23 +120,36 @@ module ActiveAdmin
       # and on every require in development mode
       ActionDispatch::Callbacks.to_prepare :active_admin do
         ActiveAdmin.unload!
-        # Because every time we load, the routes may have changed
-        # we must ensure to load the routes each request (in dev)
         Rails.application.reload_routes!
       end
 
       yield self
+
+      # Setup SASS
+      require 'sass/plugin' # This must be required after initialization
+      Sass::Plugin.add_template_location(File.expand_path("../active_admin/stylesheets/", __FILE__), File.join(Rails.root, "public/stylesheets/admin"))
     end
 
     # Registers a brand new configuration for the given resource.
-    #
-    # TODO: Setup docs for registration options
     def register(resource, options = {}, &block)
       namespace_name = options[:namespace] == false ? :root : (options[:namespace] || default_namespace)
-      namespace = namespaces[namespace_name] ||= Namespace.new(namespace_name)
+      namespace = find_or_create_namespace(namespace_name)
       namespace.register(resource, options, &block)
     end
 
+    # Creates a namespace for the given name
+    def find_or_create_namespace(name)
+      return namespaces[name] if namespaces[name]
+      namespace = Namespace.new(name)
+      ActiveAdmin::Event.dispatch ActiveAdmin::Namespace::RegisterEvent, namespace
+      namespaces[name] = namespace
+      namespace
+    end
+
+
+    # Stores if everything has been loaded or we need to reload
+    @@loaded = false
+
     # Returns true if all the configuration files have been loaded.
     def loaded?
       @@loaded
@@ -118,6 +162,7 @@ module ActiveAdmin
     # to allow for changes without having to restart the server.
     def unload!
       namespaces.values.each{|namespace| namespace.unload! }
+      self.namespaces = {}
       @@loaded = false
     end
 
@@ -129,14 +174,21 @@ module ActiveAdmin
     # and they aren't marked for re-loading. To mark the files for re-loading
     # you must first call ActiveAdmin.unload!
     def load!
-      unless loaded?
-        load_paths.flatten.compact.uniq.each do |path|
-          Dir["#{path}/*.rb"].each{|f| load f }
-        end
-        @@loaded = true
-        return true
+      # No work to do if we've already loaded
+      return false if loaded?
+
+      # Load files
+      load_paths.flatten.compact.uniq.each do |path|
+        Dir["#{path}/*.rb"].each{|f| load f }
       end
-      false
+
+      # If no configurations, let's make sure you can still login
+      load_default_namespace if namespaces.values.empty?
+
+      # Load Menus
+      namespaces.values.each{|namespace| namespace.load_menu! }
+
+      @@loaded = true
     end
 
     # Creates all the necessary routes for the ActiveAdmin configurations
@@ -190,17 +242,39 @@ module ActiveAdmin
             end
           end
 
-          if config.namespace.root?
-            instance_eval(&route_definition_block)
-          else
-            namespace config.namespace.name do
-              instance_eval(&route_definition_block)
+          # Add in the parent if it exists
+          if config.belongs_to?
+            routes_for_belongs_to = route_definition_block.dup
+            route_definition_block = Proc.new do
+              # If its optional, make the normal resource routes
+              instance_eval &routes_for_belongs_to if config.belongs_to_config.optional?
+
+              # Make the nested belongs_to routes
+              resources config.belongs_to_config.target.underscored_resource_name.pluralize do
+                instance_eval &routes_for_belongs_to
+              end
             end
           end
+
+          # Add on the namespace if required
+          if !config.namespace.root?
+            routes_in_namespace = route_definition_block.dup
+            route_definition_block = Proc.new do
+              namespace config.namespace.name do
+                instance_eval(&routes_in_namespace)
+              end
+            end
+          end
+
+          instance_eval &route_definition_block
         end
       end
     end
 
+    def load_default_namespace
+      find_or_create_namespace(default_namespace)
+    end
+
     #
     # Add before, around and after filters to each registered resource.
     #
@@ -227,3 +301,5 @@ module ActiveAdmin
 
   end
 end
+
+require 'active_admin/comments'

data/lib/active_admin/abstract_view_factory.rb

@@ -0,0 +1,95 @@
+module ActiveAdmin
+  class AbstractViewFactory
+    @@default_views = {}
+
+    def self.register(view_hash)
+      view_hash.each do |view_key, view_class|
+        @@default_views[view_key] = view_class
+      end
+    end
+
+    def initialize
+      @views = {}
+    end
+
+    # Register a new view key with the view factory
+    #
+    # eg:
+    #   
+    #   factory = AbstractViewFactory.new
+    #   factory.register :my_view => SomeViewClass
+    #
+    # You can setup many at the same time:
+    #
+    #   factory.register  :my_view => SomeClass,
+    #                     :another_view => OtherViewClass
+    #
+    def register(view_hash)
+      view_hash.each do |view_key, view_class|
+        @views[view_key] = view_class
+      end
+    end
+
+    def default_for(key)
+      @@default_views[key.to_sym]
+    end
+
+    def has_key?(key)
+      @views.has_key?(key.to_sym) || @@default_views.has_key?(key.to_sym)
+    end
+
+    def [](key)
+      get_view_for_key(key)
+    end
+
+    def []=(key, value)
+      set_view_for_key(key, value)
+    end
+
+    # Override respond to to include keys
+    def respond_to?(method)
+      key = key_from_method_name(method)
+      if has_key?(key)
+        true
+      else
+        super
+      end
+    end
+
+    private
+
+    def method_missing(method, *args)
+      key = key_from_method_name(method)
+      if has_key?(key)
+        if method.to_s.include?('=')
+          self.class_eval <<-EOS
+            def #{key}=(value)
+              set_view_for_key(:#{key}, value)
+            end
+          EOS
+        else
+          self.class_eval <<-EOS
+            def #{key}
+              get_view_for_key(:#{key})
+            end
+          EOS
+        end
+        self.send(method, *args)
+      else
+        super
+      end
+    end
+
+    def key_from_method_name(method)
+      method.to_s.gsub('=', '').to_sym
+    end
+
+    def get_view_for_key(key)
+      @views[key.to_sym] || @@default_views[key.to_sym]
+    end
+
+    def set_view_for_key(key, view)
+      @views[key.to_sym] = view
+    end
+  end
+end