ruby-vips 2.0.13 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e509c29533461f0e4654d1dd116f61b033d589d9f78924bd197cb303fc0d9d0e
-  data.tar.gz: bf53c311ee52c198b3288e6b11d773dda21403355b3704ecbc4652ce16d51d53
+  metadata.gz: b632e0e44fa32da791e46806757e9b6a1a9901d92e2de9b02e16682bc3f3e6b2
+  data.tar.gz: 5d3841b9a656d13003b1b2668c05ab89cf5b65c76a52dad070a67b9a6856fe60
 SHA512:
-  metadata.gz: 7fcdf3c4f3d66ac3550d17bc45606831a3337a41d8b5af151ff6103bdf0e891036e9ff568930e29f3e045543719801e48ec938310809c4e98af2f4f7ac695031
-  data.tar.gz: 2ddd68fe1e1f9dcc2174757658d145d5d9777a18c27436758030e376049e956860f6b5d454fe2f1dc1728b17b27cbcf37e1fa3d301edee23a9a7b17f4d0ba874
+  metadata.gz: 11c11a729818aa279cf5a157cda6e810174da9089b9ae3a0e92b3c7e6080362dfca5a970b07f3881aa7f31e5aa4acf3cd1a9a05a2e3ef09dc86d7464fe8987fe
+  data.tar.gz: 41bae93d0c491699e0042acfe687bc86766af576c9ffe57da1c20a26de548e08c73c0d7685855a155630ed5d47a3a2e2e60f982df48df2a59d4a9f4bd6ccfd34

data/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,42 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: bug
+assignees: ''
+
+---
+
+**Questions or suggestions**
+
+We are using [Discussions](https://github.com/libvips/ruby-vips/discussions) for questions and suggestions for new features. Issues are only for bug reports.
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**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.

data/.github/workflows/test.yml

@@ -0,0 +1,80 @@
+name: Test
+
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+  pull_request_target:
+    branches:
+      - master
+
+env:
+  NOKOGIRI_USE_SYSTEM_LIBRARIES: true
+  SPEC_OPTS: '--backtrace'
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v2
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '2.7'
+          bundler-cache: true
+
+      - name: Run standard Ruby linter
+        run: bundle exec standardrb --no-fix --fail-fast
+
+  test:
+    name: Functional testing
+
+    strategy:
+      matrix:
+        os-version: [ 'ubuntu-20.04' ]
+        ruby-version:
+          - 2.0
+          - 2.1
+          - 2.2
+          - 2.3
+          - 2.4
+          - 2.5
+          - 2.6
+          - 2.7
+          - 3.0
+          - jruby
+      fail-fast: true
+
+    runs-on: ${{ matrix.os-version }}
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v2
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby-version }}
+          bundler-cache: true
+
+      - name: Update apt
+        env:
+          DEBIAN_FRONTEND: noninteractive
+        run: 
+          sudo apt-get update -qq -o Acquire::Retries=3
+
+      - name: Install libvips
+        env:
+          DEBIAN_FRONTEND: noninteractive
+        run:
+          # we only need the library
+          sudo apt-get install --fix-missing -qq -o Acquire::Retries=3
+            libvips 
+
+      - name: Run Tests
+        run: bundle exec rake spec

data/.standard.yml

@@ -0,0 +1,17 @@
+fix: false              # default: false
+parallel: true          # default: false
+format: progress        # default: Standard::Formatter
+ruby_version: 2.0       # default: RUBY_VERSION
+default_ignores: false  # default: true
+
+ignore:                 # default: []
+  - '**/*':
+    - Standard/SemanticBlocks
+  - 'lib/vips/methods.rb'
+  - '{lib,example}/**/*':
+    - Lint/IneffectiveAccessModifier
+    - Lint/RescueException
+    - Style/GlobalVars
+  - 'spec/**/*':
+      - Lint/BinaryOperatorWithIdenticalOperands
+  - 'vendor/**/*'

data/.yardopts

@@ -1,2 +1 @@
---markup-provider=redcarpet
 --markup=markdown

data/CHANGELOG.md

@@ -2,6 +2,50 @@
 
 ## master
 
