fontist 2.1.3 → 2.1.5

data/lib/fontist/version.rb

@@ -1,3 +1,3 @@
 module Fontist
-  VERSION = "2.1.3".freeze
+  VERSION = "2.1.5".freeze
 end

data/lib/fontist.rb

@@ -1,14 +1,95 @@
 require "down"
 require "digest"
 require "singleton"
+require "lutaml/model"
 
 require_relative "fontist/errors"
 require_relative "fontist/version"
-require_relative "fontist/cache/manager"
+require_relative "fontist/cache"
 require_relative "fontist/memoizable"
 require_relative "fontist/path_scanning"
+require_relative "fontist/utils"
 
 module Fontist
+  # Core classes
+  autoload :Config, "#{__dir__}/fontist/config"
+  autoload :Font, "#{__dir__}/fontist/font"
+  autoload :FontCollection, "#{__dir__}/fontist/font_collection"
+  autoload :FontFile, "#{__dir__}/fontist/font_file"
+  autoload :FontInstaller, "#{__dir__}/fontist/font_installer"
+  autoload :FontModel, "#{__dir__}/fontist/font_model"
+  autoload :FontPath, "#{__dir__}/fontist/font_path"
+  autoload :FontStyle, "#{__dir__}/fontist/font_style"
+  autoload :Fontconfig, "#{__dir__}/fontist/fontconfig"
+  autoload :Formula, "#{__dir__}/fontist/formula"
+  autoload :FormulaCollection, "#{__dir__}/fontist/formula"
+  autoload :FormulaPicker, "#{__dir__}/fontist/formula_picker"
+  autoload :FormulaSuggestion, "#{__dir__}/fontist/formula_suggestion"
+  autoload :Helpers, "#{__dir__}/fontist/helpers"
+  autoload :Import, "#{__dir__}/fontist/import"
+  autoload :ImportSource, "#{__dir__}/fontist/import_source"
+  autoload :InstallLocation, "#{__dir__}/fontist/install_location"
+  autoload :StyleVersion, "#{__dir__}/fontist/style_version"
+  autoload :Update, "#{__dir__}/fontist/update"
+
+  # Index classes
+  autoload :Index, "#{__dir__}/fontist/index"
+  autoload :IndexEntry, "#{__dir__}/fontist/index"
+  autoload :IndexStats, "#{__dir__}/fontist/system_index"
+  autoload :SystemIndexFont, "#{__dir__}/fontist/system_index"
+  autoload :SystemIndexFontCollection, "#{__dir__}/fontist/system_index"
+  autoload :SystemIndex, "#{__dir__}/fontist/system_index"
+
+  # Data models
+  autoload :CollectionFile, "#{__dir__}/fontist/collection_file"
+  autoload :Extract, "#{__dir__}/fontist/extract"
+  autoload :ExtractOptions, "#{__dir__}/fontist/extract"
+  autoload :Resource, "#{__dir__}/fontist/formula"
+  autoload :ResourceCollection, "#{__dir__}/fontist/formula"
+
+  # Font sources
+  autoload :GoogleImportSource, "#{__dir__}/fontist/google_import_source"
+  autoload :MacosImportSource, "#{__dir__}/fontist/macos_import_source"
+  autoload :SilImportSource, "#{__dir__}/fontist/sil_import_source"
+  autoload :MacosFrameworkMetadata, "#{__dir__}/fontist/macos_framework_metadata"
+
+  # Manifest classes
+  autoload :Manifest, "#{__dir__}/fontist/manifest"
+  autoload :ManifestFont, "#{__dir__}/fontist/manifest"
+  autoload :ManifestRequest, "#{__dir__}/fontist/manifest_request"
+  autoload :ManifestRequestFont, "#{__dir__}/fontist/manifest_request"
+  autoload :ManifestResponse, "#{__dir__}/fontist/manifest_response"
+  autoload :ManifestResponseFont, "#{__dir__}/fontist/manifest_response"
+  autoload :ManifestResponseFontStyle, "#{__dir__}/fontist/manifest_response"
+
+  # System
+  autoload :Info, "#{__dir__}/fontist/repo"
+  autoload :Repo, "#{__dir__}/fontist/repo"
+  autoload :SystemFont, "#{__dir__}/fontist/system_font"
+
+  # CLI
+  autoload :CLI, "#{__dir__}/fontist/cli"
+  autoload :CacheCLI, "#{__dir__}/fontist/cache_cli"
+  autoload :ConfigCLI, "#{__dir__}/fontist/config_cli"
+  autoload :FontconfigCLI, "#{__dir__}/fontist/fontconfig_cli"
+  autoload :ImportCLI, "#{__dir__}/fontist/import_cli"
+  autoload :IndexCLI, "#{__dir__}/fontist/index_cli"
+  autoload :ManifestCLI, "#{__dir__}/fontist/manifest_cli"
+  autoload :RepoCLI, "#{__dir__}/fontist/repo_cli"
+  autoload :ThorExt, "#{__dir__}/fontist/cli/thor_ext"
+  autoload :Validation, "#{__dir__}/fontist/validation"
+  autoload :ValidationReport, "#{__dir__}/fontist/validation"
+  autoload :ValidationCache, "#{__dir__}/fontist/validation"
+  autoload :FontValidationResult, "#{__dir__}/fontist/validation"
+  autoload :Validator, "#{__dir__}/fontist/validator"
+  autoload :ValidateCLI, "#{__dir__}/fontist/validate_cli"
+
+  # Namespace modules
+  autoload :Indexes, "#{__dir__}/fontist/indexes"
+  autoload :InstallLocations, "#{__dir__}/fontist/install_locations"
+  autoload :Resources, "#{__dir__}/fontist/resources"
+  autoload :Macos, "#{__dir__}/fontist/macos"
+
   def self.ui
     Fontist::Utils::UI
   end
