pngcheck 0.2.8-aarch64-linux

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c70bee5327087fce3c6205fde7224b02afff7c0fd89ca8f889bdeb749f4fb305
+  data.tar.gz: b182e0cbe4bbd4044da0b9b318bde64787561b62b785dfc339f10bf740e0121b
+SHA512:
+  metadata.gz: 35f8f92b419a6cad073aeb2b6589b3b8de64b663b5c541bc5d9535b91a09b261669b686d9a06d604fe98f1e66c31badf04921adc896d1d9f158f68d2722fad10
+  data.tar.gz: 343ff210e9199cbb3cc7ebd4dba435e24b18966112dbbd65c2c1ca3605398d38b719286b724fb0f39b158084057e5d4f6876f73607cf02738ff5ffe5f398ec64

data/.cross_rubies

@@ -0,0 +1,8 @@
+x64-mingw32
+x86_64-linux
+x86_64-linux-musl
+aarch64-linux
+aarch64-linux-musl
+x86_64-darwin
+arm64-darwin
+x64-mingw-ucrt

data/.hound.yml

@@ -0,0 +1,3 @@
+ruby:
+  enabled: true
+  config_file: .rubocop.yml

data/.rspec

@@ -0,0 +1 @@
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,9 @@
+inherit_from:
+  - 'https://raw.githubusercontent.com/riboseinc/oss-guides/master/ci/rubocop.yml'
+
+AllCops:
+  TargetRubyVersion: 2.7
+  SuggestExtensions: false
+
+Gemspec/RequireMFA:
+  Enabled: false

