inertia_rails 2.0.1 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3e99464a3b4534b1ccb484be532f15a11cf6883a13ea3e25643e6546a6934cc9
-  data.tar.gz: da8e75d1927615db2b2421cffeec4b34ce4a01649756294be11520a910baeb54
+  metadata.gz: 5626c22ecacdfaa9d46b04fe63027a941af3ee6f9e32716943072a547f12bb8f
+  data.tar.gz: 3ad0c5ef9d0f2943a70d76218b1d97dce7cef8079ee0ef0bcc7e337ffeef607c
 SHA512:
-  metadata.gz: da00b4ce0a9652fdc6b68988fcae4d6ad70caafd39574e6dd369e4e71f24c9a283323910aaeaef55fe17c50521d933bac3198e999806fd6629719795228ce5a6
-  data.tar.gz: '08b1a351fb8314ae370323dd9f374f59c507a4f8d9e9504e1bab8904d633bcfa4b9dc4f92c4ee2facd1d469deded86923067f315ca7b4cce184162d783151e21'
+  metadata.gz: 1e67ddf363fef24d94688cc0f9f51f46c62aec3265acab8a3e656923cc227b05e812c56d95e2fb5996c2acca909d99ed2af1863f17420ea6ec387695af14cf8c
+  data.tar.gz: b412652b57ae50161487667e34f1d35cf396bcfde11f2ac3fe8f574d0670374722c5ff1b31e3a83b5c11dc40687afd9945f45734f0e9549f512480bbf22fb801

data/CHANGELOG.md

@@ -4,6 +4,11 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.0.0] - 2022-09-22
+
+* Allow rails layout to set inertia layout. Thanks @ElMassimo!
+* Add the ability to set inertia props and components via rails conventions (see readme)
+
 ## [2.0.1] - 2022-07-12
 
 * Fix for a middleware issue where global state could be polluted if an exception occurs in a request. Thanks @ElMassimo!

data/README.md

@@ -14,7 +14,7 @@ gem 'inertia_rails'
 
 ### Frontend
 
-Rails 7 specific frontend docs coming soon. For now, check out the official Inertia docs at https://inertiajs.com/
+Rails 7 specific frontend docs coming soon. For now, check out the official Inertia docs at https://inertiajs.com/ or see an example using React/Vite [here](https://github.com/BrandonShar/inertia-rails-template)
 
 ## Usage
 
@@ -30,6 +30,53 @@ def index
 end
 ```
 
+#### Rails Component and Instance Props 
+
+Starting in version 3.0, Inertia Rails allows you to provide your component name and props via common rails conventions. 
+
+```ruby
+class EventsController < ApplicationController
+  use_inertia_instance_props
+
+  def index
+    @events = Event.all
+  end
+
+end
+```
+
+is the same as 
+
+
+```ruby
+class EventsController < ApplicationController
+  def index
+    render inertia: 'events/index', props: {
+      events: Event.all
+    }
+  end
+end
+```
+
+#### Instance Props and Default Render Notes 
+
+In order to use instance props, you must call `use_inertia_instance_props` on the controller (or a base controller it inherits from). If any props are provided manually, instance props
+are automatically disabled for that response. Instance props are only included if they are defined after the before filter is set from `use_inertia_instance_props`.
+
+Automatic component name is also opt in, you must set the `default_render` config value to `true`. Otherwise, you can simply `render inertia: true` for the same behavior explicitly. 
+
+### Layout 
+
+Inertia layouts use the rails layout convention and can be set or changed in the same way. The original `layout` config option is still functional, but will likely be deprecated in the future in favor
+of using rails layouts.
+
+```ruby
+class EventsController < ApplicationController
+  layout 'inertia_application'
+end
+```
+
+
 ### Shared Data
 
 If you have data that you want to be provided as a prop to every component (a common use-case is informationa about the authenticated user) you can use the `shared_data` controller method.
@@ -54,6 +101,14 @@ class EventsController < ApplicationController
 end
 ```
 
+### Lazy Props
+
+On the front end, Inertia supports the concept of "partial reloads" where only the props requested are returned by the server. Sometimes, you may want to use this flow to avoid processing a particularly slow prop on the intial load. In this case, you can use Lazy props. Lazy props aren't evaluated unless they're specifically requested by name in a partial reload.
+
+```ruby
+  inertia_share some_data: InertiaRails.lazy(lambda { some_very_slow_method })
+```
+
 ### Routing
 
 If you don't need a controller to handle a static component, you can route directly to a component with the inertia route helper
