Class: Paperclip::Style

Inherits:

Object

• Object
• Paperclip::Style

show all

Defined in:

lib/paperclip/style.rb

Overview

Instance Attribute Summary (collapse)

• - (Object) attachment readonly

  Returns the value of attribute attachment.

• - (Object) format readonly

  Returns the value of attribute format.

• - (Object) name readonly

  Returns the value of attribute name.

Instance Method Summary (collapse)

• - (Object) [](key)

  Supports getting and setting style properties with hash notation to ensure backwards-compatibility eg.

• - (Object) []=(key, value)
• - (Object) convert_options
• - (Object) geometry

  returns the geometry string for this style if a proc has been supplied, we call it here.

• - (Style) initialize(name, definition, attachment) constructor

  Creates a Style object.

• - (Object) processor_options

  Supplies the hash of options that processors expect to receive as their second argument Arguments other than the standard geometry, format etc are just passed through from initialization and any procs are called here, just before post-processing.

• - (Object) processors

  retrieves from the attachment the processors defined in the has_attached_file call (which method (in the attachment) will call any supplied procs) There is an important change of interface here: a style rule can set its own processors by default we behave as before, though.

• - (Object) source_file_options
• - (Object) whiny

  retrieves from the attachment the whiny setting.

• - (Boolean) whiny?

  returns true if we're inclined to grumble.

14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

# File 'lib/paperclip/style.rb', line 14

def initialize name, definition, attachment
  @name = name
  @attachment = attachment
  if definition.is_a? Hash
    @geometry = definition.delete(:geometry)
    @format = definition.delete(:format)
    @processors = definition.delete(:processors)
    @convert_options = definition.delete(:convert_options)
    @source_file_options = definition.delete(:source_file_options)
    @other_args = definition
  elsif definition.is_a? String
    @geometry = definition
    @format = nil
    @other_args = {}
  else
    @geometry, @format = [definition, nil].flatten[0..1]
    @other_args = {}
  end
  @format  = nil if @format.blank?
end

9
10
11

# File 'lib/paperclip/style.rb', line 9

def attachment
  @attachment
end

9
10
11

# File 'lib/paperclip/style.rb', line 9

def format
  @format
end

9
10
11

# File 'lib/paperclip/style.rb', line 9

def name
  @name
end

86
87
88
89
90
91
92

# File 'lib/paperclip/style.rb', line 86

def [](key)
  if [:name, :convert_options, :whiny, :processors, :geometry, :format, :animated, :source_file_options].include?(key)
    send(key)
  elsif defined? @other_args[key]
    @other_args[key]
  end
end

94
95
96
97
98
99
100

# File 'lib/paperclip/style.rb', line 94

def []=(key, value)
  if [:name, :convert_options, :whiny, :processors, :geometry, :format, :animated, :source_file_options].include?(key)
    send("#{key}=".intern, value)
  else
    @other_args[key] = value
  end
end

54
55
56
57

# File 'lib/paperclip/style.rb', line 54

def convert_options
  @convert_options.respond_to?(:call) ? @convert_options.call(attachment.instance) : 
    (@convert_options || attachment.send(:extra_options_for, name))
end

66
67
68

# File 'lib/paperclip/style.rb', line 66

def geometry
  @geometry.respond_to?(:call) ? @geometry.call(attachment.instance) : @geometry
end

73
74
75
76
77
78
79
80
81
82

# File 'lib/paperclip/style.rb', line 73

def processor_options
  args = {}
  @other_args.each do |k,v|
    args[k] = v.respond_to?(:call) ? v.call(attachment) : v
  end
  [:processors, :geometry, :format, :whiny, :convert_options, :source_file_options].each do |k|
    (arg = send(k)) && args[k] = arg
  end
  args
end

40
41
42

# File 'lib/paperclip/style.rb', line 40

def processors
  @processors.respond_to?(:call) ? @processors.call(attachment.instance) : (@processors || attachment.processors)
end

59
60
61
62

# File 'lib/paperclip/style.rb', line 59

def source_file_options
  @source_file_options.respond_to?(:call) ? @source_file_options.call(attachment.instance) : 
    (@source_file_options || attachment.send(:extra_source_file_options_for, name))
end

45
46
47

# File 'lib/paperclip/style.rb', line 45

def whiny
  attachment.whiny
end

50
51
52

# File 'lib/paperclip/style.rb', line 50

def whiny?
  !!whiny
end