jr-paperclip 8.0.0.beta.2 → 8.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3471aff8a216591311cb34c95962b5d564db389b7f5807016e441a784db30de7
-  data.tar.gz: a1ea72929da0b406cabffda02181afee1c9689690dd0181ec07b062335af2832
+  metadata.gz: 3a0a10e43e470a988afe5f30de3f2144f18bca45154654abdbf09b57817bee4b
+  data.tar.gz: 59df71bd9e4c0577f252165bf5b1d55202ffe8d363f0eae235d30db9c90b14fb
 SHA512:
-  metadata.gz: 7849243e644ea536368cae8a1de481b8e476def749691e6beede5d767ddb3d92fff653e4fd1c2afd14eb4b843b6fef147f5c94cb3761d6d6df2bf76f1ea1f83f
-  data.tar.gz: 150d39995dc7e1102e19371c6a3bd8e26122b2942832c394a88bbe6f3105bc1e573e58055318ce83b0b0dd4f3672498fd5199a9d48d08fbe8cc93862e353156c
+  metadata.gz: 4ac11878b1797097dd0c6a369f39f03bc52153f2c9db2c2991d533b171a9f36fbec873b5859b55b378dbcb541d2d477f40de92d99456c7c3f5fb86c1d53eae5b
+  data.tar.gz: 8ec53d673eee2ddbfab2008ab3a3977d659dda2df53f9e7c34d9cef307b1889d53ead7ae3a3c4d4cebdc33452c9ec3e9a5c7abfefb36f46ca5e5f68ecf0bc644

data/.github/ISSUE_TEMPLATE/bug_report.md

@@ -7,32 +7,12 @@ assignees: ''
 
 ---
 
-**Describe the bug**
-A clear and concise description of what the bug is.
+Ruby version:
+Rails version:
+Paperclip version:
+ImageMagick version:
+libvips version: 
 
-**To Reproduce**
-Steps to reproduce the behavior:
-1. Go to '...'
-2. Click on '....'
-3. Scroll down to '....'
-4. See error
+Please include your initializer, Paperclip related options, and any error message with the full backtrace.
 
-**Expected behavior**
-A clear and concise description of what you expected to happen.
-
-**Screenshots**
-If applicable, add screenshots to help explain your problem.
-
-**Desktop (please complete the following information):**
- - OS: [e.g. iOS]
- - Browser [e.g. chrome, safari]
- - Version [e.g. 22]
-
-**Smartphone (please complete the following information):**
- - Device: [e.g. iPhone6]
- - OS: [e.g. iOS8.1]
- - Browser [e.g. stock browser, safari]
- - Version [e.g. 22]
-
-**Additional context**
-Add any other context about the problem here.
+If you are using an old version, have you checked the changelogs to see if your issue has been fixed in a later version?

data/NEWS

@@ -1,4 +1,4 @@
-8.0.0.beta.2 (2026-01-12)
+8.0.0 (2026-01-13)
 
 * Feature: Add libvips backend alongside ImageMagick via the image_processing gem
 * Feature: Per-attachment and per-style backend selection (`:backend` option)

data/README.md

@@ -14,20 +14,17 @@ Legacy versions were dropped to reduce maintenance overhead and keep up with upd
 
 Additional maintainers are very welcome.
 
----
-
-We plan to support and maintain paperclip, as well as clean it up.
+## Version 8.0.0 brings major new features and improvements:
 
-Please feel free to contribute Issues and pull requests.
-
----
+* Support for libvips backend alongside ImageMagick via the image_processing gem
+* ImageMagick 7 support (uses `magick` command when available)
+* Added `ALLOWED_IMAGEMAGICK_OPTIONS` security whitelist (GHSA-r4mg-4433-c7g3)
+* Cross-platform convert_options support (-strip, -quality, -rotate, etc.)
 
