Skip to content
Get images randomly from the web
Ruby
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
lib
spec
.gitignore
.rspec
Gemfile
README.md
Rakefile
image_suckr.gemspec

README.md

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"})
You can’t perform that action at this time.