assembly-image 2.1.4 → 2.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5aa835ae3183f8de14d0e677ded80d0ee5ffd813b2150e9fc4665245964dbab1
-  data.tar.gz: 639cad1edcc8abf76c26598bfd4949085a2fdea49f1acf5802a5a75f6b887c68
+  metadata.gz: 61afd775bdcdf7d49e958964cb581deeaca8755250a9cfe459b7a741037c198a
+  data.tar.gz: 8d0aedfe78807e2965ca0376589e097b2df9b5ca9647659a626e1fbbfb6beb87
 SHA512:
-  metadata.gz: dcc568cc992f74a80e69b6f6bae2eb56a5611a22e848371ce669634037181aae4f735ca2823e35b64037609a4c3b3f473d556fd3830a4d5a33c13d24b6536a59
-  data.tar.gz: f6cdae8947215307048dc439ef76308cb12b3523ed4722258c0d156bdee189c10c5fab6aee444ab09aeb3b3bff59a3ee4c00a3b5cf51619293a9a1ac8b214f7e
+  metadata.gz: 465cc5080873a1f079e029925bdfdcd5dd0609afef304cc53190c790608e2805894e3b8f4554a7eac6ed398decc6af077ec19dbfc945e8301d1f2454e026a982
+  data.tar.gz: f4cc63a293fe3f2d80074a697b8618e968d9dc49aa323033e4acf22c4513d92b50e5db5b7d3805c9051f366d007e82f4c14858bcb8b0445c4edf484c17b7298e

data/.rubocop.yml

@@ -26,7 +26,7 @@ Naming/FileName:
   Exclude:
    - lib/assembly-image.rb
 
-Naming/PredicateName:
+Naming/PredicatePrefix:
   ForbiddenPrefixes:
     - is_
 

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    assembly-image (2.1.4)
+    assembly-image (2.2.0)
       activesupport (> 6.1)
       assembly-objectfile (>= 1.6.4)
       ruby-vips (>= 2.0)

data/assembly-image.gemspec

@@ -4,7 +4,7 @@ $LOAD_PATH.push File.expand_path('lib', __dir__)
 
 Gem::Specification.new do |s|
   s.name        = 'assembly-image'
-  s.version     = '2.1.4'
+  s.version     = '2.2.0'
   s.authors     = ['Peter Mangiafico', 'Renzo Sanchez-Silva', 'Monty Hindman', 'Tony Calavano']
   s.email       = ['pmangiafico@stanford.edu']
   s.homepage    = ''

data/bin/console

@@ -2,8 +2,8 @@
 # frozen_string_literal: true
 
 require 'rubygems'
-require 'irb'
+require 'pry'
 
 require File.expand_path("#{File.dirname(__FILE__)}/../config/boot")
 
-IRB.start
+Pry.start

data/lib/assembly/image.rb

@@ -17,6 +17,26 @@ module Assembly
       vips_image.width
     end
 
+    # @return [boolean] true if this image is a multi-page (e.g. a TIFF with multiple pages)
+    def multi_page?
+      return false unless mimetype == 'image/tiff'
+
+      vips_image.get('n-pages').to_i > 1
+    rescue Vips::Error
+      false
+    end
+
+    # Extract and save only the first page from a multi-image TIFF
+    # @param [String] output_path path to save the extracted first page
+    def extract_first_page(output_path)
+      raise "Cannot extract first page from mimetype #{mimetype}" unless mimetype == 'image/tiff'
+
+      first_page = Vips::Image.new_from_file(path, page: 0).autorot
+      first_page.write_to_file(output_path)
+
+      true
+    end
+
     # @return [string] full default jp2 path and filename that will be created from the given image
     # Example:  given original file of '/dir/path_to_file.tif', gives '/dir/path_to_file.jp2'
     def jp2_filename

data/spec/assembly/image_spec.rb

@@ -22,4 +22,91 @@ RSpec.describe Assembly::Image do
       end
     end
   end
