activeadmin-orac 1.0.0.pre4

data/lib/active_admin/dependency.rb

@@ -0,0 +1,168 @@
+module ActiveAdmin
+  module Dependency
+    module Requirements
+      DEVISE = '>= 3.2', '< 5'
+    end
+
+    # Provides a clean interface to check for gem dependencies at runtime.
+    #
+    # ActiveAdmin::Dependency.draper
+    # => #<ActiveAdmin::Dependency::Matcher for draper 1.2.1>
+    #
+    # ActiveAdmin::Dependency.draper?
+    # => true
+    #
+    # ActiveAdmin::Dependency.draper? '>= 1.5.0'
+    # => false
+    #
+    # ActiveAdmin::Dependency.draper? '= 1.2.1'
+    # => true
+    #
+    # ActiveAdmin::Dependency.draper? '~> 1.2.0'
+    # => true
+    #
+    # ActiveAdmin::Dependency.rails? '>= 4.1.0', '<= 4.1.1'
+    # => true
+    #
+    # ActiveAdmin::Dependency.rails! '2'
+    # -> ActiveAdmin::DependencyError: You provided rails 3.2.18 but we need: 2.
+    #
+    # ActiveAdmin::Dependency.devise!
+    # -> ActiveAdmin::DependencyError: To use devise you need to specify it in your Gemfile.
+    #
+    #
+    # All but the pessimistic operator (~>) can also be run using Ruby's comparison syntax.
+    #
+    # ActiveAdmin::Dependency.rails >= '3.2.18'
+    # => true
+    #
+    # Which is especially useful if you're looking up a gem with dashes in the name.
+    #
+    # ActiveAdmin::Dependency['jquery-ui-rails'] < 5
+    # => false
+    #
+    def self.method_missing(name, *args)
+      if name[-1] == '?'
+        Matcher.new(name[0..-2]).match? args
+      elsif name[-1] == '!'
+        Matcher.new(name[0..-2]).match! args
+      else
+        Matcher.new name.to_s
+      end
+    end
+
+    def self.[](name)
+      Matcher.new name.to_s
+    end
+
+    def self.rails5?
+      rails >= '5.x'
+    end
+
+    class Matcher
+      attr_reader :name
+
+      def initialize(name)
+        @name = name
+      end
+
+      def spec
+        @spec ||= Gem.loaded_specs[name]
+      end
+
+      def spec!
+        spec || raise(DependencyError, "To use #{name} you need to specify it in your Gemfile.")
+      end
+
+      def match?(*reqs)
+        !!spec && Gem::Requirement.create(reqs).satisfied_by?(spec.version)
+      end
+
+      def match!(*reqs)
+        unless match? reqs
+          raise DependencyError, "You provided #{spec!.name} #{spec!.version} but we need: #{reqs.join ', '}."
+        end
+      end
+
+      include Comparable
+
+      def <=>(other)
+        spec!.version <=> Gem::Version.create(other)
+      end
+
+      def inspect
+        info = spec ? "#{spec.name} #{spec.version}" : '(missing)'
+        "<ActiveAdmin::Dependency::Matcher for #{info}>"
+      end
+
+      def adapter
+        @adapter ||= Adapter.const_get(@name.camelize).new self
+      end
+
+      def method_missing(method, *args, &block)
+        if respond_to_missing?(method)
+          adapter.send method, *args, &block
+        else
+          super
+        end
+      end
+
+      def respond_to_missing?(method, include_private = false)
+        adapter.respond_to?(method) || super
+      rescue NameError
+        # 🐾
+      end
+    end
+
+    # Dependency adapters provide an easy way to wrap the conditional logic
+    # necessary to support multiple versions of a gem.
+    #
+    # ActiveAdmin::Dependency.rails.adapter.parameterize 'a b'
+    # => 'a_b'
+    #
+    # ActiveAdmin::Dependency.rails.parameterize 'a b'
+    # => 'a_b'
+    #
+    # ActiveAdmin::Dependency.devise.adapter
+    # -> NameError: uninitialized constant ActiveAdmin::Dependency::Adapter::Devise
+    #
+    module Adapter
+      class Base
+        def initialize(version)
+          @version = version
+        end
+      end
+
+      class Rails < Base
+        def strong_parameters?
+          @version >= 4 || defined?(ActionController::StrongParameters)
+        end
+
+        def parameterize(string)
+          if Dependency.rails5?
+            string.parameterize separator: '_'
+          else
+            string.parameterize '_'
+          end
+        end
+
+        def redirect_back(controller, fallback_location)
+          controller.instance_exec do
+            if Dependency.rails5?
+              redirect_back fallback_location: fallback_location
+            elsif controller.request.headers.key? 'HTTP_REFERER'
+              redirect_to :back
+            else
+              redirect_to fallback_location
+            end
+          end
+        end
+
+        def render_key
+          Dependency.rails5? ? :body : :text
+        end
+      end
+    end
+
+  end
+end

