Module: NYCGeoClient::Configuration

Included in:
NYCGeoClient
Defined in:
lib/nyc_geo_client/configuration.rb

Overview

Defines constants and methods related to configuration

Constant Summary collapse

VALID_OPTIONS_KEYS =

An array of valid keys in the options hash when configuring a API

[
  :adapter,
  :subscription_key,
  :endpoint,
  :format,
  :user_agent,
  :proxy,
  :debug
].freeze
VALID_FORMATS =

An array of valid request/response formats

[:json, :xml].freeze
DEFAULT_ADAPTER =
Note:

The default faraday adapter is Net::HTTP.

The adapter that will be used to connect if none is set

Faraday.default_adapter
DEFAULT_SUBSCRIPTION_KEY =

By default, don’t set an application KEY

nil
DEFAULT_ENDPOINT =
Note:

There is no reason to use any other endpoint at this time

The endpoint that will be used to connect if none is set

'https://api.nyc.gov/geo/geoclient/v1/'.freeze
DEFAULT_FORMAT =
Note:

JSON and XML are the available formats

The response format appended to the path and sent in the ‘Accept’ header if none is set

:json
DEFAULT_PROXY =

By default, don’t use a proxy server

nil
DEFAULT_DEBUG =

By default, dont’ log the request/response

false
DEFAULT_USER_AGENT =

The user agent that will be sent to the API endpoint if none is set

"NYCGeoClient #{NYCGeoClient::VERSION}".freeze

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.extended(base) ⇒ Object

When this module is extended, set all configuration options to their default values



52
53
54
 
# File 'lib/nyc_geo_client/configuration.rb', line 52

def self.extended(base)
  base.reset
end

Instance Method Details

#configure {|_self| ... } ⇒ Object

Convenience method to allow configuration options to be set in a block

Yields:

  • (_self)

Yield Parameters:



57
58
59
 
# File 'lib/nyc_geo_client/configuration.rb', line 57

def configure
  yield self
end

#options ⇒ Object

Create a hash of options and their values



62
63
64
65
66
 
# File 'lib/nyc_geo_client/configuration.rb', line 62

def options
  VALID_OPTIONS_KEYS.inject({}) do |option, key|
    option.merge!(key => send(key))
  end
end

#reset ⇒ Object

Reset all configuration options to defaults



69
70
71
72
73
74
75
76
77
 
# File 'lib/nyc_geo_client/configuration.rb', line 69

def reset
  self.adapter          = DEFAULT_ADAPTER
  self.subscription_key = DEFAULT_SUBSCRIPTION_KEY
  self.endpoint         = DEFAULT_ENDPOINT
  self.format           = DEFAULT_FORMAT
  self.user_agent       = DEFAULT_USER_AGENT
  self.proxy            = DEFAULT_PROXY
  self.debug            = DEFAULT_DEBUG
end