sord 6.0.0 → 7.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 54bd59da2188e5392c6946e2cbd77ce55e1113abc40a2cf880671afe3c22efac
-  data.tar.gz: 9671e16277cba3b800d8dc4dcae525384064efd1138575eef441719624ebf45d
+  metadata.gz: 8f9681f7b1837fb0fb51588fb60d8bb94406b9bb9a488670244542971b0b66c7
+  data.tar.gz: 7db1dc6e7a1e3cf43d08ef6850da15eaebf18463fb5a329cdf42acb7da12c0a0
 SHA512:
-  metadata.gz: f9c0ca7bc3d427367fe069cc415e37a0250ad7c3010ebbfa119dbdd97f98b474da0a7092277f2f45810d376654545b930b3c59a7a537f4132a23ad68352f913d
-  data.tar.gz: 8b6ced8d20985ee9faaae5b672ebd90bd4ef00d396938e7db1e6fecf350d817b143db55eca1231782bf2c0bd5605394eac825d8fa612ff7e093fc0f3ce27e14c
+  metadata.gz: 84ae70452bf558690f4da7c7fb6c2b1ba65b4cf906a813b04c27766b7ad7ddb549013b49f149593c0a4366016689c0f21f904c09cd3533a19f42ea814655fea7
+  data.tar.gz: 349e397a495df5dd01d7a13eac6541f9d2b0446dbc150e74be756dbc02ead11e7c558ec27f111d852f6c39f4719deb6ba6c56bffed99a44af5a11570f20ea3fc

data/.github/workflows/examples.yml

@@ -0,0 +1,22 @@
+name: Run Sord on examples
+
+on: [push, pull_request]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    continue-on-error: false
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Ruby
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: 3.4 # Use latest for best chance of dependencies resolving
+    - name: Install dependencies
+      run: bundle install
+    - name: Install example dependencies
+      run: sudo apt-get install libldap2-dev libidn11-dev # Dependencies for `addressable`
+    - name: Run examples (RBI)
+      run: bundle exec rake examples:seed[rbi]
+    - name: Run examples (RBS)
+      run: bundle exec rake examples:reseed[rbs]

data/.github/workflows/ruby.yml

@@ -6,7 +6,7 @@ jobs:
   test:
     strategy:
       matrix:
-        ruby: [2.7, 3.0, 3.1]
+        ruby: [3.0, 3.1, 3.2, 3.3, 3.4]
     continue-on-error: false
 
     runs-on: ubuntu-latest

data/CHANGELOG.md

@@ -3,6 +3,42 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
+## [7.1.0] - 2025-07-07
+### Added
+- `nil` can be used as an alias for `NilClass` in more places in YARD types. (Thanks @apiology)
+- The Solargraph convention `undefined` can now be used as an "untyped" type. (Thanks @apiology)
+
+### Changed
+- If a constant's value does not parse successfully, type information can still be generated for
+  that constant, and Sord emits a warning. Previously, this would cause a fatal exception.
+- The version restriction on the RBS gem has been relaxed, to permit usage of 4.x versions.
+  RBS 3.x can still be used as before.
+  (Thanks @apiology)
+
+### Fixed
+- Sord now correctly resolves namespaces when classes have a namespace, e.g. `class X::Y`.
+  (Thanks @dorner)
+
+## [7.0.0] - 2025-03-03
+### Added
+- Messages now show the file and line number that the message originated from. (Thanks @apiology)
+- Sord will now recognise `Class<T, E>` as an equivalent of `Class<T>, Class<E>`, similar to the
+  existing behaviour for `Array`. (Thanks @tomoasleep)
+
+### Changed
+- **Breaking change**: Now uses Commander 5.0 to support Ruby 3.3. This increases the minimum
+  required Ruby version to 3.0.
+- **Breaking change**: Parlour version has been bumped significantly, from 5.0 to 9.1. This may be
+  relevant if you're using other Parlour plugins alongside Sord.
+
+### Fixed
+- Sord now generates correct RBI when heredoc strings are used in constants. (Thanks @apiology)
+- Fixed error when using as a Parlour plugin, but without any custom tags defined. (Thanks
+  @dsisnero)
+- Fixed incorrect precedence when union types were nested inside hashes. (Thanks @apiology)
+- Sord now adds `::` when required, to disambiguate nested namespaces from top-level ones. (Thanks
+  @sinsoku)
+
 ## [6.0.0] - 2023-05-02
 ### Changed
 - **Breaking change**: Now targets RBS 3.0

