ruby-vips 2.0.13 → 2.1.0

data/lib/vips/target.rb

@@ -0,0 +1,86 @@
+# This module provides an interface to the top level bits of libvips
+# via ruby-ffi.
+#
+# Author::    John Cupitt  (mailto:jcupitt@gmail.com)
+# License::   MIT
+
+require "ffi"
+
+module Vips
+  if Vips.at_least_libvips?(8, 9)
+    attach_function :vips_target_new_to_descriptor, [:int], :pointer
+    attach_function :vips_target_new_to_file, [:string], :pointer
+    attach_function :vips_target_new_to_memory, [], :pointer
+  end
+
+  # A target. For example:
+  #
+  # ```ruby
+  # target = Vips::Target.new_to_file('k2.jpg')
+  # image.write_to_target(target, '.jpg')
+  # ```
+  class Target < Vips::Connection
+    # The layout of the VipsRegion struct.
+    module TargetLayout
+      def self.included(base)
+        base.class_eval do
+          layout :parent, Vips::Connection::Struct
+          # rest opaque
+        end
+      end
+    end
+
+    class Struct < Vips::Connection::Struct
+      include TargetLayout
+    end
+
+    class ManagedStruct < Vips::Connection::ManagedStruct
+      include TargetLayout
+    end
+
+    # Create a new target to a file descriptor. File descriptors are
+    # small integers, for example 1 is stdout.
+    #
+    # Pass targets to {Image#write_to_target} to write images to
+    # them.
+    #
+    # @param descriptor [Integer] the file descriptor
+    # @return [Target] the new Vips::Target
+    def self.new_to_descriptor(descriptor)
+      ptr = Vips.vips_target_new_to_descriptor descriptor
+      raise Vips::Error if ptr.null?
+
+      Vips::Target.new ptr
+    end
+
+    # Create a new target to a file name.
+    #
+    # Pass targets to {Image#write_to_target} to write images to
+    # them.
+    #
+    # @param filename [String] the name of the file
+    # @return [Target] the new Vips::Target
+    def self.new_to_file(filename)
+      raise Vips::Error, "filename is nil" if filename.nil?
+      ptr = Vips.vips_target_new_to_file filename
+      raise Vips::Error if ptr.null?
+
+      Vips::Target.new ptr
+    end
+
+    # Create a new target to an area of memory.
+    #
+    # Pass targets to {Image#write_to_target} to write images to
+    # them.
+    #
+    # Once the image has been written, use {Object#get}`("blob")` to read out
+    # the data.
+    #
+    # @return [Target] the new Vips::Target
+    def self.new_to_memory
+      ptr = Vips.vips_target_new_to_memory
+
+      Vips::Target.new ptr
+    end
+  end
+end

data/lib/vips/targetcustom.rb

@@ -0,0 +1,77 @@
+# This module provides an interface to the top level bits of libvips
+# via ruby-ffi.
+#
+# Author::    John Cupitt  (mailto:jcupitt@gmail.com)
+# License::   MIT
+
+require "ffi"
+
+module Vips
+  if Vips.at_least_libvips?(8, 9)
+    attach_function :vips_target_custom_new, [], :pointer
+  end
+
+  # A target you can attach action signal handlers to to implememt
+  # custom output types.
+  #
+  # For example:
+  #
+  # ```ruby
+  # file = File.open "some/file/name", "wb"
+  # target = Vips::TargetCustom.new
+  # target.on_write { |bytes| file.write bytes }
+  # image.write_to_target target, ".png"
+  # ```
+  #
+  # (just an example -- of course in practice you'd use {Target#new_to_file}
+  # to write to a named file)
+  class TargetCustom < Vips::Target
+    module TargetCustomLayout
+      def self.included(base)
+        base.class_eval do
+          layout :parent, Vips::Target::Struct
+          # rest opaque
+        end
+      end
+    end
+
+    class Struct < Vips::Target::Struct
+      include TargetCustomLayout
+    end
+
+    class ManagedStruct < Vips::Target::ManagedStruct
+      include TargetCustomLayout
+    end
+
+    def initialize
+      pointer = Vips.vips_target_custom_new
+      raise Vips::Error if pointer.null?
+
+      super pointer
+    end
+
+    # The block is executed to write data to the source. The interface is
+    # exactly as IO::write, ie. it should write the string and return the
+    # number of bytes written.
+    #
+    # @yieldparam bytes [String] Write these bytes to the file
+    # @yieldreturn [Integer] The number of bytes written, or -1 on error
+    def on_write &block
+      signal_connect "write" do |p, len|
+        chunk = p.get_bytes(0, len)
+        bytes_written = block.call chunk
+        chunk.clear
+
+        bytes_written
+      end
+    end
+
+    # The block is executed at the end of write. It should do any necessary
+    # finishing action, such as closing a file.
+    def on_finish &block
+      signal_connect "finish" do
+        block.call
+      end
+    end
+  end
+end

