Module: Refile
- Defined in:
- lib/refile.rb,
lib/refile/app.rb,
lib/refile/file.rb,
lib/refile/type.rb,
lib/refile/rails.rb,
lib/refile/version.rb,
lib/refile/attacher.rb,
lib/refile/signature.rb,
lib/refile/attachment.rb,
lib/refile/backend/s3.rb,
lib/refile/custom_logger.rb,
lib/refile/random_hasher.rb,
lib/refile/image_processing.rb,
lib/refile/backend/file_system.rb,
lib/refile/rails/attachment_helper.rb,
lib/refile/attachment/active_record.rb
Defined Under Namespace
Modules: ActiveRecord, Attachment, AttachmentHelper, Backend Classes: App, File, ImageProcessor, RandomHasher, Signature, Type
Constant Summary collapse
- VERSION =
"0.5.0"
Class Attribute Summary collapse
-
.allow_origin ⇒ String
Value for Access-Control-Allow-Origin header.
-
.app ⇒ Refile::App?
A shortcut to the instance of the Rack application.
-
.automount ⇒ Boolean
Should the rack application be automounted in a Rails app?.
-
.content_max_age ⇒ Integer
Value for Cache-Control: max-age=
header. -
.direct_upload ⇒ Array[String]
A list of names which identify backends in the global backend registry.
-
.host ⇒ String?
The host name that the Rack application can be reached at.
-
.logger ⇒ Logger
Logger that should be used by rack application.
-
.mount_point ⇒ String
Where should the rack application be mounted? The default is 'attachments'.
Class Method Summary collapse
-
.backends ⇒ Hash{String => Backend}
A global registry of backends.
-
.cache ⇒ Backend
A shortcut to retrieving the backend named "cache" from the global registry.
-
.cache=(backend) ⇒ Object
A shortcut to setting the backend named "cache" in the global registry.
-
.configure { ... } ⇒ Object
Yield the Refile module as a convenience for configuring multiple config options at once.
-
.extract_content_type(uploadable) ⇒ String?
Extract the content type from an uploadable object.
-
.extract_filename(uploadable) ⇒ String?
Extract the filename from an uploadable object.
-
.processor(name, processor = nil) {|Refile::File| ... }
Adds a processor.
-
.processors ⇒ Hash{String => Proc}
A global registry of processors.
-
.store ⇒ Backend
A shortcut to retrieving the backend named "store" from the global registry.
-
.store=(backend) ⇒ Object
A shortcut to setting the backend named "store" in the global registry.
-
.types ⇒ Hash{Symbol => Refile::Type}
A global registry of types.
-
.verify_uploadable(uploadable, max_size) ⇒ true
Verify that the given uploadable is indeed a valid uploadable.
Class Attribute Details
.allow_origin ⇒ String
Value for Access-Control-Allow-Origin header
52 53 54 |
# File 'lib/refile.rb', line 52 def allow_origin @allow_origin end |
.app ⇒ Refile::App?
A shortcut to the instance of the Rack application. This should be
set when the application is initialized. refile/rails
sets this
value.
25 26 27 |
# File 'lib/refile.rb', line 25 def app @app end |
.automount ⇒ Boolean
Should the rack application be automounted in a Rails app?
If set to false then Refile.app should be mounted in the Rails application
routes.rb with the options at: Refile.mount_point, as: :refile_app
The default is true.
72 73 74 |
# File 'lib/refile.rb', line 72 def automount @automount end |
.content_max_age ⇒ Integer
Value for Cache-Control: max-age=
57 58 59 |
# File 'lib/refile.rb', line 57 def content_max_age @content_max_age end |
.direct_upload ⇒ Array[String]
A list of names which identify backends in the global backend registry.
The Rack application allows POST requests to only the backends specified
in this config option. This defaults to ["cache"]
, only allowing direct
uploads to the cache backend.
42 43 44 |
# File 'lib/refile.rb', line 42 def direct_upload @direct_upload end |
.host ⇒ String?
The host name that the Rack application can be reached at. If not set, Refile will use an absolute URL without hostname. It is strongly recommended to run Refile behind a CDN and to set this to the hostname of the CDN distribution. A protocol relative URL is recommended for this value.
34 35 36 |
# File 'lib/refile.rb', line 34 def host @host end |
.logger ⇒ Logger
Logger that should be used by rack application
47 48 49 |
# File 'lib/refile.rb', line 47 def logger @logger end |
.mount_point ⇒ String
Where should the rack application be mounted? The default is 'attachments'.
62 63 64 |
# File 'lib/refile.rb', line 62 def mount_point @mount_point end |
Class Method Details
.backends ⇒ Hash{String => Backend}
A global registry of backends.
77 78 79 |
# File 'lib/refile.rb', line 77 def backends @backends ||= {} end |
.cache ⇒ Backend
A shortcut to retrieving the backend named "cache" from the global registry.
150 151 152 |
# File 'lib/refile.rb', line 150 def cache backends["cache"] end |
.cache=(backend) ⇒ Object
A shortcut to setting the backend named "cache" in the global registry.
157 158 159 |
# File 'lib/refile.rb', line 157 def cache=(backend) backends["cache"] = backend end |
.configure { ... } ⇒ Object
Yield the Refile module as a convenience for configuring multiple config options at once.
165 166 167 |
# File 'lib/refile.rb', line 165 def configure yield self end |
.extract_content_type(uploadable) ⇒ String?
Extract the content type from an uploadable object. If the content type
cannot be determined, this method will return nil
.
209 210 211 212 213 214 215 216 217 218 219 |
# File 'lib/refile.rb', line 209 def extract_content_type(uploadable) if uploadable.respond_to?(:content_type) uploadable.content_type else filename = extract_filename(uploadable) if filename content_type = MIME::Types.of(filename).first content_type.to_s if content_type end end end |
.extract_filename(uploadable) ⇒ String?
Extract the filename from an uploadable object. If the filename cannot be
determined, this method will return nil
.
195 196 197 198 199 200 201 202 |
# File 'lib/refile.rb', line 195 def extract_filename(uploadable) path = if uploadable.respond_to?(:original_filename) uploadable.original_filename elsif uploadable.respond_to?(:path) uploadable.path end ::File.basename(path) if path end |
.processor(name, processor = nil) {|Refile::File| ... }
This method returns an undefined value.
Adds a processor. The processor must respond to call
, both receiving
and returning an IO-like object. Alternatively a block can be given to
this method which also receives and returns an IO-like object.
An IO-like object is recommended to be an instance of the IO
class or
one of its subclasses, like File
or a StringIO
, or a Refile::File
.
It can also be any other object which responds to size
, read
, eof
?
and close
and mimics the behaviour of IO objects for these methods.
126 127 128 129 |
# File 'lib/refile.rb', line 126 def processor(name, processor = nil, &block) processor ||= block processors[name.to_s] = processor end |
.processors ⇒ Hash{String => Proc}
A global registry of processors. These will be used by the Rack application to manipulate files prior to serving them up to the user, based on options sent trough the URL. This can be used for example to resize images or to convert files to another file format.
87 88 89 |
# File 'lib/refile.rb', line 87 def processors @processors ||= {} end |
.store ⇒ Backend
A shortcut to retrieving the backend named "store" from the global registry.
135 136 137 |
# File 'lib/refile.rb', line 135 def store backends["store"] end |
.store=(backend) ⇒ Object
A shortcut to setting the backend named "store" in the global registry.
142 143 144 |
# File 'lib/refile.rb', line 142 def store=(backend) backends["store"] = backend end |
.types ⇒ Hash{Symbol => Refile::Type}
A global registry of types. Currently, types are simply aliases for a set of content types, but their functionality may expand in the future.
95 96 97 |
# File 'lib/refile.rb', line 95 def types @types ||= {} end |
.verify_uploadable(uploadable, max_size) ⇒ true
Verify that the given uploadable is indeed a valid uploadable. This method is used by backends as a sanity check, you should not have to use this method unless you are writing a backend.
178 179 180 181 182 183 184 185 186 187 188 |
# File 'lib/refile.rb', line 178 def verify_uploadable(uploadable, max_size) [:size, :read, :eof?, :close].each do |m| unless uploadable.respond_to?(m) raise ArgumentError, "does not respond to `#{m}`." end end if max_size and uploadable.size > max_size raise Refile::Invalid, "#{uploadable.inspect} is too large" end true end |