eac_rails_utils 0.21.0 → 0.22.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3aedeca11ee83d3ba78b7ed6e4018ec11ec5358279ee8aa60aeee9a704b67bc7
-  data.tar.gz: cf7618ee67289bbcfae473c46816562d43ed1054febf31982250b1f4c1db4184
+  metadata.gz: 2d70491a91afe401a5ff75d1ecf1d1820e9164bb725d33ecbf5a233508e70faa
+  data.tar.gz: 59c3693a4563491e0da78bf4496d620c75025b7b70fb4cda760405ac04c3f436
 SHA512:
-  metadata.gz: ba22996dcb260db19cfc7ea31adf12da8f530220c2426178a50b8fbd50094040aa8bb140d83d7f81b9a1ea987f6c278f0f29c8e3d9793f52e29688e0020801c6
-  data.tar.gz: 538843dd71b2511945bede0711f03390c0620482643b7dd0beb5bbf39fae8a79dc31c723c0a3f318379dca0734d8433b1db3462dbb5f381e6b84a49c5c4a7bfd
+  metadata.gz: ed28ed741a6dc380f97f1b3a1af9afaba32baebeee1c06ccf81790eab178ac8eadf022051a3dd5dffd98c01bf421fc749ce69d4db8b4a078c8d347795a286949
+  data.tar.gz: d5b26dc72e4a8d36e9b609b606a95264432c81e612a08fa705c40da2db94fe3e6ba23108121f170dcd1f395cea969133c6799ab15ccb6520e0f3a8a22e2ed025

data/lib/eac_rails_utils/engine_helper.rb

@@ -4,6 +4,13 @@ require 'eac_ruby_utils/core_ext'
 
 module EacRailsUtils
   module EngineHelper
+    class << self
+      # @return [EacRailsUtils::Menus::Group]
+      def root_menu
+        @root_menu ||= ::EacRailsUtils::Menus::Group.new(:root)
+      end
+    end
+
     common_concern do
       append_autoload_paths
       append_self_migrations
@@ -21,6 +28,11 @@ module EacRailsUtils
           end
         end
       end
+
+      # @return [EacRailsUtils::Menus::Group]
+      def root_menu
+        ::EacRailsUtils::EnginesHelper.root_menu
+      end
     end
   end
 end

data/lib/eac_rails_utils/menus/action.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require 'eac_rails_utils/menus/node'
+require 'eac_ruby_utils/core_ext'
+
+module EacRailsUtils
+  module Menus
+    class Action < ::EacRailsUtils::Menus::Node
+      common_constructor :path, :parent_group, super_args: -> { [parent_group] } do
+        self.path = [parent_group.path_first_node] + path if path.size < 2
+      end
+
+      # @return [Symbol]
+      def key
+        path.map(&:to_s).join('_').to_sym
+      end
+
+      # @param view [ActionView::Base]
+      # @return [Array]
+      def to_dropdown_menu_entries(view)
+        [view_path(view)]
+      end
+
+      # @param view [ActionView::Base]
+      # @return [String]
+      def view_path(view)
+        path.each_with_index.inject(view) do |a, e|
+          a.send(e[1] == path.count - 1 ? "#{e[0]}_path" : e[0])
+        end
+      end
+    end
+  end
+end

data/lib/eac_rails_utils/menus/group.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+require 'eac_rails_utils/menus/action'
+require 'eac_rails_utils/menus/node'
+require 'eac_ruby_utils/core_ext'
+
+module EacRailsUtils
+  module Menus
+    class Group < ::EacRailsUtils::Menus::Node
+      class << self
+        # @param key [Object]
+        # @return [Symbol]
+        def sanitize_key(key)
+          key.to_sym
+        end
+      end
+
+      DEFAULT_PATH_FIRST_NODE = :main_app
+      SELF_LABEL_TRANSLATE_KEY_PART = '__self'
+
+      common_constructor :key, :parent_group, :path_first_node, default: [nil],
+                                                                super_args: -> { [parent_group] } do
+        self.key = self.class.sanitize_key(key)
+        self.path_first_node ||= DEFAULT_PATH_FIRST_NODE
+      end
+
+      # @param path [Array<Symbol>]
+      # @return [EacRailsUtils::Menus::Action]
+      def action(*path)
+        child_action = ::EacRailsUtils::Menus::Action.new(path, self)
+        actions[child_action.key] ||= child_action
+      end
+
+      # @return [Array<EacRailsUtils::Menus::Node>]
+      def children
+        (groups.values + actions.values).sort
+      end
+
+      # @return [EacRailsUtils::Menus::Group]
+      def group(group_key, path_first_node = nil)
+        child_group = self.class.new(group_key, self, path_first_node)
+        groups[child_group.key] ||= child_group
+      end
+
+      # @return [String]
+      def label_translate_key
+        [super, SELF_LABEL_TRANSLATE_KEY_PART].join(TRANSLATE_KEY_SEPARATOR)
+      end
+
+      # @param view [ActionView::Base]
+      # @return [Hash]
+      def to_dropdown_menu_entries(view)
+        children.inject({}) do |a, e|
+          a.merge(e.label => e.to_dropdown_menu_entries(view))
+        end
+      end
+
+      def within
+        yield(self)
+      end
+
+      private
+
+      def actions
+        @actions ||= {}
+      end
+
+      def groups
+        @groups ||= {}
+      end
+    end
+  end
+end

