extract_ttc 0.3.0-x86_64-darwin

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 9197a7d268690b6a11ee2450db7fe449566327d8e635c6b9d2b2cd57a7d6973a
+  data.tar.gz: f79c8d902df03eaa7b0f5affe7dc79268e24fdcb85f0ba949dd7c7545ceef049
+SHA512:
+  metadata.gz: d28c31ffd4b7a49448c148a14eee1f5b4ddb1083307b7a4b8fca8fdfead8897238e1ed5f5939eea9a3fd0d2643b21daca07160d1e603298886da683686b07768
+  data.tar.gz: cf235f6ba88645fc5549ed37e6f81bbfb50abab80509ef6144889e94fb65e206334b3db1ec79d6e8bc9277b280991c2e8831ba45f8950bf11f330b997c210b88

data/.gitignore

@@ -0,0 +1,15 @@
+/.bundle/
+/vendor/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+/Gemfile.lock
+**/*.so
+**/*.o
+
+# remote file cache
+.rubocop-*

data/.rspec

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

data/.rubocop.yml

@@ -0,0 +1,5 @@
+inherit_from:
+  - 'https://raw.githubusercontent.com/fontist/oss-guides/master/ci/rubocop.yml'
+
+AllCops:
+  SuggestExtensions: false

data/Gemfile

@@ -0,0 +1,4 @@
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in extract_ttc.gemspec
+gemspec

data/LICENSE.adoc

@@ -0,0 +1,13 @@
+= BSD 3-Clause License
+
+Copyright (c) 2020 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:
+
+1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+
+2. 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.
+
+3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+
+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.

data/README.adoc

@@ -0,0 +1,121 @@
+= ExtractTtc: Ruby gem to extract TTF from TTC
+
+== Purpose
+
+The gem lets you extract individual TrueType font files (`.ttf`) from a TrueType Collection file (`.ttc`).
+
+`ExtractTtc` wraps functionality provided by `stripttc.c`, originally from the
+https://github.com/fontforge/fontforge[FontForge project] as an FFI extension.
+
+Specifically, `stripttc.c` is part of the `contribs` directory of FontForge, which
+is
+https://github.com/fontforge/fontforge/blob/21ad4a18fb3d4becfe566d8215eba4483b0ddc4b/contrib/CMakeLists.txt#L1[assigned]
+the
+https://github.com/fontforge/fontforge/blob/21ad4a18fb3d4becfe566d8215eba4483b0ddc4b/LICENSE#L12-L57[BSD 3-Clause license].
+
+
+== Installation
+
+Add this line to your application's `Gemfile`:
+
+[source,ruby]
+----
+gem 'extract_ttc'
+----
+
+And then execute:
+
+[source,sh]
+----
+$ bundle install
+----
+
+Or install it yourself as:
+
+[source,sh]
+----
+$ gem install extract_ttc
+----
+
+== Usage
+
+[source,ruby]
+----
+ExtractTtc.extract("path/to/ttc/Helvetica.ttc")
+----
+
+Would extract contained TTF files from TTC to a current directory.
+
+
+== Development
+
+We are following Sandi Metz's Rules for this gem, you can read the
+http://robots.thoughtbot.com/post/50655960596/sandi-metz-rules-for-developers[description of the rules here].
+All new code should follow these
+rules. If you make changes in a pre-existing file that violates these rules you
+should fix the violations as part of your contribution.
+
+=== Setup
+
+Clone the repository:
+
+[source,sh]
+----
+git clone https://github.com/fontist/extract_ttc
+----
+
+Setup your environment:
+
+[source,sh]
+----
+bin/setup
+----
+
+Run the test suite:
+
+[source,sh]
+----
+bundle exec rspec
+----
+
+If any changes are made in the C code, then the extension needs to be recompiled:
+
+[source,sh]
+----
+bundle exec rake recompile
+----
+
+You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to https://rubygems.org[rubygems.org].
+
+
+== Contributing
+
+First, thank you for contributing! We love pull requests from everyone. By
+participating in this project, you hereby grant https://www.ribose.com[Ribose Inc.] the
+right to grant or transfer an unlimited number of non exclusive licenses or
+sub-licenses to third parties, under the copyright covering the contribution
+to use the contribution by all means.
+
+Here are a few technical guidelines to follow:
+
+1. Open an https://github.com/fontist/extract_ttc/issues[issue] to discuss a new feature.
+1. Write tests to support your new feature.
+1. Make sure the entire test suite passes locally and on CI.
+1. Open a Pull Request.
+1. https://github.com/thoughtbot/guides/tree/master/protocol/git#write-a-feature[Squash your commits]
+  after receiving feedback.
+1. Party!
+
+
+== License
+
+This gem is distributed with a BSD 3-Clause license.
+
+`stripttc.c` is obtained from:
+https://github.com/fontforge/fontforge/blob/master/contrib/fonttools/stripttc.c
+
+The BSD 3-Clause licence for `stripttc.c` is provided in `ext/stripttc/LICENSE`.
+
+This gem is developed, maintained and funded by https://www.ribose.com/[Ribose Inc.]

