typical_situation 1.0.0 → 1.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e4c1f0edb5145c0cbeab8bd20520a2be77459ff68280f2dfd99350e51c66c288
-  data.tar.gz: f72c7aba90b5984f87ddd5cba2982c512292e4ac1f44603a07eec230db4ccdee
+  metadata.gz: 59384fee031d1440a474689f99be97760aedc645343e4febf4d1356ed05ee801
+  data.tar.gz: '08b482a57e976dbe1ac86604648a4f237346c09db88c672483dfae604d566cf1'
 SHA512:
-  metadata.gz: cee57ac0c5eea896aea026f06a9889cb832ce98a303e95a6a18d9b91fe9fee9d54a5bcb19fbfa8f52279a73416aa818a2fbb88335113c29c04d2b299ebc51b8e
-  data.tar.gz: de2e3f522926679ae805b952c06ca33409d953d0d4ed3a1482081337bc1d6b87ab20bc7bbc89727037deb5fca5cef51732972c158b13c60d593d1a4a774e1835
+  metadata.gz: dbcec21abd36a2da29b901bb2ffcb0468b6cf4170b4e974bef1cd640d174813c557fa8a87bddcda23e92c5709ea5c89c4fa39de7968f62ea08d5db6ac99a01a3
+  data.tar.gz: d12f5d0e3d6408a7060d46704e8dbe47cc516119fd7ae360e863bd3d00592def5e0ce99ac2bd2e6b491575284022469299689fef943368831003da8235c0a5a3

data/README.md

@@ -1,6 +1,6 @@
 # Typical Situation [![Spec CI](https://github.com/apsislabs/typical_situation/workflows/Spec%20CI/badge.svg)](https://github.com/apsislabs/typical_situation/actions)
 
-The missing Ruby on Rails ActionController REST API mixin.
+The missing Ruby on Rails ActionController REST API mixin. Originally forked from https://github.com/mars/typical_situation
 
 A Ruby mixin (module) providing the seven standard resource actions & responses for an ActiveRecord :model_type & :collection.
 
@@ -199,6 +199,58 @@ end
 
 By default, `TypicalSituation` permits all parameters (`permit!`) when these methods return `nil` or an empty array. Override them to restrict parameters for security.
 
+#### Flash Messages
+
+Add to `config/locales/en.yml`:
+
+```yaml
+en:
+  typical_situation:
+    flash:
+      create:
+        success: "%{resource} was successfully created"
+      update:
+        success: "%{resource} was successfully updated"
+      destroy:
+        success: "%{resource} was successfully deleted"
+```
+
+**Custom messages per resource:**
+
+```yaml
+en:
+  posts:
+    flash:
+      create:
+        success: "Your blog post is now live"
+```
+
+Override translation helper:
+
+```ruby
+def translate_with_resource(key)
+  model_key = "#{resource_name}.flash.#{key}"
+  if I18n.exists?(model_key)
+    I18n.t(model_key, resource: resource_name.humanize)
+  else
+    I18n.t("typical_situation.flash.#{key}", resource: resource_name.humanize)
+  end
+end
+```
+
+**Custom flash logic:**
+
+```ruby
+def set_success_flash(action)
+  case action
+  when :create
+    flash[:notice] = "Your #{resource_name.humanize.downcase} is live"
+  when :destroy
+    flash[:warning] = translate_with_resource("#{action}.success")
+  end
+end
+```
+
 #### Authorization
 
 Control access to resources by overriding the `authorized?` method:

data/config/locales/typical_situation.en.yml

@@ -0,0 +1,9 @@
+en:
+  typical_situation:
+    flash:
+      create:
+        success: "%{resource} was successfully created"
+      update:
+        success: "%{resource} was successfully updated"
+      destroy:
+        success: "%{resource} was successfully deleted"

data/lib/typical_situation/engine.rb

@@ -0,0 +1,6 @@
+require 'rails/engine'
+
+module TypicalSituation
+  class Engine < Rails::Engine
+  end
+end

data/lib/typical_situation/flash_messages.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module TypicalSituation
+  module FlashMessages
+    private
+
+    def set_success_flash(action)
+      flash[:notice] = translate_with_resource("#{action}.success")
+    end
+
+    def set_error_flash
+      return unless @resource&.errors&.any?
+
+      flash[:error] = @resource.errors.full_messages.join(", ")
+    end
+
+    def translate_with_resource(key)
+      I18n.t(
+        "typical_situation.flash.#{key}",
+        resource: model_type.to_s.humanize
+      )
+    end
+  end
+end

data/lib/typical_situation/responses.rb

@@ -45,6 +45,7 @@ module TypicalSituation
           yield(format) if block_given?
 
           format.html do
+            set_success_flash(:update)
             set_single_instance
             changed_so_redirect || render
           end
@@ -63,6 +64,7 @@ module TypicalSituation
           yield(format) if block_given?
 
           format.html do
+            set_success_flash(:create)
             set_single_instance
             changed_so_redirect || render
           end
@@ -93,6 +95,7 @@ module TypicalSituation
 
     def respond_as_gone
       if has_errors?
+        set_error_flash
         respond_as_error
       else
         respond_to do |format|
@@ -149,6 +152,8 @@ module TypicalSituation
 
     # HTML response when @resource deleted.
     def gone_so_redirect
+      set_error_flash if has_errors?
+      set_success_flash(:destroy) unless has_errors?
       redirect_to after_resource_destroyed_path(@resource)
       true
     end

data/lib/typical_situation/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module TypicalSituation
-  VERSION = "1.0.0"
+  VERSION = "1.0.2"
 end

data/lib/typical_situation.rb

@@ -1,10 +1,12 @@
 # frozen_string_literal: true
 
-require "typical_situation/identity"
-require "typical_situation/permissions"
-require "typical_situation/actions"
-require "typical_situation/operations"
-require "typical_situation/responses"
+require 'typical_situation/engine'
+require 'typical_situation/identity'
+require 'typical_situation/permissions'
+require 'typical_situation/flash_messages'
+require 'typical_situation/actions'
+require 'typical_situation/operations'
+require 'typical_situation/responses'
 
 module TypicalSituation
   class Error < StandardError; end
@@ -12,6 +14,7 @@ module TypicalSituation
 
   include Identity
   include Permissions
+  include FlashMessages
   include Operations
   include Responses
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: typical_situation
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.2
 platform: ruby
 authors:
 - Mars Hall
@@ -190,8 +190,11 @@ files:
 - MIT-LICENSE
 - README.md
 - Rakefile
+- config/locales/typical_situation.en.yml
 - lib/typical_situation.rb
 - lib/typical_situation/actions.rb
+- lib/typical_situation/engine.rb
+- lib/typical_situation/flash_messages.rb
 - lib/typical_situation/identity.rb
 - lib/typical_situation/operations.rb
 - lib/typical_situation/permissions.rb