phlexible 0.2.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: de2a41c9efa577146733f7e842f503818c594d726995a8f62fd39f5e87749b61
-  data.tar.gz: 89306b9e9ca8b83ed58a4b598197cabe3c745c554645c0555b684c8dc653ac39
+  metadata.gz: 27b319da9b017a6659e7a8372c67da3fe5f2d41c60d853a0ff095d97770f9269
+  data.tar.gz: 2d4ecd695d5b0265f4884eddb7ab90c942687953314b831c292971542377ebcf
 SHA512:
-  metadata.gz: 87c4b0ece2ba0ce51a1b8d865a48fe09dfcd41cec04ee9f862fb05c8e82140946ebabf71056fb863fd38364bf1a80e836d2024a2dd6d80893a50c4f637231e7a
-  data.tar.gz: 2fdfd0d7c354df97d8d932bc4eb695876bb87a6434a54b16ce0de729050225acbdbb564e04feb7b6315dc2bde0ee5987456ba67ed684bbfc660c7fae04723356
+  metadata.gz: 2f20789eac80d0b8c65db6552f8528ff63dcd0952f3e2039bfc5ec4c200c700e8795979c9249d3e8f15a1103a2b8a3b79212dbd234632c3b94a7d305eb1442a7
+  data.tar.gz: df64f02ad32290c863b305db652043119098bc8034744dae36c45901fb23195994260f482ae2c6a9c2a161616f4a6913055abfec0659b5f7db6452ffbf11993e

data/Gemfile

@@ -9,4 +9,4 @@ gem 'combustion'
 gem 'phlex-testing-nokogiri'
 gem 'rake', '~> 13.0'
 gem 'rubocop', '~> 1.21'
-gem 'sus', '~> 0.16.0'
+gem 'sus', '~> 0.20.0'

data/Gemfile.lock

@@ -1,97 +1,100 @@
 PATH
   remote: .
   specs:
