avo 2.46.0 → 3.0.0.pre1

data/lib/avo/resources/controls/create_button.rb

@@ -0,0 +1,15 @@
+module Avo
+  module Resources
+    module Controls
+      class CreateButton < BaseControl
+        def initialize(**args)
+          super(**args)
+
+          if args[:item].present?
+            @label = I18n.t("avo.create_new_item", item: args[:item]) if label.nil?
+          end
+        end
+      end
+    end
+  end
+end

data/lib/avo/resources/controls/delete_button.rb

@@ -5,7 +5,11 @@ module Avo
         def initialize(**args)
           super(**args)
 
-          @label = I18n.t("avo.delete").capitalize
+          @label = args[:label] || I18n.t("avo.delete").capitalize
+          if args[:item].present?
+            @title = I18n.t("avo.delete_item", item: args[:item]).capitalize if title.nil?
+            @confirmation_message = I18n.t("avo.are_you_sure") if confirmation_message.nil?
+          end
         end
       end
     end

data/lib/avo/resources/controls/detach_button.rb

@@ -5,7 +5,10 @@ module Avo
         def initialize(**args)
           super(**args)
 
-          @label = I18n.t("avo.detach_item", item: title).humanize
+          if args[:item].present?
+            @title = I18n.t("avo.detach_item", item: args[:item]).capitalize if title.nil?
+            @confirmation_message = I18n.t("avo.are_you_sure_detach_item", item: args[:item]) if confirmation_message.nil?
+          end
         end
       end
     end

data/lib/avo/resources/controls/edit_button.rb

@@ -5,7 +5,10 @@ module Avo
         def initialize(**args)
           super(**args)
 
-          @label = I18n.t("avo.edit").capitalize
+          @label = args[:label] || I18n.t("avo.edit").capitalize
+          if args[:item].present?
+            @title = I18n.t("avo.edit_item", item: args[:item]).capitalize if title.nil?
+          end
         end
       end
     end

data/lib/avo/resources/controls/order_controls.rb

@@ -0,0 +1,8 @@
+module Avo
+  module Resources
+    module Controls
+      class OrderControls < BaseControl
+      end
+    end
+  end
+end

data/lib/avo/resources/controls/save_button.rb

@@ -0,0 +1,13 @@
+module Avo
+  module Resources
+    module Controls
+      class SaveButton < BaseControl
+        def initialize(**args)
+          super(**args)
+
+          @label = args[:label] || I18n.t("avo.save").capitalize
+        end
+      end
+    end
+  end
+end

data/lib/avo/resources/controls/show_button.rb

@@ -0,0 +1,15 @@
+module Avo
+  module Resources
+    module Controls
+      class ShowButton < BaseControl
+        def initialize(**args)
+          super(**args)
+
+          if args[:item].present?
+            @title = I18n.t("avo.view_item", item: args[:item]).capitalize if title.nil?
+          end
+        end
+      end
+    end
+  end
+end

data/lib/avo/resources/items/holder.rb

@@ -0,0 +1,76 @@
+class Avo::Resources::Items::Holder
+  attr_reader :tools
+  attr_accessor :items
+  attr_accessor :invalid_fields
+
+  def initialize
+    @items = []
+    @items_index = 0
+    @invalid_fields = []
+  end
+
+  # Adds a field to the items_holder
+  def field(field_name, **args, &block)
+    field_parser = Avo::Dsl::FieldParser.new(id: field_name, order_index: @items_index, **args, &block).parse
+
+    if field_parser.invalid?
+      as = args.fetch(:as, nil)
+
+      # End execution ehre and add the field to the invalid_fileds payload so we know to wanr the developer about that.
+      # @todo: Make sure this warning is still active
+      return add_invalid_field({
+        name: field_name,
+        as: as,
+        # resource: resource_class.name,
+        message: "There's an invalid field configuration for this resource. <br/> <code class='px-1 py-px rounded bg-red-600'>field :#{field_name}, as: #{as}</code>"
+      })
+    end
+
+    add_item field_parser.instance
+  end
+
+  def tabs(instance)
+    add_item instance
+  end
+
+  def tab(name, **args, &block)
+    add_item Avo::Resources::Items::Tab::Builder.parse_block(name: name, **args, &block)
+  end
+
+  def tool(klass, **args)
+    instance = klass.new(**args)
+    add_item instance
+  end
+
+  def panel(panel_name = nil, **args, &block)
+    panel = Avo::Resources::Items::ItemGroup::Builder.parse_block(name: panel_name, **args, &block)
+
+    add_item panel
+  end
+
+  def heading(body = nil, **args, &block)
+    field = Avo::Fields::HeadingField.new(body, **args)
+
+    add_item field
+  end
+
+  def sidebar(instance)
+    add_item instance
+  end
+
+  def add_item(instance)
+    @items << instance
+
+    increment_order_index
+  end
+
+  private
+
+  def add_invalid_field(payload)
+    @invalid_fields << payload
+  end
+
+  def increment_order_index
+    @items_index += 1
+  end
+end