data/Gemfile

@@ -2,3 +2,7 @@ source "https://rubygems.org"
 
 # Specify your gem's dependencies in sord.gemspec
 gemspec
+
+# Not in gemspec so it doesn't get distributed or depended on by the built gem.
+# Used by resolver tests, to ensure Sord can import bundled RBIs from gems.
+gem 'resolver-test', path: 'spec/resolver-test-gem'

data/Rakefile

@@ -19,85 +19,138 @@ REPOS = {
   zeitwerk: 'https://github.com/fxn/zeitwerk'
 }
 
-namespace :examples do
-  require 'fileutils'
-  require 'rainbow'
+# Thrown by tasks to present a "friendly" error message and abort the task.
+class TaskError < StandardError
+end
 
-  desc "Clone git repositories and run Sord on them as examples"
-  task :seed, [:mode, :clean] do |t, args|
-    if File.directory?('sord_examples')
-      puts Rainbow('sord_examples directory already exists, please delete the directory or run a reseed!').red
-      exit
-    end
+# Handles Sord examples, including checkout and running Sord to generate types.
+class ExampleRunner
+  attr_reader :mode, :mode_arg, :clean
+  alias clean? clean
+
+  # @return [<Symbol>] Names of gems where Sord failed.
+  attr_accessor :failed_examples
 
-    if args[:mode] == 'rbi'
-      mode_arg = '--rbi'
-    elsif args[:mode] == 'rbs'
-      mode_arg = '--rbs'
+  # @param [String] mode "rbi" or "rbs".
+  # @param [Boolean] clean Run Sord with additional options to generate minimal type output.
+  def initialize(mode:, clean: false)
+    @mode = mode
+    @clean = clean
+
+    if mode == 'rbi'
+      @mode_arg = '--rbi'
+    elsif mode == 'rbs'
+      @mode_arg = '--rbs'
     else
-      puts Rainbow('please specify \'rbi\' or \'rbs\'!').red
-      exit
+      raise TaskError, 'please specify \'rbi\' or \'rbs\'!'
+    end
+
+    @failed_examples = []
+  end
+
+  # Create the `sord_examples` directory, ready for checkouts.
+  # @raise [TaskError] If it already exists.
+  def create_examples_dir
+    if File.directory?(File.join(__dir__, 'sord_examples'))
+      raise TaskError, 'sord_examples directory already exists, please delete the directory or run a reseed!'
     end
 
     FileUtils.mkdir 'sord_examples'
-    FileUtils.cd 'sord_examples'
-    
-    Bundler.with_clean_env do
-      # Shallow clone each of the repositories, then bundle install and run sord.
-      REPOS.each do |name, url|
-        puts "Cloning #{name}..."
-        system("git clone #{url} --depth=1")
-        FileUtils.cd name.to_s
+  end
+
+  # Check that the `sord_examples` directory exists.
+  # @raise [TaskError] If it doesn't.
+  def validate_examples_dir
+    unless File.directory?(File.join(__dir__, 'sord_examples'))
+      raise TaskError, 'The sord_examples directory does not exist. Have you run the seed task?'
+    end
+  end
+
+  # Check out a repository, add Sord to its Gemfile, and install its dependencies.
+  # @param [Symbol] name Name of the checkout.
+  # @param [String] url Git URL.
+  def prepare_checkout(name, url)
+    Dir.chdir(File.join(__dir__, 'sord_examples')) do
+      puts "Cloning #{name}..."
+      system("git clone #{url} --depth=1")
+
+      Dir.chdir(name.to_s) do
         # Add sord to gemfile.
         `echo "gem 'sord', path: '../../'" >> Gemfile`
+
         # Run bundle install.
         system('bundle install')
-        # Generate sri
-        puts "Generating rbi for #{name}..."
-        if args[:clean]
-          system("bundle exec sord ../#{name}.#{args[:mode]} #{mode_arg} --no-sord-comments --replace-errors-with-untyped --replace-unresolved-with-untyped")
-        else
-          system("bundle exec sord ../#{name}.#{args[:mode]} #{mode_arg}")
-        end
-        puts "#{name}.#{args[:mode]} generated!"
-        FileUtils.cd '..'
       end
     end
