magic-presenter 1.3.0 → 1.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0336dc17e983771f6f96385c14429c66e961614ee20f1c99202ab92e970e8663
-  data.tar.gz: c923d4f65d8772b8fa52dd62c5d26a0d7b5e96f9d1b3ac12af28296dfb80547b
+  metadata.gz: 8e957e0973cd481d761d640a21626bfa1f6c4b3c3acb6b3e4323efb164dc95aa
+  data.tar.gz: 36b30c143459e650a8afe314e430a6a2636d2552cd772f2c5123e79044abe043
 SHA512:
-  metadata.gz: 94be4b679d87564d79169e919f2e5abb400971b82c0ad78d5456aedbde969e1b4574b27569dee9011861fb899637e3f5394cebfe84488a68063254b70eb7a5a7
-  data.tar.gz: 32b20c180e447a2164013d595256c12b8019a5143595d547373c82b157757bea3cf5867248d7068d1d36786e79cd0b6873d6cd814f8f760b53a990c25ed3a924
+  metadata.gz: 2bde9ac73d98838e404aa3a121edebce54845b22bbff2af7bbea53e50f7614b3ae24b6efa64d70ceba365cda64200990dc8838217e3afd43e491b4ff271c48ef
+  data.tar.gz: 2be6beeb343bf45e09dfd32b7e02c6a9bff75ce9769ed32c61125d5194c62c1f7f7ba27b2e5e67a46b7c8eece44d9760f57ed95ef09ad77a58d53116a60df918

data/README.md

@@ -55,6 +55,8 @@ person = Person.new(first_name: 'John', last_name: 'Smith').decorate
 person.name # => "John Smith"
 ```
 
+Use [load hooks](#load-hooks) to extend the base presenter functionality.
+
 ### `Magic::Presentable`
 
 This module includes `Magic::Decoratable` and allows a descendant to be decorated by presenters only.
@@ -64,6 +66,8 @@ When no presenter is found,
 - `#decorate!` raises `Magic::Lookup::Error`,
 - `#decorated` returns the original object.
 
+Use [load hooks](#load-hooks) to extend the functionality.
+
 #### Collections
 
 Active Record relations are presentable as collections. Define a collection presenter inside the matching presenter to customize collection behavior:
@@ -121,6 +125,25 @@ end
 > [!NOTE]
 > A valid `request` may be needed for URL helpers to get host data.
 
+### Load hooks
+
+Load hooks are triggered when `Magic::Presenter::Base` or `Magic::Presentable` are loaded.
+They allow you to run custom initialization code for configuration or to extend the functionality.
+
+```ruby
+ActiveSupport.on_load :presenter do
+  # Put the code to be executed when Magic::Presenter is loaded here.
+  # It runs in the context of Magic::Presenter::Base class.
+end
+```
+
+```ruby
+ActiveSupport.on_load :presentable do
+  # Put the code to be executed when Magic::Presentable is loaded here.
+  # It runs in the context of Magic::Presentable module.
+end
+```
+
 ## 🧙 Magic
 
 > [!IMPORTANT]

data/app/models/concerns/magic/presentable.rb

@@ -14,4 +14,6 @@ module Magic
 
 		def decorator_base = Presenter::Base
 	end
+
+	ActiveSupport.run_load_hooks :presentable, Presentable
 end

data/config/initializers/action_view.rb

@@ -28,7 +28,8 @@ ActiveSupport.on_load :action_view do # rubocop:disable Metrics/BlockLength
 		def assign_controller controller
 			super
 
-			self.class.decorated_method controller._helper_methods
+			self.class.decorated_method controller._helper_methods if
+					controller
 		end
 	end
 

data/lib/magic/presenter/base.rb

@@ -60,5 +60,7 @@ module Magic
 				end
 			end
 		end
+
+		ActiveSupport.run_load_hooks :presenter, Base
 	end
 end

data/lib/magic/presenter/engine.rb

@@ -2,7 +2,7 @@
 
 module Magic
 	module Presenter
-		class Engine < ::Rails::Engine # :nodoc:
+		class Engine < ::Rails::Engine
 			isolate_namespace Magic::Presenter
 
 			config.generators do

data/lib/magic/presenter/version.rb

@@ -2,6 +2,6 @@
 
 module Magic
 	module Presenter
-		VERSION = '1.3.0'
+		VERSION = '1.4.1'
 	end
 end

data/lib/magic/presenter.rb

@@ -5,7 +5,7 @@ require 'magic/decorator'
 require_relative 'presenter/version'
 require_relative 'presenter/engine'
 
-module Magic # :nodoc:
+module Magic
 	# Presentation layer for Rails models
 	module Presenter
 		autoload :Base,       'magic/presenter/base'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: magic-presenter
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 1.4.1
 platform: ruby
 authors:
   - Alexander Senko
@@ -111,7 +111,7 @@ licenses:
 metadata:
   homepage_uri: "https://github.com/Alexander-Senko/magic-presenter"
   source_code_uri: "https://github.com/Alexander-Senko/magic-presenter"
-  changelog_uri: "https://github.com/Alexander-Senko/magic-presenter/blob/v1.3.0/CHANGELOG.md"
+  changelog_uri: "https://github.com/Alexander-Senko/magic-presenter/blob/v1.4.1/CHANGELOG.md"
 rdoc_options: []
 require_paths:
   - lib