data/lib/avo/resources/items/item_group.rb

@@ -0,0 +1,48 @@
+class Avo::Resources::Items::ItemGroup
+  prepend Avo::Concerns::IsResourceItem
+
+  include Avo::Concerns::HasItems
+  include Avo::Concerns::HasItemType
+  include Avo::Concerns::IsVisible
+  include Avo::Concerns::VisibleInDifferentViews
+
+  attr_reader :name
+  attr_reader :description
+
+  delegate :items, :add_item, to: :items_holder
+
+  def initialize(name: nil, description: nil, view: nil, **args)
+    @name = name
+    @view = view
+    @description = description
+    @items_holder = Avo::Resources::Items::Holder.new
+    @args = args
+
+    post_initialize if respond_to?(:post_initialize)
+  end
+
+  class Builder
+    class << self
+      def parse_block(**args, &block)
+        Docile.dsl_eval(new(**args), &block).build
+      end
+    end
+
+    delegate :heading, to: :items_holder
+    delegate :field, to: :items_holder
+    delegate :items, to: :items_holder
+
+    attr_reader :items_holder
+
+    def initialize(name: nil, **args)
+      @panel = Avo::Resources::Items::Panel.new(name: name, **args)
+      @items_holder = Avo::Resources::Items::Holder.new
+    end
+
+    # Fetch the tab
+    def build
+      @panel.items_holder = @items_holder
+      @panel
+    end
+  end
+end

data/lib/avo/resources/items/main_panel.rb

@@ -0,0 +1,2 @@
+class Avo::Resources::Items::MainPanel < Avo::Resources::Items::Panel
+end

data/lib/avo/resources/items/panel.rb

@@ -0,0 +1,2 @@
+class Avo::Resources::Items::Panel < Avo::Resources::Items::ItemGroup
+end

data/lib/avo/resources/items/sidebar.rb

@@ -0,0 +1,47 @@
+class Avo::Resources::Items::Sidebar
+  prepend Avo::Concerns::IsResourceItem
+
+  include Avo::Concerns::HasItems
+  include Avo::Concerns::HasItemType
+  include Avo::Concerns::IsVisible
+  include Avo::Concerns::VisibleInDifferentViews
+
+  delegate :items, :add_item, to: :items_holder
+
+  attr_reader :name
+
+  def initialize(name: nil, view: nil, **args)
+    @name = name
+    @items_holder = Avo::Resources::Items::Holder.new
+    @view = view
+    @args = args
+
+    post_initialize if respond_to?(:post_initialize)
+  end
+
+  class Builder
+    class << self
+      def parse_block(**args, &block)
+        Docile.dsl_eval(new(**args), &block).build
+      end
+    end
+
+    attr_reader :items_holder
+
+    delegate :field, to: :items_holder
+    delegate :items, to: :items_holder
+    delegate :heading, to: :items_holder
+
+    def initialize(name: nil, **args)
+      @sidebar = Avo::Resources::Items::Sidebar.new(**args)
+      @items_holder = Avo::Resources::Items::Holder.new
+    end
+
+    # Fetch the sidebar
+    def build
+      @sidebar.items_holder = @items_holder
+      @sidebar
+    end
+  end
+
+end

data/lib/avo/resources/items/tab.rb