+  end
 
-    puts Rainbow("Seeding complete!").green
+  # Run Sord on a checked-out repository.
+  # @param [Symbol] name Name of the checkout.
+  def generate_types(name)
+    puts "Generating rbi for #{name}..."
+
+    Dir.chdir(File.join(__dir__, 'sord_examples', name.to_s)) do
+      if clean?
+        system("bundle exec sord ../#{name}.#{mode} #{mode_arg} --no-sord-comments --replace-errors-with-untyped --replace-unresolved-with-untyped")
+      else
+        system("bundle exec sord ../#{name}.#{mode} #{mode_arg}")
+      end
+
+      if $?.success?
+        puts "#{name}.#{mode} generated!"
+      else
+        puts "Sord exited with error"
+        failed_examples << name
+      end
+    end
   end
 
-  desc 'Regenerate the rbi files in sord_examples.'
-  task :reseed, [:mode, :clean] do |t, args|
-    if Dir.exist?('sord_examples')
-      FileUtils.cd 'sord_examples'
-    else
-      raise Rainbow("The sord_examples directory does not exist. Have you run the seed task?").red.bold
+  # Check that all Sord executions were successful.
+  # @raise [TaskError] If any failed.
+  def validate_sord_success
+    if failed_examples.any?
+      raise TaskError, "Not all Sord runs were successful: #{failed_examples.map(&:to_s).join(', ')}"
     end
+  end
+end
 
-    if args[:mode] == 'rbi'
-      mode_arg = '--rbi'
-    elsif args[:mode] == 'rbs'
-      mode_arg = '--rbs'
-    else
-      puts Rainbow('please specify \'rbi\' or \'rbs\'!').red
-      exit
+namespace :examples do
+  require 'fileutils'
+  require 'rainbow'
+
+  desc "Clone git repositories and run Sord on them as examples"
+  task :seed, [:mode, :clean] do |t, args|
+    examples = ExampleRunner.new(**args)
+    examples.create_examples_dir
+
+    Bundler.with_clean_env do
+      REPOS.each do |name, url|
+        examples.prepare_checkout(name, url)
+        examples.generate_types(name)
+      end
     end
+    examples.validate_sord_success
+
+    puts Rainbow("Seeding complete!").green
+
+  rescue TaskError => e
+    abort Rainbow(e.to_s).red
+  end
+
+  desc 'Regenerate the rbi files in sord_examples.'
+  task :reseed, [:mode, :clean] do |t, args|
+    examples = ExampleRunner.new(**args)
+    examples.validate_examples_dir
 
     REPOS.keys.each do |name|
-      FileUtils.cd name.to_s
-      puts "Regenerating rbi file for #{name}..."
-      Bundler.with_clean_env do
-        if args[:clean]
-          system("bundle exec sord ../#{name}.#{args[:mode]} #{mode_arg} --no-regenerate --no-sord-comments --replace-errors-with-untyped --replace-unresolved-with-untyped")
-        else
-          system("bundle exec sord ../#{name}.#{args[:mode]} #{mode_arg} --no-regenerate")
-        end
-      end
-      FileUtils.cd '..'
+      examples.generate_types(name)
     end
+    examples.validate_sord_success
 
     puts Rainbow("Re-seeding complete!").green
+
+  rescue TaskError => e
+    abort Rainbow(e.to_s).red
   end
   
   desc 'Delete the sord_examples directory to allow the seeder to run again.'

data/lib/sord/generator.rb

@@ -4,6 +4,7 @@ require 'sord/type_converter'
 require 'sord/logging'
 require 'parlour'
 require 'rainbow'
+require 'parser/current'
 
 module Sord
   # Converts the current working directory's YARD registry into an type
@@ -80,7 +81,6 @@ module Sord
 
       # Hook the logger so that warnings are collected
       Logging.add_hook do |type, msg, item|
-        # TODO: is it possible to get line numbers here?
         warnings << [msg, item, 0] if type == :warn
       end
     end
@@ -141,7 +141,32 @@ module Sord
         # Add the constant to the current object being generated.
         case @mode
         when :rbi
