render_turbo_stream 2.0.3 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7a57490a46044d10e1ee83f31c08f76a5b276b0687131462fe166d89405f3064
-  data.tar.gz: ae6fbdc64456d787eae9e3453ce1d08d943239f390f234091e71a0d20ef88ff6
+  metadata.gz: '087b5154db888a207a6396af1e508245b50e652513ad89be3b048f3951578398'
+  data.tar.gz: c54c8bd50712af73d95f75d614e46a2ff15346b50b95dfbc8a2294b341978fa2
 SHA512:
-  metadata.gz: b3facc3277258f03cae9e2185709f8594aa7c2b81b2b30735ba645a634ca89f16c7895cfda88a1d21252f0121ac2413bfeac03a1dcdb9f73d698f7c491a6b58a
-  data.tar.gz: 4cb888a09b19291463fdf612b6f33e55f83dfc5e01e0afca2dd477ff512321e528b07f7677c0e78b3458237db594083b0a0540636471deacdb49e153e73e7fae
+  metadata.gz: 69fd9f948bcc9e4b2c7f4a252f0958667a9cf8876b8185f307f02325f295f4023096d4991b0fa5b1f0648fb34074d9102d5741cbed5a52c09c0bb5d5b81b5043
+  data.tar.gz: e2ebc9166c0ec6a5e37d7d8d574b42345fb7f1429dfed8026c295963fe47b5fd21913c048f2164897e2a974ee33e6254590814b5392728a9836ce81fc823701d

data/README.md

@@ -1,12 +1,16 @@
 # RenderTurboStream
 
-Defining templates like `(create|update).turbo_stream.haml` annoyed me and I was looking for a testing strategy.
+Defining templates like `(create|update).turbo_stream.haml` annoyed me. 
 
-Working consistently with turbo_stream means shooting lots of partials from the backend to the frontend. This always requires the same attributes: the path to the partial, the html-id that turbo_stream points to, and maybe some locals. This gem serialises that: Partials can be controlled directly from the controller. It sets the status, generates a flash message, handles redirection, pushes it all to the front. Includes helpers for enabling request tests.
+Turbo has seamlessly integrated Action Cable. The intention here is to bring it all together in a unified workflow with a sufficient testing strategy.
 
