magic-presenter 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c2d9f852b05ac3df9f02d0a6f43256155d36f0aa54c9b94887017c6695040000
-  data.tar.gz: 07f21527902b18f58d4ffc88655b3e37317a331fa8db2f37addaa421478a523b
+  metadata.gz: 04a88e0f222913a774946299ef036231cb1628baaa980111b5bb058cb77f69a4
+  data.tar.gz: 9a5d28343913ebae389a941153d49d6c3d04acb2e6e61891ada49404a2e1d49f
 SHA512:
-  metadata.gz: 3d230e25c5b5a5bfaef1e941df5388cdcc71315287fbf71177fa7ebe1ca13ff4fa16a2e6a07e358bbed35213053262e6900b390cdc9572f5e33ea5ae59161626
-  data.tar.gz: 36e3545b509b62c1c68f22d156adec1ef46ddf34ff0efeb9875aedf13bac1856a6387006211ad9c93a9dc118aa55f98a6a0db09133172d8b6453ed6f81e968e1
+  metadata.gz: 0a572d9c94e5b75cb65c23e029d524f19d48457d1ea57bf6185d4ed463757296c2917d77e7210ab67021347b111136e34c1cbcdb15ae47c6d67445623ff13508
+  data.tar.gz: 41c4b6afee8ffb1b89aedbba4f619d94ddc04d3c4201afa6ae7c34fec7d1fe52a746eb3fc29463d316fc446c4e1a7b9458395c473c18af02b388caae0f2dabaa

data/README.md

@@ -1,5 +1,8 @@
 # 🧙 Magic Presenter
 
+![GitHub Actions Workflow Status](
+	https://img.shields.io/github/actions/workflow/status/Alexander-Senko/magic-presenter/ci.yml
+)
 ![Code Climate maintainability](
 	https://img.shields.io/codeclimate/maintainability-percentage/Alexander-Senko/magic-presenter
 )