@@ -196,38 +277,3 @@ module Fontist
     true
   end
 end
-
-require_relative "fontist/repo"
-require_relative "fontist/font"
-require_relative "fontist/formula"
-require_relative "fontist/system_font"
-require_relative "fontist/manifest"
-require_relative "fontist/manifest_response"
-require_relative "fontist/manifest_request"
-require_relative "fontist/helpers"
-require_relative "fontist/config"
-require_relative "fontist/update"
-require_relative "fontist/index"
-require_relative "fontist/indexes/incremental_scanner"
-require_relative "fontist/indexes/directory_snapshot"
-require_relative "fontist/indexes/directory_change"
-require_relative "fontist/indexes/incremental_index_updater"
-require_relative "fontist/indexes/font_index"
-require_relative "fontist/indexes/filename_index"
-require_relative "fontist/indexes/fontist_index"
-require_relative "fontist/indexes/user_index"
-require_relative "fontist/indexes/system_index"
-require_relative "fontist/cli"
-require_relative "fontist/font_installer"
-require_relative "fontist/fontconfig"
-require_relative "fontist/formula_picker"
-require_relative "fontist/formula_suggestion"
-require_relative "fontist/extract"
-require_relative "fontist/font_style"
-require_relative "fontist/font_collection"
-require_relative "fontist/import"
-require_relative "fontist/import_source"
-require_relative "fontist/macos_import_source"
-require_relative "fontist/google_import_source"
-require_relative "fontist/sil_import_source"
-require_relative "fontist/macos_framework_metadata"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fontist
 version: !ruby/object:Gem::Version
-  version: 2.1.3
+  version: 2.1.5
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-03-06 00:00:00.000000000 Z
+date: 2026-03-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: down
@@ -120,20 +120,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.7'
-- !ruby/object:Gem::Dependency
-  name: lutaml-xsd
-  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: marcel
   requirement: !ruby/object:Gem::Requirement
@@ -268,14 +254,14 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
-- ".github/workflows/deploy-pages.yml"
 - ".github/workflows/discover-fonts.yml"