@@ -0,0 +1,60 @@
+class Avo::Resources::Items::Tab
+  prepend Avo::Concerns::IsResourceItem
+
+  include Avo::Concerns::HasItems
+  include Avo::Concerns::HasItemType
+  include Avo::Concerns::IsVisible
+  include Avo::Concerns::VisibleInDifferentViews
+
+  delegate :items, :add_item, to: :items_holder
+
+  attr_accessor :description
+
+  def initialize(name: nil, description: nil, view: nil, **args)
+    @name = name
+    @description = description
+    @items_holder = Avo::Resources::Items::Holder.new
+    @view = view
+    @args = args
+
+    post_initialize if respond_to?(:post_initialize)
+  end
+
+  def name
+    Avo::ExecutionContext.new(target: @name).handle
+  end
+
+  def turbo_frame_id(parent: nil)
+    id = "#{Avo::Resources::Items::Tab.to_s.parameterize} #{name}".parameterize
+
+    return id if parent.nil?
+
+    "#{parent.turbo_frame_id} #{id}".parameterize
+  end
+
+  class Builder
+    class << self
+      def parse_block(**args, &block)
+        Docile.dsl_eval(new(**args), &block).build
+      end
+    end
+
+    attr_reader :items_holder
+
+    delegate :field, to: :items_holder
+    delegate :tool, to: :items_holder
+    delegate :panel, to: :items_holder
+    delegate :items, to: :items_holder
+
+    def initialize(name: nil, **args)
+      @tab = Avo::Resources::Items::Tab.new(name: name, **args)
+      @items_holder = Avo::Resources::Items::Holder.new
+    end
+
+    # Fetch the tab
+    def build
+      @tab.items_holder = @items_holder
+      @tab
+    end
+  end
+end

data/lib/avo/resources/items/tab_group.rb

@@ -0,0 +1,68 @@
+class Avo::Resources::Items::TabGroup
+  prepend Avo::Concerns::IsResourceItem
+
+  include Avo::Concerns::HasItems
+  include Avo::Concerns::HasItemType
+  include Avo::Concerns::IsVisible
+  include Avo::Concerns::VisibleInDifferentViews
+
+  attr_accessor :index
+  attr_accessor :style
+
+  def initialize(index: 0, view: nil, style: nil, **args)
+    @index = index
+    @items_holder = Avo::Resources::Items::Holder.new
+    @view = view
+    @style = style
+    @args = args
+
+    post_initialize if respond_to?(:post_initialize)
+  end
+
+  def turbo_frame_id
+    "#{Avo::Resources::Items::TabGroup.to_s.parameterize} #{index}".parameterize
+  end
+
+  class Builder
+    class << self
+      def parse_block(**args, &block)
+        Docile.dsl_eval(new(**args), &block).build
+      end
+    end
+
+    attr_reader :items_holder
+
+    delegate :tab, to: :items_holder
+
+    def initialize(style: nil)
+      @group = Avo::Resources::Items::TabGroup.new(style: style)
+      @items_holder = Avo::Resources::Items::Holder.new
+    end
+
+    def field(field_name, **args, &block)
+      parsed = Avo::Dsl::FieldParser.new(id: field_name, order_index: @items_index, **args, &block).parse
+      field_instance = parsed.instance
+
+      name = field_instance.name
+      tab = Avo::Resources::Items::Tab.new name: name
+
+      if field_instance.has_own_panel?
+        tab.items_holder.add_item parsed.instance
+      else
+        # If the field is not in a panel, create one and add it
+        panel = Avo::Resources::Items::Panel.new name: name
+        panel.items_holder.add_item parsed.instance
+        # Add that panel to the items_holder
+        tab.items_holder.add_item panel
+      end
+
+      @items_holder.tabs tab
+    end
+
+    # Fetch the tab
+    def build
+      @group.items_holder = @items_holder
+      @group
+    end
+  end
+end

data/lib/avo/resources/resource_manager.rb

