phlexible 3.0.0 → 3.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: af9a39dba0e25b8381fc0f513111e488e27e6fa6d31d3d41ec7d7b7d4aa07cd1
-  data.tar.gz: b1e271a6e412e7e05aabed4b8c4f3a35157a04c6a7e0723ee70b9414beb65565
+  metadata.gz: 335d7a198a6dd2e58d52abe064552a739cfd77c9910f294022bd4a96adf4ef92
+  data.tar.gz: ee505e0e79afba25172584437407b99bc9ab52609d0d7c02cf2e29edc91ac20f
 SHA512:
-  metadata.gz: 27635a6f6135a15af61920b630269372199777701ec92b216f6e7309880fd46d93705890ef8545fb7d47101d295ad0744406cc1cd9beddfdf81fe03c3b849f71
-  data.tar.gz: c22b9d2d997f94ee86ee3c3c854ec631e2864f549c76d3ffc10138de0df0e2eeafbb2c7c5d9f6e15f2cea4fa1bb1a2982ed38e784878f433edef563f1d6bf8f6
+  metadata.gz: 58bd0f6dba980c3328127363960d501e9abbc2e84543b3264d418eb30a5e0a3fad8e25a7fa5a1f9a2b3aaa2b4f0e2bc4057813cdc963a63c7c276611052e6502
+  data.tar.gz: 7c082ee6bdfc6ae5f46f680d872b16e6d125dadfd94771b7da5d87151655a4405faf4c5616ae4bb5d56277a3df8dcfa45cfd928b7b0d97f678bcf2543d65f84d

data/.rubocop.yml

@@ -1,20 +1,54 @@
+plugins:
+  - rubocop-rails
+  - rubocop-minitest
+  - rubocop-disable_syntax
+  - rubocop-packaging
+  - rubocop-rake
+  - rubocop-performance
+
 AllCops:
-  TargetRubyVersion: 3.3.0
-  SuggestExtensions: false
+  TargetRubyVersion: 3.3
   NewCops: enable
+  SuggestExtensions: false
+  Exclude:
+    - "gemfiles/**/*"
+
+Naming/FileName:
   Exclude:
-    - "vendor/**/*"
-    - gemfiles/**/*
+    - "lib/proscenium-phlex.rb"
+
+Layout/LineLength:
+  Max: 100
+Layout/IndentationConsistency:
+  EnforcedStyle: indented_internal_methods
 
 Lint/ConstantDefinitionInBlock:
   Exclude:
-    - test/**/*
+    - "test/**/*"
+Lint/ItWithoutArgumentsInBlock:
+  Enabled: false
+Lint/MissingSuper:
+  Enabled: false
+
+Metrics:
+  Enabled: false
+
+Style/DisableSyntax:
+  DisableSyntax:
+    - unless
+    - and_or_not
+    - numbered_parameters
 
+Style/CaseEquality:
+  Enabled: false
 Style/Documentation:
   Enabled: false
 Style/ClassAndModuleChildren:
-  Exclude:
-    - fixtures/**/*
+  Enabled: false
+Style/NegatedIf:
+  Enabled: false
 
-Metrics:
+Minitest/EmptyLineBeforeAssertionMethods:
+  Enabled: false
+Minitest/MultipleAssertions:
   Enabled: false

data/.ruby-version

@@ -1 +1 @@
-3.3.6
+3.3.8

data/Appraisals

@@ -1,11 +1,25 @@
 # frozen_string_literal: true
 
-appraise 'phlex-1' do
-  gem 'phlex', '>= 1.10.0', '< 2.0.0'
-  gem 'phlex-rails', '>= 1.2.1', '< 2.0.0'
+appraise 'phlex1/rails7' do
+  gem 'phlex', '~> 1.11.0'
+  gem 'phlex-rails', '~> 1.2.1'
+  gem 'rails', '~> 7.2.0'
 end
 
-appraise 'phlex-2' do
+appraise 'phlex1/rails8' do
+  gem 'phlex', '~> 1.11.0'
+  gem 'phlex-rails', '~> 1.2.1'
+  gem 'rails', '>= 8.0.0'
+end
+
+appraise 'phlex2/rails7' do
+  gem 'phlex', '>= 2.1.0', '< 3.0.0'
+  gem 'phlex-rails', '>= 2.1.0', '< 3.0.0'
+  gem 'rails', '~> 7.2.0'
+end
+
+appraise 'phlex2/rails8' do
   gem 'phlex', '>= 2.1.0', '< 3.0.0'
   gem 'phlex-rails', '>= 2.1.0', '< 3.0.0'