data/lib/active_admin/deprecation.rb

@@ -0,0 +1,35 @@
+module ActiveAdmin
+  module Deprecation
+    module_function
+
+    def warn(message, callstack = caller)
+      ActiveSupport::Deprecation.warn "Active Admin: #{message}", callstack
+    end
+
+    # Deprecate a method.
+    #
+    # @param [Module] klass the Class or Module to deprecate the method on
+    # @param [Symbol] method the method to deprecate
+    # @param [String] message the message to display to the end user
+    #
+    # Example:
+    #
+    #     class MyClass
+    #       def my_method
+    #         # ...
+    #       end
+    #       ActiveAdmin::Deprecation.deprecate self, :my_method,
+    #         "MyClass#my_method is being removed in the next release"
+    #     end
+    #
+    def deprecate(klass, method, message)
+      klass.send :define_method, "deprecated_#{method}", klass.instance_method(method)
+
+      klass.send :define_method, method do |*args|
+        ActiveAdmin::Deprecation.warn "#{message}", caller
+        send "deprecated_#{method}", *args
+      end
+    end
+
+  end
+end

data/lib/active_admin/devise.rb

@@ -0,0 +1,80 @@
+ActiveAdmin::Dependency.devise! ActiveAdmin::Dependency::Requirements::DEVISE
+
+require 'devise'
+
+module ActiveAdmin
+  module Devise
+
+    def self.config
+      {
+        path: ActiveAdmin.application.default_namespace || "/",
+        controllers: ActiveAdmin::Devise.controllers,
+        path_names: { sign_in: 'login', sign_out: "logout" },
+        sign_out_via: [*::Devise.sign_out_via, ActiveAdmin.application.logout_link_method].uniq
+      }
+    end
+
+    def self.controllers
+      {
+        sessions: "active_admin/devise/sessions",
+        passwords: "active_admin/devise/passwords",
+        unlocks: "active_admin/devise/unlocks",
+        registrations: "active_admin/devise/registrations",
+        confirmations: "active_admin/devise/confirmations"
+      }
+    end
+
+    module Controller
+      extend ::ActiveSupport::Concern
+      included do
+        layout 'active_admin_logged_out'
+        helper ::ActiveAdmin::ViewHelpers
+      end
+
+      # Redirect to the default namespace on logout
+      def root_path
+        namespace = ActiveAdmin.application.default_namespace.presence
+        root_path_method = [namespace, :root_path].compact.join('_')
+
+        path = if Helpers::Routes.respond_to? root_path_method
+                 Helpers::Routes.send root_path_method
+               else
+                 # Guess a root_path when url_helpers not helpful
+                 "/#{namespace}"
+               end
+
+        # NOTE: `relative_url_root` is deprecated by rails.
+        #       Remove prefix here if it is removed completely.
+        prefix = Rails.configuration.action_controller[:relative_url_root] || ''
+        prefix + path
+      end
+    end
+
+    class SessionsController < ::Devise::SessionsController
+      include ::ActiveAdmin::Devise::Controller
+    end
+
+    class PasswordsController < ::Devise::PasswordsController
+      include ::ActiveAdmin::Devise::Controller
+    end
+
+    class UnlocksController < ::Devise::UnlocksController
+      include ::ActiveAdmin::Devise::Controller
+    end
+
+    class RegistrationsController < ::Devise::RegistrationsController
+       include ::ActiveAdmin::Devise::Controller
+    end
+
+    class ConfirmationsController < ::Devise::ConfirmationsController
+       include ::ActiveAdmin::Devise::Controller
+    end
+
+    def self.controllers_for_filters
+      [SessionsController, PasswordsController, UnlocksController,
+        RegistrationsController, ConfirmationsController
+      ]
+    end
+
+  end
+end

data/lib/active_admin/dsl.rb