+## Version 2.1.0 (2021-3-8)
+
+* add "mutate" system [jcupitt]
+* better behaviour with some nil parameters [jcupitt]
+* revise gemspec [jcupitt]
+* allow symbols for Interpolate.new [noraj]
+* update docs for 8.10, fix minor doc formatting issues [jcupitt]
+* `new_from_array` checks array argument more carefully [dkam]
+* add `new_from_memory` and `new_from_memory_copy` [ankane]
+* jruby added to CI testing [pftg]
+* switch to github actions for CI [pftg]
+* remove rubocop, revise formatting for standardrb [pftg]
+
+## Version 2.0.17 (2019-10-29)
+
+* install msys2 libvips on Windows [larskanis]
+* better `-` to `_` conversion [Nakilon]
+* fix `GValue#set` for stricter metadata rules in 8.9 [jcupitt]
+* fix a ref leak on operation build error [jcupitt]
+* faster operation call [jcupitt]
+* add support for VipsConnection [jcupitt]
+* add `signal_connect` [jcupitt]
+* add `Image#set_kill` for progress termination [jcupitt]
+
+## Version 2.0.16 (2019-9-21)
+
+* better library name generation [renchap]
+* allow `_` as a separator in enum names [D-W-L]
+* add `Vips::Region` and `Region#fetch` [jcupitt]
+
+## Version 2.0.15 (2019-6-12)
+
+* better error messages from `write_to_memory` [linkyndy]
+* fix doc generation typo for array return [jcupitt]
+* update tests for libvips 8.8 [jcupitt]
+
+## Version 2.0.14 (2018-10-3)
+
+* update links for new home [jcupitt]
+* various doc fixes [janko-m]
+* add `Vips::get_suffixes` [jcupitt]
+* prefer options splat [ioquatix]
+* update docs for 8.8 [jcupitt]
+
 ## Version 2.0.13 (2018-8-6)
 
 * allow optional args to have `nil` as a value [janko-m]

data/Gemfile

@@ -1,4 +1,6 @@
-source 'https://rubygems.org'
+source "https://rubygems.org"
 
 # all gems are handled by .gemspec (since this repo is for a gem)
 gemspec
+
+gem "github-markup"

data/README.md

