pragma-decorator 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 7fbddf33eb638f9dc7cc36f989bc22ffea969ee5
+  data.tar.gz: 363a2780b6a8316b3330eb7756f1cda1e5a768cf
+SHA512:
+  metadata.gz: 34b21171d3f3961379083f634e2178d6b6166d7c75b0d5c50ddb6a5a6ac75390728988beaeb4a31a7ca1a9c45f0436ea32809d84ab13fd015a3866c9323054b6
+  data.tar.gz: 1f5a2172ef77a3261676d119deb273bd9b75962db264a3787fa0f3feb600390ac3fb9d280d226e2bc83919075f66eb82ce1ab9ce03f5ef38db044bd195a62aeb

data/.gitignore

@@ -0,0 +1,10 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+/spec/examples.txt

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,84 @@
+require: rubocop-rspec
+
+AllCops:
+  TargetRubyVersion: 2.3
+  Include:
+    - '**/Gemfile'
+    - '**/Rakefile'
+  Exclude:
+   - 'bin/*'
+   - 'db/**/*'
+   - 'vendor/bundle/**/*'
+   - 'spec/spec_helper.rb'
+   - 'spec/rails_helper.rb'
+   - 'spec/support/**/*'
+   - 'config/**/*'
+   - '**/Rakefile'
+   - '**/Gemfile'
+
+RSpec/DescribeClass:
+  Exclude:
+    - 'spec/requests/**/*'
+
+Style/BlockDelimiters:
+  Exclude:
+    - 'spec/**/*'
+
+Style/AlignParameters:
+  EnforcedStyle: with_fixed_indentation
+
+Style/ClosingParenthesisIndentation:
+  Enabled: false
+
+Metrics/LineLength:
+  Max: 100
+  AllowURI: true
+
+Style/FirstParameterIndentation:
+  Enabled: false
+
+Style/MultilineMethodCallIndentation:
+  EnforcedStyle: indented
+
+Style/IndentArray:
+  EnforcedStyle: consistent
+
+Style/IndentHash:
+  EnforcedStyle: consistent
+
+Style/SignalException:
+  EnforcedStyle: semantic
+
+Style/BracesAroundHashParameters:
+  EnforcedStyle: context_dependent
+
+Lint/EndAlignment:
+  AlignWith: variable
+  AutoCorrect: true
+
+Style/AndOr:
+  EnforcedStyle: conditionals
+
+Style/MultilineBlockChain:
+  Enabled: false
+
+RSpec/NamedSubject:
+  Enabled: false
+
+RSpec/ExampleLength:
+  Enabled: false
+
+Style/MultilineMethodCallBraceLayout:
+  Enabled: false
+
+Metrics/MethodLength:
+  Enabled: false
+
+Metrics/AbcSize:
+  Enabled: false
+
+Metrics/PerceivedComplexity:
+  Enabled: false
+
+Metrics/CyclomaticComplexity:
+  Enabled: false

data/.travis.yml