@@ -0,0 +1,173 @@
+module ActiveAdmin
+
+  # The Active Admin DSL. This class is where all the registration blocks
+  # are evaluated. This is the central place for the API given to
+  # users of Active Admin.
+  #
+  class DSL
+
+    def initialize(config)
+      @config = config
+    end
+
+    # Runs the registration block inside this object
+    def run_registration_block(&block)
+      instance_exec &block if block_given?
+    end
+
+    # The instance of ActiveAdmin::Resource that's being registered
+    # currently. You can use this within your registration blocks to
+    # modify options:
+    #
+    # eg:
+    #
+    #   ActiveAdmin.register Post do
+    #     config.sort_order = "id_desc"
+    #   end
+    #
+    def config
+      @config
+    end
+
+    # Include a module with this resource. The modules's `included` method
+    # is called with the instance of the `ActiveAdmin::DSL` passed into it.
+    #
+    # eg:
+    #
+    #   module HelpSidebar
+    #
+    #     def self.included(dsl)
+    #       dsl.sidebar "Help" do
+    #         "Call us for Help"
+    #       end
+    #     end
+    #
+    #   end
+    #
+    #   ActiveAdmin.register Post do
+    #     include HelpSidebar
+    #   end
+    #
+    # @param [Module] mod A module to include
+    #
+    # @return [Nil]
+    def include(mod)
+      mod.included(self)
+    end
+
+    # Returns the controller for this resource. If you pass a
+    # block, it will be evaluated in the controller.
+    #
+    # Example:
+    #
+    #   ActiveAdmin.register Post do
+    #
+    #     controller do
+    #       def some_method_on_controller
+    #         # Method gets added to Admin::PostsController
+    #       end
+    #     end
+    #
+    #   end
+    #
+    def controller(&block)
+      @config.controller.class_exec(&block) if block_given?
+      @config.controller
+    end
+
+    # Add a new action item to the resource
+    #
+    # @param [Symbol] name
+    # @param [Hash] options valid keys include:
+    #                 :only:  A single or array of controller actions to display
+    #                         this action item on.
+    #                 :except: A single or array of controller actions not to
+    #                          display this action item on.
+    def action_item(name = nil, options = {}, &block)
+      if name.is_a?(Hash)
+        options = name
+        name = nil
+      end
+
+      Deprecation.warn "using `action_item` without a name is deprecated! Use `action_item(:edit)`." unless name
+
+      config.add_action_item(name, options, &block)
+    end
+
+    # Add a new batch action item to the resource
+    # Provide a symbol/string to register the action, options, & block to execute on request
+    #
+    # To unregister an existing action, just provide the symbol & pass false as the second param
+    #
+    # @param [Symbol or String] title
+    # @param [Hash] options valid keys include:
+    # => :if is a proc that will be called to determine if the BatchAction should be displayed
+    # => :sort_order is used to sort the batch actions ascending
+    # => :confirm is a string which the user will have to accept in order to process the action
+    #
+    def batch_action(title, options = {}, &block)
+      # Create symbol & title information
+      if title.is_a? String
+        sym = title.titleize.tr(' ', '').underscore.to_sym
+      else
+        sym = title
+        title = sym.to_s.titleize
+      end
+
+      # Either add/remove the batch action
+      unless options == false
+        config.add_batch_action( sym, title, options, &block )
+      else
+        config.remove_batch_action sym
+      end
+    end
+
+    # Set the options that are available for the item that will be placed in the global
+    # navigation of the menu.
+    def menu(options = {})
+      config.menu_item_options = options
+    end
+
+    # Set the name of the navigation menu to display. This is mainly used in conjunction with the
+    # `#belongs_to` functionality.
+    #
+    # @param [Symbol] menu_name The name of the menu to display as the global navigation
+    #                 when viewing this resource. Defaults to a menu named `:default`.
+    #
+    # Pass a block returning the name of a menu you want rendered for the request, being
+    # executed in the context of the controller
+    #
+    def navigation_menu(menu_name=nil, &block)
+      config.navigation_menu_name = menu_name || block
+    end
+
+    # Rewrite breadcrumb links.
+    # Block will be executed inside controller.
+    # Block must return an array if you want to rewrite breadcrumb links.
+    #
+    # Example:
+    #   ActiveAdmin.register Post do
+    #
+    #     breadcrumb do
+    #       [
+    #         link_to('my piece', '/my/link/to/piece')
+    #       ]
+    #     end
+    #   end
+    #
+    def breadcrumb(&block)
+      config.breadcrumb = block
+    end
+
+    def sidebar(name, options = {}, &block)
+      config.sidebar_sections << ActiveAdmin::SidebarSection.new(name, options, &block)
+    end
+
+    def decorate_with(decorator_class)
+      # Force storage as a string. This will help us with reloading issues.
+      # Assuming decorator_class.to_s will return the name of the class allows
+      # us to handle a string or a class.
+      config.decorator_class_name = "::#{ decorator_class }"
+    end
+  end
+end