feat: add parse_to_return_type macro

README.md

@@ -43,7 +43,7 @@ To become responsible, prefix any response or method that returns a response wit
 response = ~HTTP::Client.get("https://www.example.com")
 ```
 
-Error conditions are clear:
+This allows a clear way to express what should happen when errors occur.
 ```crystal
 response.on_server_error do
   # oh noes
@@ -57,6 +57,14 @@ response[:message]
 # => hello world
 ```
 
+Macros are also provided to keep common tasks clean, clear and concise.
+```crystal
+def example_request_wrapper : { message: String }
+  Responsible.parse_to_return_type do
+    HTTP::Client.get("https://www.example.com")
+  end
+end
+```
 ---
 
 Responsible Responses™ maintain all existing functionality of a vanilla response object.

src/responsible.cr

@@ -25,6 +25,19 @@ module Responsible
       {{ block.body if block.is_a? AstNode }}
     end
   end
+
+  # Wraps a expression that returns a supported response object into a
+  # `Responsible::Response` before attempting to parse this out into the return
+  # type of the surrounding method.
+  #
+  # This may be 
+  macro parse_to_return_type(&block)
+    \{{ raise "no return type on method" if @def.return_type.is_a? Nop }}
+    %response = begin
+      {{ block.body }}
+    end
+    Responsible::Response.new(%response).parse_to(\{{ @def.return_type }})
+  end
 end
 
 Responsible.support HTTP::Client::Response