tapioca 0.16.9 → 0.17.7

data/lib/tapioca/commands/abstract_dsl.rb

@@ -3,34 +3,12 @@
 
 module Tapioca
   module Commands
+    # @abstract
     class AbstractDsl < CommandWithoutTracker
       include SorbetHelper
       include RBIFilesHelper
 
-      abstract!
-
-      sig do
-        params(
-          requested_constants: T::Array[String],
-          requested_paths: T::Array[Pathname],
-          outpath: Pathname,
-          only: T::Array[String],
-          exclude: T::Array[String],
-          file_header: T::Boolean,
-          tapioca_path: String,
-          skip_constant: T::Array[String],
-          quiet: T::Boolean,
-          verbose: T::Boolean,
-          number_of_workers: T.nilable(Integer),
-          auto_strictness: T::Boolean,
-          gem_dir: String,
-          rbi_formatter: RBIFormatter,
-          app_root: String,
-          halt_upon_load_error: T::Boolean,
-          compiler_options: T::Hash[String, T.untyped],
-          lsp_addon: T::Boolean,
-        ).void
-      end
+      #: (requested_constants: Array[String], requested_paths: Array[Pathname], outpath: Pathname, only: Array[String], exclude: Array[String], file_header: bool, tapioca_path: String, ?skip_constant: Array[String], ?quiet: bool, ?verbose: bool, ?number_of_workers: Integer?, ?auto_strictness: bool, ?gem_dir: String, ?rbi_formatter: RBIFormatter, ?app_root: String, ?halt_upon_load_error: bool, ?compiler_options: Hash[String, untyped], ?lsp_addon: bool) -> void
       def initialize(
         requested_constants:,
         requested_paths:,
@@ -75,7 +53,7 @@ module Tapioca
 
       private
 
-      sig { params(outpath: Pathname, quiet: T::Boolean).returns(T::Set[Pathname]) }
+      #: (Pathname outpath, quiet: bool) -> Set[Pathname]
       def generate_dsl_rbi_files(outpath, quiet:)
         if @lsp_addon
           pipeline.active_compilers.each(&:reset_state)
@@ -103,20 +81,17 @@ module Tapioca
         files_to_purge
       end
 
-      sig { returns(T::Array[String]) }
+      #: -> Array[String]
       def all_requested_constants
-        @all_requested_constants ||= T.let(
-          @requested_constants + constants_from_requested_paths,
-          T.nilable(T::Array[String]),
-        )
+        @all_requested_constants ||= @requested_constants + constants_from_requested_paths #: Array[String]?
       end
 
-      sig { returns(Tapioca::Dsl::Pipeline) }
+      #: -> Tapioca::Dsl::Pipeline
       def pipeline
-        @pipeline ||= T.let(create_pipeline, T.nilable(Tapioca::Dsl::Pipeline))
+        @pipeline ||= create_pipeline #: Tapioca::Dsl::Pipeline?
       end
 
-      sig { void }
+      #: -> void
       def load_application
         # Loaded ahead of time when using the add-on to avoid reloading multiple times
         return if @lsp_addon
@@ -129,17 +104,24 @@ module Tapioca
         )
       end
 
-      sig { returns(Tapioca::Dsl::Pipeline) }
+      #: -> Tapioca::Dsl::Pipeline
       def create_pipeline
+        error_handler = if @lsp_addon
+          ->(error) {
+            say(error)
+          }
+        else
+          ->(error) {
+            say_error(error, :bold, :red)
+          }
+        end
         Tapioca::Dsl::Pipeline.new(
           requested_constants:
             constantize(@requested_constants) + constantize(constants_from_requested_paths, ignore_missing: true),
           requested_paths: @requested_paths,
           requested_compilers: constantize_compilers(@only),
           excluded_compilers: constantize_compilers(@exclude),
-          error_handler: ->(error) {
-            say_error(error, :bold, :red)
-          },
+          error_handler: error_handler,
           skipped_constants: constantize(@skip_constant, ignore_missing: true),
           number_of_workers: @number_of_workers,
           compiler_options: @compiler_options,
@@ -147,7 +129,7 @@ module Tapioca
         )
       end
 
-      sig { params(requested_constants: T::Array[String], path: Pathname).returns(T::Set[Pathname]) }
+      #: (Array[String] requested_constants, ?path: Pathname) -> Set[Pathname]
       def existing_rbi_filenames(requested_constants, path: @outpath)
         filenames = if requested_constants.empty?
           Pathname.glob(path / "**/*.rbi")
