phlex-rails 0.5.1 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 407ff3d219b8d6ec6bbe429422b18125dde3f9cfb73ec756bad2ab4f08953083
-  data.tar.gz: b0e4f337a9626bf67a5e4dfd4172648cf69c264008fde9a5e3c1b456b98d7e72
+  metadata.gz: 5ea6f194e6a1f7b09577d125fb155dca62b50f8d807ca31c259666fa31f623e6
+  data.tar.gz: 8f05825ecc0a21249c5824b953f6facf1c421b804163519d1d97d1fdd22eebfe
 SHA512:
-  metadata.gz: b4e29f9f569bc0259d037d7b8a6e3ee8fb267d8210b2faf1e0a952d25275419e27c9621b615aad8be7d3f5531872848a63e46fdeb1a3ec8506e9babc5b27b1af
-  data.tar.gz: 4440057f8e253c7f0f78dbd41e4f92c6a8e4faeeac4cb339fbc26d09bc7bafa72302d2f2bc066b8879579b4dc3c053ba07f301622a8801d9a635a216f0ef2ac3
+  metadata.gz: 4b37858b1aff182875a4f11b616e5a1ba6fbb72323f77810ee815ee22858893a56fe5aa5dd318fbf60c2988239f9857d50190c6ccf8ca0fd4108eeb32894a7fd
+  data.tar.gz: e908c96cbeb82e5396118d14b644fba152a2e08645d32fe505e5058e3776d8cd3f4294d6a34a72ae3fa1bd7c8402aa1f686d22ee9600f959cca0c1652e78e5d5

data/.rubocop.yml

@@ -16,6 +16,8 @@ Layout/CaseIndentation:
 Style/StringConcatenation:
   Enabled: false
 
+Layout/MultilineMethodCallBraceLayout:
+  Enabled: false
 
 
 Security/Eval:

data/.ruby-version

@@ -0,0 +1 @@
+3.2.1

data/Gemfile

@@ -5,7 +5,8 @@ git_source(:github) { |repo| "https://github.com/#{repo}.git" }
 
 gemspec
 
-gem "phlex", github: "joeldrapper/phlex", branch: "main"
+gem "phlex", github: "joeldrapper/phlex"
+gem "phlex-testing-capybara", github: "joeldrapper/phlex-testing-capybara"
 gem "rspec-rails"
 gem "combustion"
 gem "rubocop"

data/lib/phlex/rails/buffered.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+require "forwardable"
+
+module Phlex::Rails
+	# A decorator that buffers all missing method calls and captures the blocks passed to them.
+	class Buffered < BasicObject
+		extend ::Forwardable
+
+		# @api private
+		def self.define_builder_yielding_method(method_name, builder)
+			class_eval(<<-RUBY, __FILE__, __LINE__ + 1)
+				# frozen_string_literal: true
+
+				def #{method_name}(*args, **kwargs, &block)
+					output = if block
+						@object.#{method_name}(*args, **kwargs) { |builder|
+							@view.capture do
+								yield(
+									::#{builder.name}.new(builder,
+										view: @view
+									)
+								)
+							end
+						}
+					else
+						@object.#{method_name}(*args, **kwargs)
+					end
+
+					case output
+					when ::ActiveSupport::SafeBuffer
+						@view.instance_variable_get(:@_target) << output
+					end
+
+					nil
+				end
+			RUBY
+		end
+
+		# @api private
+		def initialize(object, view:)
+			@object = object
+			@view = view
+		end
+
+		def respond_to_missing?(...)
+			@object.respond_to?(...)
+		end
+
+		def method_missing(*args, **kwargs, &block)
+			output = if block
+				@object.public_send(*args, **kwargs) { @view.capture(&block) }
+			else
+				@object.public_send(*args, **kwargs)
+			end
+
+			case output
+			when ::ActiveSupport::SafeBuffer
+				@view.instance_variable_get(:@_target) << output
+			end
+
+			nil
+		end
+	end
+end

