Module: Paperclip::Validators::HelperMethods
- Defined in:
- lib/paperclip/validators/attachment_size_validator.rb,
lib/paperclip/validators/attachment_presence_validator.rb,
lib/paperclip/validators/attachment_file_name_validator.rb,
lib/paperclip/validators/attachment_content_type_validator.rb,
lib/paperclip/validators/media_type_spoof_detection_validator.rb,
lib/paperclip/validators/attachment_file_type_ignorance_validator.rb
Instance Method Summary collapse
-
#do_not_validate_attachment_file_type(*attr_names) ⇒ Object
Places ActiveModel validations on the presence of a file.
-
#validates_attachment_content_type(*attr_names) ⇒ Object
Places ActiveModel validations on the content type of the file assigned.
-
#validates_attachment_file_name(*attr_names) ⇒ Object
Places ActiveModel validations on the name of the file assigned.
-
#validates_attachment_presence(*attr_names) ⇒ Object
Places ActiveModel validations on the presence of a file.
-
#validates_attachment_size(*attr_names) ⇒ Object
Places ActiveModel validations on the size of the file assigned.
-
#validates_media_type_spoof_detection(*attr_names) ⇒ Object
Places ActiveModel validations on the presence of a file.
Instance Method Details
#do_not_validate_attachment_file_type(*attr_names) ⇒ Object
Places ActiveModel validations on the presence of a file. Options:
-
if
: A lambda or name of an instance method. Validation will only be run if this lambda or method returns true. -
unless
: Same asif
but validates if lambda or method returns false.
22 23 24 25 |
# File 'lib/paperclip/validators/attachment_file_type_ignorance_validator.rb', line 22 def (*attr_names) = _merge_attributes(attr_names) validates_with AttachmentFileTypeIgnoranceValidator, .dup end |
#validates_attachment_content_type(*attr_names) ⇒ Object
Places ActiveModel validations on the content type of the file assigned. The possible options are:
-
content_type
: Allowed content types. Can be a single content type or an array. Each type can be a String or a Regexp. It should be noted that Internet Explorer uploads files with content_types that you may not expect. For example, JPEG images are given image/pjpeg and PNGs are image/x-png, so keep that in mind when determining how you match. Allows all by default. -
not
: Forbidden content types. -
message
: The message to display when the uploaded file has an invalid content type. -
if
: A lambda or name of an instance method. Validation will only be run is this lambda or method returns true. -
unless
: Same asif
but validates if lambda or method returns false.
NOTE: If you do not specify an [attachment]_content_type field on your model, content_type validation will work _ONLY upon assignment_ and re-validation after the instance has been reloaded will always succeed. You’ll still need to have a virtual attribute (created by attr_accessor
) name [attachment]_content_type
to be able to use this validator.
88 89 90 91 92 |
# File 'lib/paperclip/validators/attachment_content_type_validator.rb', line 88 def (*attr_names) = _merge_attributes(attr_names) validates_with AttachmentContentTypeValidator, .dup validate_before_processing AttachmentContentTypeValidator, .dup end |
#validates_attachment_file_name(*attr_names) ⇒ Object
Places ActiveModel validations on the name of the file assigned. The possible options are:
-
matches
: Allowed filename patterns as Regexps. Can be a single one or an array. -
not
: Forbidden file name patterns, specified the same was asmatches
. -
message
: The message to display when the uploaded file has an invalid name. -
if
: A lambda or name of an instance method. Validation will only be run is this lambda or method returns true. -
unless
: Same asif
but validates if lambda or method returns false.
75 76 77 78 79 |
# File 'lib/paperclip/validators/attachment_file_name_validator.rb', line 75 def (*attr_names) = _merge_attributes(attr_names) validates_with AttachmentFileNameValidator, .dup validate_before_processing AttachmentFileNameValidator, .dup end |
#validates_attachment_presence(*attr_names) ⇒ Object
Places ActiveModel validations on the presence of a file. Options:
-
if
: A lambda or name of an instance method. Validation will only be run if this lambda or method returns true. -
unless
: Same asif
but validates if lambda or method returns false.
21 22 23 24 25 |
# File 'lib/paperclip/validators/attachment_presence_validator.rb', line 21 def (*attr_names) = _merge_attributes(attr_names) validates_with AttachmentPresenceValidator, .dup validate_before_processing AttachmentPresenceValidator, .dup end |
#validates_attachment_size(*attr_names) ⇒ Object
Places ActiveModel validations on the size of the file assigned. The possible options are:
-
in
: a Range of bytes (i.e.1..1.megabyte
), -
less_than
: equivalent to :in => 0..options -
greater_than
: equivalent to :in => options..Infinity -
message
: error message to display, use :min and :max as replacements -
if
: A lambda or name of an instance method. Validation will only be run if this lambda or method returns true. -
unless
: Same asif
but validates if lambda or method returns false.
118 119 120 121 122 |
# File 'lib/paperclip/validators/attachment_size_validator.rb', line 118 def (*attr_names) = _merge_attributes(attr_names) validates_with AttachmentSizeValidator, .dup validate_before_processing AttachmentSizeValidator, .dup end |
#validates_media_type_spoof_detection(*attr_names) ⇒ Object
Places ActiveModel validations on the presence of a file. Options:
-
if
: A lambda or name of an instance method. Validation will only be run if this lambda or method returns true. -
unless
: Same asif
but validates if lambda or method returns false.
22 23 24 25 26 |
# File 'lib/paperclip/validators/media_type_spoof_detection_validator.rb', line 22 def validates_media_type_spoof_detection(*attr_names) = _merge_attributes(attr_names) validates_with MediaTypeSpoofDetectionValidator, .dup validate_before_processing MediaTypeSpoofDetectionValidator, .dup end |