+
+  describe '#multi_page?' do
+    context 'with a single page TIFF' do
+      before { generate_test_image(input_path) }
+
+      it 'returns false' do
+        expect(assembly_image.multi_page?).to be false
+      end
+    end
+
+    context 'with a multi-page TIFF' do
+      let(:input_path) { TEST_MULTIPAGE_TIF_FILE } # this image exists and is in our checked in codebase
+
+      it 'returns true' do
+        expect(assembly_image.multi_page?).to be true
+      end
+    end
+
+    context 'with a non-TIFF image' do
+      before { generate_test_image(input_path) }
+
+      let(:input_path) { TEST_JPEG_INPUT_FILE }
+
+      it 'returns false (JPEG cannot have multiple pages)' do
+        expect(assembly_image.multi_page?).to be false
+      end
+    end
+
+    context 'when Vips raises an error' do
+      before { generate_test_image(input_path) }
+
+      let(:input_path) { TEST_TIF_INPUT_FILE }
+
+      it 'rescues the error and returns false' do
+        allow(assembly_image.vips_image).to receive(:get).and_raise(Vips::Error, 'Test error')
+        expect(assembly_image.multi_page?).to be false
+      end
+    end
+  end
+
+  describe '#extract_first_page' do
+    let(:output_path) { File.join(TEST_OUTPUT_DIR, 'extracted.tif') }
+
+    after { FileUtils.rm_f(output_path) }
+
+    context 'with a single page TIFF' do
+      let(:input_path) { TEST_TIF_INPUT_FILE }
+
+      before { generate_test_image(input_path) }
+
+      it 'extracts and saves the first page' do
+        expect(assembly_image.multi_page?).to be false
+        result = assembly_image.extract_first_page(output_path)
+        expect(result).to be true
+        expect(File.exist?(output_path)).to be true
+        extracted = described_class.new(output_path)
+        expect(extracted.width).to eq assembly_image.width
+        expect(extracted.height).to eq assembly_image.height
+        expect(extracted.multi_page?).to be false
+      end
+    end
+
+    context 'with a multi-page TIFF' do
+      let(:input_path) { TEST_MULTIPAGE_TIF_FILE } # this is a test multi-page image that exists and is in our checked in codebase
+
+      it 'extracts only the first page' do
+        expect(assembly_image.multi_page?).to be true
+        result = assembly_image.extract_first_page(output_path)
+        expect(result).to be true
+        expect(File.exist?(output_path)).to be true
+        extracted = described_class.new(output_path)
+        expect(extracted.width).to eq assembly_image.width
+        expect(extracted.height).to eq assembly_image.height
+        expect(extracted.multi_page?).to be false
+      end
+    end
+
+    context 'with different image formats' do
+      before { generate_test_image(input_path) }
+
+      let(:input_path) { TEST_JPEG_INPUT_FILE }
+
+      it 'raises an error' do
+        expect { assembly_image.extract_first_page(output_path) }.to raise_error(RuntimeError, 'Cannot extract first page from mimetype image/jpeg')
+      end
+    end
+  end
 end

data/spec/spec_helper.rb

@@ -19,6 +19,7 @@ TEST_INPUT_DIR       = File.join(Assembly::PATH_TO_IMAGE_GEM, 'spec', 'test_data
 TEST_OUTPUT_DIR      = File.join(Assembly::PATH_TO_IMAGE_GEM, 'spec', 'test_data', 'output')
 TEST_TIF_INPUT_FILE  = File.join(TEST_INPUT_DIR, 'test.tif')
 TEST_JPEG_INPUT_FILE = File.join(TEST_INPUT_DIR, 'test.jpg')
+TEST_MULTIPAGE_TIF_FILE = File.join(Assembly::PATH_TO_IMAGE_GEM, 'spec', 'test_data', 'shapes_multi_size.tif')
 
 RSpec.configure do |config|
   # rspec-expectations config goes here. You can use an alternate

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: assembly-image
 version: !ruby/object:Gem::Version
-  version: 2.1.4
+  version: 2.2.0
 platform: ruby
 authors:
 - Peter Mangiafico
@@ -10,7 +10,7 @@ authors:
 - Tony Calavano
 bindir: exe
 cert_chain: []
-date: 2026-01-09 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -216,6 +216,7 @@ files:
 - spec/test_data/color_rgb_srgb_rot90cw.tif
 - spec/test_data/input/.empty
 - spec/test_data/output/.empty
+- spec/test_data/shapes_multi_size.tif
 homepage: ''
 licenses: []
 metadata:
@@ -234,7 +235,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 3.7.2
 specification_version: 4
 summary: Ruby implementation of image services needed to prepare objects to be accessioned
   in SULAIR digital library