turadg/pocket-ruby

View on GitHub
lib/pocket/configuration.rb

Summary

Maintainability
A
0 mins
Test Coverage
require "faraday"
require File.expand_path("../version", __FILE__)

module Pocket
  # Defines constants and methods related to configuration
  module Configuration
    # An array of valid keys in the options hash when configuring a {Pocket::API}
    VALID_OPTIONS_KEYS = [
      :adapter,
      :consumer_key,
      :access_token,
      :endpoint,
      :redirect_uri,
      :format,
      :user_agent,
      :proxy
    ].freeze

    # An array of valid request/response formats
    #
    # @note Not all methods support the XML format.
    VALID_FORMATS = [
      :json
    ].freeze

    # The adapter that will be used to connect if none is set
    #
    # @note The default faraday adapter is Net::HTTP.
    DEFAULT_ADAPTER = Faraday.default_adapter

    # By default, don't set an application ID
    DEFAULT_CONSUMER_KEY = nil

    # By default, don't set an application redirect uri
    DEFAULT_REDIRECT_URI = nil

    # By default, don't set a user access token
    DEFAULT_ACCESS_TOKEN = nil

    # The endpoint that will be used to connect if none is set
    #
    # @note There is no reason to use any other endpoint at this time
    DEFAULT_ENDPOINT = "https://getpocket.com/v3/".freeze

    # The response format appended to the path and sent in the 'Accept' header if none is set
    #
    # @note JSON is the only available format at this time
    DEFAULT_FORMAT = :json

    # By default, don't use a proxy server
    DEFAULT_PROXY = nil

    # The user agent that will be sent to the API endpoint if none is set
    DEFAULT_USER_AGENT = "Pocket Ruby Gem #{Pocket::VERSION}".freeze

    # @private
    attr_accessor :adapter,
      :consumer_key,
      :access_token,
      :endpoint,
      :redirect_uri,
      :format,
      :user_agent,
      :proxy

    # When this module is extended, set all configuration options to their default values
    def self.extended(base)
      base.reset
    end

    # Convenience method to allow configuration options to be set in a block
    def configure
      yield self
    end

    # Create a hash of options and their values
    def options
      VALID_OPTIONS_KEYS.inject({}) do |option, key|
        option.merge!(key => send(key))
      end
    end

    # Reset all configuration options to defaults
    def reset
      self.adapter = DEFAULT_ADAPTER
      self.consumer_key = DEFAULT_CONSUMER_KEY
      self.access_token = DEFAULT_ACCESS_TOKEN
      self.endpoint = DEFAULT_ENDPOINT
      self.redirect_uri = DEFAULT_REDIRECT_URI
      self.format = DEFAULT_FORMAT
      self.user_agent = DEFAULT_USER_AGENT
      self.proxy = DEFAULT_PROXY
    end
  end
end