burgundy 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0135de677253ae6ac1eb432a531a2ad03d9ea7e01d2f5cfecff1af7b3c86a262
-  data.tar.gz: 6d3aef1c8210b1ddcd9f3e4ad48c0531145fa71d7b4b7b8948e51a6b3fa6fd4f
+  metadata.gz: 0f8fdc62f55871b2606a2e02a6be0395a47aea4e24ca409218e400a2beb08486
+  data.tar.gz: 53ffaba2770d98e1eb1d905374a682d85bf8c5fd763a3a0825132b3fd5adf40e
 SHA512:
-  metadata.gz: 990a2fd0d9501979d3d02149d548885ddf37933258fd671f59b98bef918ab6043e359bebb263657c6076cd757fcf7e186641a4f4d48c6d3ec5463a31561ba240
-  data.tar.gz: b7b93b21c5b354ca7f9bc6befae0b5e8701c1aa997df31fd2f2317d3114aadfb009e809920bb7dd1b8ae1c58496ec6ce12b97ff40a684540fdebb68bf97acbf2
+  metadata.gz: 984b3757ea46e6970fdbb39f6b832b3b1fc964cdaf78a302a373c80cf53075cb9ac021abce5ebc2ae4ce6294f97457bad5cf316e98a5d5dbd3bc216a967b9fac
+  data.tar.gz: 869c013191f45f00a7c6ca3fec9deba62f8456ef83bdb1d9054739a336fbd515af8d59b24ad0544e1b0ef31fe5df817b516dc9450977b9b1933552ed7fb7d96e

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+## [0.6.0] - 2020-02-08
+
+- Allow initializing `Burgundy::Item` without passing a delegating object.
+
 ## [0.5.0] - 2019-12-10
 
 - Add `Burgundy::Item#to_json(*)`.
@@ -14,13 +18,15 @@
 
 ### Added
 
-- `Burgundy::Collection` and `Burgundy::Item.wrap` now delegates additional arguments to `Burgundy::Item#initialize`.
+- `Burgundy::Collection` and `Burgundy::Item.wrap` now delegates additional
+  arguments to `Burgundy::Item#initialize`.
 
 ## [0.1.0] - 2015-02-20
 
 ### Added
 
-- Add `Burgundy::Item#attributes`. Now is possible to easily collect attributes as a hash.
+- Add `Burgundy::Item#attributes`. Now is possible to easily collect attributes
+  as a hash.
 
 ### Changed
 
@@ -46,7 +52,8 @@
 
 ### Changed
 
-- `Burgundy::Collection#initialize` doesn't require a wrapping class anymore. This makes ActiveRecord collections easier to work.
+- `Burgundy::Collection#initialize` doesn't require a wrapping class anymore.
+  This makes ActiveRecord collections easier to work.
 
 ## [0.0.1] - 2013-10-24
 

data/README.md