@@ -161,7 +143,7 @@ module Tapioca
         filenames.to_set
       end
 
-      sig { params(constant_names: T::Array[String], ignore_missing: T::Boolean).returns(T::Array[Module]) }
+      #: (Array[String] constant_names, ?ignore_missing: bool) -> Array[Module]
       def constantize(constant_names, ignore_missing: false)
         constant_map = constant_names.to_h do |name|
           [name, Object.const_get(name)]
@@ -178,7 +160,7 @@ module Tapioca
             remove_file(filename) if File.file?(filename)
           end
 
-          raise Thor::Error, ""
+          raise Tapioca::Error, ""
         end
 
         processable_constants
@@ -186,7 +168,7 @@ module Tapioca
           .grep(Module)
       end
 
-      sig { params(compiler_names: T::Array[String]).returns(T::Array[T.class_of(Tapioca::Dsl::Compiler)]) }
+      #: (Array[String] compiler_names) -> Array[singleton(Tapioca::Dsl::Compiler)]
       def constantize_compilers(compiler_names)
         compiler_map = compiler_names.to_h do |name|
           [name, resolve(name)]
@@ -206,7 +188,7 @@ module Tapioca
         T.cast(compiler_map.values, T::Array[T.class_of(Tapioca::Dsl::Compiler)])
       end
 
-      sig { params(name: String).returns(T.nilable(T.class_of(Tapioca::Dsl::Compiler))) }
+      #: (String name) -> singleton(Tapioca::Dsl::Compiler)?
       def resolve(name)
         # Try to find built-in tapioca compiler first, then globally defined compiler.
         potentials = Tapioca::Dsl::Compilers::NAMESPACES.map do |namespace|
@@ -219,14 +201,7 @@ module Tapioca
         potentials.compact.first
       end
 
-      sig do
-        params(
-          constant_name: String,
-          rbi: RBI::File,
-          outpath: Pathname,
-          quiet: T::Boolean,
-        ).returns(T.nilable(Pathname))
-      end
+      #: (String constant_name, RBI::File rbi, ?outpath: Pathname, ?quiet: bool) -> Pathname?
       def compile_dsl_rbi(constant_name, rbi, outpath: @outpath, quiet: false)
         return if rbi.empty?
 
@@ -244,7 +219,7 @@ module Tapioca
         filename
       end
 
-      sig { params(dir: Pathname).void }
+      #: (Pathname dir) -> void
       def perform_dsl_verification(dir)
         diff = verify_dsl_rbi(tmp_dir: dir)
 
@@ -253,7 +228,7 @@ module Tapioca
         FileUtils.remove_entry(dir)
       end
 
-      sig { params(files: T::Set[Pathname]).void }
+      #: (Set[Pathname] files) -> void
       def purge_stale_dsl_rbi_files(files)
         if files.any?
           say("Removing stale RBI files...")
@@ -265,12 +240,12 @@ module Tapioca
         end
       end
 
-      sig { params(constant_name: String).returns(Pathname) }
+      #: (String constant_name) -> Pathname
       def dsl_rbi_filename(constant_name)
         @outpath / "#{underscore(constant_name)}.rbi"
       end
 
-      sig { params(tmp_dir: Pathname).returns(T::Hash[String, Symbol]) }
+      #: (tmp_dir: Pathname) -> Hash[String, Symbol]
       def verify_dsl_rbi(tmp_dir:)
         diff = {}
 
@@ -302,7 +277,7 @@ module Tapioca
         diff
       end
 
-      sig { params(cause: Symbol, files: T::Array[String]).returns(String) }
+      #: (Symbol cause, Array[String] files) -> String
       def build_error_for_files(cause, files)
         filenames = files.map do |file|
           @outpath / file
@@ -311,7 +286,7 @@ module Tapioca
         "  File(s) #{cause}:\n  - #{filenames}"
       end
 
-      sig { params(diff: T::Hash[String, Symbol], command: Symbol).void }
+      #: (Hash[String, Symbol] diff, Symbol command) -> void
       def report_diff_and_exit_if_out_of_date(diff, command)
         if diff.empty?
           say("Nothing to do, all RBIs are up-to-date.")
@@ -320,7 +295,7 @@ module Tapioca
             build_error_for_files(cause, diff_for_cause.map(&:first))
           end.join("\n")
 