@@ -1,50 +1,27 @@
 # ruby-vips
 
 [![Gem Version](https://badge.fury.io/rb/ruby-vips.svg)](https://badge.fury.io/rb/ruby-vips)
-[![Build Status](https://travis-ci.org/jcupitt/ruby-vips.svg?branch=master)](https://travis-ci.org/jcupitt/ruby-vips)
+[![Test](https://github.com/libvips/ruby-vips/workflows/Test/badge.svg)](https://github.com/libvips/ruby-vips/actions?query=workflow%3ATest)
 
-This gem provides a Ruby binding for the [libvips image processing
-library](https://jcupitt.github.io/libvips).
+This gem is a Ruby binding for the [libvips image processing
+library](https://libvips.github.io/libvips).
 
-Programs that use `ruby-vips` don't
-manipulate images directly, instead they create pipelines of image processing
-operations building on a source image. When the end of the pipe is connected
-to a destination, the whole pipeline executes at once, streaming the image
-in parallel from source to destination a section at a time. 
-
-Because `ruby-vips` is parallel, it's quick, and because it doesn't need to
-keep entire images in memory, it's light.  For example, the benchmark at
-[vips-benchmarks](https://github.com/jcupitt/vips-benchmarks) loads a
-large image, crops, shrinks, sharpens and saves again, and repeats 10 times.
-
-```text
-real time in seconds, fastest of five runs
-benchmark       tiff    jpeg
-ruby-vips.rb	0.85	0.78	
-image-magick	2.03	2.44	
-rmagick.rb	3.87	3.89	
-
-peak memory use in kb
-benchmark	peak RES
-ruby-vips.rb	43864
-rmagick.rb	788768
-```
-
-See also [benchmarks at the official libvips
-website](https://github.com/jcupitt/libvips/wiki/Speed-and-memory-use).
-There's a handy blog post explaining [how libvips opens
-files](http://libvips.blogspot.co.uk/2012/06/how-libvips-opens-file.html)
-which gives some more background.
+Programs that use `ruby-vips` don't manipulate images directly, instead
+they create pipelines of image processing operations building on a source
+image. When the end of the pipe is connected to a destination, the whole
+pipeline executes at once, streaming the image in parallel from source to
+destination a section at a time.  Because `ruby-vips` is parallel, it's quick,
+and because it doesn't need to keep entire images in memory, it's light.
 
 ## Requirements
 
   * macOS, Linux, and Windows tested
 
-  * libvips 8.2 or later, see the [libvips install instructions](https://jcupitt.github.io/libvips/install.html)
+  * libvips 8.2 or later, see the [libvips install instructions](https://libvips.github.io/libvips/install.html)
 
   * [ruby-ffi](https://github.com/ffi/ffi) 1.9 or later 
 
-  * Ruby 2.0+, JRuby should work
+  * Ruby 2.0+, JRuby
 
 ## Install
 
@@ -57,26 +34,23 @@ $ gem install ruby-vips
 or include it in `Gemfile`:
 
 ```ruby
-gem 'ruby-vips'
+gem "ruby-vips"
 ```
 
 On Windows, you'll need to set the `RUBY_DLL_PATH` environment variable to 
 point to the libvips bin directory.
 
-Take a look in `examples/`. There is [full API
-documentation](http://www.rubydoc.info/gems/ruby-vips). 
-
 # Example
 
 ```ruby
-require 'vips'
+require "vips"
 
 im = Vips::Image.new_from_file filename
 
 # put im at position (100, 100) in a 3000 x 3000 pixel image, 
 # make the other pixels in the image by mirroring im up / down / 
 # left / right, see
-# https://jcupitt.github.io/libvips/API/current/libvips-conversion.html#vips-embed
+# https://libvips.github.io/libvips/API/current/libvips-conversion.html#vips-embed
 im = im.embed 100, 100, 3000, 3000, extend: :mirror
 
 # multiply the green (middle) band by 2, leave the other two alone
@@ -93,13 +67,37 @@ im = im.conv mask, precision: :integer
 im.write_to_file output_filename
 ```
 
-# Older versions
+The `Vips` section in the API docs has a [tutorial introduction with
+examples](https://www.rubydoc.info/gems/ruby-vips/Vips).
 
-There are two older versions of this gem.
+ruby-vips has [API
+ documentation](http://www.rubydoc.info/gems/ruby-vips). The [libvips
+ reference manual](https://libvips.github.io/libvips/API/current/) has a
+ complete explanation of every method.
 
-The `0.3-stable` branch is written in C and supports a different API. It still
-works, but is only maintained for compatibility.
+The 
+[`example/`](https://github.com/libvips/ruby-vips/tree/master/example)
+directory has some simple example programs.
+
+# Benchmarks
+
+The benchmark at [vips-benchmarks](https://github.com/jcupitt/vips-benchmarks)
+loads a large image, crops, shrinks, sharpens and saves again, and repeats
+10 times.
+
+```text
+real time in seconds, fastest of five runs
+benchmark       tiff    jpeg
+ruby-vips.rb	0.85	0.78	
+image-magick	2.03	2.44	
+rmagick.rb	3.87	3.89	
+
+peak memory use in kb
+benchmark	peak RES
+ruby-vips.rb	43864
+rmagick.rb	788768
+```
+
+See also [benchmarks at the official libvips
+website](https://github.com/libvips/libvips/wiki/Speed-and-memory-use).
 
-The `1.0-stable` branch is based on `gobject-introspection` rather than
-`ffi`. It supports the same API as the current version, but is harder to
-install, less portable, slower, and less stable.

data/Rakefile

@@ -1,29 +1,27 @@
-# encoding: utf-8
-
-require 'bundler/gem_tasks'
+require "bundler/gem_tasks"
 
 begin
   Bundler.setup(:default, :development)
 rescue Bundler::BundlerError => e
-  $stderr.puts e.message
-  $stderr.puts "Run `bundle install` to install missing gems"
+  warn e.message
+  warn "Run `bundle install` to install missing gems"
   exit e.status_code
 end
 
-require 'rake'
+require "rake"
 
-require 'rspec/core'
-require 'rspec/core/rake_task'
+require "rspec/core"
+require "rspec/core/rake_task"
 RSpec::Core::RakeTask.new(:spec) do |spec|
-  spec.pattern = FileList['spec/**/*_spec.rb']
+  spec.pattern = FileList["spec/**/*_spec.rb"]
 end
 
-task :default => :spec
+task default: :spec
 
-require "github/markup"
-require "redcarpet"
-require "yard"
-require "yard/rake/yardoc_task"
+unless RUBY_PLATFORM.include?("java")
+  require "github/markup"
+  require "yard"
+  require "yard/rake/yardoc_task"
 
-YARD::Rake::YardocTask.new do |yard|
+  YARD::Rake::YardocTask.new
 end

data/TODO

@@ -1,36 +1,45 @@
 # Notes
 
-- support complex constants, eg. 
+- We should support complex constants, eg: 
 
 	Complex(1, 2)
 	=> (1+2i)
 
 # Common operations
 
-- version bump
+- Lint.
 
-	edit lib/vips/version.rb 
-	edit VERSION
+	bundle exec standardrb
 
-- reinstall local copy of gem after a change
+- Reinstall local copy of gem after a change.
 
 	bundle exec rake install
 
-- run test suite
+- Run test suite.
 
 	bundle exec rake 
 
-- regenerate autodocs
+- Version bump.
+
+	edit lib/vips/version.rb 
+	edit VERSION
+
+- Regenerate autodocs.
 
 	cd lib/vips
 	ruby > methods.rb
-	require 'vips'; Vips::generate_yard
+	require "vips"; Vips::Yard.generate
 	^D
 
-- regenerate docs
+- Regenerate docs.
 
 	bundle exec rake yard
 
-- push new gem to rubygems, tag repository with version
+- Push new gem to rubygems, tag repository with version.
 
+	gem2.5 signin --otp 111111 / enter username and passwd
 	bundle exec rake release
+
+  There's an invisible prompt for the authenticator code. Enter eg. 123456, 
+  press return and the upload should work.
+