tramway 0.4.5 → 0.4.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 54d135e0a0a71941eecdbbbf042963727d6b0e13e7a024f1c86f22d099d76feb
-  data.tar.gz: fa8e45c0a89c065df62d580e368b1e73a43a4abd06c9e542d8b8a8706dba24c0
+  metadata.gz: 57af927fcbb72fd669c6c8b7f480c37b3a83abe44cd84cf9fbabcb2cfa842786
+  data.tar.gz: ed23bd825f9bb892302f446366ad26420a84c0512af4627c5dd24fd239de7feb
 SHA512:
-  metadata.gz: 2b2b51bb24ca9c973ccd2cc3a925c102a2bedc1c1c1daa43c5be00d4563cc6491a521796a00f7cd80c8019718709e41d683c6f69819cd96172af0a5756f9ef29
-  data.tar.gz: 5db00c69d1d90c75d924d30a6989d087affbe2b2de546d774bfb58b732efce5b5a6615bd6801cdcfdd55d9f0c088c34fa2f7223793cd4d0e8c268dd10334a25e
+  metadata.gz: 0ed0b00d4f70aa52fa11299c274467e04ecd4070d9cad5ef63befe2c380186e24d13a9c7545faee0178587085f129b0af3c5f1e7376f66dea2bccf3219382c6f
+  data.tar.gz: 8862017bcd151691898293a7c4756138601ac8fd89ae6f4509024c3448c2740451e956f0ebfe83a6f42890ea1fcbfbf61a55afb6d5101b8b17cbe7dd5acf8efa

data/README.md

@@ -70,6 +70,8 @@ class UserDecorator < Tramway::BaseDecorator
   # delegates attributes to decorated object
   delegate_attributes :email, :first_name, :last_name
 
+  association :posts
+
   # you can provide your own methods with access to decorated object attributes with the method `object`
   def created_at
     I18n.l object.created_at
@@ -116,6 +118,17 @@ def show
 end
 ```
 
+#### Decorate associations
+
+```ruby
+class UserDecorator < Tramway::BaseDecorator
+  association :posts
+end
+
+user = tramway_decorate User.first
+user.posts # => decorated collection of posts with PostDecorator
+```
+
 #### Decorate nil
 
 Tramway Decorator does not decorate nil objects
@@ -198,6 +211,8 @@ class UsersController < ApplicationController
 end
 ```
 
+We also provide `submit!` as `save!` method that returns an exception in case of failed saving.
+
 #### Implement Form objects for any case
 
 *app/forms/user_updating_email_form.rb*
@@ -433,6 +448,18 @@ Pagination buttons looks like [this](https://play.tailwindcss.com/mqgDS5l9oY)
 
 **Tramway Decorator** and **Tramway Form** support `behave_as_ar` method. It allows to use `update` and `destroy` methods with decorated and form objects.
 
+### `object` method
+
+**Tramway Decorator** and **Tramway Form** have public `object` method. It allows to access ActiveRecord object itself.
+
+```ruby
+user_1 = tramway_decorate User.first
+user_1.object #=> returns pure user object
+
+user_2 = tramway_form User.first
+user_2.object #=> returns pure user object
+```
+
 ## Contributing
 
 Install [lefthook](https://github.com/evilmartians/lefthook)

data/app/components/tailwinds/form/builder.rb

@@ -60,8 +60,11 @@ module Tailwinds
       end
 
       # :reek:UtilityFunction
+      # :reek:NilCheck
       def label_build(attribute, options)
-        options[:label].presence || attribute.to_s.humanize
+        label_option = options[:label]
+
+        label_option.nil? ? attribute.to_s.humanize : label_option
       end
 
       def for_id(attribute)

data/lib/tramway/base_decorator.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require 'tramway/decorators/name_builder'
+require 'tramway/decorators/association'
 require 'tramway/decorators/collection_decorator'
 require 'tramway/utils/render'
 require 'tramway/duck_typing'
@@ -38,6 +40,8 @@ module Tramway
           delegate attribute, to: :object
         end
       end
+
+      include Tramway::Decorators::AssociationClassMethods
     end
 
     def to_partial_path

data/lib/tramway/decorators/association.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module Tramway
+  module Decorators
+    # Module for defining association instance-level methods
+    module Association
+      private
+
+      # :reek:UtilityFunction { enabled: false }
+      def decorate_has_many_association(assoc)
+        AssocDecoratorHelper.decorate_has_many_association(assoc)
+      end
+    end
+
+    # Module for defining association class-level methods
+    #
+    module AssociationClassMethods
+      def associations(*associations)
+        associations.each do |assoc|
+          association assoc
+        end
+      end
+
+      # has_and_belongs_to_many is not supported for now
+      def association(association)
+        define_method(association) do
+          assoc = object.send(association)
+
+          if assoc.is_a?(ActiveRecord::Relation)
+            AssocDecoratorHelper.decorate_has_many_association assoc
+          elsif assoc.present?
+            AssocDecoratorHelper.decorate_associated_object(assoc)
+          end
+        end
+      end
+    end
+
+    # Helper module for association decorators
+    module AssocDecoratorHelper
+      class << self
+        def decorate_has_many_association(assoc)
+          assoc.empty? ? [] : decorator(assoc.klass).decorate(assoc)
+        end
+
+        def decorate_associated_object(assoc)
+          decorator(assoc.class).decorate(assoc)
+        end
+
+        def decorator(class_name)
+          Tramway::Decorators::NameBuilder.default_decorator_class_name(class_name).constantize
+        end
+      end
+    end
+  end
+end

data/lib/tramway/decorators/class_helper.rb

@@ -16,7 +16,7 @@ module Tramway
                     object_or_array.class
                   end
 
-          "#{klass}Decorator".constantize
+          Tramway::Decorators::NameBuilder.default_decorator_class_name(klass).constantize
         end
       end
     end

data/lib/tramway/decorators/name_builder.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Tramway
+  module Decorators
+    # Implements name convention for decorators
+    #
+    module NameBuilder
+      module_function
+
+      def default_decorator_class_name(klass)
+        "#{klass}Decorator"
+      end
+    end
+  end
+end

data/lib/tramway/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Tramway
-  VERSION = '0.4.5'
+  VERSION = '0.4.6'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tramway
 version: !ruby/object:Gem::Version
-  version: 0.4.5
+  version: 0.4.6
 platform: ruby
 authors:
 - kalashnikovisme
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-05-06 00:00:00.000000000 Z
+date: 2024-05-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: dry-struct
@@ -124,8 +124,10 @@ files:
 - lib/tramway/config.rb
 - lib/tramway/configs/entities/route.rb
 - lib/tramway/configs/entity.rb
+- lib/tramway/decorators/association.rb
 - lib/tramway/decorators/class_helper.rb
 - lib/tramway/decorators/collection_decorator.rb
+- lib/tramway/decorators/name_builder.rb
 - lib/tramway/duck_typing.rb
 - lib/tramway/duck_typing/active_record_compatibility.rb
 - lib/tramway/engine.rb