-And build it dynamically: Most [turbo_power](https://github.com/marcoroth/turbo_power) commands, such as adding a css class to an html element or pushing a state to the browser history, work directly from the controller. Since turbo allows it, custom javascript functions are also possible.
+Working consistently with turbo_stream or Turbo Streams Channel means shooting a lot of partials from the backend to the frontend. This always requires the same attributes: the path to the partial, the html id that turbo_stream points to, and maybe some locals, and maybe generate a translated flash message for update or create actions. All this can be done in one step directly from the controller.
 
-ATTENTION: This plugin is in a early state.
+There are many ways and tedious details to handle redirects since Turbo! Below described are options.
+
+Execute [turbo_power](https://github.com/marcoroth/turbo_power) commands, such as adding a css class to an html element, pushing a state to the browser history, or running custom javascript actions through Turbo Stream (cable not yet integrated here) can be written in pure ruby code. No need for embeds like `.html.erb`.
+
+This plugin is in a early state.
 
 An overview of how we design a rails-7 application with turbo
 is [published on dev.to](https://dev.to/chmich/rails-7-vite-wrapping-up-1pia).
@@ -15,6 +19,8 @@ A quick and dirty application with all the features, including tests, built in i
 
 Hope it can help you.
 
+**Chris**
+
 ## Installation
 
 ```ruby
@@ -76,7 +82,7 @@ A comprehensive tutorial on turbo and how to check that it is working properly c
 **Turbo::StreamsChannel**
 
 The Rails team has seamlessly integrated `ActionCable` as `Turbo::StreamsChannel` into `Turbo Rails`. For installation along with this gem, see the [README](https://gitlab.com/sedl/renderturbostream/-/blob/main/README-cable.md).
-## Usage
+# Usage
 
 `turbo_stream_save` is a special method for streamlining `update` or `create` functions with `turbo_stream`. A controller action for update might look like this:
 
@@ -207,7 +213,7 @@ def update
     flashes_on_error: [] #=> array of strings
 
 
-## Testing Scenarios
+# Testing Scenarios
 
 For system testing there is Capybara. Its the only way to check if frontend and backend work together. But its a good practice to break tests into smaller pieces. The much larger number of tests we will write on the much faster request tests, examples here in rspec.
 
@@ -288,7 +294,7 @@ For more detailed testing of partials, there are view tests.
 Testing the plugin itself: There is a [quick-and-dirty app](https://gitlab.com/sedl/renderturbostream_railsapp) which
 includes the plugin and has tests done by rspec/request and capybara.
 
-## More Configs
+# More Configs
 
 On test helpers, the marker for a turbo-stream target is in most cases the id of the target element. This is true for the standard turbo-stream functions. On `turbo_power` it is the same in most cases. `RenderTurboStream::Libs.first_arg_is_html_id()` checks for which methods this is true. You can override this:
 
@@ -299,14 +305,14 @@ config.x.render_turbo_stream.first_argument_is_html_id = %[replace append prepen
 This setting is relevant for testing helpers.
 
 
-## Contributing
+# Contributing
 
 Contribution welcome.
 
-## License
+# License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
 
-## Thanks
+# Thanks
 
 Thanks to Marco Roth for turbo_power and thanks to DHH and the rails team for taking a bold new step by creating turbo.

data/lib/render_turbo_stream/turbo_cable_helpers.rb

@@ -1,14 +1,14 @@
 module RenderTurboStream
   module TurboCableHelpers
 
-    # def cable_partial_to_all_authenticated_users
-    #   raise "Function cable_partial_to_all_authenticated_users is "
-    #   if user_signed_in?
-    #
-    #   end
-    # end
+    def partial_to_all_authenticated_users
+      raise "Function partial_to_all_authenticated_users is not yet implemented"
+      if user_signed_in?
 
-    def cable_partial_to_channel(action, channel, partial, id, locals: nil)
+      end
+    end
+
+    def partial_to_channel(action, channel, partial, id, locals: nil)
 
       # add headers for test
       if Rails.env.test?
@@ -45,22 +45,22 @@ module RenderTurboStream
       )
     end
 
-    def cable_partial_to_me(partial, id, action: :replace, locals: nil)
+    def partial_to_me(partial, id, action: :replace, locals: nil)
       begin
         u_id = helpers.current_user&.id
         a=1
         unless u_id.present?
-          Rails.logger.debug('  • SKIP RenderTurboStream.cable_partial_to_me because current_user is nil')
+          Rails.logger.debug('  • SKIP RenderTurboStream.partial_to_me because current_user is nil')
           return
         end
       rescue
-        Rails.logger.debug('  • ERROR RenderTurboStream.cable_partial_to_me because current_user is not available')
+        Rails.logger.debug('  • ERROR RenderTurboStream.partial_to_me because current_user is not available')
         return
       end
 
-      cable_partial_to_channel(
+      partial_to_channel(
         action,
-        "current_user_#{helpers.current_user.id}",
+        "authenticated-user-#{helpers.current_user.id}",
         partial,
         id,
         locals: locals

data/lib/render_turbo_stream/turbo_cable_view_helpers.rb

@@ -3,19 +3,20 @@ module RenderTurboStream
 
     def cable_from_me
       if current_user
-        turbo_stream_from "current_user_#{current_user.id}"
+        turbo_stream_from "authenticated-user-#{current_user.id}"
       else
         Rails.logger.debug("  • SKIP CABLE_FROM_ME because not authenticated")
       end
     end
 
-    # def cable_from_all_authenticated_users
-    #   if user_signed_in?
-    #     turbo_stream_from "all_authenticated_users"
-    #   else
-    #     Rails.logger.debug("  • SKIP CABLE_FROM_ALL_AUTHENTICATED_USERS because not authenticated")
-    #   end
-    # end
+    def cable_from_all_authenticated_users
+      raise "Function cable_from_all_authenticated_users is not yet implemented"
+      if user_signed_in?
+        turbo_stream_from "all-authenticated-users"
+      else
+        Rails.logger.debug("  • SKIP CABLE_FROM_ALL_AUTHENTICATED_USERS because not authenticated")
+      end
+    end
 
     def cable_from_all
         turbo_stream_from "all"

data/lib/render_turbo_stream/version.rb

@@ -1,3 +1,3 @@
 module RenderTurboStream
-  VERSION = "2.0.3"
+  VERSION = "2.1.0"
 end

data/lib/render_turbo_stream.rb

@@ -162,7 +162,7 @@ module RenderTurboStream
         streams.each do |s|
           next unless s.is_a?(Hash)
           Rails.logger.debug("  • Send by Cable => «#{s}»")
-          cable_partial_to_me(
+          partial_to_me(
             s[:partial],
             s[:id],
             action: flash_action,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: render_turbo_stream
 version: !ruby/object:Gem::Version
-  version: 2.0.3
+  version: 2.1.0
 platform: ruby
 authors:
 - christian
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-05-01 00:00:00.000000000 Z
+date: 2023-05-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -27,8 +27,8 @@ dependencies:
 description: Handles translated flash messages, sets status and renders partials via
   Turbo Stream or Turbo::StreamsChannel directly from the controller. No need to write
   *.turbo_stream.* templates. Together with the turbo_power gem or custom turbo_stream
-  actions, you can run javascript. Redirects can now be handled easily and in multiple
-  ways. Enables a consistent testing strategy through request testing helpers.
+  actions, it can run javascript. Redirects can be handled easily and in multiple
+  ways. Through request testing helpers, this allows for consistent testing strategy.
 email:
 - christian@sedlmair.ch
 executables: []