data/Rakefile

@@ -0,0 +1,108 @@
+require "bundler/gem_tasks"
+require "rake/clean"
+require "rake/extensiontask"
+require "rake_compiler_dock"
+
+require "rubygems"
+require "rubygems/package_task"
+
+# ++ Allow rake-compiler-dock configuration without dev. dependencies
+begin
+  require "rubocop/rake_task"
+  RuboCop::RakeTask.new
+rescue LoadError
+end
+
+begin
+  require "rspec/core/rake_task"
+  RSpec::Core::RakeTask.new(:spec)
+rescue LoadError
+end
+# -- Allow rake-compiler-dock configuration without dev. dependencies
+
+R_CC_V = "RUBY_CC_VERSION=3.1.0:3.0.0:2.7.0".freeze
+bundler_ver = ENV["BUNDLER_VER"] || "2.3.22"
+
+task default: :spec
+task spec: :compile
+
+spec = Gem::Specification.load("extract_ttc.gemspec")
+
+ext_thru_rc_dock = %w[x86_64-linux aarch64-linux] +
+  %w[x64-mingw32 x64-mingw-ucrt x86_64-darwin arm64-darwin]
+
+ext_thru_musl_cc = %w[x86_64-linux-musl aarch64-linux-musl]
+
+# add your default gem packing task
+Gem::PackageTask.new(spec) do |pkg|
+end
+
+# HACK: Prevent rake-compiler from overriding required_ruby_version,
+# because the shared library here is Ruby-agnostic.
+# See https://github.com/rake-compiler/rake-compiler/issues/153
+module FixRequiredRubyVersion
+  def required_ruby_version=(*); end
+end
+Gem::Specification.prepend(FixRequiredRubyVersion)
+
+exttask = Rake::ExtensionTask.new("stripttc", spec) do |ext|
+  ext.lib_dir = "lib"
+  ext.cross_compile = true
+  ext.cross_platform = ext_thru_rc_dock + ext_thru_musl_cc
+  ext.cross_compiling do |s|
+    s.files.reject! { |path| File.fnmatch?("ext/*", path) }
+  end
+end
+
+namespace "gem" do
+  desc "Cache dependencies"
+  task "cache" do
+    sh <<~RCD
+      bundle config set cache_all true &&
+      bundle config set --local without 'development' &&
+      bundle package
+    RCD
+  end
+
+  desc "build native gems with rake-compiler-dock"
+  task "native" => "cache" do
+    ext_thru_rc_dock.each do |plat|
+      RakeCompilerDock.sh <<~RCD, platform: plat
+        gem install bundler:#{bundler_ver} --no-document &&
+        bundle install --local &&
+        bundle exec rake native:#{plat} gem #{R_CC_V}
+      RCD
+    end
+  end
+end
+
+namespace "gem" do
+  ext_thru_rc_dock.each do |plat|
+    desc "Build native gems with rake-compiler-dock in parallel"
+    multitask "parallel" => plat
+
+    desc "Build the native gem for #{plat}"
+    task plat => "cache" do
+      RakeCompilerDock.sh <<~RCD, platform: plat
+        gem install bundler:#{bundler_ver} --no-document &&
+        bundle install --local &&
+        bundle exec rake native:#{plat} \
+          pkg/#{exttask.gem_spec.full_name}-#{plat}.gem \
+          #{R_CC_V}
+      RCD
+    end
+  end
+
+  ext_thru_musl_cc.each do |plat|
+    desc "Define the gem task to build on the #{plat} platform (binary gem)"
+    task plat do
+      s = spec.dup
+      s.platform = Gem::Platform.new(plat)
+      s.files += Dir.glob("lib/extract_ttc/*.{dll,so,dylib}")
+      s.extensions = []
+
+      task = Gem::PackageTask.new(s)
+      task.define
+    end
+  end
+end

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "extract_ttc"
+
+# 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, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("rspec-core", "rspec")

data/bin/setup

@@ -0,0 +1,7 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+bundle exec rake compile

data/extract_ttc.gemspec

