Using Through Rake
Create a Rakefile in your app’s root (or add this to an existing Rakefile):
require 'your/app' require 'tiny_png/tasks'
rake tiny_png:shrink task can be called to shrink images from the command line. To use this rake task, you must pass a environment variable called
SHRINK should be a comma-separated list of paths you want shrunk. As with the
@client.shrink method, the
SHRINK variable accepts both directories and specific image paths.
NOTE: Because this works by splitting the environment string into an array based on a comma separator, it follows that you can’t have commas in your directory or image paths.
The same constraints exist from rake as do from the method call: namely, you must supply the full path, and specific image paths must exist, be readable, be writable, and end in .png.
Shrink a single file:
SHRINK=/path/to/image.png rake tiny_png:shrink
Shrink multiple files:
SHRINK=/path/to/first.png,/path/to/second.png rake tiny_png:shrink
Shrink a whole directory:
SHRINK=/image/directory rake tiny_png:shrink
Combining directories and specific image files:
SHRINK=/image/directory,/path/to/image.png rake tiny_png:shrink
The Rake task uses the blacklist method in building out the full paths. This method allows you to also specify blacklisted paths:
SHRINK=/image/directory BLACKLIST=/image/directory/blacklist.png rake tiny_png:shrink
By default, this rake task will use the settings in config/tiny_png.yml. You can overwrite specific settings by passing environment variables. For example, if I do not suppress exceptions in my base config, but want to when running a rake task, all I would need to do is set the
SUPPRESS_EXCEPTIONS environment variable to true:
SUPPRESS_EXCEPTIONS=true SHRINK=/some/image.png rake tiny_png:shrink
You can pass in an api key in a similar way:
API_KEY=my_api_key SHRINK=/some/image.png rake tiny_png:shrink
Naturally, these can all be combined in any fashion:
SUPPRESS_EXCEPTIONS=true API_KEY=my_api_key SHRINK=/image/directory,/some/image.png BLACKLIST=/image/directory/blacklist.png rake tiny_png:shrink