paulmars / image_suckr Goto Github PK

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.

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

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

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"})