-# Existing documentation
+Please check the [Image Processor](#image-processor) and [Post Processing](#post-processing) sections for more details and the [VIPS Migration Guide](https://github.com/jukra/jr-paperclip/blob/master/VIPS_MIGRATION_GUIDE.md) for migration instructions.
 
 ## Documentation valid for `master` branch
 
----
-
 <!-- START doctoc generated TOC please keep comment here to allow auto update -->
 <!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
 
@@ -100,7 +97,7 @@ Requirements
 
 ### Ruby and Rails
 
-Paperclip now requires Ruby version **>= 2.3** and Rails version **>= 4.2**
+Paperclip now requires Ruby version **>= 3.0** and Rails version **>= 7.0**
 (only if you're going to use Paperclip with Ruby on Rails).
 
 ### Image Processor
@@ -149,6 +146,9 @@ brew install vips
 
 # Ubuntu/Debian
 sudo apt install libvips
+
+# If you also need the vips and vipsheader command line tools (for example custom processors)
+sudo apt install libvips-tools
 ```
 
 Then configure Paperclip to use it as the default backend in `config/initializers/paperclip.rb` (or in your environment configuration):
@@ -211,7 +211,7 @@ Paperclip is distributed as a gem, which is how it should be used in your app.
 Include the gem in your Gemfile:
 
 ```ruby
-gem "jr-paperclip", "~> 7.3"
+gem "jr-paperclip", "~> 8.0"
 ```
 
 Or, if you want to get the latest, you can get master from the main paperclip repository:
@@ -723,6 +723,7 @@ has_attached_file :avatar, styles: { thumb: ["32x32#", :png] }
 This will convert the "thumb" style to a 32x32 square in PNG format, regardless
 of what was uploaded. If the format is not specified, it is kept the same (e.g.
 JPGs will remain JPGs). `Paperclip::Thumbnail` uses the [image_processing](https://github.com/janko/image_processing) gem to process images. This allows support for both ImageMagick (via MiniMagick) and libvips backends.
+
 [ImageMagick's geometry documentation](http://www.imagemagick.org/script/command-line-processing.php#geometry)
 has more information on the accepted style formats, which are generally supported by both backends in Paperclip.
 
@@ -734,7 +735,7 @@ has_attached_file :image, styles: { regular: ['800x800>', :png]},
     convert_options: { regular: "-posterize 3"}
 ```
 
-Paperclip delegates to the `image_processing` gem, but **whitelists supported options** for security. For ImageMagick, most standard options are supported. For libvips, a curated set of common options is available (see table below) and `Paperclip::Thumbnail` class. Unsupported options are logged as warnings and skipped.
+Paperclip delegates to the `image_processing` gem, but **whitelists supported options** for security. For ImageMagick, most standard options are supported. For libvips, a curated set of common options is available (see table below) and `Paperclip::Thumbnail` class for details. Unsupported options are logged as warnings and skipped.
 
 For full backend capabilities, refer to the image_processing documentation:
 
@@ -773,14 +774,6 @@ has_attached_file :avatar,
 
 **Note:** Some options only work with ImageMagick (e.g., `-density`, `-depth`, `-gravity`, `-crop`, `-trim`). When using the vips backend, these will be skipped with a warning logged.
 
-ImageMagick supports a number of environment variables for controlling its resource limits. For example, you can enforce memory or execution time limits by setting the following variables in your application's process environment:
-
-* `MAGICK_MEMORY_LIMIT=128MiB`
-* `MAGICK_MAP_LIMIT=64MiB`
-* `MAGICK_TIME_LIMIT=30`
-
-For a full list of variables and description, see [ImageMagick's resources documentation](http://www.imagemagick.org/script/resources.php).
-
 ---
 
 Image Processing Backends
@@ -790,16 +783,24 @@ jr-paperclip supports two image processing backends:
 
 ### ImageMagick (Default)
 
-The traditional backend, using ImageMagick via shell commands.
+The traditional backend. Paperclip uses the `image_processing` gem (via `mini_magick`) to generate shell commands for ImageMagick.
 
 ```ruby
 has_attached_file :avatar,
   styles: { thumb: "100x100#" }
 ```
 
+ImageMagick supports a number of environment variables for controlling its resource limits. For example, you can enforce memory or execution time limits by setting the following variables in your application's process environment:
+
+* `MAGICK_MEMORY_LIMIT=128MiB`
+* `MAGICK_MAP_LIMIT=64MiB`
+* `MAGICK_TIME_LIMIT=30`
+
+For a full list of variables and description, see [ImageMagick's resources documentation](http://www.imagemagick.org/script/resources.php).
+
 ### libvips (Recommended for Performance)
 
-libvips is significantly faster and uses less memory than ImageMagick.
+libvips is significantly faster and uses less memory than ImageMagick. Paperclip uses the `image_processing` gem (via `ruby-vips`) to interface with libvips.
 
 **Usage:**
 
@@ -823,6 +824,12 @@ has_attached_file :document,
   }
 ```
 
+libvips keeps a cache of recently executed operations. You can disable this for a drop in memory use:
+```ruby
+Vips::cache_set_max 0
+```
+**Note:** Typically this is not needed as libvips is already memory efficient. Disabling the cache is mostly useful in extremely memory-constrained environments (like AWS Lambda) where every MB counts. This [issue](https://github.com/libvips/ruby-vips/issues/225) has more information on memory usage.
+
 ---
 
 Custom Attachment Processors

data/VIPS_MIGRATION_GUIDE.md

@@ -14,6 +14,9 @@ brew install vips
 
 # Ubuntu/Debian
 sudo apt install libvips
+
+# If you also need the vips and vipsheader command line tools (for example custom processors)
+sudo apt install libvips-tools
 ```
 
 ## Step 1: Update your Gemfile
@@ -23,7 +26,7 @@ sudo apt install libvips
 Ensure you are using the latest version of the gem:
 
 ```ruby
-gem "jr-paperclip", "~> 8.0.0.beta.2"
+gem "jr-paperclip", "~> 8.0"
 ```
 
 ## Step 2: Gradual Migration (Per-Attachment)

data/lib/paperclip/geometry_detector_factory.rb

@@ -48,7 +48,7 @@ module Paperclip
       begin
         require "vips"
       rescue LoadError => e
-        raise Errors::CommandNotFoundError.new("Could not load ruby-vips. Please install libvips and the image_processing gem.")
+        raise Errors::CommandNotFoundError.new("Could not load ruby-vips. Please install libvips.")
       end
 
       begin

data/lib/paperclip/processor.rb

@@ -80,7 +80,7 @@ module Paperclip
       begin
         require "vips"
       rescue LoadError
-        raise Errors::CommandNotFoundError.new("Could not load ruby-vips. Please install libvips and the vips gem.")
+        raise Errors::CommandNotFoundError.new("Could not load ruby-vips. Please install libvips.")
       end
       Vips::Image.new_from_file(file_path, **options)
     end

data/lib/paperclip/version.rb

@@ -1,3 +1,3 @@
 module Paperclip
-  VERSION = "8.0.0.beta.2" unless defined?(Paperclip::VERSION)
+  VERSION = "8.0.0".freeze
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jr-paperclip
 version: !ruby/object:Gem::Version
-  version: 8.0.0.beta.2
+  version: 8.0.0
 platform: ruby
 authors:
 - Jukka Rautanen
@@ -389,7 +389,6 @@ extra_rdoc_files: []
 files:
 - ".github/FUNDING.yml"
 - ".github/ISSUE_TEMPLATE/bug_report.md"
-- ".github/ISSUE_TEMPLATE/custom.md"
 - ".github/ISSUE_TEMPLATE/feature_request.md"
 - ".github/workflows/reviewdog.yml"
 - ".github/workflows/tests.yml"

data/.github/ISSUE_TEMPLATE/custom.md

@@ -1,10 +0,0 @@
----
-name: Custom issue template
-about: Describe this issue template's purpose here.
-title: ''
-labels: ''
-assignees: ''
-
----
-
-