-    phlexible (0.1.0)
-      phlex (~> 1.0)
-      phlex-rails (~> 0.4)
+    phlexible (0.3.0)
+      phlex (~> 1.8.1)
+      phlex-rails (~> 1.0.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    actioncable (7.0.4)
-      actionpack (= 7.0.4)
-      activesupport (= 7.0.4)
+    actioncable (7.0.4.3)
+      actionpack (= 7.0.4.3)
+      activesupport (= 7.0.4.3)
       nio4r (~> 2.0)
       websocket-driver (>= 0.6.1)
-    actionmailbox (7.0.4)
-      actionpack (= 7.0.4)
-      activejob (= 7.0.4)
-      activerecord (= 7.0.4)
-      activestorage (= 7.0.4)
-      activesupport (= 7.0.4)
+    actionmailbox (7.0.4.3)
+      actionpack (= 7.0.4.3)
+      activejob (= 7.0.4.3)
+      activerecord (= 7.0.4.3)
+      activestorage (= 7.0.4.3)
+      activesupport (= 7.0.4.3)
       mail (>= 2.7.1)
       net-imap
       net-pop
       net-smtp
-    actionmailer (7.0.4)
-      actionpack (= 7.0.4)
-      actionview (= 7.0.4)
-      activejob (= 7.0.4)
-      activesupport (= 7.0.4)
+    actionmailer (7.0.4.3)
+      actionpack (= 7.0.4.3)
+      actionview (= 7.0.4.3)
+      activejob (= 7.0.4.3)
+      activesupport (= 7.0.4.3)
       mail (~> 2.5, >= 2.5.4)
       net-imap
       net-pop
       net-smtp
       rails-dom-testing (~> 2.0)
-    actionpack (7.0.4)
-      actionview (= 7.0.4)
-      activesupport (= 7.0.4)
+    actionpack (7.0.4.3)
+      actionview (= 7.0.4.3)
+      activesupport (= 7.0.4.3)
       rack (~> 2.0, >= 2.2.0)
       rack-test (>= 0.6.3)
       rails-dom-testing (~> 2.0)
       rails-html-sanitizer (~> 1.0, >= 1.2.0)
-    actiontext (7.0.4)
-      actionpack (= 7.0.4)
-      activerecord (= 7.0.4)
-      activestorage (= 7.0.4)
-      activesupport (= 7.0.4)
+    actiontext (7.0.4.3)
+      actionpack (= 7.0.4.3)
+      activerecord (= 7.0.4.3)
+      activestorage (= 7.0.4.3)
+      activesupport (= 7.0.4.3)
       globalid (>= 0.6.0)
       nokogiri (>= 1.8.5)
-    actionview (7.0.4)
-      activesupport (= 7.0.4)
+    actionview (7.0.4.3)
+      activesupport (= 7.0.4.3)
       builder (~> 3.1)
       erubi (~> 1.4)
       rails-dom-testing (~> 2.0)
       rails-html-sanitizer (~> 1.1, >= 1.2.0)
-    activejob (7.0.4)
-      activesupport (= 7.0.4)
+    activejob (7.0.4.3)
+      activesupport (= 7.0.4.3)
       globalid (>= 0.3.6)
-    activemodel (7.0.4)
-      activesupport (= 7.0.4)
-    activerecord (7.0.4)
-      activemodel (= 7.0.4)
-      activesupport (= 7.0.4)
-    activestorage (7.0.4)
-      actionpack (= 7.0.4)
-      activejob (= 7.0.4)
-      activerecord (= 7.0.4)
-      activesupport (= 7.0.4)
+    activemodel (7.0.4.3)
+      activesupport (= 7.0.4.3)
+    activerecord (7.0.4.3)
+      activemodel (= 7.0.4.3)
+      activesupport (= 7.0.4.3)
+    activestorage (7.0.4.3)
+      actionpack (= 7.0.4.3)
+      activejob (= 7.0.4.3)
+      activerecord (= 7.0.4.3)
+      activesupport (= 7.0.4.3)
       marcel (~> 1.0)
       mini_mime (>= 1.1.0)
-    activesupport (7.0.4)
+    activesupport (7.0.4.3)
       concurrent-ruby (~> 1.0, >= 1.0.2)
       i18n (>= 1.6, < 2)
       minitest (>= 5.1)
       tzinfo (~> 2.0)
     ast (2.4.2)
     builder (3.2.4)
+    cgi (0.3.6)
     combustion (1.3.7)
       activesupport (>= 3.0.0)
       railties (>= 3.0.0)
       thor (>= 0.14.6)
-    concurrent-ruby (1.1.10)
+    concurrent-ruby (1.2.2)
     crass (1.0.6)
     date (3.3.3)
+    erb (4.0.2)
+      cgi (>= 0.3.3)
     erubi (1.12.0)
-    globalid (1.0.0)
+    globalid (1.1.0)
       activesupport (>= 5.0)
     i18n (1.12.0)
       concurrent-ruby (~> 1.0)
     json (2.6.3)
-    loofah (2.19.1)
+    loofah (2.20.0)
       crass (~> 1.0.2)
       nokogiri (>= 1.5.9)
-    mail (2.8.0)
+    mail (2.8.1)
       mini_mime (>= 0.1.1)
       net-imap
       net-pop
@@ -99,8 +102,7 @@ GEM
     marcel (1.0.2)
     method_source (1.0.0)
     mini_mime (1.1.2)
-    mini_portile2 (2.8.1)
-    minitest (5.17.0)
+    minitest (5.18.0)
     net-imap (0.3.4)
       date
       net-protocol
@@ -110,79 +112,84 @@ GEM
       timeout
     net-smtp (0.3.3)
       net-protocol
-    nio4r (2.5.8)
-    nokogiri (1.13.10)
-      mini_portile2 (~> 2.8.0)
+    nio4r (2.5.9)
+    nokogiri (1.14.3-arm64-darwin)
       racc (~> 1.4)
-    parallel (1.22.1)
-    parser (3.2.0.0)
+    nokogiri (1.14.3-x86_64-darwin)
+      racc (~> 1.4)
+    nokogiri (1.14.3-x86_64-linux)
+      racc (~> 1.4)
+    parallel (1.23.0)
+    parser (3.2.2.1)
       ast (~> 2.4.1)
-    phlex (1.1.0)
+    phlex (1.8.1)
+      concurrent-ruby (~> 1.2)
+      erb (>= 4)
       zeitwerk (~> 2.6)
-    phlex-rails (0.4.2)
-      phlex (>= 1, < 2)
+    phlex-rails (1.0.0)
+      phlex (~> 1.7)
       rails (>= 6.1, < 8)
-      zeitwerk (~> 2)
+      zeitwerk (~> 2.6)
     phlex-testing-nokogiri (0.1.0)
       nokogiri (~> 1.13)
       phlex (>= 0.5)
     racc (1.6.2)
-    rack (2.2.5)
-    rack-test (2.0.2)
+    rack (2.2.6.4)
+    rack-test (2.1.0)
       rack (>= 1.3)
-    rails (7.0.4)
-      actioncable (= 7.0.4)
-      actionmailbox (= 7.0.4)
-      actionmailer (= 7.0.4)
-      actionpack (= 7.0.4)
-      actiontext (= 7.0.4)
-      actionview (= 7.0.4)
-      activejob (= 7.0.4)
-      activemodel (= 7.0.4)
-      activerecord (= 7.0.4)
-      activestorage (= 7.0.4)
-      activesupport (= 7.0.4)
+    rails (7.0.4.3)
+      actioncable (= 7.0.4.3)
+      actionmailbox (= 7.0.4.3)
+      actionmailer (= 7.0.4.3)
+      actionpack (= 7.0.4.3)
+      actiontext (= 7.0.4.3)
+      actionview (= 7.0.4.3)
+      activejob (= 7.0.4.3)
+      activemodel (= 7.0.4.3)
+      activerecord (= 7.0.4.3)
+      activestorage (= 7.0.4.3)
+      activesupport (= 7.0.4.3)
       bundler (>= 1.15.0)
-      railties (= 7.0.4)
+      railties (= 7.0.4.3)
     rails-dom-testing (2.0.3)
       activesupport (>= 4.2.0)
       nokogiri (>= 1.6)
-    rails-html-sanitizer (1.4.4)
+    rails-html-sanitizer (1.5.0)
       loofah (~> 2.19, >= 2.19.1)
-    railties (7.0.4)
-      actionpack (= 7.0.4)
-      activesupport (= 7.0.4)
+    railties (7.0.4.3)
+      actionpack (= 7.0.4.3)
+      activesupport (= 7.0.4.3)
       method_source
       rake (>= 12.2)
       thor (~> 1.0)
       zeitwerk (~> 2.5)
     rainbow (3.1.1)
     rake (13.0.6)
-    regexp_parser (2.6.1)
+    regexp_parser (2.8.0)
     rexml (3.2.5)
-    rubocop (1.43.0)
+    rubocop (1.50.2)
       json (~> 2.3)
       parallel (~> 1.10)
       parser (>= 3.2.0.0)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 1.8, < 3.0)
       rexml (>= 3.2.5, < 4.0)