-          @current_object.create_constant(constant_name, value: "T.let(#{constant.value}, T.untyped)") do |c|
+          # Parse so we can set up constant with correct heredoc syntax
+          kwargs = {}
+
+          value = constant.value
+          begin
+            value_node = Parser::CurrentRuby.parse(constant.value)
+            loc = value_node.loc
+            if loc.instance_of? Parser::Source::Map::Heredoc
+              #
+              # heredocs in Ruby come after the full expression is complete.  e.g.,
+              # puts(>>FOO)
+              #   bar
+              # FOO
+              #
+              # so if we want to wrap them in a T.let, we need to parse out the expression vs the rest
+              kwargs[:heredocs] = constant.value[loc.heredoc_body.begin_pos...loc.heredoc_end.end_pos]
+              expression = loc.expression
+              value = constant.value[expression.begin_pos...expression.end_pos]
+            end
+
+          rescue Parser::SyntaxError => e
+            # Emit a warning, since this may cause a syntax error when parsing the RBI
+            Logging.warn("syntax error on constant value: #{e}", constant)
+          end
+
+          @current_object.create_constant(constant_name, value: "T.let(#{value}, T.untyped)", **kwargs) do |c|
             c.add_comments(constant.docstring.all.split("\n"))
           end
         when :rbs
@@ -582,8 +607,10 @@ module Sord
       return if @hide_private && item.visibility == :private
       count_namespace
 
-      superclass = nil
-      superclass = item.superclass.path.to_s if item.type == :class && item.superclass.to_s != "Object"
+      if item.type == :class && item.superclass.to_s != "Object"
+        prefix = "::" if item.name.to_s == item.superclass.path
+        superclass = "#{prefix}#{item.superclass.path}"
+      end
 
       parent = @current_object
       @current_object = item.type == :class \
@@ -651,14 +678,18 @@ module Sord
         Logging.warn("Please edit the file to fix these errors.")
         Logging.warn("Alternatively, edit your YARD documentation so that your types are valid and re-run Sord.")
         warnings.each do |(msg, item, _)|