@@ -0,0 +1,9 @@
+rvm:
+  - 2.3.0
+before_install:
+  - gem update --system
+  - gem update bundler
+  - gem cleanup bundler
+branches:
+  only:
+    - master

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in pragma-decorator.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Alessandro Desantis
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,252 @@
+# Pragma::Decorator
+
+[![Build Status](https://img.shields.io/travis/pragmarb/pragma-decorator.svg?maxAge=3600&style=flat-square)](https://travis-ci.org/pragmarb/pragma-decorator)
+[![Dependency Status](https://img.shields.io/gemnasium/pragmarb/pragma-decorator.svg?maxAge=3600&style=flat-square)](https://gemnasium.com/github.com/pragmarb/pragma-decorator)
+[![Code Climate](https://img.shields.io/codeclimate/github/pragmarb/pragma-decorator.svg?maxAge=3600&style=flat-square)](https://codeclimate.com/github/pragmarb/pragma-decorator)
+[![Coveralls](https://img.shields.io/coveralls/pragmarb/pragma-decorator.svg?maxAge=3600&style=flat-square)](https://coveralls.io/github/pragmarb/pragma-decorator)
+
+Decorators are a way to easily convert your API resources to JSON with minimum hassle.
+
+They are built on top of [ROAR](https://github.com/apotonick/roar) but provide some useful helpers
+for rendering collections, including pagination metadata and expanding associations.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'pragma-decorator'
+```
+
+And then execute:
+
+```console
+$ bundle
+```
+
+Or install it yourself as:
+
+```console
+$ gem install pragma-decorator
+```
+
+## Usage
+
+Creating a decorator is as simple as inheriting from `Pragma::Decorator::Base`:
+
+```ruby
+module API
+  module V1
+    module User
+      module Decorator
+        class Resource < Pragma::Decorator::Base
+          property :id
+          property :email
+          property :full_name
+        end
+      end
+    end
+  end
+end
+```
+
+Just instantiate the decorator by passing it an object to decorate, then call `#to_hash` or
+`#to_json`:
+
+```ruby
+decorator = API::V1::User::Decorator::Resource.new(user)
+decorator.to_json
+```
+
+This will produce the following JSON:
+
+```json
+{
+  "id": 1,
+  "email": "jdoe@example.com",
+  "full_name": "John Doe"
+}
+```
+
+Since Pragma::Decorator is built on top of [ROAR](https://github.com/apotonick/roar) (which, in
+turn, is built on top of [Representable](https://github.com/apotonick/representable)), you should
+consult their documentation for the basic usage of decorators; the rest of this section only covers
+the features provided specifically by Pragma::Decorator.
+
+### Object types
+
+It is recommended that decorators expose the type of the decorated object. You can achieve this
+with the `Type` mixin:
+
+```ruby
+module API
+  module V1
+    module User
+      module Decorator
+        class Resource < Pragma::Decorator::Base
+          feature Pragma::Decorator::Type
+        end
+      end
+    end
+  end
+end
+```
+
+This would result in the following representation:
+
+```json
+{
+  "type": "user",
+  "...": "...""
+}
+```
+
+You can also set a custom type name (just make sure to use it consistently!):
+
+```ruby
+module API
+  module V1
+    module User
+      module Decorator
+        class Resource < Pragma::Decorator::Base
+          def type
+            :custom_type
+          end
+        end
+      end
+    end
+  end
+end
+```
+
+Note: `array` is already overridden with the more language-agnostic `list`.
+
+### Associations
+
+`Pragma::Decorator::Association` allows you to define associations in your decorator (currently,
+only `belongs_to`/`has_one` associations are supported):
+
+```ruby
+module API
+  module V1
+    module Invoice
+      module Decorator
+        class Resource < Pragma::Decorator::Base
+          feature Pragma::Decorator::Association
+
+          belongs_to :customer
+        end
+      end
+    end
+  end
+end
+```
+
+Rendering an invoice will now create the following representation:
+
+```json
+{
+  "customer": {
+    "id": 19
+  }
+}
+```
+
+Not impressed? Just wait.
+
+We also support association expansion through an interface similar to the one provided by the
+[Stripe API](https://stripe.com/docs/api/curl#expanding_objects). You can define which associations
+are expandable in the decorator:
+
+```ruby
+module API
+  module V1
+    module Invoice
+      module Decorator
+        class Resource < Pragma::Decorator::Base
+          feature Pragma::Decorator::Association
+
+          belongs_to :customer, expandable: true
+        end
+      end
+    end
+  end
+end
+```
+
+You can now pass `expand[]=customer` as a request parameter and have the `customer` property
+expanded into a full object!
+
+```json
+{
+  "customer": {
+    "id": 19,
+    "...": "..."
+  }
+}
+```
+
+This also works for nested associations. For instance, if the customer has a `company` association
+marked as expandable, you can pass `expand[]=customer&expand[]=customer.company` to get that
+association expanded too.
+
+In order for association expansion to work, you will have to pass the associations to expand to the
+representer as a user option:
+
+```ruby
+decorator = API::V1::Invoice::Decorator::Resource.new(invoice)
+decorator.to_json(user_options: {
+  expand: ['customer', 'customer.company', 'customer.company.contact']
+})
+```
+
+Here's a list of options accepted when defining an association:
+
+Name | Type | Default | Meaning
+---- | ---- | ------- | -------
+`expandable` | Boolean | `false` | Whether this association is expandable by consumers. Attempting to expand a non-expandable association will raise a `UnexpandableError`.
+`decorator` | Class | - | If provided, decorates the expanded object with this decorator. Otherwise, simply calls `#to_hash` on the object to get a representable hash.
+`render_nil` | Boolean | `false` | Whether the property should be rendered at all when it is `nil`.
+`exec_context` | Symbol | `:decorated` | Whether to call the getter on the decorator (`:decorator`) or the decorated object (`:decorated`).
+
+### Timestamps
+
+[UNIX time](https://en.wikipedia.org/wiki/Unix_time) is your safest bet when rendering/parsing
+timestamps in your API, as it doesn't require a timezone indicator (the timezone is always UTC).
+
+You can use the `Timestamp` mixin for converting `Time` instances to UNIX times:
+
+```ruby
+module API
+  module V1
+    module User
+      module Decorator
+        class Resource < Pragma::Decorator::Base
+          feature Pragma::Decorator::Timestamp
+
+          timestamp :created_at
+        end
+      end
+    end
+  end
+end
+```
+
+This will render a user like this:
+
+```json
+{
+  "type": "user",
+  "created_at": 1480287994
+}
+```
+
+The `#timestamp` method supports all the options supported by `#property` (except for `:as`).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/pragmarb/pragma-decorator.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "pragma/decorator"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/pragma/decorator/association/binding.rb

@@ -0,0 +1,116 @@
+# frozen_string_literal: true
+module Pragma
+  module Decorator
+    module Association
+      # Links an association definition to a specific decorator instance, allowing to render it.
+      #
+      # @author Alessandro Desantis
+      class Binding
+        # @!attribute [r] reflection
+        #   @return [Reflection] the association reflection
+        #
+        # @!attribute [r] decorator
+        #   @return [Pragma::Decorator::Base] the decorator instance
+        attr_reader :reflection, :decorator
+
+        # Initializes the binding.
+        #
+        # @param reflection [Reflection] the association reflection
+        # @param decorator [Pragma::Decorator::Base] the decorator instance
+        def initialize(reflection:, decorator:)
+          @reflection = reflection
+          @decorator = decorator
+        end
+
+        # Returns the associated object.
+        #
+        # @return [Object]
+        def associated_object
+          case reflection.options[:exec_context]
+          when :decorated
+            decorator.decorated.send(reflection.property)
+          when :decorator
+            decorator.send(reflection.property)
+          end
+        end
+
+        # Returns the unexpanded hash for the associated object (i.e. a hash with only the +id+
+        # property).
+        #
+        # @return [Hash]
+        def unexpanded_hash
+          return unless associated_object
+
+          {
+            id: associated_object.id
+          }
+        end
+
+        # Returns the expanded hash for the associated object.
+        #
+        # If a decorator was specified for the association, first decorates the associated object,
+        # then calls +#to_hash+ to render it as a hash.
+        #
+        # If no decorator was specified, calls +#as_json+ on the associated object.
+        #
+        # In any case, passes all nested associations as the +expand+ user option of the method
+        # called.
+        #
+        # @param expand [Array<String>] the associations to expand
+        #
+        # @return [Hash]
+        #
+        # @raise [UnexpandableError] if the association is not expandable
+        def expanded_hash(expand)
+          fail UnexpandableError, reflection unless reflection.expandable?
+
+          return unless associated_object
+
+          options = {
+            user_options: {
+              expand: flatten_expand(expand)
+            }
+          }
+
+          if reflection.options[:decorator]
+            reflection.options[:decorator].new(associated_object).to_hash(options)
+          else
+            associated_object.as_json(options)
+          end
+        end
+
+        # Renders the unexpanded or expanded associations, depending on the +expand+ user option
+        # passed to the decorator.
+        #
+        # @param expand [Array<String>] the associations to expand
+        #
+        # @return [Hash|Pragma::Decorator::Base]
+        def render(expand)
+          return unless associated_object
+
+          expand ||= []
+
+          if expand.any? { |value| value.to_s == reflection.property.to_s }
+            expanded_hash(expand)
+          else
+            unexpanded_hash
+          end
+        end
+
+        private
+
+        def flatten_expand(expand)
+          expected_beginning = "#{reflection.property}."
+
+          expand.reject { |value| value.to_s == reflection.property.to_s }.map do |value|
+            if value.start_with?(expected_beginning)
+              value.sub(expected_beginning, '')
+            else
+              value
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/pragma/decorator/association/reflection.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+module Pragma
+  module Decorator
+    module Association
+      # Holds the information about an association.
+      #
+      # @author Alessandro Desantis
+      class Reflection
+        # @!attribute [r] type
+        #   @return [Symbol] the type of the association
+        #
+        # @!attribute [r] property
+        #   @return [Symbol] the property holding the associated object
+        #
+        # @!attribute [r] options
+        #   @return [Hash] additional options for the association
+        attr_reader :type, :property, :options
+
+        # Initializes the association.
+        #
+        # @param type [Symbol] the type of the association
+        # @param property [Symbol] the property holding the associated object
+        # @param options [Hash] additional options
+        #
+        # @option options [Boolean] :expandable (`false`) whether the association is expandable
+        # @option options [Class] :decorator the decorator to use for the associated object
+        # @option options [Boolean] :render_nil (`true`) whether to render a +nil+ association
+        # @option options [Symbol] :exec_context (`decorated`) whether to call the getter on the
+        #   decorator (+decorator+) or the decorated object (+decorated+)
+        def initialize(type, property, **options)
+          @type = type
+          @property = property
+          @options = options
+
+          normalize_options
+          validate_options
+        end
+
+        # Returns whether the association is expandable.
+        #
+        # @return [Boolean]
+        def expandable?
+          options[:expandable]
+        end
+
+        private
+
+        def normalize_options
+          @options = {
+            expandable: false,
+            render_nil: false,
+            exec_context: :decorated
+          }.merge(options).tap do |opts|
+            opts[:exec_context] = opts[:exec_context].to_sym
+          end
+        end
+
+        def validate_options
+          unless [:decorator, :decorated].include?(options[:exec_context])
+            fail(
+              ArgumentError,
+              "'#{options[:exec_context]}' is not a valid value for :exec_context."
+            )
+          end
+        end
+      end
+    end
+  end
+end

data/lib/pragma/decorator/association/unexpandable_error.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+module Pragma
+  module Decorator
+    module Association
+      # This error is raised when expansion of an unexpandable association is attempted.
+      #
+      # @author Alessandro Desantis
+      class UnexpandableError < StandardError
+        # Initializes the error.
+        #
+        # @param reflection [Reflection] the unexpandable association
+        def initialize(reflection)
+          super "Association '#{reflection.property}' cannot be expanded."
+        end
+      end
+    end
+  end
+end

data/lib/pragma/decorator/association.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+module Pragma
+  module Decorator
+    # Adds association expansion to decorators.
+    #
+    # @author Alessandro Desantis
+    module Association
+      def self.included(klass)
+        klass.extend ClassMethods
+
+        klass.class_eval do
+          @associations = {}
+
+          def self.associations
+            @associations
+          end
+        end
+      end
+
+      # Inizializes the decorator and bindings for all the associations.
+      #
+      # @see Association::Binding
+      def initialize(*)
+        super
+
+        @association_bindings = {}
+        self.class.associations.each_pair do |property, reflection|
+          @association_bindings[property] = Binding.new(reflection: reflection, decorator: self)
+        end
+      end
+
+      module ClassMethods # rubocop:disable Style/Documentation
+        # Defines a +belongs_to+ association.
+        #
+        # See {Association::Reflection#initialize} for the list of available options.
+        #
+        # @param property [Symbol] the property containing the associated object
+        # @param options [Hash] the options of the association
+        def belongs_to(property, options = {})
+          define_association :belongs_to, property, options
+        end
+
+        # Defines a +has_one+ association.
+        #
+        # See {Association::Reflection#initialize} for the list of available options.
+        #
+        # @param property [Symbol] the property containing the associated object
+        # @param options [Hash] the options of the association
+        def has_one(property, options = {}) # rubocop:disable Style/PredicateName
+          define_association :has_one, property, options
+        end
+
+        private
+
+        def define_association(type, property, options = {})
+          create_association_definition(type, property, options)
+          create_association_getter(property)
+          create_association_property(property)
+        end
+
+        def create_association_definition(type, property, options)
+          @associations[property.to_sym] = Reflection.new(type, property, options)
+        end
+
+        def create_association_getter(property)
+          class_eval <<~RUBY
+            private def _#{property}_association
+              @association_bindings[:#{property}].render(user_options[:expand])
+            end
+          RUBY
+        end
+
+        def create_association_property(property_name)
+          options = {
+            exec_context: :decorator,
+            as: property_name
+          }.tap do |opts|
+            if @associations[property_name].options.key?(:render_nil)
+              opts[:render_nil] = @associations[property_name].options[:render_nil]
+            end
+          end
+
+          property("_#{property_name}_association", options)
+        end
+      end
+    end
+  end
+end

data/lib/pragma/decorator/base.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+require 'roar/decorator'
+require 'roar/json'
+
+module Pragma
+  module Decorator
+    # This is the base decorator that all your resource-specific decorators should extend from.
+    #
+    # It is already configured to render your resources in JSON.
+    #
+    # @author Alessandro Desantis
+    class Base < Roar::Decorator
+      feature Roar::JSON
+
+      # Overrides Representable's default +#to_hash+ to save the last options the method was run
+      # with.
+      #
+      # This allows accessing the options from property getters and is required by {Association}.
+      #
+      # @param options [Hash]
+      #
+      # @return [Hash]
+      def to_hash(options = {}, *args)
+        @last_options = options
+        super(options, *args)
+      end
+
+      protected
+
+      # Returns the options +#to_hash+ was last run with.
+      #
+      # @return [Hash]
+      def options
+        @last_options
+      end
+
+      # Returns the user options +#to_hash+ was last run with.
+      #
+      # @return [Hash]
+      #
+      # @see #options
+      def user_options
+        @last_options[:user_options] || {}
+      end
+    end
+  end
+end

data/lib/pragma/decorator/timestamp.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+module Pragma
+  module Decorator
+    # Supports rendering timestamps as UNIX times.
+    #
+    # @author Alessandro Desantis
+    module Timestamp
+      def self.included(klass)
+        klass.extend ClassMethods
+      end
+
+      module ClassMethods # rubocop:disable Style/Documentation
+        # Defines a timestamp property which will be rendered as UNIX time.
+        #
+        # @param name [Symbol] the name of the property
+        # @param options [Hash] the options of the property
+        def timestamp(name, options = {})
+          create_timestamp_getter(name, options)
+          create_timestamp_property(name, options)
+        end
+
+        private
+
+        def create_timestamp_getter(name, options = {})
+          define_method "_#{name}_timestamp" do
+            if options[:exec_context] && options[:exec_context].to_sym == :decorator
+              send(name)
+            else
+              decorated.send(name)
+            end&.to_i
+          end
+        end
+
+        def create_timestamp_property(name, options = {})
+          property "_#{name}_timestamp", options.merge(
+            as: name,
+            exec_context: :decorator
+          )
+        end
+      end
+    end
+  end
+end

data/lib/pragma/decorator/type.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+module Pragma
+  module Decorator
+    # Adds a +type+ property containing the machine-readable type of the represented object.
+    #
+    # @author Alessandro Desantis
+    module Type
+      TYPE_OVERRIDES = {
+        array: 'list'
+      }.freeze
+
+      def self.included(klass)
+        klass.class_eval do
+          property :type, exec_context: :decorator, render_nil: false
+        end
+      end
+
+      # Returns the type of the decorated object (i.e. its underscored class name).
+      #
+      # @return [String]
+      def type
+        type = decorated.class.name
+          .gsub(/([A-Z]+)([A-Z][a-z])/, '\1_\2')
+          .gsub(/([a-z\d])([A-Z])/, '\1_\2')
+          .downcase
+
+        TYPE_OVERRIDES[type.to_sym] || type
+      end
+    end
+  end
+end

data/lib/pragma/decorator/version.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+module Pragma
+  module Decorator
+    VERSION = '0.1.0'
+  end
+end

data/lib/pragma/decorator.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+require 'roar'
+
+require 'pragma/decorator/version'
+require 'pragma/decorator/base'
+require 'pragma/decorator/association'
+require 'pragma/decorator/association/reflection'
+require 'pragma/decorator/association/binding'
+require 'pragma/decorator/association/unexpandable_error'
+require 'pragma/decorator/timestamp'
+require 'pragma/decorator/type'
+
+module Pragma
+  # Represent your API resources in JSON with minimum hassle.
+  #
+  # @author Alessandro Desantis
+  module Decorator
+  end
+end

data/pragma-decorator.gemspec

@@ -0,0 +1,32 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'pragma/decorator/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'pragma-decorator'
+  spec.version       = Pragma::Decorator::VERSION
+  spec.authors       = ['Alessandro Desantis']
+  spec.email         = ['desa.alessandro@gmail.com']
+
+  spec.summary       = 'Convert your API resources into JSON with minimum hassle.'
+  spec.homepage      = 'https://github.com/pragmarb/pragma-decorator'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_dependency 'roar', '~> 1.0'
+  spec.add_dependency 'multi_json', '~> 1.12'
+
+  spec.add_development_dependency 'bundler'
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'rspec'
+  spec.add_development_dependency 'rubocop'
+  spec.add_development_dependency 'rubocop-rspec'
+  spec.add_development_dependency 'coveralls'
+end

metadata

@@ -0,0 +1,176 @@
+--- !ruby/object:Gem::Specification
+name: pragma-decorator
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Alessandro Desantis
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2016-12-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: roar
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.12'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.12'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: coveralls
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: 
+email:
+- desa.alessandro@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- ".travis.yml"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- lib/pragma/decorator.rb
+- lib/pragma/decorator/association.rb
+- lib/pragma/decorator/association/binding.rb
+- lib/pragma/decorator/association/reflection.rb
+- lib/pragma/decorator/association/unexpandable_error.rb
+- lib/pragma/decorator/base.rb
+- lib/pragma/decorator/timestamp.rb
+- lib/pragma/decorator/type.rb
+- lib/pragma/decorator/version.rb
+- pragma-decorator.gemspec
+homepage: https://github.com/pragmarb/pragma-decorator
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.2
+signing_key: 
+specification_version: 4
+summary: Convert your API resources into JSON with minimum hassle.
+test_files: []