paperclip-hacked 2.3.1.1
Sign up to get free protection for your applications and to get access to all the features.
- data/LICENSE +26 -0
- data/README.rdoc +179 -0
- data/Rakefile +103 -0
- data/generators/paperclip/USAGE +5 -0
- data/generators/paperclip/paperclip_generator.rb +27 -0
- data/generators/paperclip/templates/paperclip_migration.rb.erb +19 -0
- data/init.rb +1 -0
- data/lib/paperclip.rb +357 -0
- data/lib/paperclip/attachmenta.rb +334 -0
- data/lib/paperclip/callback_compatability.rb +33 -0
- data/lib/paperclip/geometry.rb +115 -0
- data/lib/paperclip/interpolations.rb +108 -0
- data/lib/paperclip/iostream.rb +59 -0
- data/lib/paperclip/matchers.rb +33 -0
- data/lib/paperclip/matchers/have_attached_file_matcher.rb +57 -0
- data/lib/paperclip/matchers/validate_attachment_content_type_matcher.rb +75 -0
- data/lib/paperclip/matchers/validate_attachment_presence_matcher.rb +55 -0
- data/lib/paperclip/matchers/validate_attachment_size_matcher.rb +96 -0
- data/lib/paperclip/processor.rb +49 -0
- data/lib/paperclip/storage.rb +247 -0
- data/lib/paperclip/thumbnail.rb +75 -0
- data/lib/paperclip/upfile.rb +50 -0
- data/shoulda_macros/paperclip.rb +117 -0
- data/tasks/paperclip_tasks.rake +79 -0
- data/test/attachment_test.rb +764 -0
- data/test/database.yml +4 -0
- data/test/fixtures/12k.png +0 -0
- data/test/fixtures/50x50.png +0 -0
- data/test/fixtures/5k.png +0 -0
- data/test/fixtures/bad.png +1 -0
- data/test/fixtures/s3.yml +8 -0
- data/test/fixtures/text.txt +0 -0
- data/test/fixtures/twopage.pdf +0 -0
- data/test/geometry_test.rb +177 -0
- data/test/helper.rb +128 -0
- data/test/integration_test.rb +483 -0
- data/test/interpolations_test.rb +124 -0
- data/test/iostream_test.rb +78 -0
- data/test/matchers/have_attached_file_matcher_test.rb +24 -0
- data/test/matchers/validate_attachment_content_type_matcher_test.rb +37 -0
- data/test/matchers/validate_attachment_presence_matcher_test.rb +26 -0
- data/test/matchers/validate_attachment_size_matcher_test.rb +51 -0
- data/test/paperclip_test.rb +298 -0
- data/test/processor_test.rb +10 -0
- data/test/storage_test.rb +330 -0
- data/test/thumbnail_test.rb +227 -0
- data/test/upfile_test.rb +36 -0
- metadata +185 -0
data/LICENSE
ADDED
@@ -0,0 +1,26 @@
|
|
1
|
+
|
2
|
+
LICENSE
|
3
|
+
|
4
|
+
The MIT License
|
5
|
+
|
6
|
+
Copyright (c) 2008 Jon Yurek and thoughtbot, inc.
|
7
|
+
|
8
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
9
|
+
of this software and associated documentation files (the "Software"), to deal
|
10
|
+
in the Software without restriction, including without limitation the rights
|
11
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
12
|
+
copies of the Software, and to permit persons to whom the Software is
|
13
|
+
furnished to do so, subject to the following conditions:
|
14
|
+
|
15
|
+
The above copyright notice and this permission notice shall be included in
|
16
|
+
all copies or substantial portions of the Software.
|
17
|
+
|
18
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
19
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
20
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
21
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
22
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
23
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
24
|
+
THE SOFTWARE.
|
25
|
+
|
26
|
+
|
data/README.rdoc
ADDED
@@ -0,0 +1,179 @@
|
|
1
|
+
=Paperclip
|
2
|
+
|
3
|
+
Paperclip is intended as an easy file attachment library for ActiveRecord. The
|
4
|
+
intent behind it was to keep setup as easy as possible and to treat files as
|
5
|
+
much like other attributes as possible. This means they aren't saved to their
|
6
|
+
final locations on disk, nor are they deleted if set to nil, until
|
7
|
+
ActiveRecord::Base#save is called. It manages validations based on size and
|
8
|
+
presence, if required. It can transform its assigned image into thumbnails if
|
9
|
+
needed, and the prerequisites are as simple as installing ImageMagick (which,
|
10
|
+
for most modern Unix-based systems, is as easy as installing the right
|
11
|
+
packages). Attached files are saved to the filesystem and referenced in the
|
12
|
+
browser by an easily understandable specification, which has sensible and
|
13
|
+
useful defaults.
|
14
|
+
|
15
|
+
See the documentation for +has_attached_file+ in Paperclip::ClassMethods for
|
16
|
+
more detailed options.
|
17
|
+
|
18
|
+
==Quick Start
|
19
|
+
|
20
|
+
In your model:
|
21
|
+
|
22
|
+
class User < ActiveRecord::Base
|
23
|
+
has_attached_file :avatar, :styles => { :medium => "300x300>", :thumb => "100x100>" }
|
24
|
+
end
|
25
|
+
|
26
|
+
In your migrations:
|
27
|
+
|
28
|
+
class AddAvatarColumnsToUser < ActiveRecord::Migration
|
29
|
+
def self.up
|
30
|
+
add_column :users, :avatar_file_name, :string
|
31
|
+
add_column :users, :avatar_content_type, :string
|
32
|
+
add_column :users, :avatar_file_size, :integer
|
33
|
+
add_column :users, :avatar_updated_at, :datetime
|
34
|
+
end
|
35
|
+
|
36
|
+
def self.down
|
37
|
+
remove_column :users, :avatar_file_name
|
38
|
+
remove_column :users, :avatar_content_type
|
39
|
+
remove_column :users, :avatar_file_size
|
40
|
+
remove_column :users, :avatar_updated_at
|
41
|
+
end
|
42
|
+
end
|
43
|
+
|
44
|
+
In your edit and new views:
|
45
|
+
|
46
|
+
<% form_for :user, @user, :url => user_path, :html => { :multipart => true } do |form| %>
|
47
|
+
<%= form.file_field :avatar %>
|
48
|
+
<% end %>
|
49
|
+
|
50
|
+
In your controller:
|
51
|
+
|
52
|
+
def create
|
53
|
+
@user = User.create( params[:user] )
|
54
|
+
end
|
55
|
+
|
56
|
+
In your show view:
|
57
|
+
|
58
|
+
<%= image_tag @user.avatar.url %>
|
59
|
+
<%= image_tag @user.avatar.url(:medium) %>
|
60
|
+
<%= image_tag @user.avatar.url(:thumb) %>
|
61
|
+
|
62
|
+
==Usage
|
63
|
+
|
64
|
+
The basics of paperclip are quite simple: Declare that your model has an
|
65
|
+
attachment with the has_attached_file method, and give it a name. Paperclip
|
66
|
+
will wrap up up to four attributes (all prefixed with that attachment's name,
|
67
|
+
so you can have multiple attachments per model if you wish) and give the a
|
68
|
+
friendly front end. The attributes are <attachment>_file_name,
|
69
|
+
<attachment>_file_size, <attachment>_content_type, and <attachment>_updated_at.
|
70
|
+
Only <attachment>_file_name is required for paperclip to operate. More
|
71
|
+
information about the options to has_attached_file is available in the
|
72
|
+
documentation of Paperclip::ClassMethods.
|
73
|
+
|
74
|
+
Attachmentas can be validated with Paperclip's validation methods,
|
75
|
+
validates_attachment_presence, validates_attachment_content_type, and
|
76
|
+
validates_attachment_size.
|
77
|
+
|
78
|
+
==Storage
|
79
|
+
|
80
|
+
The files that are assigned as attachments are, by default, placed in the
|
81
|
+
directory specified by the :path option to has_attached_file. By default, this
|
82
|
+
location is ":rails_root/public/system/:attachment/:id/:style/:filename". This
|
83
|
+
location was chosen because on standard Capistrano deployments, the
|
84
|
+
public/system directory is symlinked to the app's shared directory, meaning it
|
85
|
+
will survive between deployments. For example, using that :path, you may have a
|
86
|
+
file at
|
87
|
+
|
88
|
+
/data/myapp/releases/20081229172410/public/system/avatars/13/small/my_pic.png
|
89
|
+
|
90
|
+
NOTE: This is a change from previous versions of Paperclip, but is overall a
|
91
|
+
safer choice for the default file store.
|
92
|
+
|
93
|
+
You may also choose to store your files using Amazon's S3 service. You can find
|
94
|
+
more information about S3 storage at the description for
|
95
|
+
Paperclip::Storage::S3.
|
96
|
+
|
97
|
+
Files on the local filesystem (and in the Rails app's public directory) will be
|
98
|
+
available to the internet at large. If you require access control, it's
|
99
|
+
possible to place your files in a different location. You will need to change
|
100
|
+
both the :path and :url options in order to make sure the files are unavailable
|
101
|
+
to the public. Both :path and :url allow the same set of interpolated
|
102
|
+
variables.
|
103
|
+
|
104
|
+
==Post Processing
|
105
|
+
|
106
|
+
Paperclip supports an extensible selection of post-processors. When you define
|
107
|
+
a set of styles for an attachment, by default it is expected that those
|
108
|
+
"styles" are actually "thumbnails". However, you can do much more than just
|
109
|
+
thumbnail images. By defining a subclass of Paperclip::Processor, you can
|
110
|
+
perform any processing you want on the files that are attached. Any file in
|
111
|
+
your Rails app's lib/paperclip_processors directory is automatically loaded by
|
112
|
+
paperclip, allowing you to easily define custom processors. You can specify a
|
113
|
+
processor with the :processors option to has_attached_file:
|
114
|
+
|
115
|
+
has_attached_file :scan, :styles => { :text => { :quality => :better } },
|
116
|
+
:processors => [:ocr]
|
117
|
+
|
118
|
+
This would load the hypothetical class Paperclip::Ocr, which would have the
|
119
|
+
hash "{ :quality => :better }" passed to it along with the uploaded file. For
|
120
|
+
more information about defining processors, see Paperclip::Processor.
|
121
|
+
|
122
|
+
The default processor is Paperclip::Thumbnail. For backwards compatability
|
123
|
+
reasons, you can pass a single geometry string or an array containing a
|
124
|
+
geometry and a format, which the file will be converted to, like so:
|
125
|
+
|
126
|
+
has_attached_file :avatar, :styles => { :thumb => ["32x32#", :png] }
|
127
|
+
|
128
|
+
This will convert the "thumb" style to a 32x32 square in png format, regardless
|
129
|
+
of what was uploaded. If the format is not specified, it is kept the same (i.e.
|
130
|
+
jpgs will remain jpgs).
|
131
|
+
|
132
|
+
Multiple processors can be specified, and they will be invoked in the order
|
133
|
+
they are defined in the :processors array. Each successive processor will
|
134
|
+
be given the result of the previous processor's execution. All processors will
|
135
|
+
receive the same parameters, which are what you define in the :styles hash.
|
136
|
+
For example, assuming we had this definition:
|
137
|
+
|
138
|
+
has_attached_file :scan, :styles => { :text => { :quality => :better } },
|
139
|
+
:processors => [:rotator, :ocr]
|
140
|
+
|
141
|
+
then both the :rotator processor and the :ocr processor would receive the
|
142
|
+
options "{ :quality => :better }". This parameter may not mean anything to one
|
143
|
+
or more or the processors, and they are expected to ignore it.
|
144
|
+
|
145
|
+
NOTE: Because processors operate by turning the original attachment into the
|
146
|
+
styles, no processors will be run if there are no styles defined.
|
147
|
+
|
148
|
+
==Events
|
149
|
+
|
150
|
+
Before and after the Post Processing step, Paperclip calls back to the model
|
151
|
+
with a few callbacks, allowing the model to change or cancel the processing
|
152
|
+
step. The callbacks are "before_post_process" and "after_post_process" (which
|
153
|
+
are called before and after the processing of each attachment), and the
|
154
|
+
attachment-specific "before_<attachment>_post_process" and
|
155
|
+
"after_<attachment>_post_process". The callbacks are intended to be as close to
|
156
|
+
normal ActiveRecord callbacks as possible, so if you return false (specifically
|
157
|
+
- returning nil is not the same) in a before_ filter, the post processing step
|
158
|
+
will halt. Returning false in an after_ filter will not halt anything, but you
|
159
|
+
can access the model and the attachment if necessary.
|
160
|
+
|
161
|
+
NOTE: Post processing will not even *start* if the attachment is not valid
|
162
|
+
according to the validations. Your callbacks and processors will *only* be
|
163
|
+
called with valid attachments.
|
164
|
+
|
165
|
+
==Testing
|
166
|
+
|
167
|
+
Paperclip provides rspec-compatible matchers for testing attachments. See the
|
168
|
+
documentation on Paperclip::Shoulda::Matchers for more information.
|
169
|
+
|
170
|
+
==Contributing
|
171
|
+
|
172
|
+
If you'd like to contribute a feature or bugfix: Thanks! To make sure your
|
173
|
+
fix/feature has a high chance of being included, please read the following
|
174
|
+
guidelines:
|
175
|
+
|
176
|
+
1. Ask on the mailing list, or post a new GitHub Issue.
|
177
|
+
2. Make sure there are tests! We will not accept any patch that is not tested.
|
178
|
+
It's a rare time when explicit tests aren't needed. If you have questions
|
179
|
+
about writing tests for paperclip, please ask the mailing list.
|
data/Rakefile
ADDED
@@ -0,0 +1,103 @@
|
|
1
|
+
require 'rake'
|
2
|
+
require 'rake/testtask'
|
3
|
+
require 'rake/rdoctask'
|
4
|
+
|
5
|
+
$LOAD_PATH << File.join(File.dirname(__FILE__), 'lib')
|
6
|
+
require 'paperclip'
|
7
|
+
|
8
|
+
desc 'Default: run unit tests.'
|
9
|
+
task :default => [:clean, :test]
|
10
|
+
|
11
|
+
desc 'Test the paperclip plugin.'
|
12
|
+
Rake::TestTask.new(:test) do |t|
|
13
|
+
t.libs << 'lib' << 'profile'
|
14
|
+
t.pattern = 'test/**/*_test.rb'
|
15
|
+
t.verbose = true
|
16
|
+
end
|
17
|
+
|
18
|
+
desc 'Start an IRB session with all necessary files required.'
|
19
|
+
task :shell do |t|
|
20
|
+
chdir File.dirname(__FILE__)
|
21
|
+
exec 'irb -I lib/ -I lib/paperclip -r rubygems -r active_record -r tempfile -r init'
|
22
|
+
end
|
23
|
+
|
24
|
+
desc 'Generate documentation for the paperclip plugin.'
|
25
|
+
Rake::RDocTask.new(:rdoc) do |rdoc|
|
26
|
+
rdoc.rdoc_dir = 'doc'
|
27
|
+
rdoc.title = 'Paperclip'
|
28
|
+
rdoc.options << '--line-numbers' << '--inline-source'
|
29
|
+
rdoc.rdoc_files.include('README*')
|
30
|
+
rdoc.rdoc_files.include('lib/**/*.rb')
|
31
|
+
end
|
32
|
+
|
33
|
+
desc 'Update documentation on website'
|
34
|
+
task :sync_docs => 'rdoc' do
|
35
|
+
`rsync -ave ssh doc/ dev@dev.thoughtbot.com:/home/dev/www/dev.thoughtbot.com/paperclip`
|
36
|
+
end
|
37
|
+
|
38
|
+
desc 'Clean up files.'
|
39
|
+
task :clean do |t|
|
40
|
+
FileUtils.rm_rf "doc"
|
41
|
+
FileUtils.rm_rf "tmp"
|
42
|
+
FileUtils.rm_rf "pkg"
|
43
|
+
FileUtils.rm "test/debug.log" rescue nil
|
44
|
+
FileUtils.rm "test/paperclip.db" rescue nil
|
45
|
+
Dir.glob("paperclip-*.gem").each{|f| FileUtils.rm f }
|
46
|
+
end
|
47
|
+
|
48
|
+
include_file_globs = ["README*",
|
49
|
+
"LICENSE",
|
50
|
+
"Rakefile",
|
51
|
+
"init.rb",
|
52
|
+
"{generators,lib,tasks,test,shoulda_macros}/**/*"]
|
53
|
+
exclude_file_globs = ["test/s3.yml",
|
54
|
+
"test/debug.log",
|
55
|
+
"test/paperclip.db",
|
56
|
+
"test/doc",
|
57
|
+
"test/doc/*",
|
58
|
+
"test/pkg",
|
59
|
+
"test/pkg/*",
|
60
|
+
"test/tmp",
|
61
|
+
"test/tmp/*"]
|
62
|
+
spec = Gem::Specification.new do |s|
|
63
|
+
s.name = "paperclip"
|
64
|
+
s.version = Paperclip::VERSION
|
65
|
+
s.author = "Jon Yurek"
|
66
|
+
s.email = "jyurek@thoughtbot.com"
|
67
|
+
s.homepage = "http://www.thoughtbot.com/projects/paperclip"
|
68
|
+
s.platform = Gem::Platform::RUBY
|
69
|
+
s.summary = "File attachments as attributes for ActiveRecord"
|
70
|
+
s.files = FileList[include_file_globs].to_a - FileList[exclude_file_globs].to_a
|
71
|
+
s.require_path = "lib"
|
72
|
+
s.test_files = FileList["test/**/test_*.rb"].to_a
|
73
|
+
s.rubyforge_project = "paperclip"
|
74
|
+
s.has_rdoc = true
|
75
|
+
s.extra_rdoc_files = FileList["README*"].to_a
|
76
|
+
s.rdoc_options << '--line-numbers' << '--inline-source'
|
77
|
+
s.requirements << "ImageMagick"
|
78
|
+
s.add_development_dependency 'shoulda'
|
79
|
+
s.add_development_dependency 'jferris-mocha', '>= 0.9.5.0.1241126838'
|
80
|
+
s.add_development_dependency 'aws-s3'
|
81
|
+
s.add_development_dependency 'sqlite3-ruby'
|
82
|
+
s.add_development_dependency 'activerecord'
|
83
|
+
s.add_development_dependency 'activesupport'
|
84
|
+
end
|
85
|
+
|
86
|
+
desc "Print a list of the files to be put into the gem"
|
87
|
+
task :manifest => :clean do
|
88
|
+
spec.files.each do |file|
|
89
|
+
puts file
|
90
|
+
end
|
91
|
+
end
|
92
|
+
|
93
|
+
desc "Generate a gemspec file for GitHub"
|
94
|
+
task :gemspec => :clean do
|
95
|
+
File.open("#{spec.name}.gemspec", 'w') do |f|
|
96
|
+
f.write spec.to_ruby
|
97
|
+
end
|
98
|
+
end
|
99
|
+
|
100
|
+
desc "Build the gem into the current directory"
|
101
|
+
task :gem => :gemspec do
|
102
|
+
`gem build #{spec.name}.gemspec`
|
103
|
+
end
|
@@ -0,0 +1,27 @@
|
|
1
|
+
class PaperclipGenerator < Rails::Generator::NamedBase
|
2
|
+
attr_accessor :attachments, :migration_name
|
3
|
+
|
4
|
+
def initialize(args, options = {})
|
5
|
+
super
|
6
|
+
@class_name, @attachments = args[0], args[1..-1]
|
7
|
+
end
|
8
|
+
|
9
|
+
def manifest
|
10
|
+
file_name = generate_file_name
|
11
|
+
@migration_name = file_name.camelize
|
12
|
+
record do |m|
|
13
|
+
m.migration_template "paperclip_migration.rb.erb",
|
14
|
+
File.join('db', 'migrate'),
|
15
|
+
:migration_file_name => file_name
|
16
|
+
end
|
17
|
+
end
|
18
|
+
|
19
|
+
private
|
20
|
+
|
21
|
+
def generate_file_name
|
22
|
+
names = attachments.map{|a| a.underscore }
|
23
|
+
names = names[0..-2] + ["and", names[-1]] if names.length > 1
|
24
|
+
"add_attachments_#{names.join("_")}_to_#{@class_name.underscore}"
|
25
|
+
end
|
26
|
+
|
27
|
+
end
|
@@ -0,0 +1,19 @@
|
|
1
|
+
class <%= migration_name %> < ActiveRecord::Migration
|
2
|
+
def self.up
|
3
|
+
<% attachments.each do |attachment| -%>
|
4
|
+
add_column :<%= class_name.underscore.camelize.tableize %>, :<%= attachment %>_file_name, :string
|
5
|
+
add_column :<%= class_name.underscore.camelize.tableize %>, :<%= attachment %>_content_type, :string
|
6
|
+
add_column :<%= class_name.underscore.camelize.tableize %>, :<%= attachment %>_file_size, :integer
|
7
|
+
add_column :<%= class_name.underscore.camelize.tableize %>, :<%= attachment %>_updated_at, :datetime
|
8
|
+
<% end -%>
|
9
|
+
end
|
10
|
+
|
11
|
+
def self.down
|
12
|
+
<% attachments.each do |attachment| -%>
|
13
|
+
remove_column :<%= class_name.underscore.camelize.tableize %>, :<%= attachment %>_file_name
|
14
|
+
remove_column :<%= class_name.underscore.camelize.tableize %>, :<%= attachment %>_content_type
|
15
|
+
remove_column :<%= class_name.underscore.camelize.tableize %>, :<%= attachment %>_file_size
|
16
|
+
remove_column :<%= class_name.underscore.camelize.tableize %>, :<%= attachment %>_updated_at
|
17
|
+
<% end -%>
|
18
|
+
end
|
19
|
+
end
|
data/init.rb
ADDED
@@ -0,0 +1 @@
|
|
1
|
+
require File.join(File.dirname(__FILE__), "lib", "paperclip")
|
data/lib/paperclip.rb
ADDED
@@ -0,0 +1,357 @@
|
|
1
|
+
# Paperclip allows file attachments that are stored in the filesystem. All graphical
|
2
|
+
# transformations are done using the Graphics/ImageMagick command line utilities and
|
3
|
+
# are stored in Tempfiles until the record is saved. Paperclip does not require a
|
4
|
+
# separate model for storing the attachment's information, instead adding a few simple
|
5
|
+
# columns to your table.
|
6
|
+
#
|
7
|
+
# Author:: Jon Yurek
|
8
|
+
# Copyright:: Copyright (c) 2008-2009 thoughtbot, inc.
|
9
|
+
# License:: MIT License (http://www.opensource.org/licenses/mit-license.php)
|
10
|
+
#
|
11
|
+
# Paperclip defines an attachment as any file, though it makes special considerations
|
12
|
+
# for image files. You can declare that a model has an attached file with the
|
13
|
+
# +has_attached_file+ method:
|
14
|
+
#
|
15
|
+
# class User < ActiveRecord::Base
|
16
|
+
# has_attached_file :avatar, :styles => { :thumb => "100x100" }
|
17
|
+
# end
|
18
|
+
#
|
19
|
+
# user = User.new
|
20
|
+
# user.avatar = params[:user][:avatar]
|
21
|
+
# user.avatar.url
|
22
|
+
# # => "/users/avatars/4/original_me.jpg"
|
23
|
+
# user.avatar.url(:thumb)
|
24
|
+
# # => "/users/avatars/4/thumb_me.jpg"
|
25
|
+
#
|
26
|
+
# See the +has_attached_file+ documentation for more details.
|
27
|
+
|
28
|
+
require 'erb'
|
29
|
+
require 'tempfile'
|
30
|
+
require 'paperclip/upfile'
|
31
|
+
require 'paperclip/iostream'
|
32
|
+
require 'paperclip/geometry'
|
33
|
+
require 'paperclip/processor'
|
34
|
+
require 'paperclip/thumbnail'
|
35
|
+
require 'paperclip/storage'
|
36
|
+
require 'paperclip/interpolations'
|
37
|
+
require 'paperclip/style'
|
38
|
+
require 'paperclip/attachmenta'
|
39
|
+
if defined? RAILS_ROOT
|
40
|
+
Dir.glob(File.join(File.expand_path(RAILS_ROOT), "lib", "paperclip_processors", "*.rb")).each do |processor|
|
41
|
+
require processor
|
42
|
+
end
|
43
|
+
end
|
44
|
+
|
45
|
+
# The base module that gets included in ActiveRecord::Base. See the
|
46
|
+
# documentation for Paperclip::ClassMethods for more useful information.
|
47
|
+
module Paperclip
|
48
|
+
|
49
|
+
VERSION = "2.3.1.1"
|
50
|
+
|
51
|
+
class << self
|
52
|
+
# Provides configurability to Paperclip. There are a number of options available, such as:
|
53
|
+
# * whiny: Will raise an error if Paperclip cannot process thumbnails of
|
54
|
+
# an uploaded image. Defaults to true.
|
55
|
+
# * log: Logs progress to the Rails log. Uses ActiveRecord's logger, so honors
|
56
|
+
# log levels, etc. Defaults to true.
|
57
|
+
# * command_path: Defines the path at which to find the command line
|
58
|
+
# programs if they are not visible to Rails the system's search path. Defaults to
|
59
|
+
# nil, which uses the first executable found in the user's search path.
|
60
|
+
# * image_magick_path: Deprecated alias of command_path.
|
61
|
+
def options
|
62
|
+
@options ||= {
|
63
|
+
:whiny => true,
|
64
|
+
:image_magick_path => nil,
|
65
|
+
:command_path => nil,
|
66
|
+
:log => true,
|
67
|
+
:log_command => false,
|
68
|
+
:swallow_stderr => true
|
69
|
+
}
|
70
|
+
end
|
71
|
+
|
72
|
+
def path_for_command command #:nodoc:
|
73
|
+
if options[:image_magick_path]
|
74
|
+
warn("[DEPRECATION] :image_magick_path is deprecated and will be removed. Use :command_path instead")
|
75
|
+
end
|
76
|
+
path = [options[:command_path] || options[:image_magick_path], command].compact
|
77
|
+
File.join(*path)
|
78
|
+
end
|
79
|
+
|
80
|
+
def interpolates key, &block
|
81
|
+
Paperclip::Interpolations[key] = block
|
82
|
+
end
|
83
|
+
|
84
|
+
# The run method takes a command to execute and a string of parameters
|
85
|
+
# that get passed to it. The command is prefixed with the :command_path
|
86
|
+
# option from Paperclip.options. If you have many commands to run and
|
87
|
+
# they are in different paths, the suggested course of action is to
|
88
|
+
# symlink them so they are all in the same directory.
|
89
|
+
#
|
90
|
+
# If the command returns with a result code that is not one of the
|
91
|
+
# expected_outcodes, a PaperclipCommandLineError will be raised. Generally
|
92
|
+
# a code of 0 is expected, but a list of codes may be passed if necessary.
|
93
|
+
#
|
94
|
+
# This method can log the command being run when
|
95
|
+
# Paperclip.options[:log_command] is set to true (defaults to false). This
|
96
|
+
# will only log if logging in general is set to true as well.
|
97
|
+
def run cmd, params = "", expected_outcodes = 0
|
98
|
+
command = %Q[#{path_for_command(cmd)} #{params}].gsub(/\s+/, " ")
|
99
|
+
command = "#{command} 2>#{bit_bucket}" if Paperclip.options[:swallow_stderr]
|
100
|
+
Paperclip.log(command) if Paperclip.options[:log_command]
|
101
|
+
output = `#{command}`
|
102
|
+
unless [expected_outcodes].flatten.include?($?.exitstatus)
|
103
|
+
raise PaperclipCommandLineError, "Error while running #{cmd}"
|
104
|
+
end
|
105
|
+
output
|
106
|
+
end
|
107
|
+
|
108
|
+
def bit_bucket #:nodoc:
|
109
|
+
File.exists?("/dev/null") ? "/dev/null" : "NUL"
|
110
|
+
end
|
111
|
+
|
112
|
+
def included base #:nodoc:
|
113
|
+
base.extend ClassMethods
|
114
|
+
unless base.respond_to?(:define_callbacks)
|
115
|
+
base.send(:include, Paperclip::CallbackCompatability)
|
116
|
+
end
|
117
|
+
end
|
118
|
+
|
119
|
+
def processor name #:nodoc:
|
120
|
+
name = name.to_s.camelize
|
121
|
+
processor = Paperclip.const_get(name)
|
122
|
+
unless processor.ancestors.include?(Paperclip::Processor)
|
123
|
+
raise PaperclipError.new("Processor #{name} was not found")
|
124
|
+
end
|
125
|
+
processor
|
126
|
+
end
|
127
|
+
|
128
|
+
# Log a paperclip-specific line. Uses ActiveRecord::Base.logger
|
129
|
+
# by default. Set Paperclip.options[:log] to false to turn off.
|
130
|
+
def log message
|
131
|
+
logger.info("[paperclip] #{message}") if logging?
|
132
|
+
end
|
133
|
+
|
134
|
+
def logger #:nodoc:
|
135
|
+
ActiveRecord::Base.logger
|
136
|
+
end
|
137
|
+
|
138
|
+
def logging? #:nodoc:
|
139
|
+
options[:log]
|
140
|
+
end
|
141
|
+
end
|
142
|
+
|
143
|
+
class PaperclipError < StandardError #:nodoc:
|
144
|
+
end
|
145
|
+
|
146
|
+
class PaperclipCommandLineError < StandardError #:nodoc:
|
147
|
+
end
|
148
|
+
|
149
|
+
class NotIdentifiedByImageMagickError < PaperclipError #:nodoc:
|
150
|
+
end
|
151
|
+
|
152
|
+
class InfiniteInterpolationError < PaperclipError #:nodoc:
|
153
|
+
end
|
154
|
+
|
155
|
+
module ClassMethods
|
156
|
+
# +has_attached_file+ gives the class it is called on an attribute that maps to a file. This
|
157
|
+
# is typically a file stored somewhere on the filesystem and has been uploaded by a user.
|
158
|
+
# The attribute returns a Paperclip::Attachmenta object which handles the management of
|
159
|
+
# that file. The intent is to make the attachment as much like a normal attribute. The
|
160
|
+
# thumbnails will be created when the new file is assigned, but they will *not* be saved
|
161
|
+
# until +save+ is called on the record. Likewise, if the attribute is set to +nil+ is
|
162
|
+
# called on it, the attachment will *not* be deleted until +save+ is called. See the
|
163
|
+
# Paperclip::Attachmenta documentation for more specifics. There are a number of options
|
164
|
+
# you can set to change the behavior of a Paperclip attachment:
|
165
|
+
# * +url+: The full URL of where the attachment is publically accessible. This can just
|
166
|
+
# as easily point to a directory served directly through Apache as it can to an action
|
167
|
+
# that can control permissions. You can specify the full domain and path, but usually
|
168
|
+
# just an absolute path is sufficient. The leading slash *must* be included manually for
|
169
|
+
# absolute paths. The default value is
|
170
|
+
# "/system/:attachment/:id/:style/:filename". See
|
171
|
+
# Paperclip::Attachmenta#interpolate for more information on variable interpolaton.
|
172
|
+
# :url => "/:class/:attachment/:id/:style_:filename"
|
173
|
+
# :url => "http://some.other.host/stuff/:class/:id_:extension"
|
174
|
+
# * +default_url+: The URL that will be returned if there is no attachment assigned.
|
175
|
+
# This field is interpolated just as the url is. The default value is
|
176
|
+
# "/:attachment/:style/missing.png"
|
177
|
+
# has_attached_file :avatar, :default_url => "/images/default_:style_avatar.png"
|
178
|
+
# User.new.avatar_url(:small) # => "/images/default_small_avatar.png"
|
179
|
+
# * +styles+: A hash of thumbnail styles and their geometries. You can find more about
|
180
|
+
# geometry strings at the ImageMagick website
|
181
|
+
# (http://www.imagemagick.org/script/command-line-options.php#resize). Paperclip
|
182
|
+
# also adds the "#" option (e.g. "50x50#"), which will resize the image to fit maximally
|
183
|
+
# inside the dimensions and then crop the rest off (weighted at the center). The
|
184
|
+
# default value is to generate no thumbnails.
|
185
|
+
# * +default_style+: The thumbnail style that will be used by default URLs.
|
186
|
+
# Defaults to +original+.
|
187
|
+
# has_attached_file :avatar, :styles => { :normal => "100x100#" },
|
188
|
+
# :default_style => :normal
|
189
|
+
# user.avatar.url # => "/avatars/23/normal_me.png"
|
190
|
+
# * +whiny+: Will raise an error if Paperclip cannot post_process an uploaded file due
|
191
|
+
# to a command line error. This will override the global setting for this attachment.
|
192
|
+
# Defaults to true. This option used to be called :whiny_thumbanils, but this is
|
193
|
+
# deprecated.
|
194
|
+
# * +convert_options+: When creating thumbnails, use this free-form options
|
195
|
+
# field to pass in various convert command options. Typical options are "-strip" to
|
196
|
+
# remove all Exif data from the image (save space for thumbnails and avatars) or
|
197
|
+
# "-depth 8" to specify the bit depth of the resulting conversion. See ImageMagick
|
198
|
+
# convert documentation for more options: (http://www.imagemagick.org/script/convert.php)
|
199
|
+
# Note that this option takes a hash of options, each of which correspond to the style
|
200
|
+
# of thumbnail being generated. You can also specify :all as a key, which will apply
|
201
|
+
# to all of the thumbnails being generated. If you specify options for the :original,
|
202
|
+
# it would be best if you did not specify destructive options, as the intent of keeping
|
203
|
+
# the original around is to regenerate all the thumbnails when requirements change.
|
204
|
+
# has_attached_file :avatar, :styles => { :large => "300x300", :negative => "100x100" }
|
205
|
+
# :convert_options => {
|
206
|
+
# :all => "-strip",
|
207
|
+
# :negative => "-negate"
|
208
|
+
# }
|
209
|
+
# NOTE: While not deprecated yet, it is not recommended to specify options this way.
|
210
|
+
# It is recommended that :convert_options option be included in the hash passed to each
|
211
|
+
# :styles for compatability with future versions.
|
212
|
+
# * +storage+: Chooses the storage backend where the files will be stored. The current
|
213
|
+
# choices are :filesystem and :s3. The default is :filesystem. Make sure you read the
|
214
|
+
# documentation for Paperclip::Storage::Filesystem and Paperclip::Storage::S3
|
215
|
+
# for backend-specific options.
|
216
|
+
def has_attached_file name, options = {}
|
217
|
+
include InstanceMethods
|
218
|
+
|
219
|
+
write_inheritable_attribute(:attachment_definitions, {}) if attachment_definitions.nil?
|
220
|
+
attachment_definitions[name] = {:validations => []}.merge(options)
|
221
|
+
|
222
|
+
after_save :save_attached_files
|
223
|
+
before_destroy :destroy_attached_files
|
224
|
+
|
225
|
+
define_callbacks :before_post_process, :after_post_process
|
226
|
+
define_callbacks :"before_#{name}_post_process", :"after_#{name}_post_process"
|
227
|
+
|
228
|
+
define_method name do |*args|
|
229
|
+
a = attachment_for(name)
|
230
|
+
(args.length > 0) ? a.to_s(args.first) : a
|
231
|
+
end
|
232
|
+
|
233
|
+
define_method "#{name}=" do |file|
|
234
|
+
attachment_for(name).assign(file)
|
235
|
+
end
|
236
|
+
|
237
|
+
define_method "#{name}?" do
|
238
|
+
attachment_for(name).file?
|
239
|
+
end
|
240
|
+
|
241
|
+
validates_each(name) do |record, attr, value|
|
242
|
+
attachment = record.attachment_for(name)
|
243
|
+
attachment.send(:flush_errors)
|
244
|
+
end
|
245
|
+
end
|
246
|
+
|
247
|
+
# Places ActiveRecord-style validations on the size of the file assigned. The
|
248
|
+
# possible options are:
|
249
|
+
# * +in+: a Range of bytes (i.e. +1..1.megabyte+),
|
250
|
+
# * +less_than+: equivalent to :in => 0..options[:less_than]
|
251
|
+
# * +greater_than+: equivalent to :in => options[:greater_than]..Infinity
|
252
|
+
# * +message+: error message to display, use :min and :max as replacements
|
253
|
+
# * +if+: A lambda or name of a method on the instance. Validation will only
|
254
|
+
# be run is this lambda or method returns true.
|
255
|
+
# * +unless+: Same as +if+ but validates if lambda or method returns false.
|
256
|
+
def validates_attachment_size name, options = {}
|
257
|
+
min = options[:greater_than] || (options[:in] && options[:in].first) || 0
|
258
|
+
max = options[:less_than] || (options[:in] && options[:in].last) || (1.0/0)
|
259
|
+
range = (min..max)
|
260
|
+
message = options[:message] || "file size must be between :min and :max bytes."
|
261
|
+
message = message.gsub(/:min/, min.to_s).gsub(/:max/, max.to_s)
|
262
|
+
|
263
|
+
validates_inclusion_of :"#{name}_file_size",
|
264
|
+
:in => range,
|
265
|
+
:message => message,
|
266
|
+
:if => options[:if],
|
267
|
+
:unless => options[:unless]
|
268
|
+
end
|
269
|
+
|
270
|
+
# Adds errors if thumbnail creation fails. The same as specifying :whiny_thumbnails => true.
|
271
|
+
def validates_attachment_thumbnails name, options = {}
|
272
|
+
warn('[DEPRECATION] validates_attachment_thumbnail is deprecated. ' +
|
273
|
+
'This validation is on by default and will be removed from future versions. ' +
|
274
|
+
'If you wish to turn it off, supply :whiny => false in your definition.')
|
275
|
+
attachment_definitions[name][:whiny_thumbnails] = true
|
276
|
+
end
|
277
|
+
|
278
|
+
# Places ActiveRecord-style validations on the presence of a file.
|
279
|
+
# Options:
|
280
|
+
# * +if+: A lambda or name of a method on the instance. Validation will only
|
281
|
+
# be run is this lambda or method returns true.
|
282
|
+
# * +unless+: Same as +if+ but validates if lambda or method returns false.
|
283
|
+
def validates_attachment_presence name, options = {}
|
284
|
+
message = options[:message] || "must be set."
|
285
|
+
validates_presence_of :"#{name}_file_name",
|
286
|
+
:message => message,
|
287
|
+
:if => options[:if],
|
288
|
+
:unless => options[:unless]
|
289
|
+
end
|
290
|
+
|
291
|
+
# Places ActiveRecord-style validations on the content type of the file
|
292
|
+
# assigned. The possible options are:
|
293
|
+
# * +content_type+: Allowed content types. Can be a single content type
|
294
|
+
# or an array. Each type can be a String or a Regexp. It should be
|
295
|
+
# noted that Internet Explorer upload files with content_types that you
|
296
|
+
# may not expect. For example, JPEG images are given image/pjpeg and
|
297
|
+
# PNGs are image/x-png, so keep that in mind when determining how you
|
298
|
+
# match. Allows all by default.
|
299
|
+
# * +message+: The message to display when the uploaded file has an invalid
|
300
|
+
# content type.
|
301
|
+
# * +if+: A lambda or name of a method on the instance. Validation will only
|
302
|
+
# be run is this lambda or method returns true.
|
303
|
+
# * +unless+: Same as +if+ but validates if lambda or method returns false.
|
304
|
+
# NOTE: If you do not specify an [attachment]_content_type field on your
|
305
|
+
# model, content_type validation will work _ONLY upon assignment_ and
|
306
|
+
# re-validation after the instance has been reloaded will always succeed.
|
307
|
+
def validates_attachment_content_type name, options = {}
|
308
|
+
types = [options.delete(:content_type)].flatten
|
309
|
+
validates_each(:"#{name}_content_type", options) do |record, attr, value|
|
310
|
+
unless types.any?{|t| t === value }
|
311
|
+
record.errors.add(:"#{name}_content_type", :inclusion, :default => options[:message], :value => value)
|
312
|
+
end
|
313
|
+
end
|
314
|
+
end
|
315
|
+
|
316
|
+
# Returns the attachment definitions defined by each call to
|
317
|
+
# has_attached_file.
|
318
|
+
def attachment_definitions
|
319
|
+
read_inheritable_attribute(:attachment_definitions)
|
320
|
+
end
|
321
|
+
end
|
322
|
+
|
323
|
+
module InstanceMethods #:nodoc:
|
324
|
+
def attachment_for name
|
325
|
+
@_paperclip_attachments ||= {}
|
326
|
+
@_paperclip_attachments[name] ||= Attachmenta.new(name, self, self.class.attachment_definitions[name])
|
327
|
+
end
|
328
|
+
|
329
|
+
def each_attachment
|
330
|
+
self.class.attachment_definitions.each do |name, definition|
|
331
|
+
yield(name, attachment_for(name))
|
332
|
+
end
|
333
|
+
end
|
334
|
+
|
335
|
+
def save_attached_files
|
336
|
+
logger.info("[paperclip] Saving attachments.")
|
337
|
+
each_attachment do |name, attachment|
|
338
|
+
attachment.send(:save)
|
339
|
+
end
|
340
|
+
end
|
341
|
+
|
342
|
+
def destroy_attached_files
|
343
|
+
logger.info("[paperclip] Deleting attachments.")
|
344
|
+
each_attachment do |name, attachment|
|
345
|
+
attachment.send(:queue_existing_for_delete)
|
346
|
+
attachment.send(:flush_deletes)
|
347
|
+
end
|
348
|
+
end
|
349
|
+
end
|
350
|
+
|
351
|
+
end
|
352
|
+
|
353
|
+
# Set it all up.
|
354
|
+
if Object.const_defined?("ActiveRecord")
|
355
|
+
ActiveRecord::Base.send(:include, Paperclip)
|
356
|
+
File.send(:include, Paperclip::Upfile)
|
357
|
+
end
|