-      rubocop-ast (>= 1.24.1, < 2.0)
+      rubocop-ast (>= 1.28.0, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 3.0)
-    rubocop-ast (1.24.1)
-      parser (>= 3.1.1.0)
-    ruby-progressbar (1.11.0)
-    sus (0.16.0)
+    rubocop-ast (1.28.0)
+      parser (>= 3.2.1.0)
+    ruby-progressbar (1.13.0)
+    sus (0.20.3)
     thor (1.2.1)
-    timeout (0.3.1)
-    tzinfo (2.0.5)
+    timeout (0.3.2)
+    tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
     unicode-display_width (2.4.2)
     websocket-driver (0.7.5)
       websocket-extensions (>= 0.1.0)
     websocket-extensions (0.1.5)
-    zeitwerk (2.6.6)
+    zeitwerk (2.6.7)
 
 PLATFORMS
   arm64-darwin-22
@@ -195,7 +202,7 @@ DEPENDENCIES
   phlexible!
   rake (~> 13.0)
   rubocop (~> 1.21)
-  sus (~> 0.16.0)
+  sus (~> 0.20.0)
 
 BUNDLED WITH
    2.4.1

data/README.md

@@ -36,6 +36,32 @@ class UsersController
 end
 ```
 
+#### `ControllerAttributes`
+
+Include this module in your Phlex views to get access to the controller's instance variables. It
+provides an explicit interface for accessing controller instance variables from the view.
+
+```ruby
+class Views::Users::Index < Views::Base
+  include Phlexible::Rails::ControllerAttributes
+
+  controller_attribute :first_name, :last_name
+
+  def template
+    h1 { "#{@first_name} #{@last_name}" }
+  end
+end
+```
+
+##### Options
+
+- `attr_reader:` - If set to `true`, an `attr_reader` will be defined for the given attributes.
+- `alias:` - If set, the given attribute will be aliased to the given alias value.
+
+```ruby
+controller_attribute :users, attr_reader: true, alias: :my_users
+```
+
 #### `Responder`
 
 If you use [Responders](https://github.com/heartcombo/responders), Phlexible provides a responder to
@@ -46,6 +72,7 @@ Just include it in your ApplicationResponder:
 
 ```ruby
 class ApplicationResponder < ActionController::Responder
