Module: NBA::ResponseParser

Defined in:
lib/nba/response_parser.rb

Overview

Parses NBA API responses and builds collections of objects

This module consolidates the common pattern of parsing JSON responses from the NBA Stats API, extracting result sets, and building objects from header/row pairs.

Class Method Summary collapse

Class Method Details

.parse(response, result_set: nil) {|Hash| ... } ⇒ Collection

Parses an API response and returns a collection of objects

Examples:

ResponseParser.parse(response, result_set: "PlayerStats") { |data| Player.new(**data) }

Yields:

  • (Hash) —

    yields each row as a hash with header keys



20
21
22
23
24
25
26
27
28
29
30
 
# File 'lib/nba/response_parser.rb', line 20

def self.parse(response, result_set: nil, &builder)
  return Collection.new unless response

  data = parse_json(response)
  return Collection.new unless data

  result = find_result_set(data, result_set)
  return Collection.new unless result

  build_collection(result, &builder)
end

.parse_single(response, result_set: nil) {|Hash| ... } ⇒ Object?

Parses an API response and returns a single object

Examples:

ResponseParser.parse_single(response) { |data| Player.new(**data) }

Yields:

  • (Hash) —

    yields the first row as a hash with header keys



41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
 
# File 'lib/nba/response_parser.rb', line 41

def self.parse_single(response, result_set: nil)
  return unless response

  data = parse_json(response)
  return unless data

  result = find_result_set(data, result_set)
  return unless result

  headers = result["headers"]
  row = result.dig("rowSet", 0)
  return unless headers && row

  yield zip_to_hash(headers, row)
end

.zip_to_hash(headers, row) ⇒ Hash

Zips headers and row into a hash

Examples:

ResponseParser.zip_to_hash(["NAME", "AGE"], ["LeBron", 39])
#=> {"NAME" => "LeBron", "AGE" => 39}



66
67
68
 
# File 'lib/nba/response_parser.rb', line 66

def self.zip_to_hash(headers, row)
  headers.zip(row).to_h
end