data/lib/vips/version.rb

@@ -1,4 +1,3 @@
 module Vips
-    VERSION = "2.0.13"
+  VERSION = "2.1.0"
 end
-

data/ruby-vips.gemspec

@@ -1,39 +1,48 @@
-# coding: utf-8
+# frozen_string_literal: true
 
-lib = File.expand_path('../lib', __FILE__)
-$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require 'vips/version'
+require_relative "lib/vips/version"
 
 Gem::Specification.new do |spec|
   spec.name = "ruby-vips"
   spec.version = Vips::VERSION
+  spec.summary = "A fast image processing library with low memory needs"
+  spec.description = <<-DESC.strip
+    ruby-vips is a binding for the libvips image processing library. It is fast 
+    and it can process large images without loading the whole image in memory.
+  DESC
+  spec.homepage = "http://github.com/libvips/ruby-vips"
+  spec.licenses = ["MIT"]
   spec.authors = ["John Cupitt"]
-  spec.email = "jcupitt@gmail.com"
+  spec.email = ["jcupitt@gmail.com"]
 
-  spec.summary = "Ruby extension for the vips image processing library."
-  spec.description = "ruby-vips is a binding for the vips image processing library. It is extremely fast and it can process huge images without loading the whole image in memory."
-  spec.homepage = "http://github.com/jcupitt/ruby-vips"
-  spec.licenses = ["MIT"]
+  spec.metadata = {
+    "bug_tracker_uri" => "https://github.com/libvips/ruby-vips/issues",
+    "changelog_uri" =>
+      "https://github.com/libvips/ruby-vips/blob/master/CHANGELOG.md",
+    "documentation_uri" => "https://www.rubydoc.info/gems/ruby-vips",
+    "homepage_uri" => spec.homepage,
+    "source_code_uri" => "https://github.com/libvips/ruby-vips",
+
+    "msys2_mingw_dependencies" => "libvips"
+  }
 
   spec.require_paths = ["lib"]
-  spec.extra_rdoc_files = [
-    "LICENSE.txt",
-    "README.md",
-    "TODO"
-  ]
+  spec.extra_rdoc_files = %w[LICENSE.txt README.md TODO]
 
   spec.files = `git ls-files -z`.split("\x0").reject do |f|
     f.match(%r{^(test|spec|features)/})
   end
 
-  spec.add_runtime_dependency "ffi", ["~> 1.9"]
+  spec.required_ruby_version = ">= 2.0.0"
 
-  spec.add_development_dependency "rake", ["~> 11.0"]
+  spec.add_runtime_dependency "ffi", ["~> 1.12"]
+
+  spec.add_development_dependency "rake", ["~> 12.0"]
   spec.add_development_dependency "rspec", ["~> 3.3"]
   spec.add_development_dependency "yard", ["~> 0.9.11"]
-  spec.add_development_dependency "redcarpet", ["~> 3.3"]
-  spec.add_development_dependency "github-markup", ["~> 1.4"]
-  spec.add_development_dependency "bundler", ["~> 1.0"]
+  spec.add_development_dependency "bundler", [">= 1.0", "< 3"]
 
+  if Gem.ruby_version >= Gem::Version.new("2.2")
+    spec.add_development_dependency "standard"
+  end
 end
-

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ruby-vips
 version: !ruby/object:Gem::Version
