brew/Library/Homebrew/dev-cmd/generate-cask-api.rb

# typed: true
# frozen_string_literal: true

require "abstract_command"
require "cli/parser"
require "cask/cask"
require "formula"

module Homebrew
  module DevCmd
    class GenerateCaskApi < AbstractCommand
      CASK_JSON_TEMPLATE = <<~EOS
        ---
        layout: cask_json
        ---
        {{ content }}
      EOS

      cmd_args do
        description <<~EOS
          Generate `homebrew/cask` API data files for <#{HOMEBREW_API_WWW}>.
          The generated files are written to the current directory.
        EOS

        switch "-n", "--dry-run", description: "Generate API data without writing it to files."

        named_args :none
      end

      sig { override.void }
      def run
        tap = CoreCaskTap.instance
        raise TapUnavailableError, tap.name unless tap.installed?

        unless args.dry_run?
          directories = ["_data/cask", "api/cask", "api/cask-source", "cask", "api/internal/v3"].freeze
          FileUtils.rm_rf directories
          FileUtils.mkdir_p directories
        end

        Homebrew.with_no_api_env do
          tap_migrations_json = JSON.dump(tap.tap_migrations)
          File.write("api/cask_tap_migrations.json", tap_migrations_json) unless args.dry_run?

          Cask::Cask.generating_hash!

          tap.cask_files.each do |path|
            cask = Cask::CaskLoader.load(path)
            name = cask.token
            json = JSON.pretty_generate(cask.to_hash_with_variations)
            cask_source = path.read
            html_template_name = html_template(name)

            unless args.dry_run?
              File.write("_data/cask/#{name}.json", "#{json}\n")
              File.write("api/cask/#{name}.json", CASK_JSON_TEMPLATE)
              File.write("api/cask-source/#{name}.rb", cask_source)
              File.write("cask/#{name}.html", html_template_name)
            end
          rescue
            onoe "Error while generating data for cask '#{path.stem}'."
            raise
          end

          homebrew_cask_tap_json = JSON.generate(tap.to_internal_api_hash)
          File.write("api/internal/v3/homebrew-cask.json", homebrew_cask_tap_json) unless args.dry_run?
        end
      end

      private

      def html_template(title)
        <<~EOS
          ---
          title: #{title}
          layout: cask
          ---
          {{ content }}
        EOS
      end
    end
  end
end