-          puts "        (#{Rainbow(item&.path).bold}) #{msg}"
+          message = if item
+                      (filename, line), = item.files
+                      "        #{Rainbow("(#{item.path}) #{filename}:#{line}:").bold} #{msg}"
+                    else
+                      "        #{msg}"
+                   end
+          puts message
         end
       end
     rescue
-      Logging.error($!)
-      $@.each do |line|
-        puts "         #{line}"
-      end
+      Logging.error("An internal error occurred while running Sord: #{$!}")
+      raise
     end
 
     # Given two pairs of arrays representing method parameters, in the form

data/lib/sord/logging.rb

@@ -74,7 +74,8 @@ module Sord
       return unless enabled_types.include?(kind)
 
       message = if item
-        "#{header} (#{Rainbow(item.path).bold}) #{msg}"
+        (filename, line), = item.files
+        "#{header} #{Rainbow("(#{item.path}) #{filename}:#{line}:").bold} #{msg}"
       else
         "#{header} #{msg}"
       end

data/lib/sord/parlour_plugin.rb

@@ -80,6 +80,7 @@ module Sord
     end
 
     def add_custom_tags
+      return unless options[:tags]
       return if options[:tags].empty?
 
       options[:tags].each do |tag|

data/lib/sord/resolver.rb

@@ -70,14 +70,21 @@ module Sord
       klasses = [
         Parlour::RbiGenerator::Constant,
         Parlour::RbiGenerator::ModuleNamespace,
-        Parlour::RbiGenerator::ClassNamespace
+        Parlour::RbiGenerator::ClassNamespace,
+        Parlour::RbiGenerator::Namespace
+      ]
+      child_only_classes = [
+        Parlour::RbiGenerator::Namespace
       ]
       nodes.each do |node|
-        next unless klasses.include?(node.class)
-        new_path = path + [node.name]
-        names_to_paths[node.name] ||= Set.new
-        names_to_paths[node.name] << new_path.join('::')
-        add_rbi_objects_to_paths(node.children, names_to_paths, new_path) if node.respond_to?(:children)
+        if klasses.include?(node.class)
+          new_path = path + [node.name]
+          unless child_only_classes.include?(node.class)
+            names_to_paths[node.name] ||= Set.new
+            names_to_paths[node.name] << new_path.join('::')
+          end
+          add_rbi_objects_to_paths(node.children, names_to_paths, new_path) if node.respond_to?(:children)
+        end
       end
     end
 

data/lib/sord/type_converter.rb

@@ -24,7 +24,7 @@ module Sord
     # Matches valid method names.
     # From: https://stackoverflow.com/a/4379197/2626000
     METHOD_NAME_REGEX =
-      /(?:[a-z_]\w*[?!=]?|\[\]=?|<<|>>|\*\*|[!~+\*\/%&^|-]|[<>]=?|<=>|={2,3}|![=~]|=~)/i 
+      /(?:[a-z_]\w*[?!=]?|\[\]=?|<<|>>|\*\*|[!~+\*\/%&^|-]|[<>]=?|<=>|={2,3}|![=~]|=~)/i
 
     # Match duck types which require the object implement one or more methods,
     # like '#foo', '#foo & #bar', '#foo&#bar&#baz', and '#foo&#bar&#baz&#foo_bar'.
@@ -76,13 +76,15 @@ module Sord
         end
 
         # Handle hash rockets as separators.
-        # e.g. Hash<Symbol => String>
+        # e.g. Hash<Symbol => String> or Hash<Symbol, String => Integer>
         if params[character_pointer] == '=' && params[character_pointer + 1] == '>'
           if current_bracketing_level == 0
             character_pointer += 1
             result << buffer.strip
             buffer = ""
-            should_buffer = false
+            # commas are higher precedence
+            result = [result] if result.length > 1
+            return [result.first, split_type_parameters(params[character_pointer+1..-1].strip)]
           end
         end
 
@@ -127,8 +129,12 @@ module Sord
       case yard
       when nil # Type not specified
         Parlour::Types::Untyped.new
+      when "nil"
+        Parlour::Types::Raw.new('NilClass')
       when  "bool", "Bool", "boolean", "Boolean", "true", "false"
         Parlour::Types::Boolean.new
+      when "undefined" # solargraph convention
+        Parlour::Types::Untyped.new
       when 'self'
         Parlour::Types::Self.new
       when Array
@@ -193,12 +199,17 @@ module Sord
         relative_generic_type = generic_type.start_with?('::') \
           ? generic_type[2..-1] : generic_type
 
-        parameters = split_type_parameters(type_parameters)
+        yard_parameters = split_type_parameters(type_parameters)
+        parameters = yard_parameters
           .map { |x| yard_to_parlour(x, item, config) }
-        if SINGLE_ARG_GENERIC_TYPES.include?(relative_generic_type) && parameters.length > 1
-          Parlour::Types.const_get(relative_generic_type).new(Parlour::Types::Union.new(parameters))
-        elsif relative_generic_type == 'Class' && parameters.length == 1
-          Parlour::Types::Class.new(parameters.first)
+        if SINGLE_ARG_GENERIC_TYPES.include?(relative_generic_type) && yard_parameters.length > 1
+          Parlour::Types.const_get(relative_generic_type).new(yard_to_parlour(yard_parameters, item, config))
+        elsif relative_generic_type == 'Class'
+          if parameters.length == 1
+            Parlour::Types::Class.new(parameters.first)
+          else
+            Parlour::Types::Union.new(parameters.map { |x| Parlour::Types::Class.new(x) })
+          end
         elsif relative_generic_type == 'Hash'
           if parameters.length == 2
             Parlour::Types::Hash.new(*parameters)

data/lib/sord/version.rb

@@ -1,4 +1,4 @@
 # typed: strong
 module Sord
-  VERSION = '6.0.0'
+  VERSION = '7.1.0'
 end

data/rbi/sord.rbi

@@ -1,7 +1,7 @@
 # typed: strong
 # typed: strong
 module Sord
-  VERSION = T.let('5.0.0', T.untyped)
+  VERSION = T.let('7.1.0', T.untyped)
 
   # Handles writing logs to stdout and any other classes which request them.
   module Logging
@@ -178,12 +178,12 @@ module Sord
     sig { params(hash: T.untyped).returns(T.untyped) }
     def self.load_gem_objects(hash); end
 
-    # sord omit - no YARD type given for "all_decls", using untyped
+    # sord omit - no YARD type given for "env", using untyped
     # sord omit - no YARD type given for "names_to_paths", using untyped
     # sord omit - no YARD type given for "path", using untyped
     # sord omit - no YARD return type given, using untyped
-    sig { params(all_decls: T.untyped, names_to_paths: T.untyped, path: T.untyped).returns(T.untyped) }
-    def self.add_rbs_objects_to_paths(all_decls, names_to_paths, path = []); end
+    sig { params(env: T.untyped, names_to_paths: T.untyped, path: T.untyped).returns(T.untyped) }
+    def self.add_rbs_objects_to_paths(env, names_to_paths, path = []); end
 
     # sord omit - no YARD type given for "nodes", using untyped
     # sord omit - no YARD type given for "names_to_paths", using untyped
@@ -253,6 +253,7 @@ module Sord
     def add_constants(item); end
 
     # sord warn - YARD::CodeObjects::NamespaceObject wasn't able to be resolved to a constant in this project
+    # sord warn - Parlour::TypedObject wasn't able to be resolved to a constant in this project
     # Adds comments to an object based on a docstring.
     # 
     # _@param_ `item`
@@ -415,6 +416,7 @@ module Sord
     def self.split_type_parameters(params); end
 
     # sord warn - YARD::CodeObjects::Base wasn't able to be resolved to a constant in this project
+    # sord warn - Parlour::Types::Type wasn't able to be resolved to a constant in this project
     # Converts a YARD type into a Parlour type.
     # 
     # _@param_ `yard` — The YARD type.
@@ -425,7 +427,9 @@ module Sord
     sig { params(yard: T.any(T::Boolean, T::Array[T.untyped], String), item: YARD::CodeObjects::Base, config: Configuration).returns(Parlour::Types::Type) }
     def self.yard_to_parlour(yard, item, config); end
 
+    # sord warn - Parlour::Types::Type wasn't able to be resolved to a constant in this project
     # sord warn - YARD::CodeObjects::Base wasn't able to be resolved to a constant in this project
+    # sord warn - Parlour::Types::Type wasn't able to be resolved to a constant in this project
     # Handles SORD_ERRORs.
     # 
     # _@param_ `name`
@@ -445,6 +449,7 @@ module Sord
     end
     def self.handle_sord_error(name, log_warning, item, replace_errors_with_untyped); end
 
+    # sord warn - Parlour::Types::Type wasn't able to be resolved to a constant in this project
     # Given a YARD duck type string, attempts to convert it to one of a list of pre-defined RBS
     # built-in interfaces.
     # 

data/sord.gemspec

@@ -24,9 +24,10 @@ Gem::Specification.new do |spec|
 
   spec.add_dependency 'yard'
   spec.add_dependency 'sorbet-runtime'
-  spec.add_dependency 'commander', '~> 4.5'
-  spec.add_dependency 'parlour', '~> 5.0'
-  spec.add_dependency 'rbs', '~> 3.0'
+  spec.add_dependency 'commander', '~> 5.0'
+  spec.add_dependency "parser"
+  spec.add_dependency 'parlour', '~> 9.1'
+  spec.add_dependency 'rbs', '>=3.0', '<5'
 
   spec.add_development_dependency "bundler", "~> 2.0"
   spec.add_development_dependency "rake", "~> 13.0"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sord
 version: !ruby/object:Gem::Version
-  version: 6.0.0
+  version: 7.1.0
 platform: ruby
 authors:
 - Aaron Christiansen
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-05-22 00:00:00.000000000 Z
+date: 2025-07-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: yard
@@ -44,42 +44,62 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '4.5'
+        version: '5.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '4.5'
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: parser
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: parlour
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: '9.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: '9.1'
 - !ruby/object:Gem::Dependency
   name: rbs
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '3.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '3.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '5'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -160,6 +180,7 @@ extra_rdoc_files: []
 files:
 - ".github/ISSUE_TEMPLATE/bug_report.md"
 - ".github/ISSUE_TEMPLATE/feature-request.md"
+- ".github/workflows/examples.yml"
 - ".github/workflows/ruby.yml"
 - ".gitignore"
 - ".parlour"
@@ -200,7 +221,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.22
+rubygems_version: 3.4.1
 signing_key:
 specification_version: 4
 summary: Generate Sorbet RBI files from YARD documentation