timetree 0.0.1 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bd2bf9fe5f866b70a0d08f66a937091892d8d4f3ab09002887eeab9cb6695158
-  data.tar.gz: d27d7eda7746d390feee7f167226ef444e1ed9a0e837cf9ad4510aa577cba340
+  metadata.gz: f6acdee0d0822340b25b56705ae9ffb72e031a831c44755b87004471bb015c65
+  data.tar.gz: cf2be6cc1d35cdb59d686b6caed4fd967919369eafceb3867bd0cf5f0459d37a
 SHA512:
-  metadata.gz: 5d8e892ce5c8a12ca0629cab12f15228a28dc2df3d5d0abce51570c3714838aa4a05da1c96575972e4a0af3197057cf2780380d16e31ec364b58513558de5e2c
-  data.tar.gz: c793202b5743b3818fea43bdc1ca6c2b44483d197098d0191181f5bada1dd27a862f6675fa183d959eee696294ba8e6bb680fef1f8ae9753542409ba43314a3b
+  metadata.gz: f10a43690969abeae928366c13face88ed28fd3507e6fcd1b708e8bca0d61bc7772dbeaf9d9bff92d3bd24ac55e122aa5a6d84595aa7f8aa312581f682b8d491
+  data.tar.gz: 91a90869f53fde95f56cd7d0f987d7b376fb5db7ddcff15cbf86b66e1b6bedf90110f158ec4a9eb8b0893934d825c07af1a73f24e8f460f5488fe331fc7682af

data/README.md

