magic-presenter 1.3.0 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0336dc17e983771f6f96385c14429c66e961614ee20f1c99202ab92e970e8663
-  data.tar.gz: c923d4f65d8772b8fa52dd62c5d26a0d7b5e96f9d1b3ac12af28296dfb80547b
+  metadata.gz: 018f8d173f204bef93fdaf99a35417b1018a81517231f673a0dd44a1644ee61b
+  data.tar.gz: e0ca0e5a3b439b40e20d429f7f7ba35c48390f51debb30510445d4e1d682b948
 SHA512:
-  metadata.gz: 94be4b679d87564d79169e919f2e5abb400971b82c0ad78d5456aedbde969e1b4574b27569dee9011861fb899637e3f5394cebfe84488a68063254b70eb7a5a7
-  data.tar.gz: 32b20c180e447a2164013d595256c12b8019a5143595d547373c82b157757bea3cf5867248d7068d1d36786e79cd0b6873d6cd814f8f760b53a990c25ed3a924
+  metadata.gz: 3c2913873efd49741bf0991eb34cfd30e32ceede34a84eef752b86c951625cd173db3b4069473f16a0ecfc6e1ea8d26c9a75a8d8525a4e35c5d8e81e38346841
+  data.tar.gz: e28356ed613cc0f68f46618ba989956fd3dd467d91ec0bf81f1d9aced9f6504208a7dedff8ebd05bdfcb2bf7214d5dadc97ba961738928ee2fe09578a7b66eb5

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/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.0'
 	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.0
 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.0/CHANGELOG.md"
 rdoc_options: []
 require_paths:
   - lib