espn 0.0.2

data/.gitignore

@@ -0,0 +1,3 @@
+.rbenv-gemsets
+.ruby-version
+*.gem

data/Gemfile

@@ -0,0 +1,3 @@
+source "https://rubygems.org"
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,65 @@
+PATH
+  remote: .
+  specs:
+    espn (0.0.1)
+      addressable (~> 2.2)
+      faraday (~> 0.8)
+      faraday_middleware (~> 0.8)
+      hashie (~> 1.2)
+      multi_json (~> 1.3)
+      oauth (~> 0.4)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.3.3)
+    crack (0.3.2)
+    diff-lcs (1.1.3)
+    faraday (0.8.5)
+      multipart-post (~> 1.1)
+    faraday_middleware (0.9.0)
+      faraday (>= 0.7.4, < 0.9)
+    hashie (1.2.0)
+    json (1.7.7)
+    kramdown (0.14.2)
+    logutils (0.3.0)
+    markdown (1.0.0)
+      kramdown (>= 0.13.7)
+      props (>= 1.0.0)
+      textutils (>= 0.2.0)
+    multi_json (1.6.1)
+    multipart-post (1.1.5)
+    oauth (0.4.7)
+    props (1.0.0)
+    rake (10.0.3)
+    rspec (2.12.0)
+      rspec-core (~> 2.12.0)
+      rspec-expectations (~> 2.12.0)
+      rspec-mocks (~> 2.12.0)
+    rspec-core (2.12.2)
+    rspec-expectations (2.12.1)
+      diff-lcs (~> 1.1.3)
+    rspec-mocks (2.12.2)
+    simplecov (0.7.1)
+      multi_json (~> 1.0)
+      simplecov-html (~> 0.7.1)
+    simplecov-html (0.7.1)
+    textutils (0.4.0)
+      logutils (>= 0.3.0)
+    webmock (1.9.3)
+      addressable (>= 2.2.7)
+      crack (>= 0.3.2)
+    yard (0.8.4.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  espn!
+  json
+  markdown
+  rake
+  rspec
+  simplecov
+  webmock
+  yard

data/README.md

@@ -0,0 +1,5 @@
+# Ruby Wrapper for the ESPN API
+
+## Why?
+
+I have seen this halfway implemented a few times. My goal is to take over the `espn` gem name.

data/espn.gemspec

@@ -0,0 +1,33 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/espn/version', __FILE__)
+
+Gem::Specification.new do |s|
+  s.name        = 'espn'
+  s.version     = ESPN::VERSION
+  s.platform    = Gem::Platform::RUBY
+
+  s.authors     = ['Andrew Thorp']
+  s.email       = ['andrewpthorp@gmail.com']
+  s.homepage    = 'http://github.com/andrewpthorp/espn'
+  s.description = %q{Simple wrapper for the ESPN v1 API.}
+  s.summary     = s.description
+
+  s.add_runtime_dependency 'addressable', '~> 2.2'
+  s.add_runtime_dependency 'faraday', '~> 0.8'
+  s.add_runtime_dependency 'faraday_middleware', '~> 0.8'
+  s.add_runtime_dependency 'hashie', '~> 1.2'
+  s.add_runtime_dependency 'multi_json', '~> 1.3'
+  s.add_runtime_dependency 'oauth', '~> 0.4'
+
+  s.add_development_dependency 'json'
+  s.add_development_dependency 'rake'
+  s.add_development_dependency 'rspec'
+  s.add_development_dependency 'simplecov'
+  s.add_development_dependency 'webmock'
+  s.add_development_dependency 'yard'
+  s.add_development_dependency 'markdown'
+
+  s.files         = `git ls-files -cd`.split("\n")
+  s.test_files    = Dir.glob("spec/**/*")
+  s.require_paths = ["lib"]
+end

data/lib/espn.rb

@@ -0,0 +1,25 @@
+require 'espn/configuration'
+require 'espn/client'
+require 'espn/error'
+
+module ESPN
+  extend Configuration
+  class << self
+    # Alias for ESPN::Client.new
+    #
+    # @return [ESPN::Client]
+    def new(options={})
+      ESPN::Client.new(options)
+    end
+
+    # Delegate to ESPN::Client.new
+    def method_missing(method, *args, &block)
+      return super unless new.respond_to?(method)
+      new.send(method, *args, &block)
+    end
+
+    def respond_to?(method, include_private=false)
+      new.respond_to?(method, include_private) || super(method, include_private)
+    end
+  end
+end

data/lib/espn/client.rb

@@ -0,0 +1,39 @@
+require 'espn/connection'
+require 'espn/request'
+require 'espn/client/sports'
+require 'espn/client/teams'
+
+module ESPN
+
+  class Client
+    attr_accessor(*Configuration::VALID_OPTIONS_KEYS)
+
+    def initialize(options={})
+      options = ESPN.options.merge(options)
+      Configuration::VALID_OPTIONS_KEYS.each do |key|
+        send("#{key}=", options[key])
+      end
+    end
+
+    # Provides the URL for accessing the API
+    #
+    # @return [String]
+    def api_url
+      "http://api.espn.com/v1"
+    end
+
+    # Determine if an api_key has been set
+    #
+    # @return [Boolean]
+    def authed?
+      !api_key.nil?
+    end
+
+    include ESPN::Connection
+    include ESPN::Request
+    include ESPN::Client::Sports
+    include ESPN::Client::Teams
+
+  end
+
+end

data/lib/espn/client/sports.rb

@@ -0,0 +1,19 @@
+module ESPN
+  class Client
+    module Sports
+
+      # Get all sports supported by the ESPN Developer API
+      #
+      # @param [Hash] options
+      #
+      # @return [Hashie::Mash]
+      #
+      # @example
+      #   ESPN.sports()
+      def sports(options={})
+        get("/sports", options)
+      end
+
+    end
+  end
+end

data/lib/espn/client/teams.rb

@@ -0,0 +1,19 @@
+module ESPN
+  class Client
+    module Teams
+
+      # Get all sports supported by the ESPN Developer API
+      #
+      # @param [Hash] options
+      #
+      # @return [Hashie::Mash]
+      #
+      # @example
+      #   ESPN.sports()
+      def teams(options={})
+        get("/sports/teams", options)
+      end
+
+    end
+  end
+end

data/lib/espn/configuration.rb

@@ -0,0 +1,44 @@
+require 'faraday'
+require 'espn/version'
+
+module ESPN
+  module Configuration
+    VALID_OPTIONS_KEYS = [
+      :adapter,
+      :api_version,
+      :proxy,
+      :api_key,
+      :timeout,
+      :open_timeout,
+      :user_agent].freeze
+
+    DEFAULT_ADAPTER         = Faraday.default_adapter
+    DEFAULT_API_VERSION     = 1
+    DEFAULT_USER_AGENT      = "ESPN Ruby Gem #{ESPN::VERSION}".freeze
+    DEFAULT_TIMEOUT         = 10
+
+    attr_accessor(*VALID_OPTIONS_KEYS)
+
+    def self.extended(base)
+      base.reset
+    end
+
+    def configure
+      yield self
+    end
+
+    def options
+      VALID_OPTIONS_KEYS.inject({}){|o,k| o.merge!(k => send(k)) }
+    end
+
+    def reset
+      self.adapter                = DEFAULT_ADAPTER
+      self.api_version            = DEFAULT_API_VERSION
+      self.user_agent             = DEFAULT_USER_AGENT
+      self.timeout                = DEFAULT_TIMEOUT
+      self.open_timeout           = DEFAULT_TIMEOUT
+      self.api_key                = nil
+      self.proxy                  = nil
+    end
+  end
+end

data/lib/espn/connection.rb

@@ -0,0 +1,32 @@
+require 'faraday_middleware'
+require 'faraday/response/raise_espn_error'
+
+module ESPN
+  # @private
+  module Connection
+    private
+
+    def connection
+
+      options = {
+        proxy: proxy,
+        ssl: { verify: false },
+        url: api_url
+      }
+
+      options.merge!(params: { apikey: api_key }) if authed?
+
+      connection = Faraday.new(options) do |builder|
+        builder.request :url_encoded
+
+        builder.use Faraday::Response::RaiseESPNError
+        builder.use FaradayMiddleware::Mashify
+        builder.use FaradayMiddleware::ParseJson
+
+        builder.adapter adapter
+      end
+
+      connection
+    end
+  end
+end

data/lib/espn/error.rb

@@ -0,0 +1,12 @@
+module ESPN
+
+  # Custom error class for rescuing from all ESPN errors
+  class Error < StandardError; end
+
+  # 401 HTTP Status Code
+  class Unauthorized < Error; end
+
+  # 404 HTTP Status Code
+  class NotFound < Error; end
+
+end

data/lib/espn/request.rb

@@ -0,0 +1,22 @@
+require 'multi_json'
+
+module ESPN
+  module Request
+    def get(path, options={})
+      request(:get, path, options)
+    end
+
+    private
+
+    def request(method, path, options)
+      response = connection.send(method) do |request|
+        request.url(path, options)
+        request.options[:timeout] = timeout
+        request.options[:open_timeout] = open_timeout
+      end
+
+      response.body
+    end
+
+  end
+end

data/lib/espn/version.rb

@@ -0,0 +1,3 @@
+module ESPN
+  VERSION = "0.0.2" unless defined?(ESPN::VERSION)
+end

data/lib/faraday/response/raise_espn_error.rb

@@ -0,0 +1,28 @@
+require 'faraday'
+require 'multi_json'
+
+# @api private
+module Faraday
+  class Response::RaiseESPNError < Response::Middleware
+    def on_complete(response)
+      case response[:status].to_i
+      when 401
+        raise ESPN::Unauthorized, error_message(response)
+      when 404
+        raise ESPN::NotFound, error_message(response)
+      end
+    end
+
+    def error_message(response)
+      message = if (body = response[:body]) && !body.empty?
+        if body.is_a?(String)
+          body = MultiJson.load(body, :symbolize_keys => true)
+        end
+        ": #{body[:error] || body[:message] || ''}"
+      else
+        ''
+      end
+      "#{response[:method].to_s.upcase} #{response[:url].to_s}: #{response[:status]}#{message}"
+    end
+  end
+end

metadata

@@ -0,0 +1,269 @@
+--- !ruby/object:Gem::Specification
+name: espn
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+  prerelease: 
+platform: ruby
+authors:
+- Andrew Thorp
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-02-25 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: addressable
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.2'
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: faraday_middleware
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: hashie
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: oauth
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.4'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: markdown
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Simple wrapper for the ESPN v1 API.
+email:
+- andrewpthorp@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- Gemfile.lock
+- README.md
+- espn.gemspec
+- lib/espn.rb
+- lib/espn/client.rb
+- lib/espn/client/sports.rb
+- lib/espn/client/teams.rb
+- lib/espn/configuration.rb
+- lib/espn/connection.rb
+- lib/espn/error.rb
+- lib/espn/request.rb
+- lib/espn/version.rb
+- lib/faraday/response/raise_espn_error.rb
+homepage: http://github.com/andrewpthorp/espn
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: Simple wrapper for the ESPN v1 API.
+test_files: []
+has_rdoc: