mbailey-paperclip 2.3.2

Sign up to get free protection for your applications and to get access to all the features.
Files changed (56) hide show
  1. data/LICENSE +26 -0
  2. data/README.rdoc +179 -0
  3. data/Rakefile +76 -0
  4. data/generators/paperclip/USAGE +5 -0
  5. data/generators/paperclip/paperclip_generator.rb +27 -0
  6. data/generators/paperclip/templates/paperclip_migration.rb.erb +19 -0
  7. data/init.rb +1 -0
  8. data/lib/generators/paperclip/USAGE +8 -0
  9. data/lib/generators/paperclip/paperclip_generator.rb +31 -0
  10. data/lib/generators/paperclip/templates/paperclip_migration.rb.erb +19 -0
  11. data/lib/paperclip/attachment.rb +326 -0
  12. data/lib/paperclip/callback_compatability.rb +61 -0
  13. data/lib/paperclip/geometry.rb +115 -0
  14. data/lib/paperclip/interpolations.rb +108 -0
  15. data/lib/paperclip/iostream.rb +59 -0
  16. data/lib/paperclip/matchers/have_attached_file_matcher.rb +57 -0
  17. data/lib/paperclip/matchers/validate_attachment_content_type_matcher.rb +74 -0
  18. data/lib/paperclip/matchers/validate_attachment_presence_matcher.rb +54 -0
  19. data/lib/paperclip/matchers/validate_attachment_size_matcher.rb +95 -0
  20. data/lib/paperclip/matchers.rb +33 -0
  21. data/lib/paperclip/processor.rb +49 -0
  22. data/lib/paperclip/railtie.rb +24 -0
  23. data/lib/paperclip/storage.rb +247 -0
  24. data/lib/paperclip/style.rb +90 -0
  25. data/lib/paperclip/thumbnail.rb +78 -0
  26. data/lib/paperclip/upfile.rb +52 -0
  27. data/lib/paperclip/version.rb +3 -0
  28. data/lib/paperclip.rb +397 -0
  29. data/lib/tasks/paperclip.rake +79 -0
  30. data/rails/init.rb +2 -0
  31. data/shoulda_macros/paperclip.rb +119 -0
  32. data/test/attachment_test.rb +758 -0
  33. data/test/database.yml +4 -0
  34. data/test/fixtures/12k.png +0 -0
  35. data/test/fixtures/50x50.png +0 -0
  36. data/test/fixtures/5k.png +0 -0
  37. data/test/fixtures/bad.png +1 -0
  38. data/test/fixtures/s3.yml +8 -0
  39. data/test/fixtures/text.txt +0 -0
  40. data/test/fixtures/twopage.pdf +0 -0
  41. data/test/geometry_test.rb +177 -0
  42. data/test/helper.rb +148 -0
  43. data/test/integration_test.rb +483 -0
  44. data/test/interpolations_test.rb +124 -0
  45. data/test/iostream_test.rb +78 -0
  46. data/test/matchers/have_attached_file_matcher_test.rb +24 -0
  47. data/test/matchers/validate_attachment_content_type_matcher_test.rb +37 -0
  48. data/test/matchers/validate_attachment_presence_matcher_test.rb +26 -0
  49. data/test/matchers/validate_attachment_size_matcher_test.rb +51 -0
  50. data/test/paperclip_test.rb +317 -0
  51. data/test/processor_test.rb +10 -0
  52. data/test/storage_test.rb +343 -0
  53. data/test/style_test.rb +141 -0
  54. data/test/thumbnail_test.rb +227 -0
  55. data/test/upfile_test.rb +36 -0
  56. metadata +205 -0