data/Gemfile

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in pngcheck.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,53 @@
+BSD 2-Clause License
+
+Copyright (c) 2022, Ribose Inc.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+
+This module includes original pngcheck software [http://www.libpng.org/pub/png/apps/pngcheck.html]
+that is distributed under the follwoing license:
+
+   Copyright 1995-2020 by Alexander Lehmann <lehmann@usa.net>,
+                          Andreas Dilger <adilger@enel.ucalgary.ca>,
+                          Glenn Randers-Pehrson <randeg@alum.rpi.edu>,
+                          Greg Roelofs <newt@pobox.com>,
+                          John Bowler <jbowler@acm.org>,
+                          Tom Lane <tgl@sss.pgh.pa.us>
+
+   Permission to use, copy, modify, and distribute this software and its
+   documentation for any purpose and without fee is hereby granted, provided
+   that the above copyright notice appear in all copies and that both that
+   copyright notice and this permission notice appear in supporting
+   documentation.  This software is provided "as is" without express or
+   implied warranty.
+
+
+[This license applies to pngcheck.c and its associated makefiles and
+ documentation in the main directory.  The files in the "gpl" subdirectory--
+ specifically, pngsplit.c and png-fix-IDAT-windowsize.c--are licensed under the
+ GNU General Public License.  The files in "amiga" subdirectory are Copyright
+ 2003 Simon Goodwin and were contributed without an explicit license statement,
+ but insofar as the "gpl" subdirectory didn't exist at the time, it's safe to
+ assume their intended license was similar to pngcheck's, just with Simon's
+ copyright replacing the one above.]

data/README.adoc

@@ -0,0 +1,161 @@
+image:https://github.com/metanorma/pngcheck-ruby/actions/workflows/test-and-release.yml/badge.svg["test-and-release", link="https://github.com/metanorma/pngcheck-ruby/actions/workflows/test-and-release.yml"]
+
+== PngCheck: PNG, JNG and MNG integrity checks
+
+The `pngcheck` gem provides the `PngCheck` Ruby library, used to
+
+* verify the integrity of PNG, JNG and MNG files, through
+
+** checking the internal 32-bit CRCs ("checksums");
+** decompressing the image data;
+
+* dump *almost* all of the chunk-level information in the image in
+human-readable form, including:
+
+** print the basic statistics about an image (dimensions, bit depth, etc.);
+** list the color and transparency info in its palette (assuming it has one); or
+** to extract the embedded text annotations.
+
+The `PngCheck` Ruby library is a wrapper around the original
+http://www.libpng.org/pub/png/apps/pngcheck.html[`pngcheck`] tool
+from the http://www.libpng.org/pub/png/libpng.html[`libpng`] project.
+
+NOTE: `PngCheck` incorporates
+http://www.libpng.org/pub/png/apps/pngcheck.html[`pngcheck`] version 3.0.3, as
+provided on the official website:
+http://www.libpng.org/pub/png/apps/pngcheck.html
+
+NOTE: The `PngCheck` Ruby library does not distribute nor modify the `pngcheck`
+GPL executables `pngsplit` and `png-fix-IDAT-windowsize`, and hence is not bound
+under the GPL license.
+
+=== Installation
+
+Add this line to your application's Gemfile:
+
+[source,ruby]
+----
+gem 'pngcheck'
+----
+
+And then execute:
+
+[source,sh]
+----
+$ bundle install
+----
+
+Or install it yourself as:
+[source,sh]
+----
+$ gem install pngcheck
+----
+
+=== Usage
+
+==== PngCheck status codes
+
+[source,ruby]
+----
+PngCheck::STATUS_OK = 0
+PngCheck::STATUS_WARNING = 1        # an error in some circumstances but not in all
+PngCheck::STATUS_MINOR_ERROR = 3    # minor spec errors (e.g., out-of-range values)
+PngCheck::STATUS_MAJOR_ERROR = 4    # file corruption, invalid chunk length/layout, etc.
+PngCheck::STATUS_CRITICAL_ERROR = 5 # unexpected EOF or other file(system) error
+----
+
+==== File processing
+
+[source,ruby]
+----
+status, info = PngCheck.analyze_file("spec/examples/correct.png")
+----
+
+Where:
+
+* `status` is file status code
+* `info` is either file content information for correct files, or error message for corrupt files
+
+[source,ruby]
+----
+valid = PngCheck.check_file("spec/examples/correct.png")
+----
+
+Where:
+
+* `valid` is `true` if the file is correct
+* otherwise an exception is raised. Possible exception types are `PngCheck::EmptyPngError`, `PngCheck::CorruptPngError`
+
+
+==== Memory buffer processing
+
+[source,ruby]
+----
+data = File.binread("spec/examples/correct.png")
+status, info = PngCheck.analyze_buffer(data)
+----
+
+Where:
+
+* `status` is the PngCheck status code
+* `info` is either file content information for correct files, or the error
+message for corrupt files
+
+
+[source,ruby]
+----
+data = File.binread("spec/examples/correct.png")
+valid = PngCheck.check_buffer(data)
+----
+
+Where:
+
+* `valid` is `true` if the buffer is correct image
+* otherwise an exception is raised. Possible exception types are `PngCheck::EmptyPngError`, `PngCheck::CorruptPngError`
+
+
+==== Pre-validation with libpng-ruby
+
+`libpng-ruby` is the Ruby wrapper library around `libpng`, commonly used to
+process PNG files in Ruby.
+
+To prevent crashing libpng-ruby with corrupt PNG files, you may wish to
+pre-verify integrity of the PNG file before loading it with `libpng-ruby`.
+Any errors in the PNG will cause a `PngCheck::CorruptPngError` to be raised,
+hence skipping the `libpng` code.
+
+The mechanism to do so is demonstrated below:
+
+[source,ruby]
+----
+require 'png'
+encoded = File.binread("spec/examples/correct.png")
+
+begin
+  PngCheck.check_buffer(encoded)
+  dec = PNG::Decoder.new
+  raw = dec << encoded
+rescue PngCheck::CorruptPngError => e
+  puts "Exception #{e.message}"
+end
+----
+
+
+=== Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/metanorma/pngcheck-ruby.
+
+=== License
+
+Open-sourced under the link:LICENSE.txt[Ribose BSD-2 clause license].
+Copyright Ribose for all code excluding the `pngcheck` library.
+
+The `pngcheck` library is provided under its original license as unmodified
+code, its license is located
+http://www.libpng.org/pub/png/src/pngcheck-3.0.3.LICENSE[here].
+
+NOTE: The core code of the `pngcheck` library is licensed under the
+http://www.libpng.org/pub/png/src/libpng-LICENSE.txt[libpng 3-clause BSD license],
+while two additional executables `pngsplit` and `png-fix-IDAT-windowsize` are
+offered under GPL. Since the `PngCheck` Ruby library does not offer the GPL
+executables, the gem itself is offered under a BSD license instead of GPL.

data/Rakefile

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+require "rubocop/rake_task"
+require_relative "ext/layout"
+
+RSpec::Core::RakeTask.new(:spec)
+RuboCop::RakeTask.new
+
+task default: %i[spec rubocop]
+
+task :compile do
+  require_relative "ext/extconf"
+end
+
+task spec: :compile
+
+desc "Build install-compilation gem"
+task "gem:native:any" do
+  sh "rake platform:any gem"
+end
+
+desc "Download pngcheck source"
+task :pngcheck do
+  test_cmd = "test -f #{PNGCHECK_LOCAL}"
+  wget_cmd = "wget -nc -nv -O #{PNGCHECK_LOCAL} #{PNGCHECK_URI}"
+  sh "#{test_cmd} || #{wget_cmd}"
+end
+task compile: :pngcheck
+
+require "rubygems/package_task"
+
+desc "Define the gem task to build on any platform (compile on install)"
+task "platform:any" do
+  spec = Gem::Specification::load("pngcheck.gemspec").dup
+  spec.files << PNGCHECK_LOCAL
+  task = Gem::PackageTask.new(spec)
+  task.define
+end
+task "gem:native:any": :pngcheck
+
+File.readlines(".cross_rubies", chomp: true).each do |platform|
+  desc "Build pre-compiled gem for the #{platform} platform"
+  task "gem:native:#{platform}" do
+    sh "rake compile platform:#{platform} gem target_platform=#{platform}"
+  end
+
+  desc "Define the gem task to build on the #{platform} platform (binary gem)"
+  task "platform:#{platform}" do
+    spec = Gem::Specification::load("pngcheck.gemspec").dup
+    spec.platform = Gem::Platform.new(platform)
+    spec.files += Dir.glob("lib/pngcheck/*.{dll,so,dylib}")
+    spec.extensions = []
+    spec.dependencies.reject! { |d| d.name == "mini_portile2" }
+
+    task = Gem::PackageTask.new(spec)
+    task.define
+  end
+end
+
+require "rake/clean"
+
+CLOBBER.include("pkg")
+CLEAN.include("ports",
+              "tmp",
+              PNGCHECK_LOCAL,
+              "lib/pngcheck/*.dll",
+              "lib/pngcheck/*.dylib",
+              "lib/pngcheck/*.so")

data/bin/console

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "bundler/setup"
+require "pngcheck"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/rspec

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'rspec' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+                                           Pathname.new(__FILE__).realpath)
+
+bundle_binstub = File.expand_path("bundle", __dir__)
+
+if File.file?(bundle_binstub)
+  if /This file was generated by Bundler/.match?(File.read(bundle_binstub, 300))
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("rspec-core", "rspec")

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/ext/Makefile

