decorator_dryer 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 57534e692dcdc6bfc6a30bf1ba81d3392acd5aa9970c61c4a301ac680f8cbb35
-  data.tar.gz: 26e905c85521618775dc1276e9e9435f7839d003cc99137719b40d4f673b7c2d
+  metadata.gz: acaab9b600b806da72034503fd1248a8fd1a04cd9ce40da3b7a2ace4ae152f9c
+  data.tar.gz: b27d7230005a389d8d386032d9b754bc587f9544194254c917d47c00a3a93197
 SHA512:
-  metadata.gz: 8e0f3540a44117a74423b51b30d871303d61bfc8f48bfd874c915fe8c2b40ecbaae19180adf5c824dd4013ec6c365487f1fefbcdcacd5fca7a3548e1ae408285
-  data.tar.gz: 445f24bce804cf151f0967f18bd6edeabb37769390dcf2720655d51f9eb10ee8c369781ad10d2a93b6363ba804ddf956dae66cf922b62f92e821057853d2446f
+  metadata.gz: f53634e3a21b84ddd288c19ccb4042654793372619c16bfdd984c1a8cc824430baf185950bd606a4ecf90de73b5ad1f22484efaae530b0f1a1890d1883aa851c
+  data.tar.gz: 30d393ba4083a7bbd7b748752bad269db75c1e51dbe34272a676c1a7e78851e47ff10c352e56f530559a56b26d3d2823e5a51d3ff65198ad9a83255a5c363089

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    decorator_dryer (0.1.0)
+    decorator_dryer (0.1.1)
 
 GEM
   remote: https://rubygems.org/
@@ -49,6 +49,7 @@ GEM
     unicode-display_width (2.5.0)
 
 PLATFORMS
+  aarch64-linux
   x86_64-darwin-20
 
 DEPENDENCIES

data/README.md

