ez-resources 0.1.0

data/app/cells/ez/resources/search/show.slim

@@ -0,0 +1,20 @@
+= div_for 'collection-search-container'
+  = div_for 'collection-search-panel'
+    h4 = t('phrases.search_and_filter')
+
+    = div_for 'collection-search-panel-form'
+      = simple_form_for model.search, url: model.path_for(action: :index), method: :get do |f|
+        - model.collection_columns.each do |field|
+          - if field.searchable && SEARCHABLE_FIELDS.include?(field.type)
+            = div_for 'collection-search-panel-field'
+              = f.input   field_name(field),
+                label:    field_label(field),
+                required: false,
+                as:       cast_field_type(field.type),
+                collection: field.collection,
+                include_blank: true
+
+        = f.submit t('actions.apply'), class: css_for('collection-search-panel-submit-button')
+
+        - if model.params[:q]
+          = link_to t('actions.reset'), model.path_for(action: :index), class: css_for('collection-search-panel-reset-link')

data/app/cells/ez/resources/search_cell.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Ez
+  module Resources
+    class SearchCell < ApplicationCell
+      SEARCHABLE_FIELDS = %i[string association select link boolean].freeze
+
+      form
+
+      def cast_field_type(type)
+        case type
+        when :link then :string
+        when :boolean then :select
+        when :association then :string
+        else
+          type
+        end
+      end
+
+      def field_name(field)
+        if association?(field)
+          search_key(field.name, field.search_suffix, field.options.fetch(:association))
+        else
+          search_key(field.name, field.search_suffix)
+        end
+      end
+
+      def field_label(field)
+        "#{field.title} (#{t "search.suffix.#{field.search_suffix}"})"
+      end
+
+      private
+
+      def search_key(name, search_suffix, association_prefix = nil)
+        [association_prefix, name, search_suffix].compact.join('_').to_sym
+      end
+
+      def association?(field)
+        field.type == :association && field.options[:association].present?
+      end
+    end
+  end
+end

data/lib/ez/resources.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require 'ez/resources/engine'
+require 'ez/resources/manager'
+
+require 'ez/configurator'
+module Ez
+  module Resources
+    include Ez::Configurator
+
+    configure do |config|
+      config.ignore_fields = %w[id created_at updated_at]
+      config.i18n_scope = 'ez_resources'
+    end
+
+    BaseError          = Class.new(StandardError)
+    GuessingError      = Class.new(BaseError)
+    ConfigurationError = Class.new(BaseError)
+    UnavailableError   = Class.new(BaseError)
+  end
+end

data/lib/ez/resources/engine.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require 'cells-rails'
+require 'cells-slim'
+require 'simple_form'
+require 'pagy'
+require 'ransack'
+
+module Ez
+  module Resources
+    class Engine < ::Rails::Engine
+    end
+  end
+end

data/lib/ez/resources/manager.rb

