Description

ImageSuckr is a ruby gem that allows you to get random images from the web for seeding and testing purposes.

By now, only Google is supported as images source.

Installation

1. Add gem 'image_suckr' to your Gemfile
2. Run bundle install

Basic use

Create an ImageSuckr object:

suckr = ImageSuckr::GoogleSuckr.new

To get a fully random image URL:

suckr.get_image_url

To get a random image URL based on a query:

suckr.get_image_url({"q" => "car"})

All Google Image Search API arguments are supported and you can use them to filter your results.

To get the image content instead of the URL:

suckr.get_image_content

To get a file reference to the image:

suckr.get_image_file

Other useful examples

To get a RMagick image:

image = Magick::Image.from_blob(suckr.get_image_content).first

To get a MiniMagick image:

image = MiniMagick::Image.read(suckr.get_image_content)

or

image = MiniMagick::Image.open(suckr.get_image_url)

To use with Paperclip:

car.picture = suckr.get_image_file({"q" => "car"})

To use with Carrierwave:

car.remote_picture_url = suckr.get_image_url({"q" => "car"})