saxonc-runtime 12.9.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 7f85d6b83c31c30c9230826dbbe287c2521bba229ba8ed5b4a5a0f09918d3e9c
+  data.tar.gz: 92c85165b22aaeb1a8e5be147c3b0dd68fc7bf85d704385fc76ba1ccce87db01
+SHA512:
+  metadata.gz: c263ff997c3864c6099ec7a109f9b1b2e0c8734497baeedb524ee1ed6676ffafe62d1a1cec97d019679ee030a8f8275e4cf6a5c6da648a675b00f79dc7b2ffbf
+  data.tar.gz: f39ea587cef3dfc23205eba23716fd79d7a06316cbfc8b29433ef07b04f5a0163fc139d51ce69541748d0de636180d2710e207958e4cb1c0fdd44eedf4ccb5a7

data/README.md

@@ -0,0 +1,56 @@
+# saxonc-runtime
+
+A small helper gem that downloads and exposes SaxonC binaries for the `saxonc` gem (or any consumer that needs `SAXONC_HOME`). It detects your platform, fetches the right archive, and keeps it in a cache.
+
+## Installation
+
+```bash
+gem install saxonc-runtime
+# or
+bundle add saxonc-runtime
+```
+
+By default it installs the Home Edition (HE). Pick another edition with:
+
+```bash
+SAXONC_EDITION=pe gem install saxonc-runtime
+# or ee
+```
+
+Force a fresh download (ignore cache):
+
+```bash
+SAXONC_LIBS_FORCE=1 gem install saxonc-runtime
+```
+
+## Using with `saxonc`
+
+When `saxonc` builds its native extension it will, by default, ask this gem for `SAXONC_HOME`. You don't need to do anything extra.
+
+If you already have a SaxonC install, skip the download and point `saxonc` (and this helper) at it:
+
+```bash
+export SAXONC_HOME=/Users/janot/Code/ruby-saxonc/SaxonCHE-macos-arm64-12-9-0/SaxonCHE
+gem install saxonc
+```
+
+Or use mkmf flags when compiling `saxonc` from source:
+
+```bash
+gem install saxonc -- --with-saxonche-dir=/path/to/SaxonCHE
+# or supply include/lib separately
+gem install saxonc -- \
+	--with-saxonche-include=/path/to/SaxonCHE/include \
+	--with-saxonche-lib=/path/to/SaxonCHE/lib
+```
+
+Precedence when locating SaxonC: `--with-saxonche-*` flags > `SAXONC_HOME` > cached runtime from this gem.
+
+## Development
+
+```bash
+bundle install
+bundle exec rake spec
+```
+
+To release, bump `lib/saxon/runtime/version.rb`, tag `vX.Y.Z`, and push; the GitHub Actions release workflow will build, attach the gem to the GitHub Release, and publish to RubyGems.

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+require "rubocop/rake_task"
+
+RuboCop::RakeTask.new
+
+task default: %i[spec rubocop]

data/lib/saxon/runtime/edition.rb