+  include Phlexible::Rails::ActionController::ImplicitRender
   include Phlexible::Rails::Responder
 end
 ```
@@ -57,12 +84,19 @@ class UsersController < ApplicationController
   def new
     respond_with User.new
   end
+
+  def index
+    respond_with User.all
+  end
 end
 ```
 
-This responder requires the use of `ActionController::ImplicitRender`, so dont't forget to include
+This responder requires the use of `ActionController::ImplicitRender`, so don't forget to include
 that in your `ApplicationController`.
 
+If you use `ControllerAttributes` in your view, and define a `resource` attribute, the responder
+will pass that to your view.
+
 #### `AElement`
 
 No need to call Rails `link_to` helper, when you can simply render an anchor tag directly with
@@ -92,17 +126,11 @@ end
 
 Generates a form containing a single button that submits to the URL created by the set of options.
 
-It is similar to Rails `button_to` helper, which accepts the value/content of the button as the
-first argument, and a URL or route helper as the second argument.
-
-```ruby
-Phlexible::Rails::ButtonTo.new 'My Button', :root
-```
-
-Alternatively you can pass a block; the result of which will be used as the value of the button.
+It is similar to Rails `button_to` helper, which accepts the URL or route helper as the first
+argument, and the value/content of the button as the block.
 
 ```ruby
-Phlexible::Rails::ButtonTo.new(:root) { 'Go Home 👉' }
+Phlexible::Rails::ButtonTo.new(:root) { 'My Button' }
 ```
 
 The url argument accepts the same options as Rails `url_for`.
@@ -111,7 +139,7 @@ The form submits a POST request by default. You can specify a different HTTP ver
 option.
 
 ```ruby
-Phlexible::Rails::ButtonTo.new 'My Button', :root, method: :patch
+Phlexible::Rails::ButtonTo.new(:root, method: :patch) { 'My Button' }
 ```
 
 ##### Options

data/lib/phlexible/page_title.rb

@@ -4,9 +4,10 @@ module Phlexible
   #
   # Helper to assist in defining page titles within Phlex views. Also includes support for nested
   # views, where each desendent view class will have its title prepended to the page title. Simply
-  # assign the title to the `page_title` class variable:
+  # include the module and assign the title to the `page_title` class variable:
   #
   #   class MyView
+  #     include Phlexible::PageTitle
   #     self.page_title = 'My Title'
   #   end
   #

data/lib/phlexible/rails/action_controller/implicit_render.rb

@@ -11,39 +11,42 @@
 # You can do this:
 #
 #   class UsersController
+#     include Phlexible::Rails::ActionController::ImplicitRender
 #   end
 #
 module Phlexible
   module Rails
     module ActionController
       module ImplicitRender
-        NUFFIN = 'NUFFIN'
-
         def default_render
-          render_view_class || super
+          render_plex_view({ action: action_name }) || super
         end
 
-        def render_view_class(view_options = NUFFIN, render_options = {})
-          klass = render_options&.key?(:action) ? phlex_view(render_options[:action]) : phlex_view
-          return unless klass
-
-          render view_options == NUFFIN ? klass.new : klass.new(view_options), render_options
+        def assign_phlex_accessors(pview)
+          pview.tap do |view|
+            view.__controller_attributes__.each do |attr|
+              view.instance_variable_set :"@#{attr}", view_assigns[attr.to_s]
+            end
+          end
         end
 
-        private
-
         def method_for_action(action_name)
-          if action_method?(action_name)
-            action_name
-          elsif phlex_view
-            '_handle_view_class'
-          elsif respond_to?(:action_missing, true)
-            '_handle_action_missing'
-          end
+          super || ('default_phlex_render' if phlex_view(action_name))
         end
 
-        def _handle_view_class(*_args)
-          render_view_class
+        def default_phlex_render
+          render assign_phlex_accessors(phlex_view(action_name).new)
+        end
+
+        # @param options [Hash] At a minimum this may contain an `:action` key, which will be used
+        #   as the name of the view to render. If no `:action` key is provided, the current
+        #   `action_name` is used.
+        def render_plex_view(options)
+          options[:action] ||= action_name
+
+          return unless (view = phlex_view(options[:action]))
+
+          render assign_phlex_accessors(view.new)
         end
 
         def phlex_view(action_name = @_action_name)

data/lib/phlexible/rails/button_to.rb

@@ -11,20 +11,13 @@ module Phlexible
       BUTTON_TAG_METHOD_VERBS = %w[patch put delete].freeze
       DEFAULT_OPTIONS = { method: 'post', form_class: 'button_to' }.freeze
 
