Class: Yelp::Client

Inherits:
Object
  • Object
show all
Defined in:
lib/yelp/client.rb

Constant Summary collapse

API_HOST = 
'http://api.yelp.com'
REQUEST_CLASSES = 
[ Yelp::Endpoint::Search,
Yelp::Endpoint::Business,
Yelp::Endpoint::PhoneSearch]

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(options = nil) ⇒ Client

Creates an instance of the Yelp client

Parameters:

  • options (Hash, nil) (defaults to: nil) —

    a hash of the consumer key, consumer secret, token, and token secret



24
25
26
27
28
29
30
31
32
 
# File 'lib/yelp/client.rb', line 24

def initialize(options = nil)
  @configuration = nil
  define_request_methods

  unless options.nil?
    @configuration = Configuration.new(options)
    check_api_keys
  end
end

Instance Attribute Details

#configuration ⇒ Object (readonly)

Returns the value of attribute configuration.



18
19
20
 
# File 'lib/yelp/client.rb', line 18

def configuration
  @configuration
end

Instance Method Details

#check_api_keys ⇒ Object

Checks that all the keys needed were given



53
54
55
56
57
58
59
60
61
62
63
 
# File 'lib/yelp/client.rb', line 53

def check_api_keys
  if configuration.nil? || !configuration.valid?
    @configuration = nil
    raise Error::MissingAPIKeys
  else
    # Freeze the configuration so it cannot be modified once the gem is
    # configured.  This prevents the configuration changing while the gem
    # is operating, which would necessitate invalidating various caches.
    @configuration.freeze
  end
end

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

Configure the API client

Examples:

Simple configuration

Yelp.client.configure do |config|
  config.consumer_key = 'abc'
  config.consumer_secret = 'def'
  config.token = 'ghi'
  config.token_secret = 'jkl'
end

Yields:

Raises:

  • (MissingAPIKeys) —

    if the configuration is invalid



44
45
46
47
48
49
50
 
# File 'lib/yelp/client.rb', line 44

def configure
  raise Error::AlreadyConfigured unless @configuration.nil?

  @configuration = Configuration.new
  yield(@configuration)
  check_api_keys
end

#connection ⇒ Object

API connection



66
67
68
69
70
71
72
73
74
75
76
77
 
# File 'lib/yelp/client.rb', line 66

def connection
  return @connection if instance_variable_defined?(:@connection)

  check_api_keys
  @connection = Faraday.new(API_HOST) do |conn|
    # Use the Faraday OAuth middleware for OAuth 1.0 requests
    conn.request :oauth, @configuration.auth_keys

    # Using default http library, had to specify to get working
    conn.adapter :net_http
  end
end