@@ -0,0 +1,181 @@
+module Avo
+  module Resources
+    class ResourceManager
+      attr_accessor :resources
+
+      alias_method :all, :resources
+
+      class << self
+        def build
+          instance = new
+          instance.init_resources
+          instance.check_bad_resources
+          instance
+        end
+
+        # Fetches the resources available to the application.
+        # We have two ways of doing that.
+        #
+        # 1. Through eager loading.
+        # We automatically eager load the resources directory and fetch the descendants from the scanned files.
+        # This is the simple way to get started.
+        #
+        # 2. Manually, declared by the user.
+        # We have this option to load the resources because when they are loaded automatically through eager loading,
+        # those Resource classes and their methods may trigger loading other classes. And that may disrupt Rails booting process.
+        # Ex: AdminResource may use self.model_class = User. That will trigger Ruby to load the User class and itself load
+        # other classes in a chain reaction.
+        # The scenario that comes up most often is when Rails boots, the routes are being computed which eager loads the resource files.
+        # At that boot time some migration might have not been run yet, but Rails tries to access them through model associations,
+        # and they are not available.
+        #
+        # To enable this feature add a `resources` array config in your Avo initializer.
+        # config.resources = [
+        #   "UserResource",
+        #   "FishResource",
+        # ]
+        def fetch_resources
+          resources = if Avo.configuration.resources.nil?
+            BaseResource.descendants
+          else
+            Avo.configuration.resources
+          end
+
+          resources.map do |resource|
+            if resource.is_a?(Class)
+              resource
+            else
+              resource.to_s.safe_constantize
+            end
+          end
+        end
+      end
+
+      def initialize
+        @resources = []
+      end
+
+      def init_resources
+        self.resources = self.class.fetch_resources
+          .reject do |resource|
+            # Remove the BaseResource. We only need the descendants
+            resource == Avo::BaseResource
+          end
+          .uniq do |klass|
+            # On invalid resource configuration the resource classes get duplicated in `ObjectSpace`
+            # We need to de-duplicate them
+            klass.name
+          end
+          .map do |resource|
+            resource.new if resource.is_a? Class
+          end
+      end
+
+      def check_bad_resources
+        resources.each do |resource|
+          has_model = resource.model_class.present?
+
+          unless has_model
+            possible_model = resource.class.to_s.gsub "Avo::Resources::", ""
+            possible_model = possible_model.gsub "Resource", ""
+
+            Avo::App.errors.add({
+              url: "https://docs.avohq.io/2.0/resources.html#custom-model-class",
+              target: "_blank",
+              message: "#{resource.class} does not have a valid model assigned. It failed to find the #{possible_model} model. \n\r Please create that model or assign one using self.model_class = YOUR_MODEL"
+            })
+          end
+        end
+      end
+
+      # Filters out the resources that are missing the model_class
+      def valid_resources
+        resources
+          .select do |resource|
+            resource.model_class.present?
+          end
+          .sort_by(&:to_s)
+      end
+
+      # Returns the Avo resource by camelized name
+      #
+      # get_resource_by_name('User') => Avo::Resources::User
+      def get_resource(resource)
+        resource = "Avo::Resources::#{resource}" unless resource.to_s.starts_with?("Avo::Resources::")
+
+        resources.find do |available_resource|
+          resource.to_s == available_resource.class.to_s
+        end
+      end
+
+      # Returns the Avo resource by singular snake_cased name
+      #
+      # get_resource_by_name('user') => Avo::Resources::User
+      def get_resource_by_name(name)
+        get_resource name.singularize.camelize
+      end
+
+      # Returns the Avo resource by singular snake_cased name
+      # From all the resources that use the same model_class, it will fetch the first one in alphabetical order
+      #
+      # get_resource_by_name('User') => Avo::Resources::User
+      # get_resource_by_name(User) => Avo::Resources::User
+
+      def get_resource_by_model_class(klass)
+        # Fetch the mappings imposed by the user.
+        # If they are present, use those ones.
+        mapping = get_mapping_for_model klass
+        return get_resource(mapping) if mapping.present?
+
+        valid_resources
+          .find do |resource|
+            resource.model_class.model_name.name == klass.to_s
+          end
+      end
+
+      # Returns the Avo resource by singular snake_cased name
+      #
+      # get_resource_by_controller_name('delayed_backend_active_record_jobs') => DelayedJobResource
+      # get_resource_by_controller_name('users') => Avo::Resources::User
+      def get_resource_by_controller_name(name)
+        valid_resources
+          .find do |resource|
+            resource.model_class.to_s.pluralize.underscore.tr("/", "_") == name.to_s
+          end
+      end
+
+      # Returns the Avo resource by some name
+      def guess_resource(name)
+        get_resource_by_name(name.to_s) || get_resource_by_model_class(name)
+      end
+
+      # Returns the Rails model class by singular snake_cased name
+      #
+      # get_model_class_by_name('user') => User
+      def get_model_class_by_name(name)
+        name.to_s.camelize.singularize
+      end
+
+      def get_available_resources(user = nil)
+        valid_resources
+          .select do |resource|
+            Services::AuthorizationService.authorize user, resource.model_class, Avo.configuration.authorization_methods.stringify_keys["index"], raise_exception: false
+          end
+          .sort_by { |r| r.name }
+      end
+
+      def resources_for_navigation(user = nil)
+        get_available_resources(user)
+          .select do |resource|
+            resource.visible_on_sidebar
+          end
+      end
+
+      private
+
+      def get_mapping_for_model(klass)
+        (Avo.configuration.model_resource_mapping || {}).stringify_keys.transform_values(&:to_s)[klass.to_s]
+      end
+    end
+  end
+end