-      def initialize(name = nil, url = nil, options = nil)
-        @name = name
+      def initialize(url, options = nil)
         @url = url
         @options = options
       end
 
-      # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity
+      # rubocop:disable Metrics/AbcSize
       def template(&block)
-        if block_given?
-          @options = @url
-          @url = @name
-          @name = nil
-        end
-
         action = helpers.url_for(@url)
         @options = DEFAULT_OPTIONS.merge((@options || {}).symbolize_keys)
 
@@ -38,7 +31,7 @@ module Phlexible
           block_given? ? button(**button_attrs, &block) : button(**button_attrs) { @name }
         end
       end
-      # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity
+      # rubocop:enable Metrics/AbcSize
 
       private
 

data/lib/phlexible/rails/controller_attributes.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+# Include this module in your Phlex views to get access to the controller's instance variables. It
+# provides an explicit interface for accessing controller instance variables from the view. Simply
+# call `controller_attribute` with the name of any controller instance variable you want to access
+# in your view.
+#
+# @example
+#   class Views::Users::Index < Views::Base
+#     controller_attribute :user_name
+#
+#     def template
+#       h1 { @user_name }
+#     end
+#   end
+#
+# Options
+#   - `attr_reader:` - If set to `true`, an `attr_reader` will be defined for the given attributes.
+#   - `alias:` - If set, the given attribute will be aliased to the given alias value.
+#
+module Phlexible
+  module Rails
+    module ControllerAttributes
+      extend ActiveSupport::Concern
+
+      included do
+        class_attribute :__controller_attributes__, instance_predicate: false, default: Set.new
+      end
+
+      class_methods do
+        def controller_attribute(*names, **kwargs)
+          self.__controller_attributes__ += names
+
+          return if kwargs.empty?
+
+          names.each do |name|
+            attr_reader name if kwargs[:attr_reader]
+            alias_method kwargs[:alias], name if kwargs[:alias]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/phlexible/rails/responder.rb

@@ -5,21 +5,25 @@ module Phlexible
     module Responder
       # Overridden to support implicit rendering of phlex views.
       def default_render
+        return super if format != :html
+
         if @default_response
           @default_response.call(options)
         elsif !get? && has_errors?
-          render_phlex_view options.merge(status: :unprocessable_entity)
+          render_phlex_view({ status: error_status }.merge!(options))
         else
           render_phlex_view options
         end
       end
 
-      # Render the Phlex view with the current resource. Falls back to default controller rendering if
-      # no Phlex view exists.
+      # Render the Phlex view with the current resource. Falls back to default controller rendering
+      # if no Phlex view exists. Also passes the current resource to the view, which is then
+      # available as `@resource`.
       #
-      # @see Phlexible::Rails::ActionController::ImplicitRender#render_view_class
+      # @see Phlexible::Rails::ActionController::ImplicitRender#render_plex_view
       def render_phlex_view(options)
-        controller.render_view_class(@resource, options) || controller.render(options)
+        controller.instance_variable_set :@resource, @resource
+        controller.render_plex_view(options) || controller.render(options)
       end
       alias render render_phlex_view
     end

data/lib/phlexible/rails.rb

@@ -4,6 +4,7 @@ require 'phlex-rails'
 
 module Phlexible
   module Rails
+    autoload :ControllerAttributes, 'phlexible/rails/controller_attributes'
     autoload :Responder, 'phlexible/rails/responder'
     autoload :AElement, 'phlexible/rails/a_element'
 

data/lib/phlexible/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Phlexible
-  VERSION = '0.2.0'
+  VERSION = '0.4.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: phlexible
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Joel Moss
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-02-07 00:00:00.000000000 Z
+date: 2023-05-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: phlex
@@ -16,28 +16,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: 1.8.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: 1.8.1
 - !ruby/object:Gem::Dependency
   name: phlex-rails
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.4'
+        version: 1.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.4'
+        version: 1.0.0
 description: A bunch of helpers and goodies intended to make life with Phlex even
   easier!
 email:
@@ -72,6 +72,7 @@ files:
 - lib/phlexible/rails/a_element.rb
 - lib/phlexible/rails/action_controller/implicit_render.rb
 - lib/phlexible/rails/button_to.rb
+- lib/phlexible/rails/controller_attributes.rb
 - lib/phlexible/rails/responder.rb
 - lib/phlexible/version.rb
 homepage: https://github.com/joelmoss/phlexible
@@ -97,7 +98,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.1
+rubygems_version: 3.4.10
 signing_key:
 specification_version: 4
 summary: A bunch of helpers and goodies intended to make life with Phlex even easier!