Class: ZendeskAPI::Data

Inherits:
Object
  • Object
show all
Includes:
Associations
Defined in:
lib/zendesk_api/resource.rb

Overview

Represents a resource that only holds data.

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Associations

included, #wrap_resource

Constructor Details

#initialize(client, attributes = {}) ⇒ Data

Create a new resource instance.

Parameters:

  • client (Client) —

    The client to use

  • attributes (Hash) (defaults to: {}) —

    The optional attributes that describe the resource



55
56
57
58
59
60
61
62
63
64
65
66
67
 
# File 'lib/zendesk_api/resource.rb', line 55

def initialize(client, attributes = {})
  raise "Expected a Hash for attributes, got #{attributes.inspect}" unless attributes.is_a?(Hash)
  @association = attributes.delete(:association) || Association.new(:class => self.class)
  @global_params = attributes.delete(:global) || {}
  @client = client
  @attributes = ZendeskAPI::Trackie.new(attributes)

  if self.class.associations.none? { |a| a[:name] == self.class.singular_resource_name }
    ZendeskAPI::Client.check_deprecated_namespace_usage @attributes, self.class.singular_resource_name
  end

  @attributes.clear_changes unless new_record?
end

Dynamic Method Handling

This class handles dynamic methods through the method_missing method

#method_missing(*args, &block) ⇒ Object

Passes the method onto the attributes hash. If the attributes are nested (e.g. { :tickets => { :id => 1 } }), passes the method onto the nested hash.

Raises:

  • (NoMethodError) 


79
80
81
82
 
# File 'lib/zendesk_api/resource.rb', line 79

def method_missing(*args, &block)
  raise NoMethodError, ":save is not defined" if args.first.to_sym == :save
  @attributes.send(*args, &block)
end

Instance Attribute Details

#association ⇒ ZendeskAPI::Association

Returns The association.

Returns:



46
47
48
 
# File 'lib/zendesk_api/resource.rb', line 46

def association
  @association
end

#attributes ⇒ Hash (readonly) Also known as: to_param

Returns The resource’s attributes.

Returns:

  • (Hash) —

    The resource’s attributes



44
45
46
 
# File 'lib/zendesk_api/resource.rb', line 44

def attributes
  @attributes
end

#errors ⇒ Array

Returns The last received errors.

Returns:

  • (Array) —

    The last received errors



48
49
50
 
# File 'lib/zendesk_api/resource.rb', line 48

def errors
  @errors
end

#response ⇒ Object

Place to dump the last response



50
51
52
 
# File 'lib/zendesk_api/resource.rb', line 50

def response
  @response
end

Class Method Details

.inherited(klass) ⇒ Object 



14
15
16
 
# File 'lib/zendesk_api/resource.rb', line 14

def inherited(klass)
  subclasses.push(klass)
end

.namespace(namespace) ⇒ Object 



38
39
40
 
# File 'lib/zendesk_api/resource.rb', line 38

def namespace(namespace)
  @namespace = namespace
end

.new_from_response(client, response, includes = nil) ⇒ Object 



69
70
71
72
73
74
75
 
# File 'lib/zendesk_api/resource.rb', line 69

def self.new_from_response(client, response, includes = nil)
  new(client).tap do |resource|
    resource.handle_response(response)
    resource.set_includes(resource, includes, response.body) if includes
    resource.attributes.clear_changes
  end
end

.resource_name ⇒ Object Also known as: model_key

The resource name taken from the class name (e.g. ZendeskAPI::Ticket -> tickets)



28
29
30
 
# File 'lib/zendesk_api/resource.rb', line 28

def resource_name
  @resource_name ||= Inflection.plural(singular_resource_name)
end

.resource_path ⇒ Object 



32
33
34
 
# File 'lib/zendesk_api/resource.rb', line 32

def resource_path
  [@namespace, resource_name].compact.join("/")
end

.singular_resource_name ⇒ Object

The singular resource name taken from the class name (e.g. ZendeskAPI::Ticket -> ticket)



23
24
25
 
# File 'lib/zendesk_api/resource.rb', line 23

def singular_resource_name
  @singular_resource_name ||= ZendeskAPI::Helpers.snakecase_string(to_s.split("::").last)
end

.subclasses ⇒ Object 



18
19
20
 
# File 'lib/zendesk_api/resource.rb', line 18

def subclasses
  @subclasses ||= []
end

Instance Method Details

#==(other) ⇒ Object Also known as: eql

Compares resources by class and id. If id is nil, then by object_id



123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
 
# File 'lib/zendesk_api/resource.rb', line 123

def ==(other)
  return true if other.object_id == object_id

  if other && !(other.is_a?(Data) || other.is_a?(Integer))
    warn "Trying to compare #{other.class} to a Resource from #{caller.first}"
  end

  if other.is_a?(Data)
    other.id && other.id == id
  elsif other.is_a?(Integer)
    id == other
  else
    false
  end
end

#id ⇒ Object

Returns the resource id of the object or nil



89
90
91
 
# File 'lib/zendesk_api/resource.rb', line 89

def id
  key?(:id) ? method_missing(:id) : nil
end

#loaded_associations ⇒ Object 



99
100
101
102
103
104
 
# File 'lib/zendesk_api/resource.rb', line 99

def loaded_associations
  self.class.associations.select do |association|
    loaded = @attributes.method_missing(association[:name])
    loaded && !(loaded.respond_to?(:empty?) && loaded.empty?)
  end
end

#new_record? ⇒ Boolean

Has this been object been created server-side? Does this by checking for an id.

Returns:

  • (Boolean) 


94
95
96
 
# File 'lib/zendesk_api/resource.rb', line 94

def new_record?
  id.nil?
end

#path(options = {}) ⇒ Object

Returns the path to the resource



107
108
109
 
# File 'lib/zendesk_api/resource.rb', line 107

def path(options = {})
  @association.generate_path(self, options)
end

#respond_to_missing?(method, include_private = false) ⇒ Boolean

Returns:

  • (Boolean) 


84
85
86
 
# File 'lib/zendesk_api/resource.rb', line 84

def respond_to_missing?(method, include_private = false)
  @attributes.respond_to?(method) || super
end

#to_json(*args) ⇒ Object

Passes #to_json to the underlying attributes hash



112
113
114
 
# File 'lib/zendesk_api/resource.rb', line 112

def to_json(*args)
  method_missing(:to_json, *args)
end

#to_s ⇒ Object Also known as: inspect 



117
118
119
 
# File 'lib/zendesk_api/resource.rb', line 117

def to_s
  "#{self.class.singular_resource_name}: #{attributes.inspect}"
end