@@ -0,0 +1,4 @@
+# dummy Makefile, it is required to build an extension
+all:
+clean:
+install:

data/ext/extconf.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+$LOAD_PATH << File.expand_path(File.join(File.dirname(__FILE__), "../lib"))
+require "pngcheck/recipe"
+
+recipe = PngCheck::Recipe.new
+recipe.cook

data/ext/layout.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+PNGCHECK_ARCH = "pngcheck-3.0.3.tar.gz"
+PNGCHECK_URI = "http://www.libpng.org/pub/png/src/#{PNGCHECK_ARCH}"
+PNGCHECK_LOCAL = "ext/#{PNGCHECK_ARCH}"

data/ext/wrapper.c

@@ -0,0 +1,106 @@
+#ifdef _WIN32
+#   include <windows.h>
+#   include <share.h>
+#   include <io.h>
+#   include <stdio.h>
+#endif
+
+#include <sys/stat.h>
+#include <fcntl.h>
+#include <errno.h>
+
+#ifdef _WIN32
+/* https://github.com/Arryboom/fmemopen_windows  */
+
+    FILE *fmemopen(void *buf, size_t len, char *type) {
+	    int fd;
+	    FILE *fp;
+	    char tp[MAX_PATH - 13];
+	    char fn[MAX_PATH + 1];
+	    int * pfd = &fd;
+	    int retner = -1;
+	    char tfname[] = "MemTF_";
+	    if (!GetTempPathA(sizeof(tp), tp)) return NULL;
+	    if (!GetTempFileNameA(tp, tfname, 0, fn)) return NULL;
+	    retner = _sopen_s(pfd, fn, _O_CREAT | _O_SHORT_LIVED | _O_TEMPORARY | _O_RDWR | _O_BINARY | _O_NOINHERIT, _SH_DENYRW, _S_IREAD | _S_IWRITE);
+	    if (retner != 0) return NULL;
+	    if (fd == -1) return NULL;
+	    fp = _fdopen(fd, "wb+");
+	    if (!fp) {
+		    _close(fd);
+		    return NULL;
+	    }
+	    fwrite(buf, len, 1, fp);
+	    rewind(fp);
+	    return fp;
+    }
+#endif
+
+#include "pngcheck.c"
+
+#define EXTRA_MESSAGE_SIZE 1024
+
+void failed_to_open(char *extra_msg, char *fname) {
+    snprintf(extra_msg, EXTRA_MESSAGE_SIZE, "Failed to open %s: %s\n", fname, strerror(errno));
+    extra_msg[EXTRA_MESSAGE_SIZE-1] = 0;
+}
+
+void failed_to_dup(char *extra_msg, char *fmt) {
+    snprintf(extra_msg, EXTRA_MESSAGE_SIZE, fmt, strerror(errno));
+    extra_msg[EXTRA_MESSAGE_SIZE-1] = 0;
+}
+
+int pngcheck_inner(FILE* fp, char *fname, char *cname, char *extra_msg) {
+    int rc = kCriticalError;
+    int fd = open(cname, O_WRONLY);
+    if (fd == -1) {
+        failed_to_open(extra_msg, cname);
+    }
+    else {
+        int stdout_copy = dup(STDOUT_FILENO);
+        if (stdout_copy == -1) {
+            failed_to_dup(extra_msg, "Failed to save stdout: %s\n");
+        }
+        else {
+            if (dup2(fd, STDOUT_FILENO) == -1) {
+                failed_to_dup(extra_msg, "Failed to reassign stdout: %s\n");
+            }
+            else {
+                rc = pngcheck(fp, fname, 0, NULL);
+                fflush(stdout);
+            }
+            dup2(stdout_copy, STDOUT_FILENO);
+        }
+        close(fd);
+    }
+    return rc;
+}
+
+int pngcheck_file(char *fname, char *cname, char *extra_msg) {
+    int rc = kCriticalError;
+    extra_msg[0] = 0;
+    FILE* fp = fopen(fname, "rb");
+    if (fp == NULL) {
+        failed_to_open(extra_msg, fname);
+    }
+    else {
+        rc = pngcheck_inner(fp, fname, cname, extra_msg);
+        fclose(fp);
+    }
+    return rc;
+}
+
+int pngcheck_buffer(char *data, int size, char *cname, char *extra_msg) {
+    int rc = kCriticalError;
+    extra_msg[0] = 0;
+    char* fname = "[memory buffer]";
+    FILE* fp = fmemopen(data, size, "rb");
+    if (fp == NULL) {
+        failed_to_open(extra_msg, fname);
+    }
+    else {
+        rc = pngcheck_inner(fp, fname, cname, extra_msg);
+        fclose(fp);
+    }
+    return rc;
+}

