magic-presenter 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 17e4d44c0c2d9a9e09e7e099a4067b9e6aafe27e1b389cf01808ed0a77d0b9ae
-  data.tar.gz: 7d492486c2f4edb2407af461794e1f0c7e53c7f6b93e65595a618369fb845250
+  metadata.gz: 8ca84b456b21332f6eeba63a5667ed1c8cf7ac97d59141192f138d1698c504bf
+  data.tar.gz: c380ea14f2ddd44150ae71095063e895486d33077521fe1067fca81d4c4b36b0
 SHA512:
-  metadata.gz: fb2609c3dbba1cec025bca22aaa196c718b32084b2954b8184f9b5ce896e7a9289c0b7eb0660469edaf3571d27d99026f6e588f58004e395cee07a75820e38d7
-  data.tar.gz: 1a87908713cb7dbcb029687dd1d4b9006432e8ba9703ef1dbe813088060c471ada70f8d7d1f5de4cdc9210ba602bd0457b1bf061f6fd3d9a25c5a420003198e0
+  metadata.gz: 728dbf1b11115069bb58bfb47c81258f358d22c3570c35dc4a5e7e4d9429a2fa5a6dc3237d0ef0e6a0442d88ca7e9b405e481bd5ea2da90c618800593c8f5155
+  data.tar.gz: f014751ea9cf0470fd1387f25f63b56291a63a434abd177ca0e1aaab27ba1d9a4da4e590354b729fcd12a40fa19f125866daedfba4bd904f37e8d48b3c281ea6

data/README.md

@@ -68,6 +68,35 @@ See the help for more info:
 
 	$ bin/rails generate presenter --help
 
+### View helpers
+
+A presenter can use any helpers via `#helpers` (aliased as `#h`) both in class and instance methods:
+
+```ruby
+class PersonPresenter < Magic::Presenter::Base
+  def self.links
+    [ h.link_to('All', model_class) ]
+  end
+  
+  def link(...) 
+    helpers.link_to(name, self, ...)
+  end
+end
+```
+
+A view context must be set to enable helpers.
+It’s done automagically [wherever possible](#helpers).
+However, one can set it explicitly anywhere:
+
+```ruby
+Magic::Presenter.with view_context: ApplicationController.new.view_context do
+  # put the code that uses helpers within presenters here
+end
+```
+
+> [!NOTE]
+> A valid `request` may be needed for URL helpers to get host info.
+
 ## 🧙 Magic
 
 It’s based on [Magic Decorator](
@@ -109,6 +138,13 @@ Magic::Presenter.name_for Person # => "PersonPresenter"
 > Every object passed to views is decorated automagically.
 > This involves both implicit instance variables and `locals` passed explicitly.
 
+### Helpers
+
+View context is set automagically to enable helpers:
+- in views,
+- in controller actions,
+- in mailer actions.
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/config/initializers/action_controller.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+presenter_context = proc do
+	around_action :set_presenter_context
+
+	private
+
+	def set_presenter_context(&)
+		Magic::Presenter.with view_context:, &
+	end
+end
+
+ActiveSupport.on_load :action_controller, &presenter_context
+ActiveSupport.on_load :action_mailer,     &presenter_context

data/config/initializers/action_view.rb

@@ -1,19 +1,41 @@
 # frozen_string_literal: true
 
-ActiveSupport.on_load :action_view do
+ActiveSupport.on_load :action_view do # rubocop:disable Metrics/BlockLength
 	concerning :DecoratedAssignments, prepend: true do
 		def assign(assignments, ...)
-			assignments
-					.transform_values! &:decorated
+			decorate assignments
 
 			super
 		end
 
 		def _run(method, template, locals, ...)
-			locals
-					.transform_values! &:decorated
+			decorate locals
 
 			super
 		end
+
+		private
+
+		def decorate objects
+			objects
+					.transform_values!(&:decorated)
+		end
+	end
+
+	concerning :PresenterContext, prepend: true do
+		def in_rendering_context(...)
+			Magic::Presenter::Base.with view_context: self do
+				super
+			end
+		end
+
+		private
+
+		def decorate(...)
+			super
+					.each_value
+					.grep(Magic::Presenter::Base)
+					.each { _1.view_context = self }
+		end
 	end
 end

data/lib/magic/presenter/base.rb

@@ -18,6 +18,7 @@ module Magic
 		# up to `ObjectPresenter`.
 		class Base < Decorator::Base
 			include GlobalID if defined? ::GlobalID
+			prepend Helpers  if defined? ::ActionView
 
 			class << self
 				def name_for object_class

data/lib/magic/presenter/helpers.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module Magic
+	module Presenter
+		module Helpers # :nodoc:
+			extend ActiveSupport::Concern
+
+			# The Magic::Presenter::Helpers::MissingContext exception is
+			# raised when no view context to run helpers in has been set.
+			class MissingContext < RuntimeError
+				def message
+					<<~TEXT
+						missing view context
+						You should set Magic::Presenter.view_context first
+					TEXT
+				end
+			end
+
+			prepended do
+				class_attribute :view_context
+			end
+
+			class_methods do
+				include Helpers
+
+				alias __raise__ raise
+			end
+
+			private
+
+			def helpers
+				view_context or
+						__raise__ MissingContext
+			end
+
+			alias_method :h, :helpers
+
+			def method_missing(method, ...)
+				super
+			rescue NoMethodError
+				__raise__ unless view_context
+				__raise__ unless helpers.respond_to? method
+
+				helpers.send(method, ...)
+			end
+
+			def respond_to_missing?(method, ...)
+				super or
+						(helpers if view_context).respond_to?(method, ...)
+			end
+		end
+	end
+end

data/lib/magic/presenter/version.rb

@@ -2,6 +2,6 @@
 
 module Magic
 	module Presenter
-		VERSION = '0.3.0'
+		VERSION = '0.4.0'
 	end
 end

data/lib/magic/presenter.rb

@@ -9,13 +9,14 @@ module Magic # :nodoc:
 	# Presentation layer for Rails models
 	module Presenter
 		autoload :Base,      'magic/presenter/base'
+		autoload :Helpers,   'magic/presenter/helpers'
 		autoload :GlobalID,  'magic/presenter/global_id'
 		autoload :Generator, 'generators/magic/presenter/generator'
 
-		module_function
-
-		def for(...)      = Base.for(...)
-		def name_for(...) = Base.name_for(...)
+		singleton_class.delegate *%i[
+				for name_for
+				view_context view_context=
+		], to: Base
 	end
 
 	module_function

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: magic-presenter
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Alexander Senko
 bindir: bin
 cert_chain: []
-date: 2024-10-27 00:00:00.000000000 Z
+date: 2024-10-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -54,6 +54,7 @@ files:
 - README.md
 - Rakefile
 - app/models/concerns/magic/presentable.rb
+- config/initializers/action_controller.rb
 - config/initializers/action_view.rb
 - config/initializers/presentable.rb
 - config/initializers/rspec.rb
@@ -73,6 +74,7 @@ files:
 - lib/magic/presenter/base.rb
 - lib/magic/presenter/engine.rb
 - lib/magic/presenter/global_id.rb
+- lib/magic/presenter/helpers.rb
 - lib/magic/presenter/version.rb
 - lib/tasks/magic/presenter_tasks.rake
 homepage: https://github.com/Alexander-Senko/magic-presenter
@@ -81,7 +83,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/v0.3.0/CHANGELOG.md
+  changelog_uri: https://github.com/Alexander-Senko/magic-presenter/blob/v0.4.0/CHANGELOG.md
 rdoc_options: []
 require_paths:
 - lib