paperclip 3.4.0 → 6.1.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (220) hide show
  1. checksums.yaml +7 -0
  2. data/.codeclimate.yml +17 -0
  3. data/.github/issue_template.md +3 -0
  4. data/.gitignore +0 -6
  5. data/.hound.yml +1055 -0
  6. data/.rubocop.yml +1 -0
  7. data/.travis.yml +19 -12
  8. data/Appraisals +4 -11
  9. data/CONTRIBUTING.md +29 -13
  10. data/Gemfile +13 -4
  11. data/LICENSE +1 -3
  12. data/MIGRATING-ES.md +317 -0
  13. data/MIGRATING.md +375 -0
  14. data/NEWS +390 -71
  15. data/README.md +607 -152
  16. data/RELEASING.md +17 -0
  17. data/Rakefile +6 -8
  18. data/UPGRADING +12 -9
  19. data/features/basic_integration.feature +34 -21
  20. data/features/migration.feature +0 -24
  21. data/features/rake_tasks.feature +2 -3
  22. data/features/step_definitions/attachment_steps.rb +44 -36
  23. data/features/step_definitions/html_steps.rb +2 -2
  24. data/features/step_definitions/rails_steps.rb +125 -26
  25. data/features/step_definitions/s3_steps.rb +3 -3
  26. data/features/step_definitions/web_steps.rb +1 -103
  27. data/features/support/env.rb +3 -2
  28. data/features/support/fakeweb.rb +4 -1
  29. data/features/support/file_helpers.rb +12 -2
  30. data/features/support/fixtures/gemfile.txt +1 -1
  31. data/features/support/paths.rb +1 -1
  32. data/features/support/rails.rb +4 -11
  33. data/gemfiles/4.2.gemfile +17 -0
  34. data/gemfiles/5.0.gemfile +17 -0
  35. data/lib/generators/paperclip/paperclip_generator.rb +9 -3
  36. data/lib/generators/paperclip/templates/paperclip_migration.rb.erb +2 -2
  37. data/lib/paperclip/attachment.rb +215 -82
  38. data/lib/paperclip/attachment_registry.rb +60 -0
  39. data/lib/paperclip/callbacks.rb +13 -1
  40. data/lib/paperclip/content_type_detector.rb +48 -24
  41. data/lib/paperclip/errors.rb +8 -1
  42. data/lib/paperclip/file_command_content_type_detector.rb +6 -8
  43. data/lib/paperclip/filename_cleaner.rb +15 -0
  44. data/lib/paperclip/geometry_detector_factory.rb +12 -5
  45. data/lib/paperclip/geometry_parser_factory.rb +1 -1
  46. data/lib/paperclip/glue.rb +1 -2
  47. data/lib/paperclip/has_attached_file.rb +115 -0
  48. data/lib/paperclip/helpers.rb +15 -20
  49. data/lib/paperclip/interpolations/plural_cache.rb +18 -0
  50. data/lib/paperclip/interpolations.rb +36 -14
  51. data/lib/paperclip/io_adapters/abstract_adapter.rb +42 -5
  52. data/lib/paperclip/io_adapters/attachment_adapter.rb +20 -9
  53. data/lib/paperclip/io_adapters/data_uri_adapter.rb +22 -0
  54. data/lib/paperclip/io_adapters/empty_string_adapter.rb +19 -0
  55. data/lib/paperclip/io_adapters/file_adapter.rb +13 -7
  56. data/lib/paperclip/io_adapters/http_url_proxy_adapter.rb +16 -0
  57. data/lib/paperclip/io_adapters/identity_adapter.rb +12 -6
  58. data/lib/paperclip/io_adapters/nil_adapter.rb +8 -5
  59. data/lib/paperclip/io_adapters/registry.rb +6 -2
  60. data/lib/paperclip/io_adapters/stringio_adapter.rb +15 -16
  61. data/lib/paperclip/io_adapters/uploaded_file_adapter.rb +11 -7
  62. data/lib/paperclip/io_adapters/uri_adapter.rb +43 -19
  63. data/lib/paperclip/locales/en.yml +1 -0
  64. data/lib/paperclip/logger.rb +1 -1
  65. data/lib/paperclip/matchers/have_attached_file_matcher.rb +3 -6
  66. data/lib/paperclip/matchers/validate_attachment_content_type_matcher.rb +4 -4
  67. data/lib/paperclip/matchers/validate_attachment_presence_matcher.rb +7 -2
  68. data/lib/paperclip/matchers/validate_attachment_size_matcher.rb +2 -1
  69. data/lib/paperclip/matchers.rb +1 -1
  70. data/lib/paperclip/media_type_spoof_detector.rb +93 -0
  71. data/lib/paperclip/missing_attachment_styles.rb +11 -16
  72. data/lib/paperclip/processor.rb +15 -43
  73. data/lib/paperclip/processor_helpers.rb +50 -0
  74. data/lib/paperclip/rails_environment.rb +25 -0
  75. data/lib/paperclip/schema.rb +10 -8
  76. data/lib/paperclip/storage/filesystem.rb +20 -5
  77. data/lib/paperclip/storage/fog.rb +49 -23
  78. data/lib/paperclip/storage/s3.rb +153 -82
  79. data/lib/paperclip/style.rb +8 -3
  80. data/lib/paperclip/tempfile_factory.rb +6 -4
  81. data/lib/paperclip/thumbnail.rb +35 -19
  82. data/lib/paperclip/url_generator.rb +26 -14
  83. data/lib/paperclip/validators/attachment_content_type_validator.rb +15 -2
  84. data/lib/paperclip/validators/attachment_file_name_validator.rb +80 -0
  85. data/lib/paperclip/validators/attachment_file_type_ignorance_validator.rb +29 -0
  86. data/lib/paperclip/validators/attachment_presence_validator.rb +12 -8
  87. data/lib/paperclip/validators/attachment_size_validator.rb +17 -10
  88. data/lib/paperclip/validators/media_type_spoof_detection_validator.rb +31 -0
  89. data/lib/paperclip/validators.rb +31 -3
  90. data/lib/paperclip/version.rb +3 -1
  91. data/lib/paperclip.rb +41 -55
  92. data/lib/tasks/paperclip.rake +56 -9
  93. data/paperclip.gemspec +18 -17
  94. data/shoulda_macros/paperclip.rb +13 -3
  95. data/spec/paperclip/attachment_definitions_spec.rb +13 -0
  96. data/spec/paperclip/attachment_processing_spec.rb +79 -0
  97. data/spec/paperclip/attachment_registry_spec.rb +158 -0
  98. data/{test/attachment_test.rb → spec/paperclip/attachment_spec.rb} +597 -389
  99. data/spec/paperclip/content_type_detector_spec.rb +48 -0
  100. data/spec/paperclip/file_command_content_type_detector_spec.rb +40 -0
  101. data/spec/paperclip/filename_cleaner_spec.rb +13 -0
  102. data/spec/paperclip/geometry_detector_spec.rb +39 -0
  103. data/{test/geometry_parser_test.rb → spec/paperclip/geometry_parser_spec.rb} +27 -27
  104. data/{test/geometry_test.rb → spec/paperclip/geometry_spec.rb} +50 -52
  105. data/spec/paperclip/glue_spec.rb +44 -0
  106. data/spec/paperclip/has_attached_file_spec.rb +158 -0
  107. data/{test/integration_test.rb → spec/paperclip/integration_spec.rb} +179 -199
  108. data/{test/interpolations_test.rb → spec/paperclip/interpolations_spec.rb} +79 -46
  109. data/spec/paperclip/io_adapters/abstract_adapter_spec.rb +160 -0
  110. data/{test/io_adapters/attachment_adapter_test.rb → spec/paperclip/io_adapters/attachment_adapter_spec.rb} +54 -25
  111. data/spec/paperclip/io_adapters/data_uri_adapter_spec.rb +89 -0
  112. data/spec/paperclip/io_adapters/empty_string_adapter_spec.rb +17 -0
  113. data/spec/paperclip/io_adapters/file_adapter_spec.rb +131 -0
  114. data/spec/paperclip/io_adapters/http_url_proxy_adapter_spec.rb +138 -0
  115. data/spec/paperclip/io_adapters/identity_adapter_spec.rb +8 -0
  116. data/{test/io_adapters/nil_adapter_test.rb → spec/paperclip/io_adapters/nil_adapter_spec.rb} +7 -7
  117. data/{test/io_adapters/registry_test.rb → spec/paperclip/io_adapters/registry_spec.rb} +12 -9
  118. data/spec/paperclip/io_adapters/stringio_adapter_spec.rb +64 -0
  119. data/spec/paperclip/io_adapters/uploaded_file_adapter_spec.rb +146 -0
  120. data/spec/paperclip/io_adapters/uri_adapter_spec.rb +220 -0
  121. data/spec/paperclip/matchers/have_attached_file_matcher_spec.rb +19 -0
  122. data/spec/paperclip/matchers/validate_attachment_content_type_matcher_spec.rb +109 -0
  123. data/spec/paperclip/matchers/validate_attachment_presence_matcher_spec.rb +69 -0
  124. data/spec/paperclip/matchers/validate_attachment_size_matcher_spec.rb +88 -0
  125. data/spec/paperclip/media_type_spoof_detector_spec.rb +120 -0
  126. data/spec/paperclip/meta_class_spec.rb +30 -0
  127. data/spec/paperclip/paperclip_missing_attachment_styles_spec.rb +84 -0
  128. data/spec/paperclip/paperclip_spec.rb +192 -0
  129. data/spec/paperclip/plural_cache_spec.rb +37 -0
  130. data/spec/paperclip/processor_helpers_spec.rb +57 -0
  131. data/{test/processor_test.rb → spec/paperclip/processor_spec.rb} +7 -7
  132. data/spec/paperclip/rails_environment_spec.rb +33 -0
  133. data/spec/paperclip/rake_spec.rb +103 -0
  134. data/spec/paperclip/schema_spec.rb +248 -0
  135. data/{test/storage/filesystem_test.rb → spec/paperclip/storage/filesystem_spec.rb} +18 -18
  136. data/spec/paperclip/storage/fog_spec.rb +566 -0
  137. data/spec/paperclip/storage/s3_live_spec.rb +188 -0
  138. data/spec/paperclip/storage/s3_spec.rb +1693 -0
  139. data/spec/paperclip/style_spec.rb +254 -0
  140. data/spec/paperclip/tempfile_factory_spec.rb +33 -0
  141. data/spec/paperclip/tempfile_spec.rb +35 -0
  142. data/{test/thumbnail_test.rb → spec/paperclip/thumbnail_spec.rb} +186 -141
  143. data/spec/paperclip/url_generator_spec.rb +221 -0
  144. data/spec/paperclip/validators/attachment_content_type_validator_spec.rb +322 -0
  145. data/spec/paperclip/validators/attachment_file_name_validator_spec.rb +160 -0
  146. data/{test/validators/attachment_presence_validator_test.rb → spec/paperclip/validators/attachment_presence_validator_spec.rb} +20 -20
  147. data/{test/validators/attachment_size_validator_test.rb → spec/paperclip/validators/attachment_size_validator_spec.rb} +87 -59
  148. data/spec/paperclip/validators/media_type_spoof_detection_validator_spec.rb +52 -0
  149. data/spec/paperclip/validators_spec.rb +164 -0
  150. data/spec/spec_helper.rb +46 -0
  151. data/spec/support/assertions.rb +82 -0
  152. data/spec/support/fake_model.rb +25 -0
  153. data/spec/support/fake_rails.rb +12 -0
  154. data/spec/support/fixtures/empty.html +1 -0
  155. data/spec/support/fixtures/empty.xlsx +0 -0
  156. data/spec/support/fixtures/spaced file.jpg +0 -0
  157. data/spec/support/matchers/accept.rb +5 -0
  158. data/spec/support/matchers/exist.rb +5 -0
  159. data/spec/support/matchers/have_column.rb +23 -0
  160. data/{test → spec}/support/mock_attachment.rb +2 -0
  161. data/{test → spec}/support/mock_url_generator_builder.rb +2 -2
  162. data/spec/support/model_reconstruction.rb +68 -0
  163. data/spec/support/reporting.rb +11 -0
  164. data/spec/support/test_data.rb +13 -0
  165. data/spec/support/version_helper.rb +9 -0
  166. metadata +395 -346
  167. data/Gemfile.lock +0 -200
  168. data/RUNNING_TESTS.md +0 -4
  169. data/cucumber/paperclip_steps.rb +0 -6
  170. data/gemfiles/3.0.gemfile +0 -11
  171. data/gemfiles/3.1.gemfile +0 -11
  172. data/gemfiles/3.2.gemfile +0 -11
  173. data/lib/paperclip/attachment_options.rb +0 -9
  174. data/lib/paperclip/instance_methods.rb +0 -35
  175. data/test/attachment_options_test.rb +0 -27
  176. data/test/attachment_processing_test.rb +0 -29
  177. data/test/content_type_detector_test.rb +0 -40
  178. data/test/file_command_content_type_detector_test.rb +0 -25
  179. data/test/generator_test.rb +0 -80
  180. data/test/geometry_detector_test.rb +0 -24
  181. data/test/helper.rb +0 -199
  182. data/test/io_adapters/abstract_adapter_test.rb +0 -50
  183. data/test/io_adapters/file_adapter_test.rb +0 -100
  184. data/test/io_adapters/identity_adapter_test.rb +0 -8
  185. data/test/io_adapters/stringio_adapter_test.rb +0 -51
  186. data/test/io_adapters/uploaded_file_adapter_test.rb +0 -123
  187. data/test/io_adapters/uri_adapter_test.rb +0 -86
  188. data/test/matchers/have_attached_file_matcher_test.rb +0 -24
  189. data/test/matchers/validate_attachment_content_type_matcher_test.rb +0 -110
  190. data/test/matchers/validate_attachment_presence_matcher_test.rb +0 -47
  191. data/test/matchers/validate_attachment_size_matcher_test.rb +0 -86
  192. data/test/meta_class_test.rb +0 -32
  193. data/test/paperclip_missing_attachment_styles_test.rb +0 -94
  194. data/test/paperclip_test.rb +0 -259
  195. data/test/schema_test.rb +0 -200
  196. data/test/storage/fog_test.rb +0 -453
  197. data/test/storage/s3_live_test.rb +0 -179
  198. data/test/storage/s3_test.rb +0 -1236
  199. data/test/style_test.rb +0 -213
  200. data/test/support/mock_model.rb +0 -2
  201. data/test/tempfile_factory_test.rb +0 -13
  202. data/test/url_generator_test.rb +0 -187
  203. data/test/validators/attachment_content_type_validator_test.rb +0 -292
  204. data/test/validators_test.rb +0 -25
  205. /data/{test → spec}/database.yml +0 -0
  206. /data/{test → spec/support}/fixtures/12k.png +0 -0
  207. /data/{test → spec/support}/fixtures/50x50.png +0 -0
  208. /data/{test → spec/support}/fixtures/5k.png +0 -0
  209. /data/{test → spec/support}/fixtures/animated +0 -0
  210. /data/{test → spec/support}/fixtures/animated.gif +0 -0
  211. /data/{test → spec/support}/fixtures/animated.unknown +0 -0
  212. /data/{test → spec/support}/fixtures/bad.png +0 -0
  213. /data/{test → spec/support}/fixtures/fog.yml +0 -0
  214. /data/{test → spec/support}/fixtures/rotated.jpg +0 -0
  215. /data/{test → spec/support}/fixtures/s3.yml +0 -0
  216. /data/{test → spec/support}/fixtures/spaced file.png +0 -0
  217. /data/{test → spec/support}/fixtures/text.txt +0 -0
  218. /data/{test → spec/support}/fixtures/twopage.pdf +0 -0
  219. /data/{test → spec/support}/fixtures/uppercase.PNG +0 -0
  220. /data/{test → spec}/support/mock_interpolator.rb +0 -0
