Class: Uber::Client

Inherits:
Object
  • Object
show all
Includes:
API
Defined in:
lib/uber/client.rb

Constant Summary collapse

ENDPOINT = 
'https://api.uber.com'
SANDBOX_ENDPOINT = 
'https://sandbox-api.uber.com'

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from API::Requests

#trip_cancel, #trip_details, #trip_estimate, #trip_map, #trip_request, #trip_update

Methods included from API::Promotions

#promotion

Methods included from API::Me

#me

Methods included from API::Activities

#history

Methods included from API::TimeEstimates

#time_estimations

Methods included from API::PriceEstimates

#price_estimations

Methods included from API::Products

#apply_availability, #apply_surge, #products

Methods included from Utils

#perform_with_object, #perform_with_objects

Constructor Details

#initialize(options = {}) {|_self| ... } ⇒ Client

Returns a new instance of Client.

Yields:

  • (_self)

Yield Parameters:

  • _self (Uber::Client) —

    the object that the method was called on



20
21
22
23
24
25
26
 
# File 'lib/uber/client.rb', line 20

def initialize(options = {})
  options.each do |key, value|
    send(:"#{key}=", value)
  end
  yield(self) if block_given?
  validate_credential_type!
end

Instance Attribute Details

#bearer_token ⇒ Object

Returns the value of attribute bearer_token.



13
14
15
 
# File 'lib/uber/client.rb', line 13

def bearer_token
  @bearer_token
end

#client_id ⇒ Object

Returns the value of attribute client_id.



12
13
14
 
# File 'lib/uber/client.rb', line 12

def client_id
  @client_id
end

#client_secret ⇒ Object

Returns the value of attribute client_secret.



12
13
14
 
# File 'lib/uber/client.rb', line 12

def client_secret
  @client_secret
end

#connection_options ⇒ Object 



32
33
34
35
36
37
38
39
40
41
42
43
44
 
# File 'lib/uber/client.rb', line 32

def connection_options
  @connection_options ||= {
    :builder => middleware,
    :headers => {
      :accept => 'application/json',
      :user_agent => user_agent,
    },
    :request => {
      :open_timeout => 10,
      :timeout => 30,
    },
  }
end

#middleware ⇒ Object 



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

def middleware
  @middleware ||= Faraday::RackBuilder.new do |faraday|
    # Encodes as "application/x-www-form-urlencoded" if not already encoded
    faraday.request :url_encoded
    # Parse JSON response bodies
    faraday.response :parse_json
    # Use instrumentation if available
    faraday.use :instrumentation if defined?(FaradayMiddleware::Instrumentation)
    # Set default HTTP adapter
    faraday.adapter Faraday.default_adapter
  end
end

#sandbox ⇒ Object

Returns the value of attribute sandbox.



14
15
16
 
# File 'lib/uber/client.rb', line 14

def sandbox
  @sandbox
end

#server_token ⇒ Object

Returns the value of attribute server_token.



12
13
14
 
# File 'lib/uber/client.rb', line 12

def server_token
  @server_token
end

Instance Method Details

#bearer_token? ⇒ Boolean

Returns:

  • (Boolean) 


94
95
96
 
# File 'lib/uber/client.rb', line 94

def bearer_token?
  !!bearer_token
end

#credentials ⇒ Hash

Returns:

  • (Hash) 


99
100
101
102
103
104
105
 
# File 'lib/uber/client.rb', line 99

def credentials
  {
    server_token:  server_token,
    client_id:     client_id,
    client_secret: client_secret
  }
end

#credentials? ⇒ Boolean

Returns:

  • (Boolean) 


108
109
110
 
# File 'lib/uber/client.rb', line 108

def credentials?
  credentials.values.all?
end

#delete(path, params = {}) ⇒ Object

Perform an HTTP DELETE request



88
89
90
91
 
# File 'lib/uber/client.rb', line 88

def delete(path, params = {})
  headers = request_headers(:delete, path, params)
  request(:delete, path, params, headers)
end

#get(path, params = {}) ⇒ Object

Perform an HTTP GET request



70
71
72
73
 
# File 'lib/uber/client.rb', line 70

def get(path, params = {})
  headers = request_headers(:get, path, params)
  request(:get, path, params, headers)
end

#post(path, params = {}) ⇒ Object

Perform an HTTP POST request



76
77
78
79
 
# File 'lib/uber/client.rb', line 76

def post(path, params = {})
  headers = params.values.any? { |value| value.respond_to?(:to_io) } ? request_headers(:post, path, params, {}) : request_headers(:post, path, params)
  request(:post, path, params.to_json, headers)
end

#put(path, params = {}) ⇒ Object

Perform an HTTP PUT request



82
83
84
85
 
# File 'lib/uber/client.rb', line 82

def put(path, params = {})
  headers = params.values.any? { |value| value.respond_to?(:to_io) } ? request_headers(:post, path, params, {}) : request_headers(:put, path, params)
  request(:put, path, params.to_json, headers)
end

#user_agent ⇒ String

Returns:

  • (String) 


52
53
54
 
# File 'lib/uber/client.rb', line 52

def user_agent
  @user_agent ||= "Uber Ruby Gem #{Uber::Version}"
end

#user_token? ⇒ Boolean

Returns:

  • (Boolean) 


47
48
49
 
# File 'lib/uber/client.rb', line 47

def user_token?
  !!(client_id && client_secret)
end