data/lib/pngcheck/recipe.rb

@@ -0,0 +1,212 @@
+# frozen_string_literal: true
+
+require "rbconfig"
+require "mini_portile2"
+require "pathname"
+require "tmpdir"
+require "shellwords"
+require "open3"
+require_relative "version"
+
+ROOT = Pathname.new(File.expand_path("../..", __dir__))
+require "#{ROOT}/ext/layout.rb"
+
+module PngCheck
+  class Recipe < MiniPortile
+    COMMON_FLAGS = "-shared -fPIC -Wall -O -DUSE_ZLIB"
+
+    def files_to_load_all
+      @files << {
+        url: "file:#{ROOT}/#{PNGCHECK_LOCAL}", # "http://www.libpng.org/pub/png/src/pngcheck-3.0.3.tar.gz"
+        sha256: "c36a4491634af751f7798ea421321642f9590faa032eccb0dd5fb4533609dee6", # rubocop:disable Layout/LineLength
+      }
+    end
+
+    def files_to_load_cross
+      if target_platform.eql?("aarch64-linux") &&
+          !host_platform.eql?("aarch64-linux")
+        @files << {
+          url: "http://ports.ubuntu.com/pool/main/z/zlib/zlib1g-dev_1.2.11.dfsg-2ubuntu1.3_arm64.deb", # rubocop:disable Layout/LineLength
+          sha256: "0ebadc1ff2a70f0958d4e8e21ffa97d9fa4da23555eaae87782e963044a26fcf", # rubocop:disable Layout/LineLength
+        }
+      end
+    end
+
+    def initialize
+      super("pngcheck", "3.0.3")
+      files_to_load_all
+      files_to_load_cross
+      @target = ROOT.join(@target).to_s
+      @printed = {}
+    end
+
+    def lib_filename
+      @lib_filename ||=
+        if MiniPortile.windows?
+          "pngcheck.dll"
+        else
+          "pngcheck.so"
+        end
+    end
+
+    def lib_workpath
+      @lib_workpath ||= File.join(work_path, lib_filename)
+    end
+
+    def make_cmd
+      "#{cc} #{cflags} #{COMMON_FLAGS} -o #{lib_filename} wrapper.c -lz"
+    end
+
+    def cook_if_not
+      cook unless File.exist?(checkpoint)
+    end
+
+    def cook
+      super
+      FileUtils.touch(checkpoint)
+    end
+
+    def download_file_file(uri, full_path)
+      if MiniPortile.windows?
+        FileUtils.mkdir_p File.dirname(full_path)
+        FileUtils.cp uri.to_s.delete_prefix("file:"), full_path
+      else
+        super
+      end
+    end
+
+    def tmp_path
+      "tmp/#{@host}/ports"
+    end
+
+    def checkpoint
+      File.join(@target, "#{name}-#{version}-#{host}.installed")
+    end
+
+    def configure
+      FileUtils.cp(ROOT.join("ext", "wrapper.c"), work_path, verbose: false)
+      if target_platform.eql?("aarch64-linux") &&
+          !host_platform.eql?("aarch64-linux")
+        extract_file("#{work_path}/../data.tar.xz", work_path.to_s)
+      end
+    end
+
+    def verify_lib
+      begin
+        out, = Open3.capture2("file #{lib_workpath}")
+      rescue StandardError
+        message("Failed to call file, skipped library verification ...\n")
+        return
+      end
+
+      unless out.include?(target_format)
+        raise "Invalid file format '#{out.strip}', '#{@target_format}' expected"
+      end
+
+      message("Verifying #{lib_workpath} ... OK\n")
+    end
+
+    def install
+      libs = Dir.glob(File.join(work_path, "*"))
+        .grep(%r{/(?:lib)?[a-zA-Z0-9\-]+\.(?:so|dylib|dll)$})
+
+      FileUtils.cp_r(libs, ROOT.join("lib", "pngcheck"), verbose: false)
+      verify_lib
+    end
+
+    def execute(action, command, command_opts = {})
+      super(action, command, command_opts.merge(debug: false))
+    end
+
+    def message(text)
+      return super unless text.start_with?("\rDownloading")
+
+      match = text.match(/(\rDownloading .*)\(\s*\d+%\)/)
+      pattern = match ? match[1] : text
+      return if @printed[pattern]
+
+      @printed[pattern] = true
+      super
+    end
+
+    # rubocop:disable Metrics/MethodLength
+    # rubocop:disable Metrics/CyclomaticComplexity
+    def host_platform
+      @host_platform ||=
+        case @host
+        when /\Ax86_64-w64-mingw32/
+          "x64-mingw32"
+        when /\Ax86_64-w64-mingw-ucrt/
+          "x64-mingw-ucrt"
+        when /\A(arm64|aarch64).*linux/
+          "aarch64-linux"
+        when /\Ax86_64.*(darwin|macos|osx)/
+          "x86_64-darwin"
+        when /\A(arm64|aarch64).*(darwin|macos|osx)/
+          "arm64-darwin"
+        else
+          @host
+        end
+    end
+
+    def target_platform
+      @target_platform ||=
+        case ENV.fetch("target_platform", nil)
+        when /\A(arm64|aarch64).*(darwin|macos|osx)/
+          "arm64-darwin"
+        when /\Ax86_64.*(darwin|macos|osx)/
+          "x86_64-darwin"
+        when /\A(arm64|aarch64).*linux/
+          "aarch64-linux"
+        else
+          ENV.fetch("target_platform", host_platform)
+        end
+    end
+
+    def target_format
+      @target_format ||=
+        case target_platform
+        when "arm64-darwin"
+          "Mach-O 64-bit dynamically linked shared library arm64"
+        when "x86_64-darwin"
+          "Mach-O 64-bit dynamically linked shared library x86_64"
+        when "aarch64-linux"
+          "ELF 64-bit LSB shared object, ARM aarch64"
+        when /\Ax86_64.*linux.*/
+          "ELF 64-bit LSB shared object, x86-64"
+        when /\Ax64-mingw(32|-ucrt)/
+          "PE32+ executable (DLL) (console) x86-64, for MS Windows"
+        else
+          "skip"
+        end
+    end
+
+    def cc
+      @cc ||=
+        if target_platform.eql?(host_platform)
+          "gcc"
+        else
+          case target_platform
+          when "aarch64-linux"
+            "aarch64-linux-gnu-gcc"
+          when "arm64-darwin"
+            "gcc -target arm64-apple-macos11"
+          else
+            "gcc"
+          end
+        end
+    end
+
+    def cflags
+      @cflags ||=
+        if target_platform.eql?("aarch64-linux") &&
+            !host_platform.eql?("aarch64-linux")
+          "-I./usr/include -L./usr/lib/#{target_platform}-gnu"
+        else
+          ""
+        end
+    end
+    # rubocop:enable Metrics/CyclomaticComplexity
+    # rubocop:enable Metrics/MethodLength
+  end
+end