@@ -223,21 +223,90 @@ class PersonDecorator < Draper::Decorator
 end
 ```
 
+## Testing
+
+### RSpec Matchers
+
+Decorator Dryer provides RSpec matchers to help you test your decorators. To use them, require the matchers in your `spec_helper.rb` or `rails_helper.rb`:
+
+```ruby
+require 'decorator_dryer/rspec'
+```
+
+The following matchers are available:
+
+#### format_field_to_name
+
+Verifies that a decorator defines a method to retrieve the name value from an association:
+
+```ruby
+it { should format_field_to_name(:person) }
+```
+
+#### format_field_to_datetime
+
+Verifies that a decorator defines a datetime format method for a given attribute:
+
+```ruby
+it { should format_field_to_datetime(:moment_of_birth) }
+```
+
+#### format_field_to_time
+
+Verifies that a decorator defines a time format method for a given attribute:
+
+```ruby
+it { should format_field_to_time(:lunch_time) }
+```
+
+#### format_field_to_date
+
+Verifies that a decorator defines a date format method for a given attribute:
+
+```ruby
+it { should format_field_to_date(:moment_of_birth) }
+```
+
+#### format_field_to_precision_number
+
+Verifies that a decorator defines a precision number format method for a given attribute:
+
+```ruby
+it { should format_field_to_precision_number(:salary, 2) }
+```
+
+#### delegate_field
+
+Verifies that a decorator defines a method to delegate a given attribute to a given association:
+
+```ruby
+it { should delegate_field(:job_title, :employee) }
+```
+
+#### delegate_field_with_prefix
+
+Verifies that a decorator defines a method to delegate a given attribute to a given association, using the association as the method prefix:
+
+```ruby
+it { should delegate_field_with_prefix(:job_title, :employee) }
+```
+
 ## To Do
 
 * Enable formats to be overridden when calling shortcuts.
 * Add support for additional attachment libraries.
 * Add a more flexible replacement for the `to_name` shortcut.
+* Add a generator for the initialiser.
 
 ## Development
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `spec` to run the tests.
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests.
 
 To release a new version of this gem, 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
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/CodeTectonics/decorator_dryer. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/CodeTectonics/decorator_dryer/blob/master/CODE_OF_CONDUCT.md).
+Bug reports and pull requests are welcome on GitHub at https://github.com/CodeTectonics/decorator_dryer. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/CodeTectonics/decorator_dryer/blob/main/CODE_OF_CONDUCT.md).
 
 ## License
 
@@ -245,4 +314,4 @@ The gem is available as open source under the terms of the [MIT License](https:/
 
 ## Code of Conduct
 
-Everyone interacting in the DecoratorDryer project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/CodeTectonics/decorator_dryer/blob/master/CODE_OF_CONDUCT.md).
+Everyone interacting in the DecoratorDryer project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/CodeTectonics/decorator_dryer/blob/main/CODE_OF_CONDUCT.md).

data/lib/decorator_dryer/active_storage_shortcuts.rb

@@ -22,7 +22,13 @@ module DecoratorDryer
           define_method(method_name) do
             attachment = object.send(attr)
 
-            url_for(attachment) if attachment.attached?
+            if attachment.attached?
+              if attachment.content_type == "image/heic"
+                url_for(attachment.variant(format: :jpg).processed)
+              else
+                url_for(attachment)
+              end
+            end
           end
         end
       end

data/lib/decorator_dryer/rspec/matchers.rb

@@ -0,0 +1,125 @@
+# frozen_string_literal: true
+
+module DecoratorDryer
+  module RSpec
+    module Matchers
+      # Matcher to verify that a decorator defines a method to return the name attribute
+      # of a field.
+      #
+      # @example
+      #   expect(user).to format_field_to_name(:role)
+      RSpec::Matchers.define :format_field_to_name do |field|
+        match do |subject|
+          subject.decorate.send("#{field}_name") == subject.send(field).try(:name)
+        end
+        description do
+          "format #{field} to display its name attribute"
+        end
+        failure_message do |subject|
+          "expected #{subject.class.name} decorator to format #{field} with a _name suffix method"
+        end
+      end
+
+      # Matcher to verify that a decorator formats a datetime field with format '%Y-%m-%d %H:%M'.
+      #
+      # @example
+      #   expect(post).to format_field_to_datetime(:published_at)
+      RSpec::Matchers.define :format_field_to_datetime do |field|
+        match do |subject|
+          subject.decorate.send(field) == subject.send(field).try(:strftime, '%Y-%m-%d %H:%M')
+        end
+        description do
+          "format #{field} as a datetime with format '%Y-%m-%d %H:%M'"
+        end
+        failure_message do |subject|
+          "expected #{subject.class.name} decorator to format #{field} as '%Y-%m-%d %H:%M'"
+        end
+      end
+
+      # Matcher to verify that a decorator formats a date field with format '%Y-%m-%d'.
+      #
+      # @example
+      #   expect(event).to format_field_to_date(:start_date)
+      RSpec::Matchers.define :format_field_to_date do |field|
+        match do |subject|
+          subject.decorate.send(field) == subject.send(field).try(:strftime, '%Y-%m-%d')
+        end
+        description do
+          "format #{field} as a date with format '%Y-%m-%d'"
+        end
+        failure_message do |subject|
+          "expected #{subject.class.name} decorator to format #{field} as '%Y-%m-%d'"
+        end
+      end
+
+      # Matcher to verify that a decorator formats a time field with format '%H:%M'.
+      #
+      # @example
+      #   expect(schedule).to format_field_to_time(:start_time)
+      RSpec::Matchers.define :format_field_to_time do |field|
+        match do |subject|
+          subject.decorate.send(field) == subject.send(field).try(:strftime, '%H:%M')
+        end
+        description do
+          "format #{field} as a time with format '%H:%M'"
+        end
+        failure_message do |subject|
+          "expected #{subject.class.name} decorator to format #{field} as '%H:%M'"
+        end
+      end
+
+      # Matcher to verify that a decorator formats a number field with a specific precision.
+      #
+      # @example
+      #   expect(product).to format_field_to_precision_number(:price, 2)
+      RSpec::Matchers.define :format_field_to_precision_number do |field, precision|
+        match do |subject|
+          subject.decorate.send(field) == number_with_precision(subject.send(field), precision: precision)
+        end
+        description do
+          "format #{field} as a number with precision #{precision}"
+        end
+        failure_message do |subject|
+          "expected #{subject.class.name} decorator to format #{field} with precision #{precision}"
+        end
+      end
+
+      # Matcher to verify that a decorator delegates a field to an associated object.
+      #
+      # @example
+      #   expect(order).to delegate_field(:email, :customer)
+      RSpec::Matchers.define :delegate_field do |field, association|
+        match do |subject|
+          subject.decorate.send(field) == subject.send(association).decorate.send(field)
+        end
+        description do
+          "delegate #{field} to #{association}"
+        end
+        failure_message do |subject|
+          "expected #{subject.class.name} to delegate #{field} to #{association}"
+        end
+      end
+
+      # Matcher to verify that a decorator delegates a field to an associated object with
+      # a prefix based on the association name.
+      #
+      # @example
+      #   expect(order).to delegate_field_with_prefix(:email, :customer)
+      RSpec::Matchers.define :delegate_field_with_prefix do |field, association|
+        match do |subject|
+          subject.decorate.send("#{association}_#{field}") ==
+            subject.send(association).decorate.send(field)
+        end
+        description do
+          "delegate #{field} to #{association} with prefix"
+        end
+        failure_message do |subject|
+          "expected #{subject.class.name} to delegate #{field} to #{association}"
+        end
+      end
+    end
+  end
+end
+
+# Auto-include matchers when RSpec is loaded
+::RSpec.configure { |config| config.include DecoratorDryer::RSpec::Matchers }

data/lib/decorator_dryer/rspec.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+require "rspec/core"
+require_relative "rspec/matchers"
+

data/lib/decorator_dryer/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module DecoratorDryer
-  VERSION = "0.1.0"
+  VERSION = "0.1.2"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: decorator_dryer
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.2
 platform: ruby
 authors:
 - Mark Harbison
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-01-01 00:00:00.000000000 Z
+date: 2026-08-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -76,6 +76,8 @@ files:
 - lib/decorator_dryer/active_storage_shortcuts.rb
 - lib/decorator_dryer/configuration.rb
 - lib/decorator_dryer/formatters.rb
+- lib/decorator_dryer/rspec.rb
+- lib/decorator_dryer/rspec/matchers.rb
 - lib/decorator_dryer/shortcuts.rb
 - lib/decorator_dryer/version.rb
 - sig/decorator_dryer.rbs
@@ -105,7 +107,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.21
+rubygems_version: 3.4.19
 signing_key:
 specification_version: 4
 summary: Shortcuts for concise view models.