data/NEWS CHANGED
@@ -1,50 +1,369 @@
1
+ 6.1.0 (2018-07-27):
2
+
3
+ * BUGFIX: Don't double-encode URLs (Roderick Monje).
4
+ * BUGFIX: Only use the content_type when it exists (Jean-Philippe Doyle).
5
+ * STABILITY: Better handling of the content-disposition header. Now supports
6
+ file name that is either enclosed or not in double quotes and is case
7
+ insensitive as per RC6266 grammar (Hasan Kumar, Yves Riel).
8
+ * STABILITY: Change database column type of attachment file size from unsigned 4-byte
9
+ `integer` to unsigned 8-byte `bigint`. The former type limits attachment size
10
+ to just over 2GB, which can easily be exceeded by a large video file (Laurent
11
+ Arnoud, Alen Zamanyan).
12
+ * STABILITY: Better error message when thumbnail processing errors (Hayden Ball).
13
+ * STABILITY: Fix file linking issues around Windows (Akihiko Odaki).
14
+ * STABILITY: Files without an extension will now be checked for spoofing attempts
15
+ (George Walters II).
16
+ * STABILITY: Manually close Tempfiles when we are done with them (Erkki Eilonen).
17
+
18
+ 6.0.0 (2018-03-09):
19
+
20
+ * Improvement: Depend only on `aws-sdk-s3` instead of `aws-sdk` (https://github.com/thoughtbot/paperclip/pull/2481)
21
+
22
+ 5.3.0 (2018-03-09):
23
+
24
+ * Improvement: Use `FactoryBot` instead of `FactoryGirl` (https://github.com/thoughtbot/paperclip/pull/2501)
25
+ * Improvement: README updates (https://github.com/thoughtbot/paperclip/pull/2411, https://github.com/thoughtbot/paperclip/pull/2433, https://github.com/thoughtbot/paperclip/pull/2374, https://github.com/thoughtbot/paperclip/pull/2417, https://github.com/thoughtbot/paperclip/pull/2536)
26
+ * Improvement: Remove Ruby 2.4 deprecation warning (https://github.com/thoughtbot/paperclip/pull/2401)
27
+ * Improvement: Rails 5 migration compatibility (https://github.com/thoughtbot/paperclip/pull/2470)
28
+ * Improvement: Documentation around post processing (https://github.com/thoughtbot/paperclip/pull/2381)
29
+ * Improvement: S3 hostname example documentation (https://github.com/thoughtbot/paperclip/pull/2379)
30
+ * Bugfix: Allow paperclip to load in IRB (https://github.com/thoughtbot/paperclip/pull/2369)
31
+ * Bugfix: MIME type detection (https://github.com/thoughtbot/paperclip/issues/2527)
32
+ * Bugfix: Bad tempfile state after symlink failure (https://github.com/thoughtbot/paperclip/pull/2540)
33
+ * Bugfix: Rewind file after Fog bucket creation (https://github.com/thoughtbot/paperclip/pull/2572)
34
+ * Improvement: Use `Terrapin` instead of `Cocaine` (https://github.com/thoughtbot/paperclip/pull/2553)
35
+
36
+ 5.2.1 (2018-01-25):
37
+
38
+ * Bugfix: Fix copying files on Windows. (#2532)
39
+
40
+ 5.2.0 (2018-01-23):
41
+
42
+ * Security: Remove the automatic loading of URI adapters. Some of these
43
+ adapters can be specially crafted to expose your network topology. (#2435)
44
+ * Bugfix: The rake task no longer rescues `Exception`. (#2476)
45
+ * Bugfix: Handle malformed `Content-Disposition` headers (#2283)
46
+ * Bugfix: The `:only_process` option works when passed a lambda again. (#2289)
47
+ * Improvement: Added `:use_accelerate_endpoint` option when using S3 to enable
48
+ [Amazon S3 Transfer Acceleration](http://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html)
49
+ (#2291)
50
+ * Improvement: Make the fingerprint digest configurable per attachment. The
51
+ default remains MD5. Making this configurable means it can change in a future
52
+ version because it is not considered secure anymore against intentional file
53
+ corruption. For more info, see https://en.wikipedia.org/wiki/MD5#Security
54
+
55
+ You can change the digest used for an attachment by adding the
56
+ `:adapter_options` parameter to the `has_attached_file` options like this:
57
+ `has_attached_file :avatar, adapter_options: { hash_digest: Digest::SHA256 }`
58
+
59
+ Use the rake task to regenerate fingerprints with the new digest for a given
60
+ class. Note that this does **not** check the file integrity using the old
61
+ fingerprint. Run the following command to regenerate fingerprints for all
62
+ User attachments:
63
+ `CLASS=User rake paperclip:refresh:fingerprints`
64
+ You can optionally limit the attachment that will be processed, e.g:
65
+ `CLASS=User ATTACHMENT=avatar rake paperclip:refresh:fingerprints` (#2229)
66
+ * Improvement: The new `frame_index` option on the thumbnail processor allows
67
+ you to select a specific frame from an animated upload to use as a thumbnail.
68
+ Initial support is for mkv, avi, MP4, mov, MPEG, and GIF. (#2155)
69
+ * Improvement: Instead of copying files, use hard links. This is an
70
+ optimization. (#2120)
71
+ * Improvement: S3 storage option `:s3_prefixes_in_alias`. (#2287)
72
+ * Improvement: Fog option `:fog_public` can be a lambda. (#2302)
73
+ * Improvement: One fewer warning on JRuby. (#2352)
74
+ * Ruby 2.4.0 compatibility (doesn't use Fixnum anymore)
75
+
76
+ 5.1.0 (2016-08-19):
77
+
78
+ * Add default `content_type_detector` to `UploadedFileAdapter` (#2270)
79
+ * Default S3 protocol to empty string (#2038)
80
+ * Don't write original file if it wasn't reprocessed (#1993)
81
+ * Disallow trailing newlines in regular expressions (#2266)
82
+ * Support for readbyte in Paperclip attachments (#2034)
83
+ * (port from 4.3) Uri io adapter uses the content-disposition filename (#2250)
84
+ * General refactors and documentation improvements
85
+
86
+ 5.0.0 (2016-07-01):
87
+
88
+ * Improvement: Add `read_timeout` configuration for URI Adapter download_content method.
89
+ * README adjustments for Ruby beginners (add links, elucidate model in Quick Start)
90
+ * Bugfix: Now it's possible to save images from URLs with special characters [#1932]
91
+ * Bugfix: Return false when file to copy is not present in cloud storage [#2173]
92
+ * Automatically close file while checking mime type [#2016]
93
+ * Add `read_timeout` option to `UriAdapter#download_content` method [#2232]
94
+ * Fix a nil error in content type validation matcher [#1910]
95
+ * Documentation improvements
96
+
97
+ 5.0.0.beta2 (2016-04-01):
98
+
99
+ * Bugfix: Dynamic fog directory option is now respected
100
+ * Bugfix: Fixes cocaine duplicated paths [#2169]
101
+ * Removal of dead code (older versions of Rails and AWS SDK)
102
+ * README adjustments
103
+
104
+ 5.0.0.beta1 (2016-03-13):
105
+
106
+ * Bug Fix: megabytes of mime-types info in logs when a spoofed media type is detected.
107
+ * Drop support to end-of-life'd ruby 2.0.
108
+ * Drop support for end-of-life'd Rails 3.2 and 4.1
109
+ * Drop support for AWS v1
110
+ * Remove tests for JRuby and Rubinius from Travis CI (they were failing)
111
+ * Improvement: Add `fog_options` configuration to send options to fog when
112
+ storing files.
113
+ * Extracted repository for locales only: https://github.com/thoughtbot/paperclip-i18n
114
+ * Bugfix: Original file could be unlinked during `post_process_style`, producing failures
115
+ * Bugfix for image magick scaling images up
116
+ * Memory consumption improvements
117
+ * `url` on a unpersisted record returns `default_url` rather than `nil`
118
+ * Improvement: aws-sdk v2 support
119
+ https://github.com/thoughtbot/paperclip/pull/1903
120
+
121
+ If your Gemfile contains aws-sdk (>= 2.0.0) and aws-sdk-v1, paperclip will use
122
+ aws-sdk v2. With aws-sdk v2, S3 storage requires you to set the s3_region.
123
+ s3_region may be nested in s3_credentials, and (if not nested in
124
+ s3_credentials) it may be a Proc.
125
+
126
+ 4.3
127
+
128
+ See patch versions in v4.3 NEWS:
129
+ https://github.com/thoughtbot/paperclip/blob/v4.3/NEWS
130
+
131
+ 4.3.0 (2015-06-18):
132
+
133
+ * Improvement: Update aws-sdk and cucumber gem versions.
134
+ * Improvement: Add `length` alias for `size` method in AbstractAdapter.
135
+ * Improvement: Removed some cruft
136
+ * Improvement: deep_merge! Attachment definitions
137
+ * Improvement: Switch to mimemagic gem for content-type detection
138
+ * Improvement: Allows multiple content types for spoof detector
139
+ * Bug Fix: Don't assume we have Rails.env if we have Rails
140
+ * Performance: Decrease Memory footprint
141
+ * Ruby Versioning: Drop support for 1.9.3 (EOL'ed)
142
+ * Rails Versioning: Drop support for 4.0.0 (EOL'ed)
143
+
144
+ 4.2.4 (2015-06-05):
145
+
146
+ * Rollback backwards incompatible change, allowing paperclip to run on
147
+ Ruby >= 1.9.2.
148
+
149
+ 4.2.3:
150
+
151
+ * Fix dependency specifications (didn't work with Rails 4.1)
152
+ * Fix paperclip tests in CI
153
+
154
+ 4.2.2:
155
+
156
+ * Security fix: Fix a potential security issue with spoofing
157
+
158
+ 4.2.1:
159
+
160
+ * Improvement: Added `validate_media_type` options to allow/bypass spoof check
161
+ * Improvement: Added incremental backoff when AWS gives us a SlowDown error.
162
+ * Improvement: Stream downloads when usign aws-sdk.
163
+ * Improvement: Documentation fixes, includes Windows instructions.
164
+ * Improvement: Added pt-BR, zh-HK, zh-CN, zh-TW, and ja-JP locales.
165
+ * Improvement: Better escaping for characters in URLs
166
+ * Improvement: Honor `fog_credentials[:scheme]`
167
+ * Improvement: Also look for custom processors in lib/paperclip
168
+ * Improvement: id partitioning for string IDs works like integer id
169
+ * Improvement: Can pass options to DB adapters in migrations
170
+ * Improvement: Update expiring_url creation for later versions of fog
171
+ * Improvement: `path` can be a Proc in S3 attachments
172
+ * Test Fix: Improves speed and reliability of the specs
173
+ * Bug Fix: #original_filename= does not error when passed `nil`
174
+
175
+ 4.2.0:
176
+
177
+ * Improvement: Converted test suite from test/unit to RSpec
178
+ * Improvement: Refactored Paperclip::Attachment#assign
179
+ * Improvement: Added Spanish and German locales
180
+ * Improvement: Required Validators accept validator subclasses
181
+ * Improvement: EXIF orientation checking can be turned off for performance
182
+ * Improvement: Documentation updates
183
+ * Improvement: Better #human_size method for AttachmentSizeValidators
184
+ * Bug Fix: Allow MIME-types with dots in them
185
+ * Improvement: Travis CI updates
186
+ * Improvement: Validators can take multiple messages
187
+ * Improvement: Per-style options for S3 storage
188
+ * Improvement: Allow `nil` geometry strings
189
+ * Improvement: Use `eager_load!`
190
+
191
+ 4.1.1:
192
+
193
+ * Improvement: Add default translations for spoof validation
194
+ * Bug Fix: Don't check for spoofs if the file hasn't changed
195
+ * Bug Fix: Callback chain terminator is different in Rails 4.1, remove warnings
196
+ * Improvement: Fixed various Ruby warnings
197
+ * Bug Fix: Give bundler a hint, so it doesn't run forever on a fresh bundle
198
+ * Improvement: Documentation fixes
199
+ * Improvement: Allow travis-ci to finish-fast
200
+
201
+
202
+ 4.1.0:
203
+
204
+ * Improvement: Add :content_type_mappings to correct for missing spoof types
205
+ * Improvement: Credit Egor Homakov with discovering the content_type spoof bug
206
+ * Improvement: Memoize calls to identify in the thumbnail processor
207
+ * Improvement: Make MIME type optional for Data URIs.
208
+ * Improvement: Add default format for styles
209
+
210
+ 4.0.0:
211
+
212
+ * Security: Attachments are checked to make sure they're not pulling a fast one.
213
+ * Security: It is now *enforced* that every attachment has a file/mime validation.
214
+ * Bug Fix: Removed a call to IOAdapter#close that was causing issues.
215
+ * Improvement: Added bullets to the 3.5.3 list of changes. Very important.
216
+ * Improvement: Updated the copyright to 2014
217
+
218
+ 3.5.3:
219
+
220
+ * Improvement: After three long, hard years... we know how to upgrade
221
+ * Bug Fix: #expiring_url returns 'missing' urls if nothing is attached
222
+ * Improvement: Lots of documentation fixes
223
+ * Improvement: Lots of fixes for Ruby warnings
224
+ * Improvement: Test the most appropriate Ruby/Rails comobinations on Travis
225
+ * Improvement: Delegate more IO methods through IOAdapters
226
+ * Improvement: Remove Rails 4 deprecations
227
+ * Improvement: Both S3's and Fog's #expiring_url can take a Time or Int
228
+ * Bug Fix: Both S3's and Fog's expiring_url respect style when missing the file
229
+ * Bug Fix: Timefiles will have a reasonable-length name. They're all MD5 hashes now
230
+ * Bug Fix: Don't delete files off S3 when reprocessing due to AWS inconsistencies
231
+ * Bug Fix: "swallow_stream" isn't thread dafe. Use :swallow_stderr
232
+ * Improvement: Regexps use \A and \Z instead of ^ and $
233
+ * Improvement: :s3_credentials can take a lambda as an argument
234
+ * Improvement: Search up the class heirarchy for attachments
235
+ * Improvement: deep_merge options instead of regular merge
236
+ * Bug Fix: Prevent file deletion on transaction rollback
237
+ * Test Improvement: Ensure more files are properly closed during tests
238
+ * Test Bug Fix: Return the gemfile's syntax to normal
239
+
240
+ 3.5.2:
241
+
242
+ * Security: Force cocaine to at least 0.5.3 to include a security fix
243
+ * Improvement: Fixed some README exmaples
244
+ * Feature: Added HTTP URL Proxy Adapter, can assign string URLs as attachments
245
+ * Improvement: Put validation errors on the base attribute and the sub-attribute
246
+
247
+ 3.5.1:
248
+
249
+ * Bug Fix: Returned the class-level `attachment_definitions` method for compatability.
250
+ * Improvement: Ensured compatability with Rails 4
251
+ * Improvement: Added Rails 4 to the Appraisals
252
+ * Bug Fix: #1296, where validations were generating errors
253
+ * Improvement: Specify MIT license in the gemspec
254
+
255
+ 3.5.0:
256
+
257
+ * Feature: Handle Base64-encoded data URIs as uploads
258
+ * Feature: Add a FilenameCleaner class to allow custom filename sanitation
259
+ * Improvement: Satisfied Mocha deprecation warnings
260
+ * Bug Fix: Allow empty string to be submitted and ignored, as some forms do this
261
+ * Improvement: Make #expiring_url behavior consistent with #url
262
+ * Bug Fix: "Validate" attachments without invoking AR's validations
263
+ * Improvement: Various refactorings for a cleaner codebase
264
+ * Improvement: Be agnostic, use ActiveModel when appropriate
265
+ * Improvement: Add validation errors to the base attachment attribute
266
+ * Improvement: Handle errors in rake tasks
267
+ * Improvement: Largely refactor has_attached_file into a new class
268
+ * Improvement: Added Ruby 2.0.0 as a supported platform and removed 1.8.7
269
+ * Improvement: Fixed some incompatabilities in the test suite
270
+
271
+ 3.4.2:
272
+
273
+ * Improvement: Use https for Gemfile urls
274
+ * Improvement: Updated and more correct documentation
275
+ * Improvement: Use the -optimize flag on animated GIFs
276
+ * Improvement: Remove the Gemfile.lock
277
+ * Improvement: Add #expiring_url as an alias for #url until the storage defines it
278
+ * Improvement: Remove path clash checking, as it's unnecessary
279
+ * Bug Fix: Do not rely on checking version numbers for aws-sdk
280
+
281
+ 3.4.1:
282
+
283
+ * Improvement: Various documentation fixes and improvements
284
+ * Bug Fix: Clearing an attachment with `preserve_files` on should still clear the attachment
285
+ * Bug Fix: Instances are #changed? when a new file is assigned
286
+ * Bug Fix: Correctly deal with S3 styles when using a lambda
287
+ * Improvement: Accept and pass :credential_provider option to AWS-SDK
288
+ * Bug Fix: Sanitize original_filename more correctly in IO Adapters
289
+ * Improvement: s3_host_name can be a lambda
290
+ * Improvement: Cache some interpolations for speed
291
+ * Improvement: Update to latest cocaine
292
+ * Improvement: Update copyrights, various typos
293
+
294
+ 3.4.0:
295
+
296
+ * Bug Fix: Allow UploadedFileAdapter to force the use of `file`
297
+ * Bug Fix: Close the file handle when dealing with URIs
298
+ * Bug Fix: Ensure files are closed for writing when we're done.
299
+ * Bug Fix: Fixed 'type' being nil on Windows 7 error.
300
+ * Bug Fix: Fixed nil access when no s3 headers are defined
301
+ * Bug Fix: Fixes auto_orientation
302
+ * Bug Fix: Prevent a missing method error when switching from aws_sdk to fog
303
+ * Bug Fix: Properly fail to process invalid attachments
304
+ * Bug Fix: Server-side encryption is specified correctly
305
+ * Bug Fix: fog_public returned to true by default
306
+ * Bug Fix: Check attachment paths for duplicates, not URLs
307
+ * Feature: Add Attachment#blank?
308
+ * Feature: Add support for blacklisting certain content_types
309
+ * Feature: Add support for style-specific s3 headers and meta data
310
+ * Feature: Allow only_process to be a lambda
311
+ * Feature: Allow setting of escape url as a default option
312
+ * Feature: Create :override_file_permissions option for filesystem attachments
313
+ * Improvement: Add Attachment#as_json
314
+ * Improvement: Evaluate lambdas for fog_file properties
315
+ * Improvement: Extract geometry parsing into factories
316
+ * Improvement: Fixed various typos
317
+ * Improvement: Refactored some tests
318
+ * Improvement: Reuse S3 connections
319
+
1
320
  New In 3.3.1:
2
321
 
3
- * Bug fix: Moved Filesystem's copy_to_local_file to the right place.
322
+ * Bug Fix: Moved Filesystem's copy_to_local_file to the right place.
4
323
 
5
- New in 3.3.0:
324
+ 3.3.0:
6
325
 
7
326
  * Improvement: Upgrade cocaine to 0.4
8
327
 
9
- New in 3.2.0:
328
+ 3.2.0:
10
329
 
11
- * Bug fix: Use the new correct Amazon S3 encryption header.
12
- * Bug fix: The rake task respects the updated_at column.
13
- * Bug fix: Strip newline from content type.
330
+ * Bug Fix: Use the new correct Amazon S3 encryption header.
331
+ * Bug Fix: The rake task respects the updated_at column.
332
+ * Bug Fix: Strip newline from content type.
14
333
  * Feature: Fog file visibility can be specified per style.
15
334
  * Feature: Automatically rotate images.
16
335
  * Feature: Reduce class-oriented programming of the attachment definitions.
17
336
 
18
- New in 3.1.4:
337
+ 3.1.4:
19
338
 
20
- * Bug fix: Allow user to be able to set path without `:style` attribute and not raising an error.
339
+ * Bug Fix: Allow user to be able to set path without `:style` attribute and not raising an error.
21
340
  This is a regression introduced in 3.1.3, and that feature will be postponed to another minor
22
341
  release instead.
23
342
  * Feature: Allow for URI Adapter as an optional paperclip io adapter.
24
343
 
25
- New in 3.1.3:
344
+ 3.1.3:
26
345
 
27
- * Bug fix: Copy empty attachment between instances is now working.
28
- * Bug fix: Correctly rescue Fog error.
29
- * Bug fix: Using default path and url options in Fog storage now work as expected.
30
- * Bug fix: `Attachment#s3_protocol` now returns a protocol without colon suffix.
346
+ * Bug Fix: Copy empty attachment between instances is now working.
347
+ * Bug Fix: Correctly rescue Fog error.
348
+ * Bug Fix: Using default path and url options in Fog storage now work as expected.
349
+ * Bug Fix: `Attachment#s3_protocol` now returns a protocol without colon suffix.
31
350
  * Feature: Paperclip will now raise an error if multiple styles are defined but no `:style`
32
351
  interpolation exists in `:path`.
33
352
  * Feature: Add support for `#{attachment}_created_at` field
34
- * Bug fix: Paperclip now gracefully handles msising file command.
35
- * Bug fix: `StringIOAdapter` now accepts content type.
353
+ * Bug Fix: Paperclip now gracefully handles msising file command.
354
+ * Bug Fix: `StringIOAdapter` now accepts content type.
36
355
 
37
- New in 3.1.2:
356
+ 3.1.2:
38
357
 
39
- * Bug fix: #remove_attachment on 3.1.0 and 3.1.1 mistakenly trying to remove the column that has
358
+ * Bug Fix: #remove_attachment on 3.1.0 and 3.1.1 mistakenly trying to remove the column that has
40
359
  the same name as data type (such as :string, :datetime, :interger.) You're advised to update to
41
360
  Paperclip 3.1.2 as soon as possible.
42
361
 
43
- New in 3.1.1:
362
+ 3.1.1:
44
363
 
45
- * Bug fix: Paperclip will only load Paperclip::Schema only when Active Record is available.
364
+ * Bug Fix: Paperclip will only load Paperclip::Schema only when Active Record is available.
46
365
 
47
- New in 3.1.0:
366
+ 3.1.0:
48
367
 
49
368
  * Feature: Paperclip now support new migration syntax (sexy migration) that reads better:
50
369
 
@@ -64,39 +383,39 @@ New in 3.1.0:
64
383
  * Feature: Migration now support Rails 3.2+ `change` method.
65
384
  * API CHANGE: Old `t.has_attached_file` and `drop_attached_file` are now deprecated. You're advised
66
385
  to update your migration file before the next MAJOR version.
67
- * Bug fix: Tempfile now rewinded before generating fingerprint
386
+ * Bug Fix: Tempfile now rewinded before generating fingerprint
68
387
  * API CHANGE: Tempfiles are now unlinked after `after_flush_writes`
69
388
 
70
389
  If you need to interact with the generated tempfiles, please define an `after_flush_writes` method
71
390
  in your model. You'll be able to access files via `@queue_for_write` instance variable.
72
391
 
73
- * Bug fix: `:s3_protocol` can now be defined as either String or Symbol
74
- * Bug fix: Tempfiles are now rewinded before get passed into `after_flush_writes`
392
+ * Bug Fix: `:s3_protocol` can now be defined as either String or Symbol
393
+ * Bug Fix: Tempfiles are now rewinded before get passed into `after_flush_writes`
75
394
  * Feature: Added expiring_url method to Fog Storage
76
395
  * API CHANGE: Paperclip now tested against AWS::SDK 1.5.2 onward
77
- * Bug fix: Improved the output of the content_type validator so the actual failure is displayed
396
+ * Bug Fix: Improved the output of the content_type validator so the actual failure is displayed
78
397
  * Feature: Animated formats now identified using ImageMagick.
79
398
  * Feature: AttachmentAdapter now support fetching attachment with specific style.
80
399
  * Feature: Paperclip default options can now be configured in Rails.configuration.
81
400
  * Feature: add Geometry#resize_to to calculate dimensions of new source.
82
- * Bug fix: Fixed a bug whereby a file type with multiple mime types but no official type would cause
401
+ * Bug Fix: Fixed a bug whereby a file type with multiple mime types but no official type would cause
83
402
  the best_content_type to throw an error on trying nil.content_type.
84
- * Bug fix: Fix problem when the gem cannot be installed on the system that has Asepsis installed.
403
+ * Bug Fix: Fix problem when the gem cannot be installed on the system that has Asepsis installed.
85
404
 
86
- New in 3.0.4:
405
+ 3.0.4:
87
406
 
88
407
  * Feature: Adds support for S3 scheme-less URL generation.
89
408
 
90
- New in 3.0.3:
409
+ 3.0.3:
91
410
 
92
- * Bug fix: ThumbnailProcessor now correctly detects and preserve animated GIF.
93
- * Bug fix: File extension is now preserved in generated Tempfile from adapter.
94
- * Bug fix: Uploading file with unicode file name now won't raise an error when
411
+ * Bug Fix: ThumbnailProcessor now correctly detects and preserve animated GIF.
412
+ * Bug Fix: File extension is now preserved in generated Tempfile from adapter.
413
+ * Bug Fix: Uploading file with unicode file name now won't raise an error when
95
414
  logging in the AWS is turned on.
96
- * Bug fix: Task "paperclip:refresh:missing_styles" now work correctly.
97
- * Bug fix: Handle the case when :restricted_characters is nil.
98
- * Bug fix: Don't delete all the existing styles if we reprocess.
99
- * Bug fix: Content type is now ensured to not having a new line character.
415
+ * Bug Fix: Task "paperclip:refresh:missing_styles" now work correctly.
416
+ * Bug Fix: Handle the case when :restricted_characters is nil.
417
+ * Bug Fix: Don't delete all the existing styles if we reprocess.
418
+ * Bug Fix: Content type is now ensured to not having a new line character.
100
419
  * API CHANGE: Non-Rails usage should include Paperclip::Glue directly.
101
420
 
102
421
  `Paperclip::Railtie` was intended to be used with Ruby on Rails only. If you're
@@ -105,27 +424,27 @@ New in 3.0.3:
105
424
 
106
425
  ActiveRecord::Base.send :include, Paperclip::Glue
107
426
 
108
- * Bug fix: AttachmentContentTypeValidator now allow you to specify :allow_blank/:allow_nil
109
- * Bug fix: Make sure content type always a String.
110
- * Bug fix: Fix attachment.reprocess! when using storage providers fog and s3.
111
- * Bug fix: Fix a problem with incorrect content_type detected with 'file' command for an empty file on Mac.
427
+ * Bug Fix: AttachmentContentTypeValidator now allow you to specify :allow_blank/:allow_nil
428
+ * Bug Fix: Make sure content type always a String.
429
+ * Bug Fix: Fix attachment.reprocess! when using storage providers fog and s3.
430
+ * Bug Fix: Fix a problem with incorrect content_type detected with 'file' command for an empty file on Mac.
112
431
 
113
- New in 3.0.2:
432
+ 3.0.2:
114
433
 
115
434
  * API CHANGE: Generated migration class name is now plural (AddAttachmentToUsers instead of AddAttachmentToUser)
116
435
  * API CHANGE: Remove Rails plugin initialization code.
117
436
  * API CHANGE: Explicitly require Ruby 1.9.2 in the Gemfile.
118
- * Bug fix: Fixes AWS::S3::Errors::RequestTimeout on Model#save.
119
- * Bug fix: Fix a problem when there's no logger specified.
120
- * Bug fix: Fix a problem when attaching Rack::Test::UploadedFile instance.
437
+ * Bug Fix: Fixes AWS::S3::Errors::RequestTimeout on Model#save.
438
+ * Bug Fix: Fix a problem when there's no logger specified.
439
+ * Bug Fix: Fix a problem when attaching Rack::Test::UploadedFile instance.
121
440
 
122
- New in 3.0.1:
441
+ 3.0.1:
123
442
 
124
443
  * Feature: Introduce Paperlip IO adapter.
125
- * Bug fix: Regression in AttachmentContentTypeValidator has been fixed.
444
+ * Bug Fix: Regression in AttachmentContentTypeValidator has been fixed.
126
445
  * API CHANGE: #to_file has been removed. Use the #copy_to_local_file method instead.
127
446
 
128
- New in 3.0.0:
447
+ 3.0.0:
129
448
 
130
449
  * API CHANGE: Paperclip now requires at least Ruby on Rails version 3.0.0
131
450
  * API CHANGE: The default :url and :path have changed. The new scheme avoids
@@ -139,58 +458,58 @@ New in 3.0.0:
139
458
  :url => "/system/:attachment/:id/:style/:filename"
140
459
 
141
460
  * Feature: Adding Rails 3 style validators, and adding `validates_attachment` method as a shorthand.
142
- * Bug fix: Paperclip's rake tasks now loading records in batch.
143
- * Bug fix: Attachment style name with leading number now not raising an error.
144
- * Bug fix: File given to S3 and Fog storage will now be rewinded after flush_write.
461
+ * Bug Fix: Paperclip's rake tasks now loading records in batch.
462
+ * Bug Fix: Attachment style name with leading number now not raising an error.
463
+ * Bug Fix: File given to S3 and Fog storage will now be rewinded after flush_write.
145
464
  * Feature: You can now pass addional parameter to S3 expiring URL, such as :content_type.
146
465
 
147
- New in 2.7.0:
466
+ 2.7.0:
148
467
 
149
- * Bug fix: Checking the existence of a file on S3 handles all AWS errors.
150
- * Bug fix: Clear the fingerprint when removing an attachment.
151
- * Bug fix: Attachment size validation message reads more nicely now.
468
+ * Bug Fix: Checking the existence of a file on S3 handles all AWS errors.
469
+ * Bug Fix: Clear the fingerprint when removing an attachment.
470
+ * Bug Fix: Attachment size validation message reads more nicely now.
152
471
  * Feature: Style names can be either symbols or strings.
153
472
  * Compatibility: Support for ActiveSupport < 2.3.12.
154
473
  * Compatibility: Support for Rails 3.2.
155
474
 
156
- New in 2.6.0:
475
+ 2.6.0:
157
476
 
158
- * Bug fix: Files are re-wound after reading.
477
+ * Bug Fix: Files are re-wound after reading.
159
478
  * Feature: Remove Rails dependency from specs that need Paperclip.
160
479
  * Feature: Validation matchers support conditionals.
161
480
 
162
- New in 2.5.2:
481
+ 2.5.2:
163
482
 
164
- * Bug fix: Can be installed on Windows.
483
+ * Bug Fix: Can be installed on Windows.
165
484
  * Feature: The Fog bucket name, authentication, and host can be determined at runtime via Proc.
166
485
  * Feature: Special characters are replaced with underscores in #url and #path.
167
486
 
168
- New in 2.5.1:
487
+ 2.5.1:
169
488
 
170
489
  * Feature: After we've computed the content type, pass it to Fog.
171
490
  * Feature: S3 encryption with the new :s3_server_side_encryption option.
172
491
  * Feature: Works without ActiveRecord, allowing for e.g. mongo backends.
173
492
 
174
- New in 2.5.0:
493
+ 2.5.0:
175
494
 
176
495
  * Performance: Only connect to S3 when absolutely needed.
177
- * Bug fix: STI with cached classes respect new options.
178
- * Bug fix: conditional validations broke, and now work again.
496
+ * Bug Fix: STI with cached classes respect new options.
497
+ * Bug Fix: conditional validations broke, and now work again.
179
498
  * Feature: URL generation is now parameterized and can be changed with plugins or custom code.
180
499
  * Feature: :convert_options and :source_file_options to control the ImageMagick processing.
181
500
  * Performance: String geometry specifications now parse more quickly.
182
- * Bug fix: Handle files with question marks in the filename.
183
- * Bug fix: Don't raise an error when generating an expiring URL on an unassigned attachment.
184
- * Bug fix: The rake task runs over all instances of an ActiveRecord model, ignoring default scopes.
501
+ * Bug Fix: Handle files with question marks in the filename.
502
+ * Bug Fix: Don't raise an error when generating an expiring URL on an unassigned attachment.
503
+ * Bug Fix: The rake task runs over all instances of an ActiveRecord model, ignoring default scopes.
185
504
  * Feature: DB migration has_attached_file and drop_attached_file methods.
186
- * Bug fix: Switch from AWS::S3 to AWS::SDK for the S3 backend.
187
- * Bug fix: URL generator uses '?' in the URL unless it already appears and there is no prior '='.
188
- * Bug fix: Always convert the content type to a string before stripping blanks.
505
+ * Bug Fix: Switch from AWS::S3 to AWS::SDK for the S3 backend.
506
+ * Bug Fix: URL generator uses '?' in the URL unless it already appears and there is no prior '='.
507
+ * Bug Fix: Always convert the content type to a string before stripping blanks.
189
508
  * Feature: The :keep_old_files option preserves the files in storage even when the attachment is cleared or changed.
190
509
  * Performance: Optimize Fog's public_url access by avoiding it when possible.
191
- * Bug fix: Avoid a runtime error when generating the ID partition for an unsaved attachment.
510
+ * Bug Fix: Avoid a runtime error when generating the ID partition for an unsaved attachment.
192
511
  * Performance: Do not calculate the fingerprint if it is never persisted.
193
- * Bug fix: Process the :original style before all others, in case of a dependency.
512
+ * Bug Fix: Process the :original style before all others, in case of a dependency.
194
513
  * Feature: S3 headers can be set at runtime by passing a proc object as the value.
195
- * Bug fix: Generating missing attachment styles for a model which has had its attachment changed should not raise.
196
- * Bug fix: Do not collide with the built-in Ruby hashing method.
514
+ * Bug Fix: Generating missing attachment styles for a model which has had its attachment changed should not raise.
515
+ * Bug Fix: Do not collide with the built-in Ruby hashing method.