data/lib/pngcheck/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module PngCheck
+  VERSION = "0.2.8"
+end

data/lib/pngcheck.rb

@@ -0,0 +1,103 @@
+# frozen_string_literal: true
+
+require "ffi"
+require "tempfile"
+require_relative "pngcheck/version"
+
+module PngCheck
+  EMPTY_IMAGE = "Image is empty"
+
+  class CorruptPngError < StandardError; end
+
+  class EmptyPngError < StandardError
+    def initialize(msg = EMPTY_IMAGE)
+      super
+    end
+  end
+
+  STATUS_OK = 0
+  STATUS_WARNING = 1        # an error in some circumstances but not in all
+  STATUS_MINOR_ERROR = 3    # minor spec errors (e.g., out-of-range values)
+  STATUS_MAJOR_ERROR = 4    # file corruption, invalid chunk length/layout, etc.
+  STATUS_CRITICAL_ERROR = 5 # unexpected EOF or other file(system) error
+
+  EXTRA_MESSAGE_SIZE = 1024
+
+  extend FFI::Library
+
+  lib_filename = FFI::Platform.windows? ? "pngcheck.dll" : "pngcheck.so"
+  ffi_lib File.expand_path("pngcheck/#{lib_filename}", __dir__)
+    .gsub("/", File::ALT_SEPARATOR || File::SEPARATOR)
+
+  # int pngcheck_file(char *fname, char *cname, char *extra_message)
+  typedef :string, :file_path
+  typedef :pointer, :extra_message
+  typedef :int, :status
+  attach_function :pngcheck_file, %i[file_path file_path extra_message],
+                  :status
+  # int pngcheck_string(char *data, int size, char *cname, char *extra_message)
+  typedef :pointer, :data
+  typedef :int, :size
+  attach_function :pngcheck_buffer, %i[data size file_path extra_message],
+                  :status
+
+  @@semaphore = Mutex.new
+
+  class << self
+    def analyze_file(path)
+      return [STATUS_CRITICAL_ERROR, EMPTY_IMAGE] if File.zero? path
+
+      do_analyze_file(path)
+    end
+
+    def check_file(path)
+      status, info = analyze_file(path)
+      raise EmptyPngError.new if info.eql? EMPTY_IMAGE
+      raise CorruptPngError.new info unless status == STATUS_OK
+
+      true
+    end
+
+    def analyze_buffer(data)
+      return [STATUS_CRITICAL_ERROR, EMPTY_IMAGE] if data.empty?
+
+      do_analyze_buffer(data)
+    end
+
+    def check_buffer(data)
+      status, info = analyze_buffer(data)
+      raise EmptyPngError.new if info.eql? EMPTY_IMAGE
+      raise CorruptPngError.new info unless status == STATUS_OK
+
+      true
+    end
+
+    private
+
+    def do_analyze_file(path)
+      Tempfile.open("captured-stream-") do |captured_stream|
+        extra_msg = FFI::Buffer.alloc_out(EXTRA_MESSAGE_SIZE, 1, false)
+        @@semaphore.lock
+        status = pngcheck_file(path, captured_stream.path, extra_msg)
+        @@semaphore.unlock
+        # we assume that pngcheck_file returns either captured_stream
+        # or extra message but not both
+
+        [status, captured_stream.read + extra_msg.get_string(0)]
+      end
+    end
+
+    def do_analyze_buffer(data)
+      Tempfile.open("captured-stream-") do |captured_stream|
+        extra_msg = FFI::Buffer.alloc_out(EXTRA_MESSAGE_SIZE, 1, false)
+        mem_buf = FFI::MemoryPointer.new(:char, data.bytesize)
+        mem_buf.put_bytes(0, data)
+        @@semaphore.lock
+        status = pngcheck_buffer(mem_buf, data.bytesize, captured_stream.path,
+                                 extra_msg)
+        @@semaphore.unlock
+        [status, captured_stream.read + extra_msg.get_string(0)]
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,158 @@
+--- !ruby/object:Gem::Specification
+name: pngcheck
+version: !ruby/object:Gem::Version
+  version: 0.2.8
+platform: aarch64-linux
+authors:
+- Ribose Inc.
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2022-09-30 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.3.22
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.3.22
+- !ruby/object:Gem::Dependency
+  name: ffi
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: libpng-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+description: 
+email:
+- open.source@ribose.com
+executables:
+- console
+- rspec
+- setup
+extensions: []
+extra_rdoc_files: []
+files:
+- ".cross_rubies"
+- ".hound.yml"
+- ".rspec"
+- ".rubocop.yml"
+- Gemfile
+- LICENSE.txt
+- README.adoc
+- Rakefile
+- bin/console
+- bin/rspec
+- bin/setup
+- ext/Makefile
+- ext/extconf.rb
+- ext/layout.rb
+- ext/wrapper.c
+- lib/pngcheck.rb
+- lib/pngcheck/pngcheck.so
+- lib/pngcheck/recipe.rb
+- lib/pngcheck/version.rb
+homepage: https://github.com/metanorma/pngcheck-ruby
+licenses:
+- BSD-2-Clause
+metadata:
+  homepage_uri: https://github.com/metanorma/pngcheck-ruby
+  source_code_uri: https://github.com/metanorma/pngcheck-ruby
+  changelog_uri: https://github.com/metanorma/pngcheck-ruby
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.6
+signing_key: 
+specification_version: 4
+summary: Ruby interface to pngcheck.
+test_files: []