Module: Saddle::Options

Included in:
Client
Defined in:
lib/saddle/options.rb

Instance Method Summary collapse

Instance Method Details

#add_middleware(m) ⇒ Object

Use this to add additional middleware to the request stack ex: add_middleware(

:klass => MyMiddleware,
:args => [arg1, arg2],

) end



75
76
77
# File 'lib/saddle/options.rb', line 75

def add_middleware m
  self.additional_middlewares << m
end

#default_optionsObject

Construct our default options, based upon the class methods



8
9
10
11
12
13
14
15
16
17
18
19
20
# File 'lib/saddle/options.rb', line 8

def default_options
  {
    :host => host,
    :port => port,
    :path_prefix => path_prefix,
    :use_ssl => use_ssl,
    :request_style => request_style,
    :num_retries => num_retries,
    :timeout => timeout,
    :additional_middlewares => self.additional_middlewares,
    :stubs => stubs,
  }
end

#hostObject

The default host for this client



23
24
25
# File 'lib/saddle/options.rb', line 23

def host
  'localhost'
end

#instrumentation_keyObject

If you want to set up an ActiveSupport::Notification, give your client

an instrumentation key to monitor.


60
61
62
# File 'lib/saddle/options.rb', line 60

def instrumentation_key
  nil
end

#num_retriesObject

Default number of retries per request



49
50
51
# File 'lib/saddle/options.rb', line 49

def num_retries
  3
end

#path_prefixObject

A string prefix to prepend to paths as they are build (ie, ‘v1’)



33
34
35
# File 'lib/saddle/options.rb', line 33

def path_prefix
  nil
end

#portObject

The default port for this client



28
29
30
# File 'lib/saddle/options.rb', line 28

def port
  nil
end

#request_styleObject

The POST/PUT style for this client options are [:json, :urlencoded]



44
45
46
# File 'lib/saddle/options.rb', line 44

def request_style
  :json
end

#stubsObject

If the Typhoeus adapter is being used, pass stubs to it for testing.



80
81
82
# File 'lib/saddle/options.rb', line 80

def stubs
  nil
end

#timeoutObject

Default timeout per request (in seconds)



54
55
56
# File 'lib/saddle/options.rb', line 54

def timeout
  30
end

#use_sslObject

Should this client use SSL by default?



38
39
40
# File 'lib/saddle/options.rb', line 38

def use_ssl
  false
end