gem "noun-project-api", "~> 1.0.0"

# initializers/noun_project_api.rb
NounProjectApi.configure do |config|
  # Will only show public domain icons when running in dev/test envs
  config.public_domain = ['development', 'test'].include?(ENV['RAILS_ENV'])
end

icon_finder = NounProjectApi::IconRetriever.new(token, secret)

result = icon_finder.find(1) # Returns a hash of the parsed JSON result.

result = icon_finder.find_by_slug('globe') # Returns a hash of the parsed JSON result.

icons_finder = NounProjectApi::IconsRetriever.new(token, secret)

result = icons_finder.find('cat') # Returns an array of the parsed JSON results.

result = icons_finder.recent_uploads # Returns an array of the parsed JSON results.

collection_finder = NounProjectApi::CollectionRetriever.new(token, secret)

result = collection_finder.find(1) # Returns a hash of the parsed JSON result.

result = collection_finder_finder.find_by_slug('national-park-service') # Returns a hash of the parsed JSON result.

result.class # NounProjectApi::Icon
result.id # 1
result.public_domain? # true/false
result.svg_url # url/nil
result.preview_url # 200 size preview url
result.preview_url(42) # 42 size preview url

# You can always access the original Hash at
result.original_hash