-  version: 2.0.13
+  version: 2.1.0
 platform: ruby
 authors:
 - John Cupitt
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-08-06 00:00:00.000000000 Z
+date: 2021-03-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ffi
@@ -16,28 +16,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.9'
+        version: '1.12'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.9'
+        version: '1.12'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '11.0'
+        version: '12.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '11.0'
+        version: '12.0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -67,50 +67,44 @@ dependencies:
       - !ruby/object:Gem::Version
         version: 0.9.11
 - !ruby/object:Gem::Dependency
-  name: redcarpet
+  name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.3'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '3.3'
-- !ruby/object:Gem::Dependency
-  name: github-markup
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
+        version: '1.0'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '1.4'
+        version: '3'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.0'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '1.4'
+        version: '3'
 - !ruby/object:Gem::Dependency
-  name: bundler
+  name: standard
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.0'
-description: ruby-vips is a binding for the vips image processing library. It is extremely
-  fast and it can process huge images without loading the whole image in memory.
-email: jcupitt@gmail.com
+        version: '0'
+description: "ruby-vips is a binding for the libvips image processing library. It
+  is fast \n    and it can process large images without loading the whole image in
+  memory."
+email:
+- jcupitt@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files:
@@ -118,8 +112,10 @@ extra_rdoc_files:
 - README.md
 - TODO
 files:
+- ".github/ISSUE_TEMPLATE/bug_report.md"
+- ".github/workflows/test.yml"
 - ".gitignore"
-- ".travis.yml"
+- ".standard.yml"
 - ".yardopts"
 - CHANGELOG.md
 - Gemfile
@@ -129,18 +125,20 @@ files:
 - TODO
 - VERSION
 - example/annotate.rb
+- example/connection.rb
 - example/daltonize8.rb
+- example/draw_lines.rb
 - example/example1.rb
 - example/example2.rb
 - example/example3.rb
 - example/example4.rb
 - example/example5.rb
 - example/inheritance_with_refcount.rb
+- example/progress.rb
 - example/thumb.rb
 - example/trim8.rb
 - example/watermark.rb
 - example/wobble.rb
-- install-vips.sh
 - lib/ruby-vips.rb
 - lib/vips.rb
 - lib/vips/access.rb
@@ -148,8 +146,10 @@ files:
 - lib/vips/angle.rb
 - lib/vips/angle45.rb
 - lib/vips/bandformat.rb
+- lib/vips/blend_mode.rb
 - lib/vips/coding.rb
 - lib/vips/compass_direction.rb
+- lib/vips/connection.rb
 - lib/vips/direction.rb
 - lib/vips/extend.rb
 - lib/vips/gobject.rb
@@ -160,6 +160,7 @@ files:
 - lib/vips/interpretation.rb
 - lib/vips/kernel.rb
 - lib/vips/methods.rb
+- lib/vips/mutableimage.rb
 - lib/vips/object.rb
 - lib/vips/operation.rb
 - lib/vips/operationboolean.rb
@@ -170,13 +171,24 @@ files:
 - lib/vips/operationmath2.rb
 - lib/vips/operationrelational.rb
 - lib/vips/operationround.rb
+- lib/vips/region.rb
 - lib/vips/size.rb
+- lib/vips/source.rb
+- lib/vips/sourcecustom.rb
+- lib/vips/target.rb
+- lib/vips/targetcustom.rb
 - lib/vips/version.rb
 - ruby-vips.gemspec
-homepage: http://github.com/jcupitt/ruby-vips
+homepage: http://github.com/libvips/ruby-vips
 licenses:
 - MIT
-metadata: {}
+metadata:
+  bug_tracker_uri: https://github.com/libvips/ruby-vips/issues
+  changelog_uri: https://github.com/libvips/ruby-vips/blob/master/CHANGELOG.md
+  documentation_uri: https://www.rubydoc.info/gems/ruby-vips
+  homepage_uri: http://github.com/libvips/ruby-vips
+  source_code_uri: https://github.com/libvips/ruby-vips
+  msys2_mingw_dependencies: libvips
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -185,16 +197,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 2.0.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6
+rubygems_version: 3.1.2
 signing_key: 
 specification_version: 4
-summary: Ruby extension for the vips image processing library.
+summary: A fast image processing library with low memory needs
 test_files: []