data/lib/phlex/rails/buffered_checkbox_builder.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Phlex::Rails
+	class BufferedCheckboxBuilder < Buffered
+		# @!method object(...)
+		# @!method text(...)
+		# @!method value(...)
+		def_delegators :@object,
+			:object,
+			:text,
+			:value
+	end
+end

data/lib/phlex/rails/buffered_form_builder.rb

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+module Phlex::Rails
+	class BufferedFormBuilder < Buffered
+		# @!method field_id(...)
+		# @!method field_name(...)
+		# @!method id(...)
+		# @!method multipart=(value)
+		# @!method to_model(...)
+		# @!method to_partial_path(...)
+		def_delegators :@object,
+			:to_model,
+			:to_partial_path,
+			:options,
+			:id,
+			:field_helpers,
+			:multipart=,
+			:field_name,
+			:index,
+			:multipart,
+			:multipart?,
+			:emitted_hidden_id?,
+			:field_id,
+			:options=,
+			:object=,
+			:object_name,
+			:field_helpers=,
+			:field_helpers?,
+			:object_name=,
+			:object,
+			:convert_to_model,
+			:model_name_from_record_or_class
+
+		# @!method button(...)
+		# @!method check_box(...)
+		# @!method collection_select(...)
+		# @!method color_field(...)
+		# @!method date_field(...)
+		# @!method date_select(...)
+		# @!method datetime_field(...)
+		# @!method datetime_local_field(...)
+		# @!method datetime_select(...)
+		# @!method email_field(...)
+		# @!method file_field(...)
+		# @!method grouped_collection_select(...)
+		# @!method hidden_field(...)
+		# @!method month_field(...)
+		# @!method number_field(...)
+		# @!method password_field(...)
+		# @!method phone_field(...)
+		# @!method radio_button(...)
+		# @!method range_field(...)
+		# @!method rich_text_area(...)
+		# @!method search_field(...)
+		# @!method select(...)
+		# @!method submit(...)
+		# @!method telephone_field(name, value = nil, **attributes)
+		# 	Outputs an input field of type <code>tel</code>.
+		# 	@param name [Symbol] the name of the field.
+		# 	@param value [String] the default value.
+		# 	@param attributes HTML attributes.
+		# 	@return [nil]
+		# @!method text_area(...)
+		# @!method text_field(...)
+		# @!method time_field(...)
+		# @!method time_select(...)
+		# @!method time_zone_select(...)
+		# @!method url_field(...)
+		# @!method week_field(...)
+		# @!method weekday_select(...)
+
+		# @!method label(...)
+		# 	@yield [builder]
+		# 	@yieldparam builder [Phlex::Rails::BufferedLabelBuilder]
+		define_builder_yielding_method :label, ::Phlex::Rails::BufferedLabelBuilder
+
+		# @!method fields(...)
+		# 	@yield [builder]
+		# 	@yieldparam builder [Phlex::Rails::BufferedFormBuilder]
+		define_builder_yielding_method :fields, ::Phlex::Rails::BufferedFormBuilder
+
+		# @!method fields_for(...)
+		# 	@yield [builder]
+		# 	@yieldparam builder [Phlex::Rails::BufferedFormBuilder]
+		define_builder_yielding_method :fields_for, ::Phlex::Rails::BufferedFormBuilder
+
+		# @!method collection_check_boxes(...)
+		# 	@yield [builder]
+		# 	@yieldparam builder [Phlex::Rails::BufferedCheckboxBuilder]
+		define_builder_yielding_method :collection_check_boxes, ::Phlex::Rails::BufferedCheckboxBuilder
+
+		# @!method collection_radio_buttons(...)
+		# 	@yield [builder]
+		# 	@yieldparam builder [Phlex::Rails::BufferedRadioButtonBuilder]
+		define_builder_yielding_method :collection_radio_buttons, ::Phlex::Rails::BufferedRadioButtonBuilder
+	end
+end

