fifi 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: fb6a94cb40940b9b08d22a254f5c880205c6bc7a32af9cfb3c6c1d657cd3c37d
+  data.tar.gz: ce8dd952c35424eac4a11e2bb1ddbaef749cf79b4b852206b94c265d52e4eeed
+SHA512:
+  metadata.gz: f071be05fa94c1da9390d5176dcaf7f748e102e19b5bcb5d5cff1056ce2214a89de073d0066d6053b5d22c204ec50bceed825d11443ca900237249881537c984
+  data.tar.gz: b5e3bed6d2a0c0806c40832c4abdabdea105aa68e5f5a6cfb0fe32377d39809ae79d5fd3295e63aa6caa01c29c00b73dfa9b93b2bc03fea03d380796e5be466e

data/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,40 @@
+# Fifi
+
+Fifi is a tiny CLI to download or install Google Fonts. It pulls font files from
+the Google Fonts GitHub repository via the GitHub API.
+
+## Usage
+
+```
+gem install fifi
+
+fifi install nunito
+fifi install nunito, inter, open sans
+fifi download nunito -o assets/fonts
+fifi download nunito
+```
+
+## Install
+
+```
+gem install fifi
+```
+
+## Options
+
+- `-o, --output DIR`: Download destination for `download`.
+- `-s, --static`: Prefer static fonts instead of variable.
+
+## Notes
+
+- The GitHub API is rate-limited. If you hit limits, set `FIFI_GITHUB_TOKEN`
+  or `GITHUB_TOKEN` to a personal access token.
+
+## Install
+
+Build and install the gem locally:
+
+```
+gem build fifi.gemspec
+gem install ./fifi-0.1.0.gem
+```

data/bin/fifi

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "fifi"
+
+exit Fifi::CLI.start(ARGV)

data/lib/fifi/cli.rb

@@ -0,0 +1,168 @@
+# frozen_string_literal: true
+
+require "optparse"
+require "fileutils"
+require "fifi/google_fonts"
+
+module Fifi
+  class CLI
+    def self.start(argv)
+      new(argv).run
+    end
+
+    def initialize(argv)
+      @argv = argv.dup
+    end
+
+    def run
+      return show_usage if @argv.empty?
+      return show_usage if help_flag?(@argv.first)
+
+      command = @argv.shift
+      case command
+      when "install"
+        run_install(@argv)
+      when "download"
+        run_download(@argv)
+      else
+        warn "Unknown command: #{command}"
+        show_usage(exit_code: 1)
+      end
+    end
+
+    private
+
+    def run_install(args)
+      options = { variable: true }
+      parser = OptionParser.new do |opts|
+        opts.banner = "Usage: fifi install <fonts> [options]"
+        opts.on("-s", "--static", "Prefer static fonts (default: variable)") do
+          options[:variable] = false
+        end
+        opts.on("-h", "--help", "Show help") do
+          puts opts
+          return 0
+        end
+      end
+
+      parser.parse!(args)
+      fonts = parse_fonts(args)
+      if fonts.empty?
+        warn "No fonts provided."
+        puts parser
+        return 1
+      end
+
+      font_dir = default_font_dir
+      failures = 0
+
+      fonts.each do |font|
+        begin
+          files = GoogleFonts.new(font, variable: options[:variable]).fetch(font_dir)
+          puts "Installed #{font} (#{files.size} files) to #{font_dir}"
+        rescue StandardError => e
+          failures += 1
+          warn "Failed to install #{font}: #{e.message}"
+        end
+      end
+
+      if linux_platform? && failures < fonts.size
+        puts "If fonts are not visible, run: fc-cache -f"
+      end
+
+      failures.zero? ? 0 : 1
+    end
+
+    def run_download(args)
+      options = { variable: true, output: Dir.pwd }
+      parser = OptionParser.new do |opts|
+        opts.banner = "Usage: fifi download <fonts> [options]"
+        opts.on("-o", "--output DIR", "Output directory (default: current dir)") do |dir|
+          options[:output] = dir
+        end
+        opts.on("-s", "--static", "Prefer static fonts (default: variable)") do
+          options[:variable] = false
+        end
+        opts.on("-h", "--help", "Show help") do
+          puts opts
+          return 0
+        end
+      end
+
+      parser.parse!(args)
+      fonts = parse_fonts(args)
+      if fonts.empty?
+        warn "No fonts provided."
+        puts parser
+        return 1
+      end
+
+      failures = 0
+
+      fonts.each do |font|
+        begin
+          files = GoogleFonts.new(font, variable: options[:variable]).fetch(options[:output])
+          puts "Downloaded #{font} (#{files.size} files) to #{options[:output]}"
+        rescue StandardError => e
+          failures += 1
+          warn "Failed to download #{font}: #{e.message}"
+        end
+      end
+
+      failures.zero? ? 0 : 1
+    end
+
+    def parse_fonts(args)
+      raw = args.join(" ").strip
+      return [] if raw.empty?
+
+      raw.split(",").map { |font| font.strip }.reject(&:empty?)
+    end
+
+    def show_usage(exit_code: 0)
+      puts <<~USAGE
+        Usage:
+          fifi install <fonts> [options]
+          fifi download <fonts> [options]
+
+        Examples:
+          fifi install nunito
+          fifi install nunito, inter, open sans
+          fifi download nunito -o assets/fonts
+          fifi download nunito
+
+        Options:
+          -s, --static    Prefer static fonts (default: variable)
+          -h, --help      Show help
+      USAGE
+      exit_code
+    end
+
+    def help_flag?(arg)
+      %w[-h --help help].include?(arg)
+    end
+
+    def default_font_dir
+      if mac_platform?
+        File.join(Dir.home, "Library", "Fonts")
+      elsif windows_platform?
+        base = ENV["LOCALAPPDATA"] || File.join(Dir.home, "AppData", "Local")
+        File.join(base, "Microsoft", "Windows", "Fonts")
+      else
+        File.join(Dir.home, ".local", "share", "fonts")
+      end
+    end
+
+    def mac_platform?
+      /darwin/i.match?(RUBY_PLATFORM)
+    end
+
+    def windows_platform?
+      /mswin|mingw|cygwin/i.match?(RUBY_PLATFORM)
+    end
+
+    def linux_platform?
+      /linux/i.match?(RUBY_PLATFORM)
+    end
+  end
+end

