Class: ImageOptim
- Inherits:
-
Object
- Object
- ImageOptim
- Defined in:
- lib/image_optim.rb,
lib/image_optim/cmd.rb,
lib/image_optim/path.rb,
lib/image_optim/cache.rb,
lib/image_optim/space.rb,
lib/image_optim/config.rb,
lib/image_optim/runner.rb,
lib/image_optim/worker.rb,
lib/image_optim/handler.rb,
lib/image_optim/cache_path.rb,
lib/image_optim/image_meta.rb,
lib/image_optim/worker/svgo.rb,
lib/image_optim/bin_resolver.rb,
lib/image_optim/hash_helpers.rb,
lib/image_optim/worker/jhead.rb,
lib/image_optim/worker/advpng.rb,
lib/image_optim/worker/pngout.rb,
lib/image_optim/optimized_path.rb,
lib/image_optim/option_helpers.rb,
lib/image_optim/true_false_nil.rb,
lib/image_optim/worker/optipng.rb,
lib/image_optim/worker/gifsicle.rb,
lib/image_optim/worker/jpegtran.rb,
lib/image_optim/worker/pngcrush.rb,
lib/image_optim/worker/pngquant.rb,
lib/image_optim/bin_resolver/bin.rb,
lib/image_optim/worker/jpegoptim.rb,
lib/image_optim/option_definition.rb,
lib/image_optim/bin_resolver/error.rb,
lib/image_optim/configuration_error.rb,
lib/image_optim/runner/glob_helpers.rb,
lib/image_optim/runner/option_parser.rb,
lib/image_optim/worker/class_methods.rb,
lib/image_optim/worker/jpegrecompress.rb,
lib/image_optim/non_negative_integer_range.rb,
lib/image_optim/bin_resolver/simple_version.rb,
lib/image_optim/bin_resolver/comparable_condition.rb
Overview
Main interface
Defined Under Namespace
Modules: Cmd, HashHelpers, ImageMeta, OptionHelpers, Space Classes: BinResolver, Cache, CachePath, Config, ConfigurationError, Handler, NonNegativeIntegerRange, OptimizedPath, OptionDefinition, Path, Runner, TimeoutExceeded, TrueFalseNil, Worker
Instance Attribute Summary collapse
-
#allow_lossy ⇒ Object
readonly
Allow lossy workers and optimizations.
-
#cache_dir ⇒ Object
readonly
Cache directory.
-
#cache_worker_digests ⇒ Object
readonly
Cache worker digests.
-
#nice ⇒ Object
readonly
Nice level.
-
#pack ⇒ Object
readonly
Use image_optim_pack.
-
#skip_missing_workers ⇒ Object
readonly
Skip workers with missing or problematic binaries.
-
#threads ⇒ Object
readonly
Number of threads to run with.
-
#timeout ⇒ Object
readonly
Timeout.
-
#verbose ⇒ Object
readonly
Verbose output?.
Class Method Summary collapse
-
.full_version ⇒ Object
Full version of image_optim.
-
.method_missing(method, *args, &block) ⇒ Object
Optimization methods with default options.
- .respond_to_missing?(method, include_private = false) ⇒ Boolean
-
.version ⇒ Object
Version of image_optim gem spec loaded.
Instance Method Summary collapse
-
#env_path ⇒ Object
Join resolve_dir, default path and vendor path for PATH environment variable.
-
#initialize(options = {}) ⇒ ImageOptim
constructor
Initialize workers, specify options using worker underscored name:.
-
#optimizable?(path) ⇒ Boolean
Are there workers for file at path?.
-
#optimize_image(original) ⇒ Object
Optimize one file, return new path as OptimizedPath or nil if optimization failed.
-
#optimize_image!(original) ⇒ Object
Optimize one file in place, return original as OptimizedPath or nil if optimization failed.
-
#optimize_image_data(original_data) ⇒ Object
Optimize image data, return new data or nil if optimization failed.
-
#optimize_images(paths, &block) ⇒ Object
Optimize multiple images if block given yields path and result for each image and returns array of yield results else return array of path and result pairs.
-
#optimize_images!(paths, &block) ⇒ Object
Optimize multiple images in place if block given yields path and result for each image and returns array of yield results else return array of path and result pairs.
-
#optimize_images_data(datas, &block) ⇒ Object
Optimize multiple image datas if block given yields original and result for each image data and returns array of yield results else return array of path and result pairs.
-
#resolve_bin!(bin) ⇒ Object
Check existance of binary, create symlink if ENV contains path for key XXX_BIN where XXX is upper case bin name.
- #respond_to?(method, include_private = false) ⇒ Boolean
-
#workers_for_image(path) ⇒ Object
Get workers for image.
Constructor Details
#initialize(options = {}) ⇒ ImageOptim
Initialize workers, specify options using worker underscored name:
pass false to disable worker
ImageOptim.new(:pngcrush => false)
or hash with options to worker
ImageOptim.new(:advpng => {:level => 3}, :optipng => {:level => 2})
use :threads to set number of parallel optimizers to run (passing true or nil determines number of processors, false disables parallel processing)
ImageOptim.new(:threads => 8)
use :nice to specify optimizers nice level (true or nil makes it 10, false makes it 0)
ImageOptim.new(:nice => 20)
71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 |
# File 'lib/image_optim.rb', line 71 def initialize( = {}) config = Config.new() @verbose = config.verbose $stderr << "config:\n#{config.to_s.gsub(/^/, ' ')}" if verbose %w[ nice threads pack skip_missing_workers allow_lossy cache_dir cache_worker_digests timeout ].each do |name| instance_variable_set(:"@#{name}", config.send(name)) $stderr << "#{name}: #{send(name)}\n" if verbose end @bin_resolver = BinResolver.new(self) @workers_by_format = Worker.create_all_by_format(self) do |klass| config.for_worker(klass) end @cache = Cache.new(self, @workers_by_format) log_workers_by_format if verbose config. end |
Instance Attribute Details
#allow_lossy ⇒ Object (readonly)
Allow lossy workers and optimizations
41 42 43 |
# File 'lib/image_optim.rb', line 41 def allow_lossy @allow_lossy end |
#cache_dir ⇒ Object (readonly)
Cache directory
44 45 46 |
# File 'lib/image_optim.rb', line 44 def cache_dir @cache_dir end |
#cache_worker_digests ⇒ Object (readonly)
Cache worker digests
47 48 49 |
# File 'lib/image_optim.rb', line 47 def cache_worker_digests @cache_worker_digests end |
#nice ⇒ Object (readonly)
Nice level
26 27 28 |
# File 'lib/image_optim.rb', line 26 def nice @nice end |
#pack ⇒ Object (readonly)
Use image_optim_pack
35 36 37 |
# File 'lib/image_optim.rb', line 35 def pack @pack end |
#skip_missing_workers ⇒ Object (readonly)
Skip workers with missing or problematic binaries
38 39 40 |
# File 'lib/image_optim.rb', line 38 def skip_missing_workers @skip_missing_workers end |
#threads ⇒ Object (readonly)
Number of threads to run with
29 30 31 |
# File 'lib/image_optim.rb', line 29 def threads @threads end |
#timeout ⇒ Object (readonly)
Timeout
50 51 52 |
# File 'lib/image_optim.rb', line 50 def timeout @timeout end |
#verbose ⇒ Object (readonly)
Verbose output?
32 33 34 |
# File 'lib/image_optim.rb', line 32 def verbose @verbose end |
Class Method Details
.full_version ⇒ Object
Full version of image_optim
216 217 218 |
# File 'lib/image_optim.rb', line 216 def full_version "image_optim v#{version}" end |
.method_missing(method, *args, &block) ⇒ Object
Optimization methods with default options
190 191 192 193 194 195 196 |
# File 'lib/image_optim.rb', line 190 def method_missing(method, *args, &block) if optimize_image_method?(method) new.send(method, *args, &block) else super end end |
.respond_to_missing?(method, include_private = false) ⇒ Boolean
198 199 200 |
# File 'lib/image_optim.rb', line 198 def respond_to_missing?(method, include_private = false) optimize_image_method?(method) || super end |
.version ⇒ Object
Version of image_optim gem spec loaded
209 210 211 212 213 |
# File 'lib/image_optim.rb', line 209 def version Gem.loaded_specs['image_optim'].version.to_s rescue 'DEV' end |
Instance Method Details
#env_path ⇒ Object
Join resolve_dir, default path and vendor path for PATH environment variable
239 240 241 |
# File 'lib/image_optim.rb', line 239 def env_path @bin_resolver.env_path end |
#optimizable?(path) ⇒ Boolean
Are there workers for file at path?
228 229 230 |
# File 'lib/image_optim.rb', line 228 def optimizable?(path) !!workers_for_image(path) end |
#optimize_image(original) ⇒ Object
Optimize one file, return new path as OptimizedPath or nil if optimization failed
110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 |
# File 'lib/image_optim.rb', line 110 def optimize_image(original) original = Path.convert(original) return unless (workers = workers_for_image(original)) optimized = @cache.fetch(original) do Handler.for(original) do |handler| current_worker = nil begin with_timeout(@timeout) do workers.each do |worker| current_worker = worker handler.process{ |src, dst| worker.optimize(src, dst) } end end rescue TimeoutExceeded => e if current_worker && current_worker.pid pid = current_worker.pid cleanup_process(pid) end raise e end end end return unless optimized OptimizedPath.new(optimized, original) end |
#optimize_image!(original) ⇒ Object
Optimize one file in place, return original as OptimizedPath or nil if optimization failed
142 143 144 145 146 147 |
# File 'lib/image_optim.rb', line 142 def optimize_image!(original) original = Path.convert(original) return unless (result = optimize_image(original)) result.replace(original) OptimizedPath.new(original, result.original_size) end |
#optimize_image_data(original_data) ⇒ Object
Optimize image data, return new data or nil if optimization failed
150 151 152 153 154 155 156 157 158 159 160 161 162 |
# File 'lib/image_optim.rb', line 150 def optimize_image_data(original_data) format = ImageMeta.format_for_data(original_data) return unless format Path.temp_file %W[image_optim .#{format}] do |temp| temp.binmode temp.write(original_data) temp.close if (result = optimize_image(temp.path)) result.binread end end end |
#optimize_images(paths, &block) ⇒ Object
Optimize multiple images if block given yields path and result for each image and returns array of yield results else return array of path and result pairs
168 169 170 |
# File 'lib/image_optim.rb', line 168 def optimize_images(paths, &block) run_method_for(paths, :optimize_image, &block) end |
#optimize_images!(paths, &block) ⇒ Object
Optimize multiple images in place if block given yields path and result for each image and returns array of yield results else return array of path and result pairs
176 177 178 |
# File 'lib/image_optim.rb', line 176 def optimize_images!(paths, &block) run_method_for(paths, :optimize_image!, &block) end |
#optimize_images_data(datas, &block) ⇒ Object
Optimize multiple image datas if block given yields original and result for each image data and returns array of yield results else return array of path and result pairs
184 185 186 |
# File 'lib/image_optim.rb', line 184 def optimize_images_data(datas, &block) run_method_for(datas, :optimize_image_data, &block) end |
#resolve_bin!(bin) ⇒ Object
Check existance of binary, create symlink if ENV contains path for key XXX_BIN where XXX is upper case bin name
234 235 236 |
# File 'lib/image_optim.rb', line 234 def resolve_bin!(bin) @bin_resolver.resolve!(bin) end |
#respond_to?(method, include_private = false) ⇒ Boolean
203 204 205 |
# File 'lib/image_optim.rb', line 203 def respond_to?(method, include_private = false) optimize_image_method?(method) || super end |