data/lib/phlex/rails/buffered_label_builder.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Phlex::Rails
+	class BufferedLabelBuilder < Buffered
+		# @!method object(...)
+		# @!method translation(...)
+		def_delegators :@object,
+			:object,
+			:translation
+	end
+end

data/lib/phlex/rails/buffered_radio_button_builder.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Phlex::Rails
+	class BufferedRadioButtonBuilder < Buffered
+		# @!method object(...)
+		# @!method text(...)
+		# @!method value(...)
+		def_delegators :@object,
+			:object,
+			:text,
+			:value
+	end
+end

data/lib/phlex/rails/helper_macros.rb

@@ -0,0 +1,95 @@
+# frozen_string_literal: true
+
+# @api private
+module Phlex::Rails::HelperMacros
+	def define_output_helper(method_name)
+		class_eval(<<-RUBY, __FILE__, __LINE__ + 1)
+			# frozen_string_literal: true
+
+			def #{method_name}(...)
+				output = helpers.#{method_name}(...)
+
+				case output
+				when ActiveSupport::SafeBuffer
+					@_target << output
+				end
+
+				nil
+			end
+		RUBY
+	end
+
+	def define_output_helper_with_capture_block(method_name)
+		class_eval(<<-RUBY, __FILE__, __LINE__ + 1)
+			# frozen_string_literal: true
+
+			def #{method_name}(*args, **kwargs, &block)
+				output = if block
+					helpers.#{method_name}(*args, **kwargs) { capture(&block) }
+				else
+					helpers.#{method_name}(*args, **kwargs)
+				end
+
+				case output
+				when ActiveSupport::SafeBuffer
+					@_target << output
+				end
+
+				nil
+			end
+		RUBY
+	end
+
+	def define_value_helper(method_name)
+		class_eval(<<-RUBY, __FILE__, __LINE__ + 1)
+			# frozen_string_literal: true
+
+			def #{method_name}(...)
+				helpers.#{method_name}(...)
+			end
+		RUBY
+	end
+
+	def define_value_helper_with_capture_block(method_name)
+		class_eval(<<-RUBY, __FILE__, __LINE__ + 1)
+			# frozen_string_literal: true
+
+			def #{method_name}(*args, **kwargs, &block)
+				if block
+					helpers.#{method_name}(*args, **kwargs) { capture(&block) }
+				else
+					helpers.#{method_name}(*args, **kwargs)
+				end
+			end
+		RUBY
+	end
+
+	def define_builder_yielding_helper(method_name, builder)
+		class_eval(<<-RUBY, __FILE__, __LINE__ + 1)
+			# frozen_string_literal: true
+
+			def #{method_name}(*args, **kwargs)
+				output = if block_given?
+					helpers.#{method_name}(*args, **kwargs) { |form|
+						capture do
+							yield(
+								#{builder.name}.new(form,
+									view: self
+								)
+							)
+						end
+					}
+				else
+					helpers.#{method_name}(*args, **kwargs)
+				end
+
+				case output
+				when ActiveSupport::SafeBuffer
+					@_target << output
+				end
+
+				nil
+			end
+		RUBY
+	end
+end

data/lib/phlex/rails/helpers/routes.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Phlex::Rails::Helpers
+	module Routes
+		include DefaultURLOptions
+		include Rails.application.routes.url_helpers
+	end
+end

data/lib/phlex/rails/helpers/tag.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Phlex::Rails::Helpers::Tag
+	def tag(...)
+		result = helpers.tag(...)
+
+		case result
+		when ActiveSupport::SafeBuffer
+			@_target << result
+		when ActionView::Helpers::TagHelper::TagBuilder
+			Phlex::Rails::Buffered.new(
+				result,
+				view: self
+			)
+		end
+	end
+end