@@ -62,6 +117,10 @@ If you don't need a controller to handle a static component, you can route direc
 inertia 'about' => 'AboutComponent'
 ```
 
+### SSR
+
+Enable SSR via the config settings for `ssr_enabled` and `ssr_url`
+
 ## Configuration
 
 Inertia Rails has a few different configuration options that can be set anywhere, but the most common location is from within an initializer.
@@ -72,10 +131,9 @@ InertiaRails.configure do |config|
   
   # set the current version for automatic asset refreshing. A string value should be used if any.
   config.version = nil
+  # enable default inertia rendering (warning! this will override rails default rendering behavior)
+  config.default_render = true
   
-  # set the layout you want inertia components to be rendered within. This layout must include any required inertia javascript.
-  config.layout = 'application'
-
   # ssr specific options
   config.ssr_enabled = false
   config.ssr_url = 'http://localhost:13714'

data/inertia_rails.gemspec

@@ -34,4 +34,5 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "sqlite3"
   spec.add_development_dependency "appraisal"
   spec.add_development_dependency "responders"
+  spec.add_development_dependency "debug"
 end

data/lib/inertia_rails/controller.rb

@@ -20,6 +20,21 @@ module InertiaRails
           InertiaRails.share_block(block) if block
         end
       end
+
+      def use_inertia_instance_props
+        before_action do
+          @_inertia_instance_props = true
+          @_inertia_skip_props = view_assigns.keys + ['_inertia_skip_props']
+        end
+      end
+    end
+
+    def default_render
+      if InertiaRails.default_render?
+        render(inertia: true)
+      else
+        super
+      end
     end
 
     def redirect_to(options = {}, response_options = {})
@@ -36,8 +51,21 @@ module InertiaRails
       )
     end
 
+    def inertia_view_assigns
+      return {} unless @_inertia_instance_props
+      view_assigns.except(*@_inertia_skip_props)
+    end
+
     private
 
+    def inertia_layout
+      layout = ::InertiaRails.layout
+
+      # When the global configuration is not set, let Rails decide which layout
+      # should be used based on the controller configuration.
+      layout.nil? ? true : layout
+    end
+
     def inertia_location(url)
       headers['X-Inertia-Location'] = url
       head :conflict

data/lib/inertia_rails/inertia_rails.rb

@@ -32,6 +32,10 @@ module InertiaRails
     Configuration.ssr_url
   end
 
+  def self.default_render?
+    Configuration.default_render
+  end 
+
   def self.html_headers
     self.threadsafe_html_headers || []
   end
@@ -62,10 +66,11 @@ module InertiaRails
   private
 
   module Configuration
-    mattr_accessor(:layout) { 'application' }
+    mattr_accessor(:layout) { nil }
     mattr_accessor(:version) { nil }
     mattr_accessor(:ssr_enabled) { false }
     mattr_accessor(:ssr_url) { 'http://localhost:13714' }
+    mattr_accessor(:default_render) { false }
 
     def self.evaluated_version
       self.version.respond_to?(:call) ? self.version.call : self.version

data/lib/inertia_rails/renderer.rb

@@ -7,12 +7,12 @@ module InertiaRails
     attr_reader :component, :view_data
 
     def initialize(component, controller, request, response, render_method, props:, view_data:)
-      @component = component
+      @component = component.is_a?(TrueClass) ? "#{controller.controller_path}/#{controller.action_name}" : component
       @controller = controller
       @request = request
       @response = response
       @render_method = render_method
-      @props = props || {}
+      @props = props || controller.inertia_view_assigns
       @view_data = view_data || {}
     end
 
@@ -23,7 +23,7 @@ module InertiaRails
         @render_method.call json: page, status: @response.status, content_type: Mime[:json]
       else
         return render_ssr if ::InertiaRails.ssr_enabled? rescue nil
-        @render_method.call template: 'inertia', layout: ::InertiaRails.layout, locals: (view_data).merge({page: page})
+        @render_method.call template: 'inertia', layout: layout, locals: (view_data).merge({page: page})
       end
     end
 
@@ -34,7 +34,11 @@ module InertiaRails
       res = JSON.parse(Net::HTTP.post(uri, page.to_json, 'Content-Type' => 'application/json').body)
       
       ::InertiaRails.html_headers = res['head']
-      @render_method.call html: res['body'].html_safe, layout: ::InertiaRails.layout, locals: (view_data).merge({page: page})
+      @render_method.call html: res['body'].html_safe, layout: layout, locals: (view_data).merge({page: page})
+    end
+
+    def layout
+      @controller.send(:inertia_layout)
     end
 
     def props

data/lib/inertia_rails/version.rb

@@ -1,3 +1,3 @@
 module InertiaRails
-  VERSION = "2.0.1"
+  VERSION = "3.0.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: inertia_rails
 version: !ruby/object:Gem::Version
-  version: 2.0.1
+  version: 3.0.0
 platform: ruby
 authors:
 - Brian Knoles
@@ -10,7 +10,7 @@ authors:
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-07-12 00:00:00.000000000 Z
+date: 2022-09-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -124,6 +124,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: debug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description:
 email:
 - brain@bellawatt.com