Retrieve total and total_pages pagination metadata from search method

[gustavosobral]

Closes #40

[aaronklaassen]

@gustavosobral Yeah you're right this should be fixed, but I'm hesitant to bump a major version for it (i.e. break the return value of the #search methods).

Another option might be to create a SearchResult class that delegates to the existing array, but also has some attr_readers on it for the totals. Something like:

class SearchResult < SimpleDelegator
  attr_reader :total, :total_pages
end

# Photo
def search(...)
  results = get().parse().whatever # Array
  SearchResult.new(results)
end

^ I mean that's fuzzy, obviously. But does that makes sense?

[aaronklaassen]

Closing this due to #45