@@ -0,0 +1,41 @@
+require_relative "lib/extract_ttc/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "extract_ttc"
+  spec.version       = ExtractTtc::VERSION
+  spec.authors       = ["Ribose Inc."]
+  spec.email         = ["operations@ribose.com"]
+
+  spec.summary       = "Extract TTC file to TTF files"
+  spec.description   = "Extract font collection to separate font files"
+  spec.homepage      = "https://github.com/fontist/extract_ttc"
+  spec.license       = "BSD-3-Clause"
+  spec.required_ruby_version = Gem::Requirement.new(">= 2.6.0")
+
+  spec.metadata["homepage_uri"]    = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/fontist/extract_ttc"
+  spec.metadata["changelog_uri"]   = "https://github.com/fontist/extract_ttc"
+
+  spec.files = Dir.chdir(__dir__) do
+    `git ls-files -z`
+      .split("\x0").reject { |f| f.match(%r{^(.github|test|spec|features)/}) }
+  end
+
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_runtime_dependency "ffi", "~> 1.0"
+  spec.add_runtime_dependency "bundler", '~> 2.3', '>= 2.3.22'
+  spec.add_runtime_dependency "rake", "~> 13"
+  spec.add_runtime_dependency "rake-compiler", "~> 1.2"
+  spec.add_runtime_dependency "rake-compiler-dock", "~> 1.2"
+
+  spec.add_development_dependency "rspec", "~> 3.0"
+  spec.add_development_dependency "rubocop", "~> 1.5"
+  spec.add_development_dependency "rubocop-performance", "~> 1.10"
+  spec.add_development_dependency "rubocop-rails", "~> 2.9"
+
+  spec.extensions << "ext/stripttc/extconf.rb"
+  spec.metadata["rubygems_mfa_required"] = "false"
+end

data/lib/extract_ttc/version.rb

@@ -0,0 +1,3 @@
+module ExtractTtc
+  VERSION = "0.3.0".freeze
+end

data/lib/extract_ttc.rb

@@ -0,0 +1,79 @@
+require "extract_ttc/version"
+require "ffi"
+require "tempfile"
+
+module ExtractTtc
+  class Error < StandardError; end
+
+  class ReadFileError < Error; end
+
+  class InvalidFileError < Error; end
+
+  class WriteFileError < Error; end
+
+  class UnknownResultError < Error; end
+
+  extend FFI::Library
+  # NOTE: ffi doesn't support bundles out of box https://github.com/ffi/ffi/issues/42#issuecomment-750031554
+  # NOTE: rake-compiler doesn't support dylib generation https://github.com/rake-compiler/rake-compiler/issues/183
+  lib_name = if File.exists?(File.join(File.dirname(__FILE__),
+                                       "stripttc.bundle"))
+               "stripttc.bundle"
+             else
+               "stripttc.so"
+             end
+  ffi_lib File.join(File.dirname(__FILE__), lib_name)
+  attach_function :handlefile, [:string], :int
+
+  def self.extract(path)
+    stdout, stderr, code = capture3 do
+      handlefile(path)
+    end
+
+    return handle_error(code, stderr) unless code.zero?
+
+    fetch_filenames(stdout)
+  end
+
+  def self.handle_error(code, stderr)
+    case code
+    when -1
+      raise ReadFileError, stderr
+    when -2
+      raise InvalidFileError, stderr
+    when -3
+      raise WriteFileError, stderr
+    else
+      raise UnknownResultError, "Return code: #{code}"
+    end
+  end
+
+  def self.capture3
+    stderr = status = nil
+
+    stdout = capture_stream($stdout) do
+      stderr = capture_stream($stderr) do
+        status = yield
+      end
+    end
+
+    [stdout, stderr, status]
+  end
+
+  def self.capture_stream(stream_io)
+    origin_stream = stream_io.dup
+
+    Tempfile.open("captured_stream") do |captured_stream|
+      stream_io.reopen(captured_stream)
+      yield
+      captured_stream.rewind
+      return captured_stream.read
+    end
+  ensure
+    stream_io.reopen(origin_stream)
+  end
+
+  def self.fetch_filenames(stdout)
+    stdout.split("=>").last.split
+  end
+end

metadata

@@ -0,0 +1,195 @@
+--- !ruby/object:Gem::Specification
+name: extract_ttc
+version: !ruby/object:Gem::Version
+  version: 0.3.0
+platform: x86_64-darwin
+authors:
+- Ribose Inc.
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2022-09-29 00:00:00.000000000 Z
+dependencies:
+- !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: 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: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13'
+- !ruby/object:Gem::Dependency
+  name: rake-compiler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: rake-compiler-dock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !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.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: rubocop-performance
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.9'
+description: Extract font collection to separate font files
+email:
+- operations@ribose.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- Gemfile
+- LICENSE.adoc
+- README.adoc
+- Rakefile
+- bin/console
+- bin/rspec
+- bin/setup
+- extract_ttc.gemspec
+- lib/2.7/stripttc.bundle
+- lib/3.0/stripttc.bundle
+- lib/3.1/stripttc.bundle
+- lib/extract_ttc.rb
+- lib/extract_ttc/version.rb
+homepage: https://github.com/fontist/extract_ttc
+licenses:
+- BSD-3-Clause
+metadata:
+  homepage_uri: https://github.com/fontist/extract_ttc
+  source_code_uri: https://github.com/fontist/extract_ttc
+  changelog_uri: https://github.com/fontist/extract_ttc
+  rubygems_mfa_required: 'false'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.6.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.4
+signing_key:
+specification_version: 4
+summary: Extract TTC file to TTF files
+test_files: []