+- ".github/workflows/docs.yml"
 - ".github/workflows/formulas-auto-update-test.yml"
+- ".github/workflows/links.yml"
 - ".github/workflows/post-rake.yml"
 - ".github/workflows/rake-metanorma.yaml"
 - ".github/workflows/rake.yml"
 - ".github/workflows/release.yml"
-- ".github/workflows/release.yml.orig"
 - ".github/workflows/tebako-pack.yml"
 - ".gitignore"
 - ".gitmodules"
@@ -289,24 +275,80 @@ files:
 - Rakefile
 - docs/.gitignore
 - docs/.vitepress/config.ts
-- docs/guide/api-ruby.md
+- docs/.vitepress/data/cli-commands.json
+- docs/.vitepress/data/exit-codes.json
+- docs/.vitepress/data/features.json
+- docs/.vitepress/theme/components/HeroCodeBlock.vue
+- docs/.vitepress/theme/components/WithinHero.vue
+- docs/.vitepress/theme/index.ts
+- docs/.vitepress/theme/style.css
+- docs/api/errors.md
+- docs/api/font.md
+- docs/api/fontconfig.md
+- docs/api/formula.md
+- docs/api/index.md
+- docs/api/manifest.md
+- docs/cli/cache.md
+- docs/cli/config.md
+- docs/cli/create-formula.md
+- docs/cli/exit-codes.md
+- docs/cli/fontconfig.md
+- docs/cli/import.md
+- docs/cli/index-cmd.md
+- docs/cli/index.md
+- docs/cli/install.md
+- docs/cli/list.md
+- docs/cli/manifest.md
+- docs/cli/repo.md
+- docs/cli/status.md
+- docs/cli/uninstall.md
+- docs/cli/update.md
+- docs/cli/version.md
+- docs/components/CliCommand.vue
+- docs/components/CliExamples.vue
+- docs/components/CliOptions.vue
+- docs/components/ExitCodes.vue
 - docs/guide/ci.md
+- docs/guide/concepts/fonts.md
+- docs/guide/concepts/formats.md
+- docs/guide/concepts/index.md
+- docs/guide/concepts/licenses.md
+- docs/guide/concepts/requirements.md
+- docs/guide/concepts/variable-fonts.md
 - docs/guide/fontconfig.md
+- docs/guide/formulas.md
+- docs/guide/how-it-works.md
 - docs/guide/index.md
+- docs/guide/installation.md
+- docs/guide/maintainer/import.md
+- docs/guide/maintainer/index.md
+- docs/guide/manifests.md
+- docs/guide/platforms/index.md
+- docs/guide/platforms/macos.md
+- docs/guide/platforms/windows.md
 - docs/guide/proxy.md
+- docs/guide/quick-start.md
 - docs/guide/why.md
 - docs/index.md
+- docs/lychee.toml
 - docs/package-lock.json
 - docs/package.json
-- docs/public/hero.png
-- docs/public/logo.png
-- docs/reference/index.md
+- docs/public/apple-touch-icon.png
+- docs/public/favicon-96x96.png
+- docs/public/favicon.ico
+- docs/public/favicon.svg
+- docs/public/logo-full.svg
+- docs/public/logo.svg
+- docs/public/site.webmanifest
+- docs/public/web-app-manifest-192x192.png
+- docs/public/web-app-manifest-512x512.png
 - exe/fontist
 - fontist.gemspec
 - formula_filename_index.yml
 - formula_index.yml
 - google-fonts-multi-format-usage.md
 - lib/fontist.rb
+- lib/fontist/cache.rb
 - lib/fontist/cache/manager.rb
 - lib/fontist/cache/store.rb
 - lib/fontist/cache_cli.rb
@@ -336,6 +378,7 @@ files:
 - lib/fontist/import.rb
 - lib/fontist/import/convert_formulas.rb
 - lib/fontist/import/create_formula.rb