data/lib/eac_rails_utils/menus/node.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module EacRailsUtils
+  module Menus
+    class Node
+      LABEL_TRANSLATE_KEY_PREFIX = 'eac_rails_utils.menus'
+      TRANSLATE_KEY_SEPARATOR = '.'
+
+      acts_as_abstract :key
+      common_constructor :parent_group
+      compare_by :label
+      attr_reader :custom_label
+
+      # @return [String]
+      def auto_label
+        ::I18n.t(label_translate_key)
+      end
+
+      # @param custom_label [String, nil]
+      # @return [String, self]
+      def label(custom_label = nil)
+        if custom_label.present?
+          self.custom_label = custom_label
+          self
+        else
+          (self.custom_label || auto_label).call_if_proc
+        end
+      end
+
+      # @return [String]
+      def label_translate_key
+        parent_label_translate_key
+      end
+
+      # @return [String]
+      def parent_label_translate_key
+        [
+          parent_group.if_present(LABEL_TRANSLATE_KEY_PREFIX, &:parent_label_translate_key),
+          key
+        ].join(TRANSLATE_KEY_SEPARATOR)
+      end
+
+      private
+
+      attr_writer :custom_label
+    end
+  end
+end

data/lib/eac_rails_utils/menus.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module EacRailsUtils
+  module Menus
+    require_sub __FILE__
+  end
+end

data/lib/eac_rails_utils/patches/active_model/naming.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require 'active_model/naming'
+
+module ActiveModel
+  module Naming
+    # @return [String]
+    def plural_name
+      model_name.human(count: 2)
+    end
+
+    # @return [String]
+    def singular_name
+      model_name.human(count: 1)
+    end
+  end
+end

data/lib/eac_rails_utils/patches/active_model.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/require_sub'
+::EacRubyUtils.require_sub __FILE__

data/lib/eac_rails_utils/patches/application.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require 'eac_rails_utils/menus/group'
+
+module Rails
+  class Application
+    # @return [EacRailsUtils::Menus::Group]
+    def root_menu
+      @root_menu ||= ::EacRailsUtils::Menus::Group.new(:root, nil)
+    end
+  end
+end

data/lib/eac_rails_utils/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module EacRailsUtils
-  VERSION = '0.21.0'
+  VERSION = '0.22.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: eac_rails_utils
 version: !ruby/object:Gem::Version
-  version: 0.21.0
+  version: 0.22.0
 platform: ruby
 authors:
 - E.A.C.
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-07-05 00:00:00.000000000 Z
+date: 2023-09-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bootstrap-sass
@@ -36,20 +36,20 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.118'
+        version: '0.119'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.118.1
+        version: 0.119.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.118'
+        version: '0.119'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.118.1
+        version: 0.119.2
 - !ruby/object:Gem::Dependency
   name: htmlbeautifier
   requirement: !ruby/object:Gem::Requirement
@@ -205,6 +205,10 @@ files:
 - lib/eac_rails_utils/engine.rb
 - lib/eac_rails_utils/engine_helper.rb
 - lib/eac_rails_utils/htmlbeautifier.rb
+- lib/eac_rails_utils/menus.rb
+- lib/eac_rails_utils/menus/action.rb
+- lib/eac_rails_utils/menus/group.rb
+- lib/eac_rails_utils/menus/node.rb
 - lib/eac_rails_utils/models.rb
 - lib/eac_rails_utils/models/fetch_errors.rb
 - lib/eac_rails_utils/models/inequality_queries.rb
@@ -225,7 +229,10 @@ files:
 - lib/eac_rails_utils/models/test_utils.rb
 - lib/eac_rails_utils/models/validations.rb
 - lib/eac_rails_utils/patches.rb
+- lib/eac_rails_utils/patches/active_model.rb
+- lib/eac_rails_utils/patches/active_model/naming.rb
 - lib/eac_rails_utils/patches/active_model_associations.rb
+- lib/eac_rails_utils/patches/application.rb
 - lib/eac_rails_utils/patches/numeric.rb
 - lib/eac_rails_utils/patches/numeric/number_helper.rb
 - lib/eac_rails_utils/patches/rails_4.rb