metacpan-api.txt

MetaCPAN::API
  ->new(base_url, user_agent)

  ->author(author_id)         # returns a ::Author object
  ->author_search({ query })  # returns a ::ResultSet object
  # additional methods for objects
  # additional methods for backcompat

MetaCPAN::API::Author
  ->name
  # etc

MetaCPAN::API::Request
  # used for querying and interpreting results

MetaCPAN::API::ResultSet
  ->first
  ->page
  ->all # all pages?

MetaCPAN::API::ResultIterator
  ->next
  # automatic pagination