@@ -0,0 +1,326 @@
1
+ # encoding: utf-8
2
+ module Paperclip
3
+ # The Attachment class manages the files for a given attachment. It saves
4
+ # when the model saves, deletes when the model is destroyed, and processes
5
+ # the file upon assignment.
6
+ class Attachment
7
+
8
+ def self.default_options
9
+ @default_options ||= {
10
+ :url => "/system/:attachment/:id/:style/:filename",
11
+ :path => ":rails_root/public:url",
12
+ :styles => {},
13
+ :processors => [:thumbnail],
14
+ :convert_options => {},
15
+ :default_url => "/:attachment/:style/missing.png",
16
+ :default_style => :original,
17
+ :storage => :filesystem,
18
+ :whiny => Paperclip.options[:whiny] || Paperclip.options[:whiny_thumbnails]
19
+ }
20
+ end
21
+
22
+ attr_reader :name, :instance, :default_style, :convert_options, :queued_for_write, :whiny, :options
23
+
24
+ # Creates an Attachment object. +name+ is the name of the attachment,
25
+ # +instance+ is the ActiveRecord object instance it's attached to, and
26
+ # +options+ is the same as the hash passed to +has_attached_file+.
27
+ def initialize name, instance, options = {}
28
+ @name = name
29
+ @instance = instance
30
+
31
+ options = self.class.default_options.merge(options)
32
+
33
+ @url = options[:url]
34
+ @url = @url.call(self) if @url.is_a?(Proc)
35
+ @path = options[:path]
36
+ @path = @path.call(self) if @path.is_a?(Proc)
37
+ @styles = options[:styles]
38
+ @normalized_styles = nil
39
+ @default_url = options[:default_url]
40
+ @default_style = options[:default_style]
41
+ @storage = options[:storage]
42
+ @whiny = options[:whiny_thumbnails] || options[:whiny]
43
+ @convert_options = options[:convert_options]
44
+ @processors = options[:processors]
45
+ @options = options
46
+ @queued_for_delete = []
47
+ @queued_for_write = {}
48
+ @errors = {}
49
+ @dirty = false
50
+
51
+ initialize_storage
52
+ end
53
+
54
+ def styles
55
+ unless @normalized_styles
56
+ @normalized_styles = {}
57
+ (@styles.respond_to?(:call) ? @styles.call(self) : @styles).each do |name, args|
58
+ @normalized_styles[name] = Paperclip::Style.new(name, args, self)
59
+ end
60
+ end
61
+ @normalized_styles
62
+ end
63
+
64
+ def processors
65
+ @processors.respond_to?(:call) ? @processors.call(instance) : @processors
66
+ end
67
+
68
+ # What gets called when you call instance.attachment = File. It clears
69
+ # errors, assigns attributes, and processes the file. It
70
+ # also queues up the previous file for deletion, to be flushed away on
71
+ # #save of its host. In addition to form uploads, you can also assign
72
+ # another Paperclip attachment:
73
+ # new_user.avatar = old_user.avatar
74
+ def assign uploaded_file
75
+ ensure_required_accessors!
76
+
77
+ if uploaded_file.is_a?(Paperclip::Attachment)
78
+ uploaded_file = uploaded_file.to_file(:original)
79
+ close_uploaded_file = uploaded_file.respond_to?(:close)
80
+ end
81
+
82
+ return nil unless valid_assignment?(uploaded_file)
83
+
84
+ uploaded_file.binmode if uploaded_file.respond_to? :binmode
85
+ self.clear
86
+
87
+ return nil if uploaded_file.nil?
88
+
89
+ @queued_for_write[:original] = uploaded_file.to_tempfile
90
+ instance_write(:file_name, uploaded_file.original_filename.strip)
91
+ instance_write(:content_type, uploaded_file.content_type.to_s.strip)
92
+ instance_write(:file_size, uploaded_file.size.to_i)
93
+ instance_write(:updated_at, Time.now)
94
+
95
+ @dirty = true
96
+
97
+ post_process
98
+
99
+ # Reset the file size if the original file was reprocessed.
100
+ instance_write(:file_size, @queued_for_write[:original].size.to_i)
101
+ ensure
102
+ uploaded_file.close if close_uploaded_file
103
+ end
104
+
105
+ # Returns the public URL of the attachment, with a given style. Note that
106
+ # this does not necessarily need to point to a file that your web server
107
+ # can access and can point to an action in your app, if you need fine
108
+ # grained security. This is not recommended if you don't need the
109
+ # security, however, for performance reasons. set
110
+ # include_updated_timestamp to false if you want to stop the attachment
111
+ # update time appended to the url
112
+ def url style_name = default_style, include_updated_timestamp = true
113
+ url = original_filename.nil? ? interpolate(@default_url, style_name) : interpolate(@url, style_name)
114
+ include_updated_timestamp && updated_at ? [url, updated_at].compact.join(url.include?("?") ? "&" : "?") : url
115
+ end
116
+
117
+ # Returns the path of the attachment as defined by the :path option. If the
118
+ # file is stored in the filesystem the path refers to the path of the file
119
+ # on disk. If the file is stored in S3, the path is the "key" part of the
120
+ # URL, and the :bucket option refers to the S3 bucket.
121
+ def path style_name = default_style
122
+ original_filename.nil? ? nil : interpolate(@path, style_name)
123
+ end
124
+
125
+ # Alias to +url+
126
+ def to_s style_name = nil
127
+ url(style_name)
128
+ end
129
+
130
+ # Returns an array containing the errors on this attachment.
131
+ def errors
132
+ @errors
133
+ end
134
+
135
+ # Returns true if there are changes that need to be saved.
136
+ def dirty?
137
+ @dirty
138
+ end
139
+
140
+ # Saves the file, if there are no errors. If there are, it flushes them to
141
+ # the instance's errors and returns false, cancelling the save.
142
+ def save
143
+ flush_deletes
144
+ flush_writes
145
+ @dirty = false
146
+ true
147
+ end
148
+
149
+ # Clears out the attachment. Has the same effect as previously assigning
150
+ # nil to the attachment. Does NOT save. If you wish to clear AND save,
151
+ # use #destroy.
152
+ def clear
153
+ queue_existing_for_delete
154
+ @errors = {}
155
+ end
156
+
157
+ # Destroys the attachment. Has the same effect as previously assigning
158
+ # nil to the attachment *and saving*. This is permanent. If you wish to
159
+ # wipe out the existing attachment but not save, use #clear.
160
+ def destroy
161
+ clear
162
+ save
163
+ end
164
+
165
+ # Returns the name of the file as originally assigned, and lives in the
166
+ # <attachment>_file_name attribute of the model.
167
+ def original_filename
168
+ instance_read(:file_name)
169
+ end
170
+
171
+ # Returns the size of the file as originally assigned, and lives in the
172
+ # <attachment>_file_size attribute of the model.
173
+ def size
174
+ instance_read(:file_size) || (@queued_for_write[:original] && @queued_for_write[:original].size)
175
+ end
176
+
177
+ # Returns the content_type of the file as originally assigned, and lives
178
+ # in the <attachment>_content_type attribute of the model.
179
+ def content_type
180
+ instance_read(:content_type)
181
+ end
182
+
183
+ # Returns the last modified time of the file as originally assigned, and
184
+ # lives in the <attachment>_updated_at attribute of the model.
185
+ def updated_at
186
+ time = instance_read(:updated_at)
187
+ time && time.to_f.to_i
188
+ end
189
+
190
+ # Paths and URLs can have a number of variables interpolated into them
191
+ # to vary the storage location based on name, id, style, class, etc.
192
+ # This method is a deprecated access into supplying and retrieving these
193
+ # interpolations. Future access should use either Paperclip.interpolates
194
+ # or extend the Paperclip::Interpolations module directly.
195
+ def self.interpolations
196
+ warn('[DEPRECATION] Paperclip::Attachment.interpolations is deprecated ' +
197
+ 'and will be removed from future versions. ' +
198
+ 'Use Paperclip.interpolates instead')
199
+ Paperclip::Interpolations
200
+ end
201
+
202
+ # This method really shouldn't be called that often. It's expected use is
203
+ # in the paperclip:refresh rake task and that's it. It will regenerate all
204
+ # thumbnails forcefully, by reobtaining the original file and going through
205
+ # the post-process again.
206
+ def reprocess!
207
+ new_original = Tempfile.new("paperclip-reprocess")
208
+ new_original.binmode
209
+ if old_original = to_file(:original)
210
+ new_original.write( old_original.read )
211
+ new_original.rewind
212
+
213
+ @queued_for_write = { :original => new_original }
214
+ post_process
215
+
216
+ old_original.close if old_original.respond_to?(:close)
217
+
218
+ save
219
+ else
220
+ true
221
+ end
222
+ end
223
+
224
+ # Returns true if a file has been assigned.
225
+ def file?
226
+ !original_filename.blank?
227
+ end
228
+
229
+ # Writes the attachment-specific attribute on the instance. For example,
230
+ # instance_write(:file_name, "me.jpg") will write "me.jpg" to the instance's
231
+ # "avatar_file_name" field (assuming the attachment is called avatar).
232
+ def instance_write(attr, value)
233
+ setter = :"#{name}_#{attr}="
234
+ responds = instance.respond_to?(setter)
235
+ self.instance_variable_set("@_#{setter.to_s.chop}", value)
236
+ instance.send(setter, value) if responds || attr.to_s == "file_name"
237
+ end
238
+
239
+ # Reads the attachment-specific attribute on the instance. See instance_write
240
+ # for more details.
241
+ def instance_read(attr)
242
+ getter = :"#{name}_#{attr}"
243
+ responds = instance.respond_to?(getter)
244
+ cached = self.instance_variable_get("@_#{getter}")
245
+ return cached if cached
246
+ instance.send(getter) if responds || attr.to_s == "file_name"
247
+ end
248
+
249
+ private
250
+
251
+ def ensure_required_accessors! #:nodoc:
252
+ %w(file_name).each do |field|
253
+ unless @instance.respond_to?("#{name}_#{field}") && @instance.respond_to?("#{name}_#{field}=")
254
+ raise PaperclipError.new("#{@instance.class} model missing required attr_accessor for '#{name}_#{field}'")
255
+ end
256
+ end
257
+ end
258
+
259
+ def log message #:nodoc:
260
+ Paperclip.log(message)
261
+ end
262
+
263
+ def valid_assignment? file #:nodoc:
264
+ file.nil? || (file.respond_to?(:original_filename) && file.respond_to?(:content_type))
265
+ end
266
+
267
+ def initialize_storage #:nodoc:
268
+ @storage_module = Paperclip::Storage.const_get(@storage.to_s.capitalize)
269
+ self.extend(@storage_module)
270
+ end
271
+
272
+ def extra_options_for(style) #:nodoc:
273
+ all_options = convert_options[:all]
274
+ all_options = all_options.call(instance) if all_options.respond_to?(:call)
275
+ style_options = convert_options[style]
276
+ style_options = style_options.call(instance) if style_options.respond_to?(:call)
277
+
278
+ [ style_options, all_options ].compact.join(" ")
279
+ end
280
+
281
+ def post_process #:nodoc:
282
+ return if @queued_for_write[:original].nil?
283
+ instance.run_paperclip_callbacks(:post_process) do
284
+ instance.run_paperclip_callbacks(:"#{name}_post_process") do
285
+ post_process_styles
286
+ end
287
+ end
288
+ end
289
+
290
+ def post_process_styles #:nodoc:
291
+ styles.each do |name, style|
292
+ begin
293
+ raise RuntimeError.new("Style #{name} has no processors defined.") if style.processors.blank?
294
+ @queued_for_write[name] = style.processors.inject(@queued_for_write[:original]) do |file, processor|
295
+ Paperclip.processor(processor).make(file, style.processor_options, self)
296
+ end
297
+ rescue PaperclipError => e
298
+ log("An error was received while processing: #{e.inspect}")
299
+ (@errors[:processing] ||= []) << e.message if @whiny
300
+ end
301
+ end
302
+ end
303
+
304
+ def interpolate pattern, style_name = default_style #:nodoc:
305
+ Paperclip::Interpolations.interpolate(pattern, self, style_name)
306
+ end
307
+
308
+ def queue_existing_for_delete #:nodoc:
309
+ return unless file?
310
+ @queued_for_delete += [:original, *styles.keys].uniq.map do |style|
311
+ path(style) if exists?(style)
312
+ end.compact
313
+ instance_write(:file_name, nil)
314
+ instance_write(:content_type, nil)
315
+ instance_write(:file_size, nil)
316
+ instance_write(:updated_at, nil)
317
+ end
318
+
319
+ def flush_errors #:nodoc:
320
+ @errors.each do |error, message|
321
+ [message].flatten.each {|m| instance.errors.add(name, m) }
322
+ end
323
+ end
324
+
325
+ end
326
+ end
@@ -0,0 +1,61 @@
1
+ module Paperclip
2
+ module CallbackCompatability
3
+ module Rails21
4
+ def self.included(base)
5
+ base.extend(Defining)
6
+ base.send(:include, Running)
7
+ end
8
+
9
+ module Defining
10
+ def define_paperclip_callbacks(*args)
11
+ args.each do |callback|
12
+ define_callbacks("before_#{callback}")
13
+ define_callbacks("after_#{callback}")
14
+ end
15
+ end
16
+ end
17
+
18
+ module Running
19
+ def run_paperclip_callbacks(callback, opts = nil, &blk)
20
+ # The overall structure of this isn't ideal since after callbacks run even if
21
+ # befores return false. But this is how rails 3's callbacks work, unfortunately.
22
+ if run_callbacks(:"before_#{callback}"){ |result, object| result == false } != false
23
+ blk.call
24
+ end
25
+ run_callbacks(:"after_#{callback}"){ |result, object| result == false }
26
+ end
27
+ end
28
+ end
29
+
30
+ module Rails3
31
+ def self.included(base)
32
+ base.extend(Defining)
33
+ base.send(:include, Running)
34
+ end
35
+
36
+ module Defining
37
+ def define_paperclip_callbacks(*callbacks)
38
+ define_callbacks *[callbacks, {:terminator => "result == false"}].flatten
39
+ callbacks.each do |callback|
40
+ eval <<-end_callbacks
41
+ def before_#{callback}(*args, &blk)
42
+ set_callback(:#{callback}, :before, *args, &blk)
43
+ end
44
+ def after_#{callback}(*args, &blk)
45
+ set_callback(:#{callback}, :after, *args, &blk)
46
+ end
47
+ end_callbacks
48
+ end
49
+ end
50
+ end
51
+
52
+ module Running
53
+ def run_paperclip_callbacks(callback, opts = nil, &block)
54
+ run_callbacks(callback, opts, &block)
55
+ end
56
+ end
57
+
58
+ end
59
+
60
+ end
61
+ end
@@ -0,0 +1,115 @@
1
+ module Paperclip
2
+
3
+ # Defines the geometry of an image.
4
+ class Geometry
5
+ attr_accessor :height, :width, :modifier
6
+
7
+ # Gives a Geometry representing the given height and width
8
+ def initialize width = nil, height = nil, modifier = nil
9
+ @height = height.to_f
10
+ @width = width.to_f
11
+ @modifier = modifier
12
+ end
13
+
14
+ # Uses ImageMagick to determing the dimensions of a file, passed in as either a
15
+ # File or path.
16
+ def self.from_file file
17
+ file = file.path if file.respond_to? "path"
18
+ geometry = begin
19
+ Paperclip.run("identify", "-format", "%wx%h", "#{file}[0]")
20
+ rescue PaperclipCommandLineError
21
+ ""
22
+ end
23
+ parse(geometry) ||
24
+ raise(NotIdentifiedByImageMagickError.new("#{file} is not recognized by the 'identify' command."))
25
+ end
26
+
27
+ # Parses a "WxH" formatted string, where W is the width and H is the height.
28
+ def self.parse string
29
+ if match = (string && string.match(/\b(\d*)x?(\d*)\b([\>\<\#\@\%^!])?/i))
30
+ Geometry.new(*match[1,3])
31
+ end
32
+ end
33
+
34
+ # True if the dimensions represent a square
35
+ def square?
36
+ height == width
37
+ end
38
+
39
+ # True if the dimensions represent a horizontal rectangle
40
+ def horizontal?
41
+ height < width
42
+ end
43
+
44
+ # True if the dimensions represent a vertical rectangle
45
+ def vertical?
46
+ height > width
47
+ end
48
+
49
+ # The aspect ratio of the dimensions.
50
+ def aspect
51
+ width / height
52
+ end
53
+
54
+ # Returns the larger of the two dimensions
55
+ def larger
56
+ [height, width].max
57
+ end
58
+
59
+ # Returns the smaller of the two dimensions
60
+ def smaller
61
+ [height, width].min
62
+ end
63
+
64
+ # Returns the width and height in a format suitable to be passed to Geometry.parse
65
+ def to_s
66
+ s = ""
67
+ s << width.to_i.to_s if width > 0
68
+ s << "x#{height.to_i}" if height > 0
69
+ s << modifier.to_s
70
+ s
71
+ end
72
+
73
+ # Same as to_s
74
+ def inspect
75
+ to_s
76
+ end
77
+
78
+ # Returns the scaling and cropping geometries (in string-based ImageMagick format)
79
+ # neccessary to transform this Geometry into the Geometry given. If crop is true,
80
+ # then it is assumed the destination Geometry will be the exact final resolution.
81
+ # In this case, the source Geometry is scaled so that an image containing the
82
+ # destination Geometry would be completely filled by the source image, and any
83
+ # overhanging image would be cropped. Useful for square thumbnail images. The cropping
84
+ # is weighted at the center of the Geometry.
85
+ def transformation_to dst, crop = false
86
+ if crop
87
+ ratio = Geometry.new( dst.width / self.width, dst.height / self.height )
88
+ scale_geometry, scale = scaling(dst, ratio)
89
+ crop_geometry = cropping(dst, ratio, scale)
90
+ else
91
+ scale_geometry = dst.to_s
92
+ end
93
+
94
+ [ scale_geometry, crop_geometry ]
95
+ end
96
+
97
+ private
98
+
99
+ def scaling dst, ratio
100
+ if ratio.horizontal? || ratio.square?
101
+ [ "%dx" % dst.width, ratio.width ]
102
+ else
103
+ [ "x%d" % dst.height, ratio.height ]
104
+ end
105
+ end
106
+
107
+ def cropping dst, ratio, scale
108
+ if ratio.horizontal? || ratio.square?
109
+ "%dx%d+%d+%d" % [ dst.width, dst.height, 0, (self.height * scale - dst.height) / 2 ]
110
+ else
111
+ "%dx%d+%d+%d" % [ dst.width, dst.height, (self.width * scale - dst.width) / 2, 0 ]
112
+ end
113
+ end
114
+ end
115
+ end
@@ -0,0 +1,108 @@
1
+ module Paperclip
2
+ # This module contains all the methods that are available for interpolation
3
+ # in paths and urls. To add your own (or override an existing one), you
4
+ # can either open this module and define it, or call the
5
+ # Paperclip.interpolates method.
6
+ module Interpolations
7
+ extend self
8
+
9
+ # Hash assignment of interpolations. Included only for compatability,
10
+ # and is not intended for normal use.
11
+ def self.[]= name, block
12
+ define_method(name, &block)
13
+ end
14
+
15
+ # Hash access of interpolations. Included only for compatability,
16
+ # and is not intended for normal use.
17
+ def self.[] name
18
+ method(name)
19
+ end
20
+
21
+ # Returns a sorted list of all interpolations.
22
+ def self.all
23
+ self.instance_methods(false).sort
24
+ end
25
+
26
+ # Perform the actual interpolation. Takes the pattern to interpolate
27
+ # and the arguments to pass, which are the attachment and style name.
28
+ def self.interpolate pattern, *args
29
+ all.reverse.inject( pattern.dup ) do |result, tag|
30
+ result.gsub(/:#{tag}/) do |match|
31
+ send( tag, *args )
32
+ end
33
+ end
34
+ end
35
+
36
+ # Returns the filename, the same way as ":basename.:extension" would.
37
+ def filename attachment, style_name
38
+ "#{basename(attachment, style_name)}.#{extension(attachment, style_name)}"
39
+ end
40
+
41
+ # Returns the interpolated URL. Will raise an error if the url itself
42
+ # contains ":url" to prevent infinite recursion. This interpolation
43
+ # is used in the default :path to ease default specifications.
44
+ def url attachment, style_name
45
+ raise InfiniteInterpolationError if attachment.options[:url].include?(":url")
46
+ attachment.url(style_name, false)
47
+ end
48
+
49
+ # Returns the timestamp as defined by the <attachment>_updated_at field
50
+ def timestamp attachment, style_name
51
+ attachment.instance_read(:updated_at).to_s
52
+ end
53
+
54
+ # Returns the Rails.root constant.
55
+ def rails_root attachment, style_name
56
+ Rails.root
57
+ end
58
+
59
+ # Returns the Rails.env constant.
60
+ def rails_env attachment, style_name
61
+ Rails.env
62
+ end
63
+
64
+ # Returns the underscored, pluralized version of the class name.
65
+ # e.g. "users" for the User class.
66
+ # NOTE: The arguments need to be optional, because some tools fetch
67
+ # all class names. Calling #class will return the expected class.
68
+ def class attachment = nil, style_name = nil
69
+ return super() if attachment.nil? && style_name.nil?
70
+ attachment.instance.class.to_s.underscore.pluralize
71
+ end
72
+
73
+ # Returns the basename of the file. e.g. "file" for "file.jpg"
74
+ def basename attachment, style_name
75
+ attachment.original_filename.gsub(/#{File.extname(attachment.original_filename)}$/, "")
76
+ end
77
+
78
+ # Returns the extension of the file. e.g. "jpg" for "file.jpg"
79
+ # If the style has a format defined, it will return the format instead
80
+ # of the actual extension.
81
+ def extension attachment, style_name
82
+ ((style = attachment.styles[style_name]) && style[:format]) ||
83
+ File.extname(attachment.original_filename).gsub(/^\.+/, "")
84
+ end
85
+
86
+ # Returns the id of the instance.
87
+ def id attachment, style_name
88
+ attachment.instance.id
89
+ end
90
+
91
+ # Returns the id of the instance in a split path form. e.g. returns
92
+ # 000/001/234 for an id of 1234.
93
+ def id_partition attachment, style_name
94
+ ("%09d" % attachment.instance.id).scan(/\d{3}/).join("/")
95
+ end
96
+
97
+ # Returns the pluralized form of the attachment name. e.g.
98
+ # "avatars" for an attachment of :avatar
99
+ def attachment attachment, style_name
100
+ attachment.name.to_s.downcase.pluralize
101
+ end
102
+
103
+ # Returns the style, or the default style if nil is supplied.
104
+ def style attachment, style_name
105
+ style_name || attachment.default_style
106
+ end
107
+ end
108
+ end
@@ -0,0 +1,59 @@
1
+ # Provides method that can be included on File-type objects (IO, StringIO, Tempfile, etc) to allow stream copying
2
+ # and Tempfile conversion.
3
+ module IOStream
4
+
5
+ # Returns a Tempfile containing the contents of the readable object.
6
+ def to_tempfile
7
+ name = respond_to?(:original_filename) ? original_filename : (respond_to?(:path) ? path : "stream")
8
+ tempfile = Paperclip::Tempfile.new("stream" + File.extname(name))
9
+ tempfile.binmode
10
+ self.stream_to(tempfile)
11
+ end
12
+
13
+ # Copies one read-able object from one place to another in blocks, obviating the need to load
14
+ # the whole thing into memory. Defaults to 8k blocks. If this module is included in both
15
+ # StringIO and Tempfile, then either can have its data copied anywhere else without typing
16
+ # worries or memory overhead worries. Returns a File if a String is passed in as the destination
17
+ # and returns the IO or Tempfile as passed in if one is sent as the destination.
18
+ def stream_to path_or_file, in_blocks_of = 8192
19
+ dstio = case path_or_file
20
+ when String then File.new(path_or_file, "wb+")
21
+ when IO then path_or_file
22
+ when Tempfile then path_or_file
23
+ end
24
+ buffer = ""
25
+ self.rewind
26
+ while self.read(in_blocks_of, buffer) do
27
+ dstio.write(buffer)
28
+ end
29
+ dstio.rewind
30
+ dstio
31
+ end
32
+ end
33
+
34
+ class IO #:nodoc:
35
+ include IOStream
36
+ end
37
+
38
+ %w( Tempfile StringIO ).each do |klass|
39
+ if Object.const_defined? klass
40
+ Object.const_get(klass).class_eval do
41
+ include IOStream
42
+ end
43
+ end
44
+ end
45
+
46
+ # Corrects a bug in Windows when asking for Tempfile size.
47
+ if defined? Tempfile
48
+ class Tempfile
49
+ def size
50
+ if @tmpfile
51
+ @tmpfile.fsync
52
+ @tmpfile.flush
53
+ @tmpfile.stat.size
54
+ else
55
+ 0
56
+ end
57
+ end
58
+ end
59
+ end