+  gem 'rails', '>= 8.0.0'
 end

data/README.md

@@ -36,6 +36,26 @@ class UsersController
 end
 ```
 
+##### View Resolution
+
+By default, views are resolved using the `phlex_view_path` method, which constructs a path based on the controller and action name. For example, `UsersController#index` will look for `Users::IndexView`.
+
+You can customize this behavior by overriding `phlex_view_path` in your controller:
+
+```ruby
+class UsersController
+  include Phlexible::Rails::ActionController::ImplicitRender
+
+  private
+
+    def phlex_view_path(action_name)
+      "views/#{controller_path}/#{action_name}"
+    end
+end
+```
+
+This would resolve `UsersController#index` to `Views::Users::Index` instead.
+
 #### `Callbacks`
 
 While Phlex does have `before_template`, `after_template`, and `around_template` hooks, they must be defined as regular Ruby methods, meaning you have to always remember to call `super` when redefining any hook method.
@@ -251,7 +271,7 @@ end
 
 ### PageTitle
 
-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:
+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 include *Phlexible::PageTitle* module and assign the title to the `page_title` class variable:
 
 ```ruby
 class MyView
@@ -261,6 +281,55 @@ end
 
 Then call the `page_title` method in the `<head>` of your page.
 
+### `ProcessAttributes`
+
+> This functionality is already built in to **Phlex >= 1**. This module is only needed for **Phlex >= 2**.
+
+Allows you to intercept and modify HTML element attributes before they are rendered. This is useful for adding default attributes, transforming values, or conditionally modifying attributes based on other attributes.
+
+Extend your view class with `Phlexible::ProcessAttributes` and define a `process_attributes` instance method that receives the attributes hash and returns the modified hash.
+
+```ruby
+class MyView < Phlex::HTML
+  extend Phlexible::ProcessAttributes
+
+  def process_attributes(attrs)
+    # Add a default class to all elements
+    attrs[:class] ||= 'my-default-class'
+    attrs
+  end
+
+  def view_template
+    div(id: 'container') { 'Hello' }
+  end
+end
+```
+
+This will output:
+
+```html
+<div id="container" class="my-default-class">Hello</div>
+```
+
+The `process_attributes` method is called for all standard HTML elements and void elements, as well as any custom elements registered with `register_element`.
+
+```ruby
+class MyView < Phlex::HTML
+  extend Phlexible::ProcessAttributes
+
+  register_element :my_custom_element
+
+  def process_attributes(attrs)
+    attrs[:data_processed] = true
+    attrs
+  end
+
+  def view_template
+    my_custom_element(name: 'test') { 'Custom content' }
+  end
+end
+```
+
 ## Development
 
 After checking out the repo, install dependencies with:
@@ -274,16 +343,11 @@ This gem supports varios major Phlex versions, as defined in the `Appraisal` fil
 To run tests for all supported Phlex versions:
 
 ```
-bundle exec appraisal sus
+bundle exec appraisal rails t
 ```
 
 To run tests for a specific Phlex versions, call:
 
-```bash
-bundle exec appraisal phlex-1 sus
-bundle exec appraisal phlex-2 sus
-```
-
 To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
 ## Contributing

data/Rakefile

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
-require 'bundler/gem_tasks'
-require 'rubocop/rake_task'
+require 'bundler/setup'
 
-RuboCop::RakeTask.new
+APP_RAKEFILE = File.expand_path('test/dummy/Rakefile', __dir__)
+load 'rails/tasks/engine.rake'
 
-task default: :rubocop
+require 'bundler/gem_tasks'

data/gemfiles/phlex1_rails7.gemfile

@@ -0,0 +1,24 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "amazing_print"
+gem "appraisal"
+gem "debug"
+gem "rubocop-disable_syntax", require: false
+gem "rubocop-minitest", require: false
+gem "rubocop-packaging", require: false
+gem "rubocop-performance", require: false
+gem "rubocop-rails", require: false
+gem "rubocop-rake", require: false
+gem "capybara"
+gem "maxitest"
+gem "minitest", "~> 5.0"
+gem "minitest-difftastic"
+gem "minitest-focus"
+gem "minitest-spec-rails"
+gem "phlex", "~> 1.11.0"
+gem "phlex-rails", "~> 1.2.1"
+gem "rails", "~> 7.2.0"
+
+gemspec path: "../"