data/lib/fifi/google_fonts.rb

@@ -0,0 +1,120 @@
+# frozen_string_literal: true
+
+require "fileutils"
+require "json"
+require "open-uri"
+
+module Fifi
+  class GoogleFonts
+    REPO_API_BASE = "https://api.github.com/repos/google/fonts/contents"
+    LICENSE_DIRS = %w[ofl apache ufl].freeze
+
+    def initialize(font_name, variable: true)
+      @font_name = font_name
+      @variable = variable
+    end
+
+    def fetch(destination_dir)
+      files = resolve_files
+      FileUtils.mkdir_p(destination_dir)
+
+      files.map do |file|
+        target = File.join(destination_dir, file[:name])
+        download_file(file[:url], target)
+        target
+      end
+    end
+
+    private
+
+    def resolve_files
+      family_url = find_family_dir
+      raise "Font family not found in Google Fonts repo" unless family_url
+
+      entries = fetch_json(family_url)
+      static_dir = entries.find { |entry| entry["type"] == "dir" && entry["name"] == "static" }
+      root_fonts = entries.select { |entry| entry["type"] == "file" && font_file?(entry["name"]) }
+      variable_fonts = root_fonts.select { |entry| variable_file?(entry["name"]) }
+      static_root_fonts = root_fonts.reject { |entry| variable_file?(entry["name"]) }
+
+      chosen = if @variable
+        if variable_fonts.any?
+          variable_fonts
+        elsif static_dir
+          list_static_dir(static_dir["url"])
+        else
+          static_root_fonts.empty? ? root_fonts : static_root_fonts
+        end
+      else
+        if static_dir
+          list_static_dir(static_dir["url"])
+        elsif static_root_fonts.any?
+          static_root_fonts
+        else
+          variable_fonts.empty? ? root_fonts : variable_fonts
+        end
+      end
+
+      chosen.map { |entry| { name: entry["name"], url: entry["download_url"] } }
+            .reject { |entry| entry[:url].nil? }
+    end
+
+    def list_static_dir(url)
+      entries = fetch_json(url)
+      entries.select { |entry| entry["type"] == "file" && font_file?(entry["name"]) }
+    end
+
+    def find_family_dir
+      normalized = normalize_family(@font_name)
+      LICENSE_DIRS.each do |dir|
+        url = "#{REPO_API_BASE}/#{dir}/#{normalized}"
+        return url if url_exists?(url)
+      end
+      nil
+    end
+
+    def url_exists?(url)
+      fetch_json(url)
+      true
+    rescue OpenURI::HTTPError => e
+      return false if e.message.include?("404")
+      raise "GitHub API error: #{e.message}"
+    end
+
+    def fetch_json(url)
+      raw = URI.open(url, github_headers).read
+      JSON.parse(raw)
+    rescue OpenURI::HTTPError => e
+      raise "GitHub API error for #{url}: #{e.message}"
+    rescue JSON::ParserError => e
+      raise "Unexpected response from GitHub API for #{url}: #{e.message}"
+    end
+
+    def download_file(url, target)
+      URI.open(url, "rb", **github_headers) do |io|
+        File.open(target, "wb") { |file| IO.copy_stream(io, file) }
+      end
+    rescue OpenURI::HTTPError => e
+      raise "Failed to download #{@font_name} (#{e.message})"
+    end
+
+    def github_headers
+      headers = { "User-Agent" => "fifi" }
+      token = ENV["FIFI_GITHUB_TOKEN"] || ENV["GITHUB_TOKEN"]
+      headers["Authorization"] = "token #{token}" if token && !token.empty?
+      headers
+    end
+
+    def normalize_family(name)
+      name.downcase.gsub(/[^a-z0-9]/, "")
+    end
+
+    def font_file?(name)
+      name.match?(/\.(ttf|otf)$/i)
+    end
+
+    def variable_file?(name)
+      name.match?(/\[.+\]/) || name.match?(/VariableFont|\\bVF\\b/i)
+    end
+  end
+end

data/lib/fifi/version.rb

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

data/lib/fifi.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require "fifi/version"
+require "fifi/cli"

metadata

@@ -0,0 +1,52 @@
+--- !ruby/object:Gem::Specification
+name: fifi
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Fifi Contributors
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-02-12 00:00:00.000000000 Z
+dependencies: []
+description: Fifi installs or downloads Google Fonts with a simple CLI.
+email: []
+executables:
+- fifi
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- README.md
+- bin/fifi
+- lib/fifi.rb
+- lib/fifi/cli.rb
+- lib/fifi/google_fonts.rb
+- lib/fifi/version.rb
+homepage: https://github.com/Greyoxide/fifi
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/Greyoxide/fifi
+  bug_tracker_uri: https://github.com/Greyoxide/fifi/issues
+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.0.3.1
+signing_key: 
+specification_version: 4
+summary: Install or download Google Fonts from the terminal.
+test_files: []