@@ -0,0 +1,114 @@
+# frozen_string_literal: true
+
+require 'ez/resources/manager/dsl'
+require 'ez/resources/manager/config'
+
+module Ez
+  module Resources
+    module Manager
+      include ::Cell::RailsExtensions::ActionController
+
+      def self.included(base)
+        base.extend(DSL)
+
+        base.rescue_from UnavailableError do
+          if Ez::Resources.config.ui_failed_hook
+            instance_exec(&Ez::Resources.config.ui_failed_hook)
+          else
+            flash[:alert] = t('messages.unavailable', scope: Ez::Resources.config.i18n_scope)
+            redirect_to '/'
+          end
+        end
+      end
+
+      def index
+        Manager::Hooks.can!(:can_list?, ez_resource_config)
+
+        ez_resource_view :collection, ez_resource_config
+      end
+
+      def show
+        Manager::Hooks.can!(:can_read?, ez_resource_config)
+
+        if ez_resource_config.show_action_renders_form?
+          ez_resource_view :form, ez_resource_config
+        else
+          # TODO: render show cell
+        end
+      end
+
+      def new
+        Manager::Hooks.can!(:can_create?, ez_resource_config)
+
+        ez_resource_view :form, ez_resource_config
+      end
+
+      def create
+        Manager::Hooks.can!(:can_create?, ez_resource_config)
+
+        @ez_resource = ez_resource_config.model.new(ez_resource_params)
+
+        if @ez_resource.save
+          flash[:notice] = t('messages.created',
+                             resource_name: ez_resource_config.resource_name,
+                             scope:         Ez::Resources.config.i18n_scope)
+
+          redirect_to ez_resource_config.path_for(action: :index)
+        else
+          flash[:alert] = t('messages.invalid',
+                            resource_name: ez_resource_config.resource_name,
+                            scope:         Ez::Resources.config.i18n_scope)
+
+          ez_resource_view :form, ez_resource_config
+        end
+      end
+
+      def edit
+        Manager::Hooks.can!(:can_update?, ez_resource_config, ez_resource_config.data)
+
+        ez_resource_view :form, ez_resource_config
+      end
+
+      def update
+        Manager::Hooks.can!(:can_update?, ez_resource_config, ez_resource_config.data)
+
+        @ez_resource = ez_resource_config.data
+
+        if @ez_resource.update(ez_resource_params)
+          flash[:notice] = t('messages.updated',
+                             resource_name: ez_resource_config.resource_name,
+                             scope:         Ez::Resources.config.i18n_scope)
+
+          redirect_to ez_resource_config.path_for(action: :index)
+        else
+          flash[:alert] = t('messages.invalid',
+                            resource_name: ez_resource_config.resource_name,
+                            scope:         Ez::Resources.config.i18n_scope)
+
+          ez_resource_view :form, ez_resource_config
+        end
+      end
+
+      # TODO: Later
+      def destroy; end
+
+      private
+
+      def ez_resource_view(cell_name, *args)
+        render html: cell("ez/resources/#{cell_name}", *args), layout: true
+      end
+
+      def ez_resource_params
+        params.require(:ez_resource).permit(ez_resource_config.form_fields.map(&:name))
+      end
+
+      def ez_resource_config
+        Config.new(
+          controller: self,
+          dsl_config: self.class.ez_resource_config_store,
+          data:       @ez_resource
+        )
+      end
+    end
+  end
+end

data/lib/ez/resources/manager/action.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Ez
+  module Resources
+    module Manager
+      class Action
+        attr_reader :name, :builder, :options
+
+        def initialize(name, builder, options = {})
+          @name = name
+          @builder = builder
+          @options = options
+        end
+      end
+    end
+  end
+end

data/lib/ez/resources/manager/config.rb