+- lib/fontist/import/files.rb
 - lib/fontist/import/files/collection_file.rb
 - lib/fontist/import/files/font_detector.rb
 - lib/fontist/import/font_metadata_extractor.rb
@@ -345,6 +388,7 @@ files:
 - lib/fontist/import/formula_serializer.rb
 - lib/fontist/import/google.rb
 - lib/fontist/import/google/api.rb
+- lib/fontist/import/google/data_sources.rb
 - lib/fontist/import/google/data_sources/base.rb
 - lib/fontist/import/google/data_sources/github.rb
 - lib/fontist/import/google/data_sources/ttf.rb
@@ -354,6 +398,7 @@ files:
 - lib/fontist/import/google/metadata.proto
 - lib/fontist/import/google/metadata_adapter.rb
 - lib/fontist/import/google/metadata_parser.rb
+- lib/fontist/import/google/models.rb
 - lib/fontist/import/google/models/axis.rb
 - lib/fontist/import/google/models/axis_metadata.rb
 - lib/fontist/import/google/models/file_metadata.rb
@@ -364,13 +409,16 @@ files:
 - lib/fontist/import/google/models/source_metadata.rb
 - lib/fontist/import/google_fonts_importer.rb
 - lib/fontist/import/google_import.rb
+- lib/fontist/import/helpers.rb
 - lib/fontist/import/helpers/hash_helper.rb
 - lib/fontist/import/helpers/system_helper.rb
 - lib/fontist/import/import_display.rb
 - lib/fontist/import/macos.rb
 - lib/fontist/import/macos/macos_license.txt
 - lib/fontist/import/manual_formula_builder.rb
+- lib/fontist/import/models.rb
 - lib/fontist/import/models/font_metadata.rb
+- lib/fontist/import/otf.rb
 - lib/fontist/import/otf/font_file.rb
 - lib/fontist/import/recursive_extraction.rb
 - lib/fontist/import/sil_import.rb
@@ -381,6 +429,7 @@ files:
 - lib/fontist/import_source.rb
 - lib/fontist/index.rb
 - lib/fontist/index_cli.rb
+- lib/fontist/indexes.rb
 - lib/fontist/indexes/base_font_collection_index.rb
 - lib/fontist/indexes/default_family_font_index.rb
 - lib/fontist/indexes/directory_change.rb
@@ -396,10 +445,13 @@ files:
 - lib/fontist/indexes/system_index.rb
 - lib/fontist/indexes/user_index.rb
 - lib/fontist/install_location.rb
+- lib/fontist/install_locations.rb
 - lib/fontist/install_locations/base_location.rb
 - lib/fontist/install_locations/fontist_location.rb
 - lib/fontist/install_locations/system_location.rb
 - lib/fontist/install_locations/user_location.rb
+- lib/fontist/macos.rb
+- lib/fontist/macos/catalog.rb
 - lib/fontist/macos/catalog/asset.rb
 - lib/fontist/macos/catalog/base_parser.rb
 - lib/fontist/macos/catalog/catalog_manager.rb
@@ -419,6 +471,7 @@ files:
 - lib/fontist/path_scanning.rb
 - lib/fontist/repo.rb
 - lib/fontist/repo_cli.rb
+- lib/fontist/resources.rb
 - lib/fontist/resources/apple_cdn_resource.rb
 - lib/fontist/resources/archive_resource.rb
 - lib/fontist/resources/google_resource.rb

data/.github/workflows/deploy-pages.yml