-          raise Thor::Error, <<~ERROR
+          raise Tapioca::Error, <<~ERROR
             #{set_color("RBI files are out-of-date. In your development environment, please run:", :green)}
               #{set_color("`#{default_command(command)}`", :green, :bold)}
             #{set_color("Once it is complete, be sure to commit and push any changes", :green)}
@@ -333,14 +308,14 @@ module Tapioca
         end
       end
 
-      sig { params(path: Pathname).returns(T::Array[Pathname]) }
+      #: (Pathname path) -> Array[Pathname]
       def rbi_files_in(path)
         Pathname.glob(path / "**/*.rbi").map do |file|
           file.relative_path_from(path)
         end.sort
       end
 
-      sig { params(class_name: String).returns(String) }
+      #: (String class_name) -> String
       def underscore(class_name)
         return class_name unless /[A-Z-]|::/.match?(class_name)
 
@@ -352,22 +327,20 @@ module Tapioca
         word
       end
 
-      sig { params(constant: String).returns(String) }
+      #: (String constant) -> String
       def rbi_filename_for(constant)
         underscore(constant) + ".rbi"
       end
 
-      sig { params(constant: String).returns(String) }
+      #: (String constant) -> String
       def generate_command_for(constant)
         default_command(:dsl, constant)
       end
 
-      sig { returns(T::Array[String]) }
+      #: -> Array[String]
       def constants_from_requested_paths
-        @constants_from_requested_paths ||= T.let(
-          Static::SymbolLoader.symbols_from_paths(@requested_paths).to_a,
-          T.nilable(T::Array[String]),
-        )
+        @constants_from_requested_paths ||=
+          Static::SymbolLoader.symbols_from_paths(@requested_paths).to_a #: Array[String]?
       end
     end
   end

data/lib/tapioca/commands/abstract_gem.rb

@@ -3,33 +3,12 @@
 
 module Tapioca
   module Commands
+    # @abstract
     class AbstractGem < Command
       include SorbetHelper
       include RBIFilesHelper
 