@@ -0,0 +1,130 @@
+module Saxon::Runtime
+  class Edition
+    attr_reader :version, :platform
+
+    VERSION_REGEX = /\A(\d+)\.(\d+)\.(\d+)\z/
+    def initialize(version = Saxon::Runtime::SAXON_VERSION)
+      unless version.match?(VERSION_REGEX)
+        raise ArgumentError, "Invalid version format: #{version}. Expected format: 'X.Y.Z'"
+      end
+      @version = version
+
+      unless platform
+        raise "Unsupported platform: #{os or "unknown"}-#{arch or "unknown"}"
+      end
+      @platform = platform
+    end
+
+    def path
+      File.expand_path File.join(Saxon::Runtime.base_dir, version, edition, platform)
+    end
+
+    def installed?
+      File.exist?(path)
+    end
+
+    def available_platforms
+      [
+        'linux-x86_64',
+        'linux-aarch64',
+        'macos-x86_64',
+        'macos-arm64',
+        'windows-x86_64'
+      ]
+    end
+
+    def platform
+      platform = "#{os}-#{arch}"
+      available_platforms.include?(platform) ? platform : nil
+    end
+
+    def download_url
+      "https://downloads.saxonica.com/SaxonC/#{edition}/#{version_major}/SaxonCHE-#{platform}-#{version_major}-#{version_minor}-#{version_patch}.zip"
+    end
+
+    def install!
+      STDERR.puts "SaxonC does not appear to be installed in #{path}, installing!"
+      FileUtils.mkdir_p Saxon::Runtime.base_dir
+
+      Tempfile.create("saxonc.zip") do |zip_file|
+
+        begin
+          zip_file.open "wb" do |file|
+            STDERR.puts "Downloading SaxonC from #{download_url}..."
+            file.write URI.open(download_url).read
+          end
+        rescue OpenURI::HTTPError => e
+          raise "Failed to download SaxonC from #{download_url}, perhaps the version or platform is not supported: #{e.message}"
+        rescue StandardError => e
+          raise "An error occurred while downloading SaxonC: #{e.message}"
+        end
+
+        STDERR.puts "Extracting SaxonC..."
+        Zip::File.open(zip_file.path) do |zip_file|
+          zip_file.each do |entry|
+            entry.extract(File.join(temp_dir, entry.name))
+          end
+        end
+
+        extracted_dir = Dir['saxonc*'].find { |path| File.directory?(path) }
+
+        if FileUtils.mv extracted_dir, path
+          STDOUT.puts "\nSuccessfully installed SaxonC to #{path}!\n"
+        end
+
+        if FileUtils.rm_rf temp_dir
+          STDOUT.puts "Removed temporarily downloaded files."
+        end
+      end
+
+      raise "Failed to install SaxonC. Sorry :(" unless File.exist?(path)
+    end
+
+    def ensure_installed!
+      install! unless installed?
+    end
+
+    private
+
+    def version_major
+      version.split('.')[0]
+    end
+
+    def version_minor
+      version.split('.')[1]
+    end
+
+    def version_patch
+      version.split('.')[2]
+    end
+
+    def os
+      case RbConfig::CONFIG['host_os']
+      when /linux/
+        'linux'
+      when /darwin/
+        'macos'
+      when /mswin|mingw|cygwin/
+        'windows'
+      else
+        nil
+      end
+    end
+
+    def arch
+      RbConfig::CONFIG['host_cpu']
+    end
+
+    def edition
+      self.class.name.split('::').last
+    end
+
+    def temp_path
+      ENV['TMPDIR'] || ENV['TEMP'] || '/tmp'
+    end
+  end
+
+  HE = Class.new(Edition)
+  PE = Class.new(Edition)
+  EE = Class.new(Edition)
+end

data/lib/saxon/runtime/version.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Saxon
+  module Runtime
+    SAXON_VERSION = "12.9.0"
+    VERSION = SAXON_VERSION + ".0"
+  end
+end

data/lib/saxon/runtime.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+require_relative "runtime/version"
+require "fileutils"
+
+module Saxon
+  module Runtime
+    class Error < StandardError; end
+    class UnknownEdition < Error; end;
+    class UnsupportedPlatform < Error; end;
+
+    class << self
+      def edition
+        @edition || Saxon::Runtime::HE.new
+      end
+
+      def edition=(edition)
+        @edition = edition
+      end
+
+      def base_dir
+        @base_dir ||= File.join(File.expand_path('~'), '.saxonc')
+      end
+
+      def base_dir=(dir)
+        @base_dir = dir
+      end
+
+      def path
+        edition.path
+      end
+
+      # Removes the local saxon copies
+      def implode!
+        FileUtils.rm_rf File.join(File.expand_path('~'), '.saxonc')
+      end
+
+      # Clears cached state. Primarily useful for testing.
+      def reset!
+        @base_dir = @path = @edition = @version = nil
+      end
+    end
+  end
+end
+
+require 'saxon/runtime/edition'

metadata

@@ -0,0 +1,50 @@
+--- !ruby/object:Gem::Specification
+name: saxonc-runtime
+version: !ruby/object:Gem::Version
+  version: 12.9.0.0
+platform: ruby
+authors:
+- Jakob Kofoed Janot
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+description: A small helper gem that downloads and exposes SaxonC binaries for the
+  `saxonc` gem (or any consumer that needs `SAXONC_HOME`). It detects your platform,
+  fetches the right archive, and keeps it in a cache.
+email:
+- jakob@janot.dk
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- Rakefile
+- lib/saxon/runtime.rb
+- lib/saxon/runtime/edition.rb
+- lib/saxon/runtime/version.rb
+homepage: https://github.com/jakobjanot/ruby-saxonc-runtime
+licenses: []
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/jakobjanot/ruby-saxonc-runtime
+  source_code_uri: https://github.com/jakobjanot/ruby-saxonc-runtime
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.0
+specification_version: 4
+summary: A small helper gem that downloads and exposes SaxonC binaries for the `saxonc`
+  gem.
+test_files: []