@@ -6,7 +6,8 @@
 [![Gem](https://img.shields.io/gem/v/burgundy.svg)](https://rubygems.org/gems/burgundy)
 [![Gem](https://img.shields.io/gem/dt/burgundy.svg)](https://rubygems.org/gems/burgundy)
 
-A simple wrapper for objects (think of Burgundy as a decorator/presenter) in less than 150 lines.
+A simple wrapper for objects (think of Burgundy as a decorator/presenter) in
+less than 150 lines.
 
 ## Installation
 
@@ -43,7 +44,8 @@ Then you can instantiate it:
 user = UserPresenter.new(User.first)
 ```
 
-The `Burgundy::Item` has access to helper and route methods. Notice that the wrapper item is accessible through the `Burgundy::Item#item` method.
+The `Burgundy::Item` has access to helper and route methods. Notice that the
+wrapper item is accessible through the `Burgundy::Item#item` method.
 
 ```ruby
 class UserPresenter < Burgundy::Item
@@ -53,7 +55,8 @@ class UserPresenter < Burgundy::Item
 end
 ```
 
-You don't have to expose attributes; everything is delegated to the wrapped item.
+You don't have to expose attributes; everything is delegated to the wrapped
+item.
 
 To wrap an entire collection, just use the `Burgundy::Collection` class.
 
@@ -68,9 +71,12 @@ class WorkshopsController < ApplicationController
 end
 ```
 
-or just call `WorkshopPresenter.wrap(Workshop.sorted_by_name)`. Both ways return a `Burgundy::Collection` instance.
+or just call `WorkshopPresenter.wrap(Workshop.sorted_by_name)`. Both ways return
+a `Burgundy::Collection` instance.
 
-You may need to provide additional arguments to the item class. On your collection, all additional arguments will be delegated to the item classe, like the following example:
+You may need to provide additional arguments to the item class. On your
+collection, all additional arguments will be delegated to the item classe, like
+the following example:
 
 ```ruby
 WorkshopPresenter.wrap(Workshop.all, current_user)
@@ -84,13 +90,16 @@ class WorkshopPresenter < Burgundy::Item
 end
 ```
 
-The query will be performed only when needed, usually on the view (easier to cache). The collection is an enumerable object and can be passed directly to the `render` method. Each item will be wrapped by the provided class.
+The query will be performed only when needed, usually on the view (easier to
+cache). The collection is an enumerable object and can be passed directly to the
+`render` method. Each item will be wrapped by the provided class.
 
 ```erb
 <%= render @workshops %>
 ```
 
-Route URLs may require the default url options. Burgundy try to get them from the following objects:
+Route URLs may require the default url options. Burgundy try to get them from
+the following objects:
 
 * `Rails.configuration.action_mailer.default_url_options`
 * `Rails.application.routes.default_url_options`
@@ -103,7 +112,8 @@ config.action_controller.default_url_options = {
 }
 ```
 
-You can map attributes into a hash; I use this strategy for using presenters on API responses (so I can skip adding yet another dependency to my project).
+You can map attributes into a hash; I use this strategy for using presenters on
+API responses (so I can skip adding yet another dependency to my project).
 
 ```ruby
 class UserPresenter < Burgundy::Item

data/lib/burgundy.rb

@@ -2,6 +2,7 @@
 
 require "delegate"
 require "burgundy/version"
+require "burgundy/guard"
 require "burgundy/item"
 require "burgundy/collection"
 require "burgundy/rails" if defined?(Rails)

data/lib/burgundy/guard.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Burgundy
+  class Guard
+    def initialize(item)
+      @item = item
+    end
+
+    def method_missing(name, *) # rubocop:disable Style/MethodMissingSuper
+      class_name = @item.class.name || @item.class.inspect
+
+      error_message = %W[
+        #{class_name} was initialized without a delegating object and
+        didn't implement #{class_name}##{name}
+      ].join(" ")
+
+      raise ArgumentError, "#{error_message}\n#{caller[1]}"
+    end
+
+    def respond_to_missing?(*)
+      true
+    end
+  end
+end

data/lib/burgundy/item.rb

@@ -29,9 +29,9 @@ module Burgundy
       @attributes
     end
 
-    def initialize(item)
-      @item = item
-      __setobj__(item)
+    def initialize(item = nil)
+      @item = item || Guard.new(self)
+      __setobj__(@item)
     end
 
     def attributes

data/lib/burgundy/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Burgundy
-  VERSION = "0.5.0"
+  VERSION = "0.6.0"
 end

data/test/unit/burgundy_test.rb

@@ -11,6 +11,37 @@ class BurgundyTest < Minitest::Test
     assert_equal "HELLO", item.upcase
   end
 
+  test "allows initializing item without a delegating object" do
+    item = wrapper.new
+
+    assert item
+  end
+
+  test "raises exception when calling methods without delegating object" do
+    wrapper = Class.new(Burgundy::Item) do
+      def self.name
+        "MyDecorator"
+      end
+    end
+
+    item = wrapper.new
+
+    error = assert_raises(ArgumentError) { item.missing_attribute }
+
+    error_message = %w[
+      MyDecorator was initialized without a delegating object and didn't
+      implement MyDecorator#missing_attribute
+    ].join(" ")
+
+    line_reference =
+      "#{__FILE__}:29:in `block (2 levels) in <class:BurgundyTest>'"
+
+    error_message = "#{error_message}\n#{line_reference}"
+
+    assert_equal ArgumentError, error.class
+    assert_equal error_message, error.message
+  end
+
   test "wraps items" do
     items = wrapper.wrap([1, 2, 3])
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: burgundy
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Nando Vieira
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-12-10 00:00:00.000000000 Z
+date: 2020-02-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -141,6 +141,7 @@ files:
 - burgundy.gemspec
 - lib/burgundy.rb
 - lib/burgundy/collection.rb
+- lib/burgundy/guard.rb
 - lib/burgundy/item.rb
 - lib/burgundy/rails.rb
 - lib/burgundy/version.rb
@@ -204,7 +205,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.1.2
 signing_key: 
 specification_version: 4
 summary: A simple wrapper for objects in less than 100 lines.