-      abstract!
-
-      sig do
-        params(
-          gem_names: T::Array[String],
-          exclude: T::Array[String],
-          include_dependencies: T::Boolean,
-          prerequire: T.nilable(String),
-          postrequire: String,
-          typed_overrides: T::Hash[String, String],
-          outpath: Pathname,
-          file_header: T::Boolean,
-          include_doc: T::Boolean,
-          include_loc: T::Boolean,
-          include_exported_rbis: T::Boolean,
-          number_of_workers: T.nilable(Integer),
-          auto_strictness: T::Boolean,
-          dsl_dir: String,
-          rbi_formatter: RBIFormatter,
-          halt_upon_load_error: T::Boolean,
-          lsp_addon: T.nilable(T::Boolean),
-        ).void
-      end
+      #: (gem_names: Array[String], exclude: Array[String], include_dependencies: bool, prerequire: String?, postrequire: String, typed_overrides: Hash[String, String], outpath: Pathname, file_header: bool, include_doc: bool, include_loc: bool, include_exported_rbis: bool, ?number_of_workers: Integer?, ?auto_strictness: bool, ?dsl_dir: String, ?rbi_formatter: RBIFormatter, ?halt_upon_load_error: bool, ?lsp_addon: bool?) -> void
       def initialize(
         gem_names:,
         exclude:,
@@ -65,18 +44,18 @@ module Tapioca
 
         super()
 
-        @bundle = T.let(Gemfile.new(exclude), Gemfile)
-        @existing_rbis = T.let(nil, T.nilable(T::Hash[String, String]))
-        @expected_rbis = T.let(nil, T.nilable(T::Hash[String, String]))
-        @include_doc = T.let(include_doc, T::Boolean)
-        @include_loc = T.let(include_loc, T::Boolean)
+        @bundle = Gemfile.new(exclude) #: Gemfile
+        @existing_rbis = nil #: Hash[String, String]?
+        @expected_rbis = nil #: Hash[String, String]?
+        @include_doc = include_doc #: bool
+        @include_loc = include_loc #: bool
         @include_exported_rbis = include_exported_rbis
         @halt_upon_load_error = halt_upon_load_error
       end
 
       private
 
-      sig { params(gem: Gemfile::GemSpec).void }
+      #: (Gemfile::GemSpec gem) -> void
       def compile_gem_rbi(gem)
         gem_name = set_color(gem.name, :yellow, :bold)
 
@@ -116,12 +95,12 @@ module Tapioca
         end
       end
 
-      sig { void }
+      #: -> void
       def perform_removals
         say("Removing RBI files of gems that have been removed:", [:blue, :bold])
         puts
 
-        anything_done = T.let(false, T::Boolean)
+        anything_done = false #: bool
 
         gems = removed_rbis
 
@@ -143,12 +122,12 @@ module Tapioca
         anything_done
       end
 
-      sig { void }
+      #: -> void
       def perform_additions
         say("Generating RBI files of gems that are added or updated:", [:blue, :bold])
         puts
 
-        anything_done = T.let(false, T::Boolean)
+        anything_done = false #: bool
 
         gems = added_rbis
 
@@ -186,34 +165,34 @@ module Tapioca
         anything_done
       end
 
-      sig { returns(T::Array[String]) }
+      #: -> Array[String]
       def removed_rbis
         (existing_rbis.keys - expected_rbis.keys).sort
       end
 
-      sig { params(gem_name: String).returns(Pathname) }
+      #: (String gem_name) -> Pathname
       def existing_rbi(gem_name)
         gem_rbi_filename(gem_name, T.must(existing_rbis[gem_name]))
       end
 
-      sig { returns(T::Array[String]) }
+      #: -> Array[String]
       def added_rbis
         expected_rbis.select do |name, value|
           existing_rbis[name] != value
         end.keys.sort
       end
 
-      sig { params(gem_name: String).returns(Pathname) }
+      #: (String gem_name) -> Pathname
       def expected_rbi(gem_name)
         gem_rbi_filename(gem_name, T.must(expected_rbis[gem_name]))
       end
 
-      sig { params(gem_name: String).returns(T::Boolean) }
+      #: (String gem_name) -> bool
       def gem_rbi_exists?(gem_name)
         existing_rbis.key?(gem_name)
       end
 
-      sig { params(diff: T::Hash[String, Symbol], command: Symbol).void }
+      #: (Hash[String, Symbol] diff, Symbol command) -> void
       def report_diff_and_exit_if_out_of_date(diff, command)
         if diff.empty?
           say("Nothing to do, all RBIs are up-to-date.")
@@ -222,7 +201,7 @@ module Tapioca
             build_error_for_files(cause, diff_for_cause.map(&:first))
           end.join("\n")
 
-          raise Thor::Error, <<~ERROR
+          raise Tapioca::Error, <<~ERROR
             #{set_color("RBI files are out-of-date. In your development environment, please run:", :green)}
               #{set_color("`#{default_command(command)}`", :green, :bold)}
             #{set_color("Once it is complete, be sure to commit and push any changes", :green)}
@@ -233,36 +212,36 @@ module Tapioca
         end
       end
 
-      sig { params(old_filename: Pathname, new_filename: Pathname).void }
+      #: (Pathname old_filename, Pathname new_filename) -> void
       def move(old_filename, new_filename)
         say("-> Moving: #{old_filename} to #{new_filename}")
         old_filename.rename(new_filename.to_s)
       end
 
-      sig { returns(T::Hash[String, String]) }
+      #: -> Hash[String, String]
       def existing_rbis
         @existing_rbis ||= Pathname.glob((@outpath / "*@*.rbi").to_s)
           .to_h { |f| T.cast(f.basename(".*").to_s.split("@", 2), [String, String]) }
       end
 
-      sig { returns(T::Hash[String, String]) }
+      #: -> Hash[String, String]
       def expected_rbis
         @expected_rbis ||= @bundle.dependencies
           .reject { |gem| @exclude.include?(gem.name) }
           .to_h { |gem| [gem.name, gem.version.to_s] }
       end
 
-      sig { params(gem_name: String, version: String).returns(Pathname) }
+      #: (String gem_name, String version) -> Pathname
       def gem_rbi_filename(gem_name, version)
         @outpath / "#{gem_name}@#{version}.rbi"
       end
 
-      sig { params(cause: Symbol, files: T::Array[String]).returns(String) }
+      #: (Symbol cause, Array[String] files) -> String
       def build_error_for_files(cause, files)
         "  File(s) #{cause}:\n  - #{files.join("\n  - ")}"
       end
 
-      sig { params(gem: Gemfile::GemSpec, file: RBI::File).void }
+      #: (Gemfile::GemSpec gem, RBI::File file) -> void
       def merge_with_exported_rbi(gem, file)
         return file unless gem.export_rbi_files?
 

data/lib/tapioca/commands/annotations.rb

@@ -6,15 +6,7 @@ module Tapioca
     class Annotations < CommandWithoutTracker
       extend T::Sig
 
-      sig do
-        params(
-          central_repo_root_uris: T::Array[String],
-          auth: T.nilable(String),
-          netrc_file: T.nilable(String),
-          central_repo_index_path: String,
-          typed_overrides: T::Hash[String, String],
-        ).void
-      end
+      #: (central_repo_root_uris: Array[String], ?auth: String?, ?netrc_file: String?, ?central_repo_index_path: String, ?typed_overrides: Hash[String, String]) -> void
       def initialize(
         central_repo_root_uris:,
         auth: nil,
@@ -23,19 +15,20 @@ module Tapioca
         typed_overrides: {}
       )
         super()
-        @outpath = T.let(Pathname.new(DEFAULT_ANNOTATIONS_DIR), Pathname)
+        @outpath = Pathname.new(DEFAULT_ANNOTATIONS_DIR) #: Pathname
         @central_repo_root_uris = central_repo_root_uris
         @auth = auth
         @netrc_file = netrc_file
-        @netrc_info = T.let(nil, T.nilable(Netrc))
-        @tokens = T.let(repo_tokens, T::Hash[String, T.nilable(String)])
-        @indexes = T.let({}, T::Hash[String, RepoIndex])
+        @netrc_info = nil #: Netrc?
+        @tokens = repo_tokens #: Hash[String, String?]
+        @indexes = {} #: Hash[String, RepoIndex]
         @typed_overrides = typed_overrides
       end
 
       private
 
-      sig { override.void }
+      # @override
+      #: -> void
       def execute
         @indexes = fetch_indexes
         project_gems = list_gemfile_gems
@@ -46,7 +39,7 @@ module Tapioca
         GitAttributes.create_vendored_attribute_file(@outpath)
       end
 
-      sig { returns(T::Array[GemInfo]) }
+      #: -> Array[GemInfo]
       def list_gemfile_gems
         say("Listing gems from Gemfile.lock... ", [:blue, :bold])
         gemfile = Bundler.read_file("Gemfile.lock")
@@ -56,7 +49,7 @@ module Tapioca
         gem_info
       end
 
-      sig { params(project_gems: T::Array[GemInfo]).void }
+      #: (Array[GemInfo] project_gems) -> void
       def remove_expired_annotations(project_gems)
         say("Removing annotations for gems that have been removed... ", [:blue, :bold])
 
@@ -77,11 +70,11 @@ module Tapioca
         say("\nDone\n\n", :green)
       end
 
-      sig { returns(T::Hash[String, RepoIndex]) }
+      #: -> Hash[String, RepoIndex]
       def fetch_indexes
         multiple_repos = @central_repo_root_uris.size > 1
         repo_number = 1
-        indexes = T.let({}, T::Hash[String, RepoIndex])
+        indexes = {} #: Hash[String, RepoIndex]
 
         @central_repo_root_uris.each do |uri|
           index = fetch_index(uri, repo_number: multiple_repos ? repo_number : nil)
@@ -92,13 +85,13 @@ module Tapioca
         end
 
         if indexes.empty?
-          raise Thor::Error, set_color("Can't fetch annotations without sources (no index fetched)", :bold, :red)
+          raise Tapioca::Error, set_color("Can't fetch annotations without sources (no index fetched)", :bold, :red)
         end
 
         indexes
       end
 
-      sig { params(repo_uri: String, repo_number: T.nilable(Integer)).returns(T.nilable(RepoIndex)) }
+      #: (String repo_uri, repo_number: Integer?) -> RepoIndex?
       def fetch_index(repo_uri, repo_number:)
         say("Retrieving index from central repository#{repo_number ? " ##{repo_number}" : ""}... ", [:blue, :bold])
         content = fetch_file(repo_uri, CENTRAL_REPO_INDEX_PATH)
@@ -109,10 +102,10 @@ module Tapioca
         index
       end
 
-      sig { params(project_gems: T::Array[GemInfo]).returns(T::Array[String]) }
+      #: (Array[GemInfo] project_gems) -> Array[String]
       def fetch_annotations(project_gems)
         say("Fetching gem annotations from central repository... ", [:blue, :bold])
-        fetchable_gems = T.let(Hash.new { |h, k| h[k] = [] }, T::Hash[GemInfo, T::Array[String]])
+        fetchable_gems = Hash.new { |h, k| h[k] = [] } #: Hash[GemInfo, Array[String]]
 
         project_gems.each_with_object(fetchable_gems) do |gem_info, hash|
           @indexes.each do |uri, index|
@@ -132,7 +125,7 @@ module Tapioca
         fetched_gems.keys.map(&:name).sort
       end
 
-      sig { params(repo_uris: T::Array[String], gem_info: GemInfo).void }
+      #: (Array[String] repo_uris, GemInfo gem_info) -> bool
       def fetch_annotation(repo_uris, gem_info)
         gem_name = gem_info.name
         gem_version = gem_info.version
@@ -142,7 +135,7 @@ module Tapioca
         end
 
         content = merge_files(gem_name, contents.compact)
-        return unless content
+        return false unless content
 
         content = apply_typed_override(gem_name, content)
         content = filter_versions(gem_version, content)
@@ -150,9 +143,10 @@ module Tapioca
 
         say("\n  Fetched #{set_color(gem_name, :yellow, :bold)}", :green)
         create_file(@outpath.join("#{gem_name}.rbi"), content)
+        true
       end
 
-      sig { params(repo_uri: String, path: String).returns(T.nilable(String)) }
+      #: (String repo_uri, String path) -> String?
       def fetch_file(repo_uri, path)
         if repo_uri.start_with?(%r{https?://})
           fetch_http_file(repo_uri, path)
@@ -161,7 +155,7 @@ module Tapioca
         end
       end
 
-      sig { params(repo_uri: String, path: String).returns(T.nilable(String)) }
+      #: (String repo_uri, String path) -> String?
       def fetch_local_file(repo_uri, path)
         File.read("#{repo_uri}/#{path}")
       rescue => e
@@ -169,7 +163,7 @@ module Tapioca
         nil
       end
 
-      sig { params(repo_uri: String, path: String).returns(T.nilable(String)) }
+      #: (String repo_uri, String path) -> String?
       def fetch_http_file(repo_uri, path)
         auth = @tokens[repo_uri]
         uri = URI("#{repo_uri}/#{path}")
@@ -193,7 +187,7 @@ module Tapioca
         nil
       end
 
-      sig { params(name: String, content: String).returns(String) }
+      #: (String name, String content) -> String
       def add_header(name, content)
         # WARNING: Changing this header could impact how GitHub determines if the file should be hidden:
         # https://github.com/github/linguist/pull/6143
@@ -213,7 +207,7 @@ module Tapioca
         end
       end
 
-      sig { params(name: String, content: String).returns(String) }
+      #: (String name, String content) -> String
       def apply_typed_override(name, content)
         strictness = @typed_overrides[name]
         return content unless strictness
@@ -225,7 +219,7 @@ module Tapioca
         Spoom::Sorbet::Sigils.update_sigil(content, strictness)
       end
 
-      sig { params(gem_version: ::Gem::Version, content: String).returns(String) }
+      #: (::Gem::Version gem_version, String content) -> String
       def filter_versions(gem_version, content)
         rbi = RBI::Parser.parse_string(content)
         rbi.filter_versions!(gem_version)
@@ -233,7 +227,7 @@ module Tapioca
         rbi.string
       end
 
-      sig { params(gem_name: String, contents: T::Array[String]).returns(T.nilable(String)) }
+      #: (String gem_name, Array[String] contents) -> String?
       def merge_files(gem_name, contents)
         return if contents.empty?
 
@@ -260,7 +254,7 @@ module Tapioca
         nil
       end
 
-      sig { returns(T::Hash[String, T.nilable(String)]) }
+      #: -> Hash[String, String?]
       def repo_tokens
         @netrc_info = Netrc.read(@netrc_file) if @netrc_file
         @central_repo_root_uris.filter_map do |uri|
@@ -272,7 +266,7 @@ module Tapioca
         end.to_h
       end
 
-      sig { params(repo_uri: String).returns(T.nilable(String)) }
+      #: (String repo_uri) -> String?
       def token_for(repo_uri)
         return unless @netrc_info
 
@@ -288,7 +282,7 @@ module Tapioca
         "token #{token}"
       end
 
-      sig { params(path: String, repo_uri: String, message: String).void }
+      #: (String path, String repo_uri, message: String) -> void
       def say_http_error(path, repo_uri, message:)
         say_error("\nCan't fetch file `#{path}` from #{repo_uri} (#{message})\n\n", :bold, :red)
         say_error(<<~ERROR)