@@ -0,0 +1,150 @@
+# frozen_string_literal: true
+
+module Ez
+  module Resources
+    module Manager
+      class Config
+        include Pagy::Backend
+
+        DEFAULT_ACTIONS = %i[index show new create edit update destroy].freeze
+
+        attr_reader :paginator, :search, :controller
+
+        def initialize(controller:, dsl_config:, data: nil)
+          @controller = controller
+          @dsl_config = dsl_config
+          @data       = data
+        end
+
+        def data
+          @data ||= case controller.action_name
+                    when 'index'  then collection
+                    when 'new'    then new_resource
+                    when 'show'   then resource
+                    when 'edit'   then resource
+                    when 'update' then resource
+                    else
+                      raise ConfigurationError, "Invalid action #{controller.action_name}"
+          end
+        end
+
+        def total_count
+          @total_count ||= model.count
+        end
+
+        def model
+          @model ||= dsl_config.model || controller_name.classify.constantize
+        rescue NameError
+          raise GuessingError, "Ez::Resources tried to guess model name as #{controller_name.classify} but constant is missing. You can define model class explicitly with :model options"
+        end
+
+        def actions
+          @actions ||= dsl_config.actions || DEFAULT_ACTIONS
+        end
+
+        def show_action_renders_form?
+          @show_action_renders_form ||= dsl_config.show_action_renders_form
+        end
+
+        def hooks
+          @hooks ||= dsl_config.hooks || []
+        end
+
+        def resource_label
+          @resource_label ||= dsl_config.resource_label || :id
+        end
+
+        def resource_name
+          @resource_name ||= controller_name.classify
+        end
+
+        def resources_name
+          @resources_name ||= dsl_config.resources_name || resource_name.pluralize
+        end
+
+        def paginate_collection?
+          @paginate_collection ||= dsl_config.paginate_collection != false
+        end
+
+        def collection_search?
+          @collection_search ||= dsl_config.collection_search != false
+        end
+
+        def collection_views
+          @collection_views ||= dsl_config.collection_views || []
+        end
+
+        def collection_columns
+          @collection_columns ||= dsl_config.collection_columns || model.columns.map do |column|
+            Ez::Resources::Manager::Field.new(
+              name:  column.name,
+              title: column.name.to_s.humanize,
+              type:  column.sql_type_metadata.type
+            )
+          end.reject { |col| Ez::Resources.config.ignore_fields.include?(col.name) }
+        end
+
+        def collection_actions
+          @colleciton_actions ||= dsl_config.collection_actions || []
+        end
+
+        def form_fields
+          @form_fields ||= dsl_config.form_fields || collection_columns || []
+        end
+
+        def path_for(action:, id: nil, params: nil)
+          if id
+            controller.url_for(action: action, id: id, only_path: true)
+          elsif params
+            controller.url_for(action: action, **params, only_path: true)
+          else
+            controller.url_for(action: action, only_path: true)
+          end
+        end
+
+        def params
+          @params ||= controller.params
+        end
+
+        private
+
+        attr_reader :dsl_config
+
+        def collection
+          return paginated_collection if paginate_collection?
+
+          @collection ||= if dsl_config.collection_query
+                            dsl_config.collection_query.call(model, controller)
+                          else
+                            model.all
+                          end
+        end
+
+        def paginated_collection
+          @search = model.ransack(params[:q])
+
+          @paginated_collection ||= if dsl_config.collection_query
+                                      pagy, paginated_collection = pagy dsl_config.collection_query.call(search.result, controller)
+                                    else
+                                      pagy, paginated_collection = pagy search.result.includes(dsl_config.includes)
+                                    end
+
+          @paginator = pagy
+          paginated_collection
+        end
+
+        def new_resource
+          @new_resource ||= model.new
+        end
+
+        def resource
+          @resource ||= model.find(controller.params[:id])
+        end
+
+        def controller_name
+          @controller_name ||= controller.controller_name
+        end
+      end
+    end
+  end
+end

data/lib/ez/resources/manager/config_store.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+require 'ez/resources/manager/fields'
+require 'ez/resources/manager/hooks'
+
+module Ez
+  module Resources
+    module Manager
+      class ConfigStore
+        attr_accessor :actions, :model, :paginate_collection, :resource_name, :resource_label, :resources_name,
+                      :collection_columns, :collection_query, :collection_search, :show_action_renders_form, :includes,
+                      :collection_views
+
+        def collection_columns(&block)
+          if block_given?
+            @collection_columns = Fields.new(&block).fields
+          else
+            @collection_columns
+          end
+        end
+
+        def collection_actions(&block)
+          if block_given?
+            @collection_actions = Fields.new(&block).actions
+          else
+            @collection_actions
+          end
+        end
+
+        def form_fields(&block)
+          if block_given?
+            @form_fields = Fields.new(&block).fields
+          else
+            @form_fields
+          end
+        end
+
+        def hooks(&block)
+          if block_given?
+            @hooks = Hooks.new(&block).hooks
+          else
+            @hooks
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ez/resources/manager/dsl.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require 'ez/resources/manager/config_store'
+
+module Ez
+  module Resources
+    module Manager
+      module DSL
+        def ez_resource_config_store
+          @ez_resource_config_store || Ez::Resources::Manager::ConfigStore.new
+        end
+
+        def ez_resource(&block)
+          config = Ez::Resources::Manager::ConfigStore.new
+          block.call(config)
+
+          @ez_resource_config_store = config
+        end
+      end
+    end
+  end
+end