@@ -1,4 +1,4 @@
-# TimeTree Api Client
+# Simple TimeTree apis client
 
 [![Gem Version](https://badge.fury.io/rb/timetree.svg)](http://badge.fury.io/rb/timetree)
 
@@ -30,14 +30,64 @@ Set `access_token` to the value you got by above:
 ```ruby
 # using configure
 TimeTree.configure do |config|
-  config.access_token = '<YOUR_ACCESS_TOKEN>'
+  config.token = '<YOUR_ACCESS_TOKEN>'
 end
 client = TimeTree::Client.new
 
 # using initializer
 client = TimeTree::Client.new('<YOUR_ACCESS_TOKEN>')
 
-# TODO
+# get a current user's information
+user = client.current_user
+=> #<TimeTree::User id:xxx_u001>
+user.name
+=> "USER Name 001"
+
+# get current user's calendars
+cals = client.calendars
+=> [#<TimeTree::Calendar id:xxx_cal001>, #<TimeTree::Calendar id:xxx_cal002>, ...]
+
+cal = cals.first
+cal.name
+=> "Calendar Name 001"
+
+# get upcoming events on the calendar
+evs = cal.upcoming_events
+=> [#<TimeTree::Event id:xxx_ev001>, #<TimeTree::Event id:xxx_ev002>, ...]
+ev = evs.first
+ev.title
+=> "Event Name 001"
+
+# updates an event
+ev.title += ' Updated'
+ev.start_at = Time.parse('2020-06-20 09:00 +09:00')
+ev.end_at = Time.parse('2020-06-20 10:00 +09:00')
+ev.update
+=> #<TimeTree::Event id:xxx_ev001>
+
+# creates an event
+copy_ev = ev.dup
+new_ev = copy_ev.create
+=> #<TimeTree::Event id:xxx_newev001>
+
+# deletes an event
+ev.delete
+=> true
+
+# creates comment to an event
+ev.create_comment 'HOGE HOGE message.'
+=> #<TimeTree::Activity id:xxx_act001>
+
+# check apis error response
+begin
+  ev.delete
+  ev.delete # 404 Error occured.
+rescue TimeTree::ApiError => e
+  e
+  => #<TimeTree::ApiError title:Not Found, status:404>
+  e.response
+  => #<Faraday::Response>
+end
 ```
 
 ## Contributing

data/lib/timetree.rb

@@ -1,16 +1,16 @@
 # frozen_string_literal: true
 
-Dir[
-  File.join(
-    File.dirname(__FILE__),
-    'timetree',
-    '*'
-  )
-].sort.each do |f|
-  require f
-end
+require 'zeitwerk'
+loader = Zeitwerk::Loader.for_gem
+loader.inflector.inflect(
+  'timetree' => 'TimeTree'
+)
+loader.setup
 
+# module for TimeTree apis client
 module TimeTree
+  class Error < StandardError
+  end
   class << self
     def configure
       yield configuration
@@ -20,7 +20,4 @@ module TimeTree
       @configuration ||= Configuration.new
     end
   end
-
-  class Error < StandardError
-  end
 end

data/lib/timetree/activity.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module TimeTree
+  # Model for TimeTree comment.
+  class Activity < BaseModel
+    # @return [String]
+    attr_accessor :content
+    # @return [Time]
+    attr_accessor :updated_at
+    # @return [Time]
+    attr_accessor :created_at
+    # calendar's id.
+    # @return [String]
+    attr_accessor :calendar_id
+    # event's id.
+    # @return [String]
+    attr_accessor :event_id
+
+    TIME_FIELDS = %i[updated_at created_at].freeze
+
+    #
+    # Creates a comment to the associated event.
+    #
+    # @return [TimeTree::Activity]
+    # @raise [TimeTree::Error] if @client is not set.
+    # @raise [TimeTree::Error] if the calendar_id property is not set.
+    # @raise [TimeTree::Error] if the event_id property is not set.
+    # @raise [TimeTree::ApiError] if the http response status will not success.
+    # @since 0.0.1
+    def create
+      raise Error, '@client is nil.' if @client.nil?
+      raise Error, 'calendar_id is required.' if calendar_id.nil?
+      raise Error, 'event_id is required.' if event_id.nil?
+
+      @client.create_activity calendar_id, event_id, data_params
+    end
+
+    #
+    # convert to a TimeTree request body format.
+    #
+    # @return [Hash]
+    # @since 0.0.1
+    def data_params
+      {
+        data: { attributes: { content: content } }
+      }
+    end
+  end
+end

data/lib/timetree/api_error.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module TimeTree
+  # TimeTree apis client error object.
+  class ApiError < StandardError
+    # @return [Faraday::Response]
+    attr_reader :response
+    # @return [String]
+    attr_reader :type
+    # @return [String]
+    attr_reader :title
+    # @return [String]
+    attr_reader :errors
+    # @return [Integer]
+    attr_reader :status
+
+    def initialize(response)
+      @response = response
+      @type = response.body[:type]
+      @title = response.body[:title]
+      @errors = response.body[:errors]
+      @status = response.status
+    end
+
+    def inspect
+      "\#<#{self.class}:#{object_id} title:#{@title}, status:#{@status}>"
+    end
+  end
+end

data/lib/timetree/base_model.rb

@@ -0,0 +1,138 @@
+# frozen_string_literal: true
+
+require 'time'
+
+module TimeTree
+  # TimeTree base model object.
+  class BaseModel
+    # @return [Array<Hash<String,String>>]
+    attr_accessor :relationships
+    # @return [String]
+    attr_reader :id
+    # @return [String]
+    attr_reader :type
+
+    # @param data [Hash]
+    # TimeTree apis's response data.
+    # @param included [Hash]
+    # @param client [TimeTree::Client]
+    # @return [TimeTree::User, TimeTree::Label, TimeTree::Calendar, TimeTree::Event, TimeTree::Activity]
+    # A TimeTree model object that be based on the type.
+    # @raise [TimeTree::Error] if the type property is not set.
+    # @since 0.0.1
+    def self.to_model(data, included: nil, client: nil)
+      id = data[:id]
+      type = data[:type]
+      raise Error, 'type is required.' if type.nil?
+
+      attributes = data[:attributes] || {}
+      relationships = data[:relationships] || {}
+      params = {
+        id: id,
+        type: type,
+        client: client,
+        attributes: attributes,
+        relationships: relationships,
+        included: included
+      }
+
+      case type
+      when 'user'
+        User.new(**params)
+      when 'label'
+        Label.new(**params)
+      when 'calendar'
+        Calendar.new(**params)
+      when 'event'
+        Event.new(**params)
+      when 'activity'
+        Activity.new(**params)
+      end
+    end
+
+    def initialize(id:, type:, client: nil, attributes: nil, relationships: nil, included: nil)
+      @id = id
+      @type = type
+      @client = client
+      set_attributes attributes
+      set_relationships relationships, included
+    end
+
+    def inspect
+      "\#<#{self.class}:#{object_id} id:#{id}>"
+    end
+
+    private
+
+    def to_model(data)
+      self.class.to_model data, client: @client
+    end
+
+    def set_attributes(attributes)
+      return unless attributes.is_a? Hash
+      return if attributes.empty?
+
+      setter_methods = self.class.instance_methods.select { |method| method.to_s.end_with? '=' }
+      attributes.each do |key, value|
+        setter = "#{key.to_sym}=".to_sym
+        next unless setter_methods.include? setter
+
+        if defined?(self.class::TIME_FIELDS) && self.class::TIME_FIELDS.include?(key)
+          value = Time.parse value
+        end
+        instance_variable_set "@#{key}", value
+      end
+    end
+
+    def set_relationships(relationships, included)
+      return unless relationships.is_a? Hash
+      return if relationships.empty?
+      return unless defined? self.class::RELATIONSHIPS
+      return if self.class::RELATIONSHIPS.empty?
+
+      self.class::RELATIONSHIPS.each do |key|
+        relation = relationships[key]
+        next unless relation
+        next unless relation[:data]
+
+        @relationships ||= {}
+        @relationships[key] = relation[:data]
+      end
+
+      return if included.nil?
+      return unless included.is_a? Array
+      return if included.empty?
+
+      set_relationship_data_if_included(included)
+    end
+
+    def set_relationship_data_if_included(included)
+      @_relation_data_dic = {}
+      included.each do |data|
+        item = to_model(data)
+        next unless item
+
+        @_relation_data_dic[item.type] ||= {}
+        @_relation_data_dic[item.type][item.id] = item
+      end
+      detect_relation_data = lambda { |type, id|
+        return unless @_relation_data_dic[type]
+
+        @_relation_data_dic[type][id]
+      }
+      @relationships.each do |key, id_data|
+        relation_data = nil
+        if id_data.is_a? Array
+          relation_data = []
+          id_data.each do |d|
+            item = detect_relation_data.call(d[:type], d[:id])
+            relation_data << item if item
+          end
+        elsif id_data.is_a? Hash
+          relation_data = detect_relation_data.call(id_data[:type], id_data[:id])
+        end
+        instance_variable_set "@#{key}", relation_data if relation_data
+      end
+    end
+  end
+end

data/lib/timetree/calendar.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+module TimeTree
+  # Model for TimeTree calendar.
+  class Calendar < BaseModel
+    # @return [String]
+    attr_accessor :name
+    # @return [String]
+    attr_accessor :description
+    # @return [String]
+    attr_accessor :color
+    # @return [Integer]
+    attr_accessor :order
+    # @return [String]
+    attr_accessor :image_url
+    # @return [Time]
+    attr_accessor :created_at
+
+    TIME_FIELDS = %i[created_at].freeze
+    RELATIONSHIPS = %i[labels members].freeze
+
+    #
+    # Get the event's information.
+    #
+    # @param event_id [String]
+    # event's id.
+    # @return [TimeTree::Event]
+    # @raise [TimeTree::Error] if @client is not set.
+    # @raise [TimeTree::ApiError] if the http response status will not success.
+    # @since 0.0.1
+    def event(event_id)
+      raise Error, '@client is nil.' if @client.nil?
+
+      @client.event id, event_id
+    end
+
+    #
+    # Get the events' information after a request date.
+    #
+    # @param days [Integer]
+    # The number of days to get.
+    # @param timezone [String]
+    # Timezone.
+    # @return [Array<TimeTree::Event>]
+    # @raise [TimeTree::Error] if @client is not set.
+    # @raise [TimeTree::ApiError] if the http response status will not success.
+    # @since 0.0.1
+    def upcoming_events(days: 7, timezone: 'UTC')
+      raise Error, '@client is nil.' if @client.nil?
+
+      @client.upcoming_events id, days: days, timezone: timezone
+    end
+
+    #
+    # Get a calendar's label information used in event.
+    #
+    # @return [Array<TimeTree::Label>]
+    # @raise [TimeTree::Error] if @client is not set.
+    # @raise [TimeTree::ApiError] if the http response status will not success.
+    # @since 0.0.1
+    def labels
+      return @labels if defined? @labels
+      raise Error, '@client is nil.' if @client.nil?
+
+      @labels = @client.calendar_labels id
+    end
+
+    #
+    # Get a calendar's member information.
+    #
+    # @return [Array<TimeTree::User>]
+    # @raise [TimeTree::Error] if @client is not set.
+    # @raise [TimeTree::ApiError] if the http response status will not success.
+    # @since 0.0.1
+    def members
+      return @members if defined? @members
+      raise Error, '@client is nil.' if @client.nil?
+
+      @members = @client.calendar_members id
+    end
+  end
+end

data/lib/timetree/client.rb

@@ -1,99 +1,137 @@
 # frozen_string_literal: true
 
-require 'time'
-require 'faraday'
-require 'faraday_middleware'
-
 module TimeTree
+  # TimeTree apis client.
   class Client
     API_HOST = 'https://timetreeapis.com'
-
+    # @return [String]
+    attr_reader :token
+    # @return [Integer]
     attr_reader :ratelimit_limit
+    # @return [Integer]
     attr_reader :ratelimit_remaining
+    # @return [Time]
     attr_reader :ratelimit_reset_at
 
-    def initialize(access_token = nil)
-      config = TimeTree.configuration
-      @access_token = access_token || config.access_token
-      @logger = config.logger
-    end
+    # @param token [String] a TimeTree's access token.
+    def initialize(token = nil)
+      @token = token || TimeTree.configuration.token
+      raise Error, 'token is required.' unless ready_token?
 
-    def inspect
-      limit_info = nil
-      if @ratelimit_limit
-        limit_info = " ratelimit:#{@ratelimit_remaining}/#{@ratelimit_limit}"
-      end
-      if @ratelimit_reset_at
-        limit_info = "#{limit_info}, reset_at:#{@ratelimit_reset_at.strftime('%m/%d %R')}"
-      end
-      "\#<#{self.class}:#{object_id}#{limit_info}>"
+      @http_cmd = HttpCommand.new(API_HOST, self)
     end
 
     #
-    # User
+    # Get current user information.
     #
-
-    def user
-      res = get '/user'
-      raise if res.status != 200
+    # @return [TimeTree::User]
+    # @raise [TimeTree::ApiError] if the http response status will not success.
+    # @since 0.0.1
+    def current_user
+      res = @http_cmd.get '/user'
+      raise ApiError, res if res.status != 200
 
       to_model res.body[:data]
     end
 
     #
-    # Calendar
+    # Get a single calendar's information.
     #
-
+    # @param cal_id [String] calendar's id.
+    # @param include_relationships [Array<symbol>]
+    # includes association's object in the response.
+    # @return [TimeTree::Calendar]
+    # @raise [TimeTree::ApiError] if the http response status will not success.
+    # @since 0.0.1
     def calendar(cal_id, include_relationships: nil)
       params = relationships_params(include_relationships, Calendar::RELATIONSHIPS)
-      res = get "/calendars/#{cal_id}", params
-      raise if res.status != 200
+      res = @http_cmd.get "/calendars/#{cal_id}", params
+      raise ApiError, res if res.status != 200
 
       to_model(res.body[:data], included: res.body[:included])
     end
 
+    #
+    # Get calendar list that current user can access.
+    #
+    # @param include_relationships [Array<symbol>]
+    # includes association's object in the response.
+    # @return [Array<TimeTree::Calendar>]
+    # @raise [TimeTree::ApiError] if the http response status will not success.
+    # @since 0.0.1
     def calendars(include_relationships: nil)
       params = relationships_params(include_relationships, Calendar::RELATIONSHIPS)
-      res = get '/calendars', params
-      raise if res.status != 200
+      res = @http_cmd.get '/calendars', params
+      raise ApiError, res if res.status != 200
 
       included = res.body[:included]
       res.body[:data].map { |item| to_model(item, included: included) }
     end
 
+    #
+    # Get a calendar's label information used in event.
+    #
+    # @param cal_id [String] calendar's id.
+    # @return [Array<TimeTree::Label>]
+    # @raise [TimeTree::ApiError] if the http response status will not success.
+    # @since 0.0.1
     def calendar_labels(cal_id)
-      res = get "/calendars/#{cal_id}/labels"
-      raise if res.status != 200
+      res = @http_cmd.get "/calendars/#{cal_id}/labels"
+      raise ApiError, res if res.status != 200
 
       res.body[:data].map { |item| to_model(item) }
     end
 
+    #
+    # Get a calendar's member information.
+    #
+    # @param cal_id [String] calendar's id.
+    # @return [Array<TimeTree::User>]
+    # @raise [TimeTree::ApiError] if the http response status will not success.
+    # @since 0.0.1
     def calendar_members(cal_id)
-      res = get "/calendars/#{cal_id}/members"
-      raise if res.status != 200
+      res = @http_cmd.get "/calendars/#{cal_id}/members"
+      raise ApiError, res if res.status != 200
 
       res.body[:data].map { |item| to_model item }
     end
 
     #
-    # Schedule/Keep
+    # Get the event's information.
     #
-
+    # @param cal_id [String] calendar's id.
+    # @param event_id [String] event's id.
+    # @param include_relationships [Array<symbol>]
+    # includes association's object in the response.
+    # @return [TimeTree::Event]
+    # @raise [TimeTree::ApiError] if the http response status will not success.
+    # @since 0.0.1
     def event(cal_id, event_id, include_relationships: nil)
       params = relationships_params(include_relationships, Event::RELATIONSHIPS)
-      res = get "/calendars/#{cal_id}/events/#{event_id}", params
-      raise if res.status != 200
+      res = @http_cmd.get "/calendars/#{cal_id}/events/#{event_id}", params
+      raise ApiError, res if res.status != 200
 
       ev = to_model(res.body[:data], included: res.body[:included])
       ev.calendar_id = cal_id
       ev
     end
 
+    #
+    # Get the events' information after a request date.
+    #
+    # @param cal_id[String] calendar's id.
+    # @param days [Integer] The number of days to get.
+    # @param timezone [String] Timezone.
+    # @param include_relationships [Array<symbol>]
+    # includes association's object in the response.
+    # @return [Array<TimeTree::Event>]
+    # @raise [TimeTree::ApiError] if the http response status will not success.
+    # @since 0.0.1
     def upcoming_events(cal_id, days: 7, timezone: 'UTC', include_relationships: nil)
       params = relationships_params(include_relationships, Event::RELATIONSHIPS)
       params.merge!(days: days, timezone: timezone)
-      res = get "/calendars/#{cal_id}/upcoming_events", params
-      raise if res.status != 200
+      res = @http_cmd.get "/calendars/#{cal_id}/upcoming_events", params
+      raise ApiError, res if res.status != 200
 
       included = res.body[:included]
       res.body[:data].map do |item|
@@ -103,38 +141,70 @@ module TimeTree
       end
     end
 
+    #
+    # Creates an event to the calendar.
+    #
+    # @param cal_id [String] calendar's id.
+    # @param params [Hash] TimeTree request body format.
+    # @return [TimeTree::Event]
+    # @raise [TimeTree::ApiError] if the http response status will not success.
+    # @since 0.0.1
     def create_event(cal_id, params)
-      res = post "/calendars/#{cal_id}/events", params
-      raise if res.status != 201
+      res = @http_cmd.post "/calendars/#{cal_id}/events", params
+      raise ApiError, res if res.status != 201
 
       ev = to_model res.body[:data]
       ev.calendar_id = cal_id
       ev
     end
 
+    #
+    # Updates an event.
+    #
+    # @param cal_id [String] calendar's id.
+    # @param event_id [String] event's id.
+    # @param params [Hash]
+    # event's information specified in TimeTree request body format.
+    # @return [TimeTree::Event]
+    # @raise [TimeTree::ApiError] if the http response status will not success.
+    # @since 0.0.1
     def update_event(cal_id, event_id, params)
-      res = put "/calendars/#{cal_id}/events/#{event_id}", params
-      raise if res.status != 200
+      res = @http_cmd.put "/calendars/#{cal_id}/events/#{event_id}", params
+      raise ApiError, res if res.status != 200
 
       ev = to_model res.body[:data]
       ev.calendar_id = cal_id
       ev
     end
 
+    #
+    # Deletes an event.
+    #
+    # @param cal_id [String] calendar's id.
+    # @param event_id [String] event's id.
+    # @return [true] if the operation succeeded.
+    # @raise [TimeTree::ApiError] if the http response status will not success.
+    # @since 0.0.1
     def delete_event(cal_id, event_id)
-      res = delete "/calendars/#{cal_id}/events/#{event_id}"
-      raise if res.status != 204
+      res = @http_cmd.delete "/calendars/#{cal_id}/events/#{event_id}"
+      raise ApiError, res if res.status != 204
 
       true
     end
 
     #
-    # Activity
+    # Creates comment to an event.
     #
-
+    # @param cal_id [String] calendar's id.
+    # @param event_id [String] event's id.
+    # @param params [Hash]
+    # comment's information specified in TimeTree request body format.
+    # @return [TimeTree::Activity]
+    # @raise [TimeTree::ApiError] if the nhttp response status is not success.
+    # @since 0.0.1
     def create_activity(cal_id, event_id, params)
-      res = post "/calendars/#{cal_id}/events/#{event_id}/activities", params
-      raise if res.status != 201
+      res = @http_cmd.post "/calendars/#{cal_id}/events/#{event_id}/activities", params
+      raise ApiError, res if res.status != 201
 
       activity = to_model res.body[:data]
       activity.calendar_id = cal_id
@@ -142,21 +212,22 @@ module TimeTree
       activity
     end
 
-    private
-
-    attr_reader :logger
-
-    def to_model(data, included: nil)
-      TimeTree::BaseModel.to_model data, client: self, included: included
-    end
-
-    def relationships_params(relationships, default)
-      params = {}
-      relationships ||= default
-      params[:include] = relationships.join ',' if relationships.is_a? Array
-      params
+    def inspect
+      limit_info = nil
+      if @ratelimit_limit
+        limit_info = " ratelimit:#{@ratelimit_remaining}/#{@ratelimit_limit}"
+      end
+      if @ratelimit_reset_at
+        limit_info = "#{limit_info}, reset_at:#{@ratelimit_reset_at.strftime('%m/%d %R')}"
+      end
+      "\#<#{self.class}:#{object_id}#{limit_info}>"
     end
 
+    #
+    # update ratelimit properties
+    #
+    # @param res [Faraday::Response]
+    # apis http response.
     def update_ratelimit(res)
       limit = res.headers['x-ratelimit-limit']
       remaining = res.headers['x-ratelimit-remaining']
@@ -166,54 +237,21 @@ module TimeTree
       @ratelimit_reset_at = Time.at reset.to_i if reset
     end
 
-    def get(path, params = {})
-      logger.info "GET #{connection.build_url("#{API_HOST}#{path}", params)}"
-      res = connection.get path, params
-      update_ratelimit(res)
-      logger.debug "Response status:#{res.status}, body:#{res.body}"
-      res
+    private
+
+    def to_model(data, included: nil)
+      TimeTree::BaseModel.to_model data, client: self, included: included
     end
 
-    def put(path, params = {})
-      logger.debug "PUT #{API_HOST}#{path} body:#{params}"
-      res = connection.put path do |req|
-        req.headers['Content-Type'] = 'application/json'
-        req.body = params.to_json
-      end
-      update_ratelimit(res)
-      logger.debug "Response status:#{res.status}, body:#{res.body}"
-      res
+    def ready_token?
+      @token.is_a?(String) && !@token.empty?
     end
 
-    def post(path, params = {})
-      @logger.debug "POST #{API_HOST}#{path} body:#{params}"
-      res = connection.post path, params do |req|
-        req.headers['Content-Type'] = 'application/json'
-        req.body = params.to_json
-      end
-      update_ratelimit(res)
-      logger.debug "Response status:#{res.status}, body:#{res.body}"
-      res
-    end
-
-    def delete(path, params = {})
-      @logger.debug "DELETE #{API_HOST}#{path} params:#{params}"
-      res = connection.delete path, params
-      update_ratelimit(res)
-      logger.debug "Response status:#{res.status}, body:#{res.body}"
-      res
-    end
-
-    def connection
-      Faraday.new(
-        url: API_HOST,
-        headers: {
-          'Accept' => 'application/vnd.timetree.v1+json',
-          'Authorization' => "Bearer #{@access_token}"
-        }
-      ) do |builder|
-        builder.response :json, parser_options: { symbolize_names: true }, content_type: /\bjson$/
-      end
+    def relationships_params(relationships, default)
+      params = {}
+      relationships ||= default
+      params[:include] = relationships.join ',' if relationships.is_a? Array
+      params
     end
   end
 end