@@ -1,54 +0,0 @@
-name: deploy-pages
-
-permissions:
-  contents: read
-
-on:
-  push:
-    branches: "main"
-    paths-ignore:
-      - README.md
-      - CONTRIBUTING.md
-      - LICENSE
-      - .gitignore
-      - .github/**
-      - "!.github/workflows/deploy-pages.yml"
-  workflow_dispatch:
-
-concurrency:
-  group: ${{ github.workflow }}
-  cancel-in-progress: true
-
-jobs:
-  deploy-pages:
-    environment:
-      name: github-pages
-      url: ${{ steps.deploy-pages.outputs.page_url }}
-    permissions:
-      pages: write
-      id-token: write
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: latest
-          # Lockfile is in subfolder
-          # cache: npm
-      - uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: ruby
-      - run: rdoc -x docs
-      - run: npm install
-        working-directory: docs
-      - id: configure-pages
-        uses: actions/configure-pages@v4
-      - run: npm run build
-        working-directory: docs
-        env:
-          BASE_PATH: ${{ steps.configure-pages.outputs.base_path }}/
-      - run: mv docs/.vitepress/dist _site
-      - run: mv doc _site/reference/api-ruby
-      - uses: actions/upload-pages-artifact@v3
-      - id: deploy-pages
-        uses: actions/deploy-pages@v4

data/.github/workflows/release.yml.orig

@@ -1,36 +0,0 @@
-name: release
-
-on:
-  workflow_dispatch:
-    inputs:
-      next_version:
-        description: |
-          Next release version. Possible values: x.y.z, major, minor, patch (or pre|rc|etc).
-          Also, you can pass 'skip' to skip 'git tag' and do 'gem push' for the current version
-        required: true
-        default: 'skip'
-  repository_dispatch:
-    types: [ do-release ]
-
-permissions:
-  contents: read
-<<<<<<< HEAD
-=======
-  packages: write
-<<<<<<< Updated upstream
-=======
-  id-token: write
->>>>>>> Stashed changes
->>>>>>> 35f3c7d (fix: release gha)
-
-jobs:
-  release:
-    permissions:
-      contents: write
-      packages: write
-      id-token: write
-    uses: fontist/support/.github/workflows/release.yml@main
-    with:
-      next_version: ${{ github.event.inputs.next_version }}
-    secrets:
-      rubygems-api-key: ${{ secrets.FONTIST_CI_RUBYGEMS_API_KEY }}

data/docs/guide/api-ruby.md

@@ -1,189 +0,0 @@
-# Fontist Ruby library
-
-In addition to the command-line interface, Fontist can be used as a Ruby library.
-
-## Fontist::Font
-
-The `Fontist::Font` is your go-to place to deal with any font using Fontist.
-
-This interface allows you to find a font or install a font.
-
-### Finding a font
-
-The `Fontist::Font.find` interface can be used to find a font in your system.
-
-It will look into the operating system specific font directories, and also the fontist specific `~/.fontist` directory.
-
-```ruby
-Fontist::Font.find(name)
-```
-
-- If Fontist finds a font, then it will return the paths.
-- Otherwise, it will either raise an unsupported font error, or trigger display of installation instructions for that specific font.
-
-### Install a font
-
-The `Fontist::Font.install` interface can be used to install any supported font.
-
-This interface first checks if you already have that font installed or not and if you do, then it will return the paths.
-
-If you don't have a font but that font is supported by Fontist, then it will download the font and copy it to `~/.fontist` directory and also return the paths.
-
-```ruby
-Fontist::Font.install(name, confirmation: "no")
-```
-
-If there are issues detected with the provided font, such as the font is not supported, those errors would be raised.
-
-### List all fonts
-
-The `Fontist::Font` interface exposes an interface to list all supported fonts.
-
-This might be useful if you want to know the name of the font or the available styles. You can do that by using:
-
-```ruby
-Fontist::Font.all
-```
-
-The return values are model objects, so you can easily access their properties and perform operations on them.
-
-## Fontist::Formula
-
-The `fontist` gem internally uses the `Fontist::Formula` interface to find a registered formula or fonts supported by any formula. Unless you need to do anything with that, you shouldn't need to work with this interface directly. But if you do, then these are the public interfaces it offers.
-
-### Find a formula
-
-The `Fontist::Formula.find` interface allows you to find any of the registered formulas. This interface takes a font name as an argument and it looks through each of the registered formulas that offer this font installation. Usages:
-
-```ruby
-Fontist::Formula.find("Calibri")
-```
-
-This method will search and return a Fontist formula for the provided keyword which allows for further processing, such as license checks or proceeding with the installation of the font in your system.
-
-### List font styles supported by a formula
-
-Normally, each font name can be associated with multiple styles or collections, for example, the `Calibri` font might contain `regular`, `bold`, or `italic` styles fonts and if you want an interface that can return the complete list then this is your friend.
-
-You can use it as following:
-
-```ruby
-Fontist::Formula.find_fonts("Calibri")
-```
-
-### List all formulas
-
-The `Fontist::Formula` interface exposes an interface to list all registered font formulas. This might be useful if you want to know the name of the formula or what type of fonts can be installed using that formula. Usages:
-
-```ruby
-Fontist::Formula.all
-```
-
-The return values are model objects, so you can easily access their properties and perform operations on them.
-
-## Fontist::Manifest
-
-### Global options
-
-Fontist can be switched to use the preferred family names. This format was used prior to v1.10.
-
-```ruby
-Fontist.preferred_family = true
-```
-
-### Manifest from YAML file or Hash
-
-Fontist lets you find font locations from a defined manifest Hash in the following format:
-
-```ruby
-{
-  "Segoe UI"=>["Regular", "Bold"],
-  "Roboto Mono"=>["Regular"]
-}
-```
-
-Calling the following code returns a nested Hash with font paths and names. Font name is useful to choose a specific font in a font collection file (TTC).
-
-```ruby
-Fontist::Manifest.from_yaml(manifest)
-Fontist::Manifest.from_hash(manifest)
-```
-
-```ruby
-{
-  "Segoe UI"=> {
-    "Regular"=>{
-      "full_name"=>"Segoe UI",
-      "paths"=>["/Users/user/.fontist/fonts/SEGOEUI.TTF"]
-    },
-    "Bold"=>{
-      "full_name"=>"Segoe UI Bold",
-      "paths"=>["/Users/user/.fontist/fonts/SEGOEUIB.TTF"]
-    }
-  },
-  "Roboto Mono"=> {
-    "Regular"=>{
-      "full_name"=>nil,
-      "paths"=>[]
-    }
-  }
-}
-```
-
-Fontist lets you not only obtain font locations but also install fonts from the manifest:
-
-```ruby
-manifest.install(confirmation: "yes")
-```
-
-It will install fonts and return their locations:
-
-```ruby
-{
-  "Segoe UI"=> {
-    "Regular"=>{
-      "full_name"=>"Segoe UI",
-      "paths"=>["/Users/user/.fontist/fonts/SEGOEUI.TTF"]},
-    "Bold"=>{
-      "full_name"=>"Segoe UI Bold",
-      "paths"=>["/Users/user/.fontist/fonts/SEGOEUIB.TTF"]
-    }
-  },
-  "Roboto Mono"=> {
-    "Regular"=>{
-      "full_name"=>"Roboto Mono Regular",
-      "paths"=>["/Users/user/.fontist/fonts/RobotoMono-VariableFont_wght.ttf"]
-    }
-  }
-}
-```
-
-#### Support of YAML format
-
-Both commands support a YAML file as an input with a `from_file` method. For example, if there is a `manifest.yml` file containing:
-
-```yaml
----
-Segoe UI:
-  - Regular
-  - Bold
-Roboto Mono:
-  - Regular
-```
-
-Then the following calls would return font names and paths, as from the `from_hash` method (see Fontist::Manifest).
-
-```ruby
-manifest = Fontist::Manifest.from_file("manifest.yml")
-manifest.install(confirmation: "yes")
-```
-
-## Fontist::Fontconfig
-
-Fontist supports work with Fontconfig via the Ruby interface:
-
-```ruby
-Fontist::Fontconfig.update              # let detect fontist fonts
-Fontist::Fontconfig.remove              # disable detection
-Fontist::Fontconfig.remove(force: true) # do not fail if no config exists
-```