@@ -15,11 +18,15 @@ Based on [Magic Decorator](https://github.com/Alexander-Senko/magic-decorator),
 
 Install the gem and add to the application's Gemfile by executing:
 
-    $ bundle add magic-presenter
+	$ bundle add magic-presenter
 
 If bundler is not being used to manage dependencies, install the gem by executing:
 
-    $ gem install magic-presenter
+	$ gem install magic-presenter
+
+After all the gems are `bundle`d run the installer in the project directory to generate the necessary files:
+
+	$ bin/rails generate magic:presenter:install
 
 ## Usage
 
@@ -51,7 +58,17 @@ When no presenter is found,
 - `#decorate!` raises `Magic::Lookup::Error`,
 - `#decorated` returns the original object.
 
-## Magic
+### Generators
+
+A generator can be used to generate a presenter:
+
+	$ bin/rails generate presenter Person
+
+See the help for more info:
+
+	$ bin/rails generate presenter --help
+
+## 🧙 Magic
 
 It’s based on [Magic Decorator](
 	https://github.com/Alexander-Senko/magic-decorator#magic
@@ -59,7 +76,7 @@ It’s based on [Magic Decorator](
 
 ### Presentable scope
 
-`Magic::Presentable` is mixed into `ActiveModel::Model` by default.
+`Magic::Presentable` is mixed into `ActiveModel::API` by default.
 It means that any model, be it `ActiveRecord::Base`, `Mongoid::Document` or whatever else, is _magically presentable_.
 
 ### Presenter class inference
@@ -68,9 +85,24 @@ Presenters provide automatic class inference for any model based on its class na
 	https://github.com/Alexander-Senko/magic-lookup
 ).
 
-For example, `MyNamespace::MyModel.new.decorate` looks for `MyNamespace::MyModelPresenter` first.
+For example, `MyNamespace::MyModel.new.decorate` looks for `MyNamespace::MyPresenter` first.
 When missing, it further looks for decorators for its ancestor classes, up to `ObjectPresenter`.
 
+#### Mapping rules
+
+- `MyObject` → `MyObjectPresenter`
+- `MyModel`  → `MyPresenter`
+- `MyRecord` → `MyPresenter`
+
+> [!TIP]
+> That’s why `ApplicationPresenter` presents `ApplicationRecord`  alongside all its descendants automagically with no extra code.
+
+When in doubt, one can use `Magic::Presenter.name_for`:
+
+```ruby
+Magic::Presenter.name_for Person # => "PersonPresenter"
+```
+
 ## 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/loading.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+Rails.application.config.to_prepare do
+	[ Rails.root / 'app/presenters' ]
+			.select(&:exist?)
+			.each { Rails.autoloaders.main.eager_load_dir _1 }
+end unless Rails.application.config.eager_load

data/config/initializers/presentable.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
-ActiveSupport.on_load :active_model do
-	include Magic::Presentable
+Rails.application.config.to_prepare do
+	ActiveModel::API.include Magic::Presentable
 end

data/config/initializers/rspec.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+RSpec.configure do |config|
+	config.include concern(:PresenterExampleGroup) {
+		included { metadata[:type] = :presenter }
+	}, file_path: %r'spec/presenters', type: :presenter
+end if defined? RSpec

data/lib/generators/magic/presenter/generator.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Magic
+	module Presenter
+		module Generator # :nodoc:
+			require 'generators/presenter/presenter_generator'
+
+			private
+
+			def file_name name = super()
+				name
+						.camelize
+						.then { Magic::Presenter.name_for _1 }
+						.underscore
+			end
+
+			def file_path path = super(), root: target_root
+				root / 'presenters' / path
+			end
+
+			def presenter_path(*) = file_path(*, root: PresenterGenerator.target_root)
+		end
+	end
+end

data/lib/generators/magic/presenter/install/USAGE

@@ -0,0 +1,10 @@
+Description:
+    Generates application files used by Magic Presenter:
+        ApplicationPresenter:   a base class for other presenters to
+                                inherit from.
+
+Example:
+    bin/rails generate magic:presenter:install
+
+    This will create:
+        ApplicationPresenter:   app/presenters/application_presenter.rb

data/lib/generators/magic/presenter/install/install_generator.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Magic
+	module Presenter
+		class InstallGenerator < Rails::Generators::Base # :nodoc:
+			include Generator
+
+			source_root File.expand_path('templates', __dir__)
+
+			def create_files
+				template 'application_presenter.rb', "#{presenter_path namespaced_file_name 'ApplicationRecord'}.rb"
+			end
+
+			private
+
+			def namespaced_file_name(*)
+				File.join *(namespaced_path if namespaced?), file_name(*)
+			end
+		end
+	end
+end

data/lib/generators/magic/presenter/install/templates/application_presenter.rb.tt

@@ -0,0 +1,6 @@
+<% module_namespacing do -%>
+class ApplicationPresenter < Magic::Presenter::Base
+  # Define presentation-specific methods here.
+  # They are shared by all the descendant presenters.
+end
+<% end -%>

data/lib/generators/presenter/USAGE

@@ -0,0 +1,28 @@
+Description:
+    Generates a new presenter for a model. Pass the model name, either
+    CamelCased or under_scored, as an argument.
+
+    This generator invokes your configured test framework, which
+    defaults to TestUnit. It supports both TestUnit and RSpec.
+
+    If a `--parent` option is given, it’s used as a superclass of the
+    created presenter.
+
+Example:
+    bin/rails generate presenter account
+
+    This will create:
+        Presenter:  app/presenters/account_presenter.rb
+      for TestUnit:
+        Test:       test/presenters/account_presenter_test.rb
+      for RSpec:
+        Spec:       spec/presenters/account_presenter_spec.rb
+
+    bin/rails generate presenter admin/account
+
+    This will create:
+        Presenter:  app/presenters/admin/account_presenter.rb
+      for TestUnit:
+        Test:       test/presenters/admin/account_presenter_test.rb
+      for RSpec:
+        Spec:       spec/presenters/admin/account_presenter_spec.rb

data/lib/generators/presenter/presenter_generator.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+class PresenterGenerator < Rails::Generators::NamedBase # :nodoc:
+	include Magic::Presenter::Generator
+
+	source_root File.expand_path('templates', __dir__)
+
+	check_class_collision suffix: 'Presenter'
+
+	class_option :parent,
+			type:    :string,
+			default: 'ApplicationPresenter',
+			desc:    'The parent class for the generated presenter'
+
+	cattr_reader :target_root, default: Pathname('app')
+
+	def create_presenter_file
+		template 'presenter.rb', "#{file_path}.rb"
+	end
+
+	hook_for :test_framework
+
+	private
+
+	def parent_class_name = options[:parent].classify
+end

data/lib/generators/presenter/templates/presenter.rb.tt

@@ -0,0 +1,5 @@
+<% module_namespacing do -%>
+class <%= class_name %> < <%= parent_class_name %>
+  # Define presentation-specific methods here.
+end
+<% end -%>

data/lib/generators/rspec/presenter/presenter_generator.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require 'generators/rspec'
+require 'generators/magic/presenter/generator'
+
+module Rspec # :nodoc:
+	module Generators # :nodoc:
+		class PresenterGenerator < Base # :nodoc:
+			include Magic::Presenter::Generator
+
+			source_root File.expand_path('templates', __dir__)
+
+			cattr_reader :target_root, default: Pathname('spec')
+
+			def create_test_file
+				template 'presenter_spec.rb', "#{file_path}_spec.rb"
+			end
+		end
+	end
+end

data/lib/generators/rspec/presenter/templates/presenter_spec.rb.tt

@@ -0,0 +1,7 @@
+require 'rails_helper'
+
+<% module_namespacing do -%>
+RSpec.describe <%= class_name %> do
+  pending "add some examples to (or delete) #{__FILE__}"
+end
+<% end -%>

data/lib/generators/test_unit/presenter/presenter_generator.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require 'rails/generators/test_unit'
+require 'generators/magic/presenter/generator'
+
+module TestUnit # :nodoc:
+	module Generators # :nodoc:
+		class PresenterGenerator < Base # :nodoc:
+			include Magic::Presenter::Generator
+
+			source_root File.expand_path('templates', __dir__)
+
+			check_class_collision suffix: 'PresenterTest'
+
+			cattr_reader :target_root, default: Pathname('test')
+
+			def create_test_file
+				template 'presenter_test.rb', "#{file_path}_test.rb"
+			end
+		end
+	end
+end

data/lib/generators/test_unit/presenter/templates/presenter_test.rb.tt

@@ -0,0 +1,9 @@
+require "test_helper"
+
+<% module_namespacing do -%>
+class <%= class_name %>Test < ActiveSupport::TestCase
+  # test "the truth" do
+  #   assert true
+  # end
+end
+<% end -%>

data/lib/magic/presentable.rb

@@ -9,6 +9,6 @@ module Magic
 
 		private
 
-		def decorator = Presenter.for self.class
+		def decorator_base = Presenter
 	end
 end

data/lib/magic/presenter/base.rb

@@ -13,12 +13,18 @@ module Magic
 		#
 		# Presenters provide automatic class inference for any model based
 		# on its class name powered by Magic Lookup.
-		# For example, `MyModel.new` looks for `MyModelPresenter` first.
+		# For example, `MyModel.new` looks for `MyPresenter` first.
 		# If not found, it looks for presenters of its ancestor classes,
 		# up to `ObjectPresenter`.
 		class Base < Decorator::Base
 			class << self
-				def name_for(object_class) = "#{object_class}Presenter"
+				def name_for object_class
+					object_class
+							.to_s
+							.delete_suffix('Model')
+							.delete_suffix('Record')
+							.then { "#{_1}Presenter" }
+				end
 			end
 		end
 	end

data/lib/magic/presenter/engine.rb

@@ -4,6 +4,10 @@ module Magic
 	module Presenter
 		class Engine < ::Rails::Engine # :nodoc:
 			isolate_namespace Magic::Presenter
+
+			config.generators do
+				_1.test_framework = :rspec
+			end
 		end
 	end
 end

data/lib/magic/presenter/version.rb

@@ -2,6 +2,6 @@
 
 module Magic
 	module Presenter
-		VERSION = '0.1.0'
+		VERSION = '0.2.0'
 	end
 end

data/lib/magic/presenter.rb

@@ -5,12 +5,13 @@ require 'magic/decorator'
 require_relative 'presenter/version'
 require_relative 'presenter/engine'
 
-module Magic
+module Magic # :nodoc:
 	autoload :Presentable, 'magic/presentable'
 
 	# Presentation layer for Rails models
 	module Presenter
-		autoload :Base, 'magic/presenter/base'
+		autoload :Base,      'magic/presenter/base'
+		autoload :Generator, 'generators/magic/presenter/generator'
 
 		module_function
 

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: magic-presenter
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Alexander Senko
 bindir: bin
 cert_chain: []
-date: 2024-10-19 00:00:00.000000000 Z
+date: 2024-10-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -35,14 +35,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.3.0.alpha
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.3.0.alpha
 description: Based on Magic Decorator, it’s meant to replace Draper.
 email:
 - Alexander.Senko@gmail.com
@@ -53,7 +53,20 @@ files:
 - MIT-LICENSE
 - README.md
 - Rakefile
+- config/initializers/loading.rb
 - config/initializers/presentable.rb
+- config/initializers/rspec.rb
+- lib/generators/magic/presenter/generator.rb
+- lib/generators/magic/presenter/install/USAGE
+- lib/generators/magic/presenter/install/install_generator.rb
+- lib/generators/magic/presenter/install/templates/application_presenter.rb.tt
+- lib/generators/presenter/USAGE
+- lib/generators/presenter/presenter_generator.rb
+- lib/generators/presenter/templates/presenter.rb.tt
+- lib/generators/rspec/presenter/presenter_generator.rb
+- lib/generators/rspec/presenter/templates/presenter_spec.rb.tt
+- lib/generators/test_unit/presenter/presenter_generator.rb
+- lib/generators/test_unit/presenter/templates/presenter_test.rb.tt
 - lib/magic/presentable.rb
 - lib/magic/presenter.rb
 - lib/magic/presenter/authors.rb
@@ -67,7 +80,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.1.0/CHANGELOG.md
+  changelog_uri: https://github.com/Alexander-Senko/magic-presenter/blob/v0.2.0/CHANGELOG.md
 rdoc_options: []
 require_paths:
 - lib