Class: SendGrid::Client
- Inherits:
-
Object
- Object
- SendGrid::Client
- Defined in:
- lib/ruby_http_client.rb
Overview
A simple REST client.
Instance Attribute Summary collapse
-
#host ⇒ Object
readonly
Returns the value of attribute host.
-
#http ⇒ Object
readonly
Returns the value of attribute http.
-
#request ⇒ Object
readonly
Returns the value of attribute request.
-
#request_headers ⇒ Object
readonly
Returns the value of attribute request_headers.
-
#url_path ⇒ Object
readonly
Returns the value of attribute url_path.
Instance Method Summary collapse
-
#_(name = nil) ⇒ Object
Add variable values to the url.
-
#add_ssl(http) ⇒ Object
Allow for https calls.
-
#add_version(url = nil) ⇒ Object
Add the API version, subclass this function to customize.
-
#build_args(args) ⇒ Object
Set the query params, request headers and request body.
-
#build_query_params(url, query_params) ⇒ Object
Add query parameters to the url.
-
#build_request(name, args) ⇒ Object
Build the API request for HTTP::NET.
-
#build_request_headers(request) ⇒ Object
Build the final request headers.
-
#build_url(query_params: nil) ⇒ Object
Build the final url.
-
#initialize(host: nil, request_headers: nil, version: nil, url_path: nil) ⇒ Client
constructor
-
Args : -
host
-> Base URL for the api.
-
-
#make_request(http, request) ⇒ Object
Make the API call and return the response.
-
#method_missing(name, *args, &_block) ⇒ Object
Dynamically add segments to the url, then call a method.
-
#update_headers(request_headers) ⇒ Object
Update the headers for the request.
Constructor Details
#initialize(host: nil, request_headers: nil, version: nil, url_path: nil) ⇒ Client
-
Args :
-
host
-> Base URL for the api. (e.g. api.sendgrid.com) -
request_headers
-> A hash of the headers you want applied onall calls
-
version
-> The version number of the API.Subclass add_version for custom behavior. Or just pass the version as part of the URL (e.g. client._("/v3"))
-
url_path
-> A list of the url path segments
-
33 34 35 36 37 38 39 40 41 |
# File 'lib/ruby_http_client.rb', line 33 def initialize(host: nil, request_headers: nil, version: nil, url_path: nil) @host = host @request_headers = request_headers || {} @version = version @url_path = url_path || [] @methods = %w(delete get patch post put) @query_params = nil @request_body = nil end |
Dynamic Method Handling
This class handles dynamic methods through the method_missing method
#method_missing(name, *args, &_block) ⇒ Object
Dynamically add segments to the url, then call a method. (e.g. client.name.name.get())
-
Args :
-
The args are autmoatically passed in
-
-
Returns :
-
Client object or Response object
-
206 207 208 209 210 211 212 213 214 215 216 |
# File 'lib/ruby_http_client.rb', line 206 def method_missing(name, *args, &_block) # Capture the version if name.to_s == 'version' @version = args[0] return _ end # We have reached the end of the method chain, make the API call return build_request(name, args) if @methods.include?(name.to_s) # Add a segment to the URL _(name) end |
Instance Attribute Details
#host ⇒ Object (readonly)
Returns the value of attribute host.
22 23 24 |
# File 'lib/ruby_http_client.rb', line 22 def host @host end |
#http ⇒ Object (readonly)
Returns the value of attribute http.
22 23 24 |
# File 'lib/ruby_http_client.rb', line 22 def http @http end |
#request ⇒ Object (readonly)
Returns the value of attribute request.
22 23 24 |
# File 'lib/ruby_http_client.rb', line 22 def request @request end |
#request_headers ⇒ Object (readonly)
Returns the value of attribute request_headers.
22 23 24 |
# File 'lib/ruby_http_client.rb', line 22 def request_headers @request_headers end |
#url_path ⇒ Object (readonly)
Returns the value of attribute url_path.
22 23 24 |
# File 'lib/ruby_http_client.rb', line 22 def url_path @url_path end |
Instance Method Details
#_(name = nil) ⇒ Object
Add variable values to the url. (e.g. /your/api/variable_value/call) Another example: if you have a ruby reserved word, such as true, in your url, you must use this method.
-
Args :
-
name
-> Name of the url segment
-
-
Returns :
-
Client object
-
191 192 193 194 195 196 |
# File 'lib/ruby_http_client.rb', line 191 def _(name = nil) url_path = name ? @url_path.push(name) : @url_path @url_path = [] Client.new(host: @host, request_headers: @request_headers, version: @version, url_path: url_path) end |
#add_ssl(http) ⇒ Object
Allow for https calls
-
Args :
-
http
-> HTTP::NET object
-
-
Returns :
-
HTTP::NET object
-
173 174 175 176 177 178 179 |
# File 'lib/ruby_http_client.rb', line 173 def add_ssl(http) if host.start_with?('https') http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_PEER end http end |
#add_version(url = nil) ⇒ Object
Add the API version, subclass this function to customize
-
Args :
-
url
-> An empty url string
-
-
Returns :
-
The url string with the version pre-pended
-
73 74 75 76 |
# File 'lib/ruby_http_client.rb', line 73 def add_version(url = nil) path = @version ? "/#{@version}" : '' url.concat(path) end |
#build_args(args) ⇒ Object
Set the query params, request headers and request body
-
Args :
-
args
-> array of args obtained from method_missing
-
96 97 98 99 100 101 102 103 104 105 106 107 108 109 |
# File 'lib/ruby_http_client.rb', line 96 def build_args(args) args.each do |arg| arg.each do |key, value| case key.to_s when 'query_params' @query_params = value when 'request_headers' update_headers(value) when 'request_body' @request_body = value end end end end |
#build_query_params(url, query_params) ⇒ Object
Add query parameters to the url
-
Args :
-
url
-> path to endpoint -
query_params
-> hash of query parameters
-
-
Returns :
-
The url string with the query parameters appended
-
86 87 88 89 |
# File 'lib/ruby_http_client.rb', line 86 def build_query_params(url, query_params) params = query_params.map { |key, value| "#{key}=#{value}" }.join('&') url.concat("?#{params}") end |
#build_request(name, args) ⇒ Object
Build the API request for HTTP::NET
-
Args :
-
name
-> method name, received from method_missing -
args
-> args passed to the method
-
-
Returns :
-
A Response object from make_request
-
132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 |
# File 'lib/ruby_http_client.rb', line 132 def build_request(name, args) build_args(args) if args uri = build_url(query_params: @query_params) @http = add_ssl(Net::HTTP.new(uri.host, uri.port)) net_http = Kernel.const_get('Net::HTTP::' + name.to_s.capitalize) @request = build_request_headers(net_http.new(uri.request_uri)) if (@request_body && (!@request_headers.has_key?('Content-Type') || @request_headers['Content-Type'] == 'application/json') ) @request.body = @request_body.to_json @request['Content-Type'] = 'application/json' elsif !@request_body and (name.to_s == "post") @request['Content-Type'] = '' else @request.body = @request_body end make_request(@http, @request) end |
#build_request_headers(request) ⇒ Object
Build the final request headers
-
Args :
-
request
-> HTTP::NET request object
-
-
Returns :
-
HTTP::NET request object
-
59 60 61 62 63 64 |
# File 'lib/ruby_http_client.rb', line 59 def build_request_headers(request) @request_headers.each do |key, value| request[key] = value end request end |
#build_url(query_params: nil) ⇒ Object
Build the final url
-
Args :
-
query_params
-> A hash of query parameters
-
-
Returns :
-
The final url string
-
118 119 120 121 122 |
# File 'lib/ruby_http_client.rb', line 118 def build_url(query_params: nil) url = [add_version(''), *@url_path].join('/') url = build_query_params(url, query_params) if query_params URI.parse("#{@host}#{url}") end |
#make_request(http, request) ⇒ Object
Make the API call and return the response. This is separated into it’s own function, so we can mock it easily for testing.
-
Args :
-
http
-> NET:HTTP request object -
request
-> NET::HTTP request object
-
-
Returns :
-
Response object
-
161 162 163 164 |
# File 'lib/ruby_http_client.rb', line 161 def make_request(http, request) response = http.request(request) Response.new(response) end |
#update_headers(request_headers) ⇒ Object
Update the headers for the request
-
Args :
-
request_headers
-> Hash of request header key/values
-
48 49 50 |
# File 'lib/ruby_http_client.rb', line 48 def update_headers(request_headers) @request_headers.merge!(request_headers) end |