pigeonhole-db 1.1.0

data/vendor/bundle/ruby/3.4.0/gems/rbs-4.2.0/stdlib/psych/0/dbm.rbs

@@ -0,0 +1,237 @@
+%a{annotate:rdoc:skip}
+module Psych
+  # <!-- rdoc-file=lib/yaml/dbm.rb -->
+  # YAML + DBM = YDBM
+  #
+  # YAML::DBM provides the same interface as ::DBM.
+  #
+  # However, while DBM only allows strings for both keys and values, this library
+  # allows one to use most Ruby objects for values by first converting them to
+  # YAML. Keys must be strings.
+  #
+  # Conversion to and from YAML is performed automatically.
+  #
+  # See the documentation for ::DBM and ::YAML for more information.
+  #
+  class DBM < ::DBM
+    VERSION: ::String
+
+    # <!--
+    #   rdoc-file=lib/yaml/dbm.rb
+    #   - ydbm[key] -> value
+    # -->
+    # Return value associated with `key` from database.
+    #
+    # Returns `nil` if there is no such `key`.
+    #
+    # See #fetch for more information.
+    #
+    def []: (String key) -> untyped
+
+    # <!--
+    #   rdoc-file=lib/yaml/dbm.rb
+    #   - ydbm[key] = value
+    # -->
+    # Set `key` to `value` in database.
+    #
+    # `value` will be converted to YAML before storage.
+    #
+    # See #store for more information.
+    #
+    def []=: (String key, untyped val) -> untyped
+
+    # <!--
+    #   rdoc-file=lib/yaml/dbm.rb
+    #   - ydbm.fetch( key, ifnone = nil )
+    #   - ydbm.fetch( key ) { |key| ... }
+    # -->
+    # Return value associated with `key`.
+    #
+    # If there is no value for `key` and no block is given, returns `ifnone`.
+    #
+    # Otherwise, calls block passing in the given `key`.
+    #
+    # See ::DBM#fetch for more information.
+    #
+    def fetch: (String keystr, ?untyped? ifnone) { (untyped) -> untyped } -> untyped
+
+    # <!--
+    #   rdoc-file=lib/yaml/dbm.rb
+    #   - index( keystr )
+    # -->
+    # Deprecated, used YAML::DBM#key instead.
+    # ---
+    # Note: YAML::DBM#index makes warning from internal of ::DBM#index. It says
+    # 'DBM#index is deprecated; use DBM#key', but DBM#key behaves not same as
+    # DBM#index.
+    #
+    def index: (String keystr) -> untyped
+
+    # <!--
+    #   rdoc-file=lib/yaml/dbm.rb
+    #   - ydbm.key(value) -> string
+    # -->
+    # Returns the key for the specified value.
+    #
+    def key: (String keystr) -> String
+
+    # <!--
+    #   rdoc-file=lib/yaml/dbm.rb
+    #   - ydbm.values_at(*keys)
+    # -->
+    # Returns an array containing the values associated with the given keys.
+    #
+    def values_at: (*untyped keys) -> Array[untyped]
+
+    # <!--
+    #   rdoc-file=lib/yaml/dbm.rb
+    #   - ydbm.delete(key)
+    # -->
+    # Deletes value from database associated with `key`.
+    #
+    # Returns value or `nil`.
+    #
+    def delete: (String key) -> untyped
+
+    # <!--
+    #   rdoc-file=lib/yaml/dbm.rb
+    #   - ydbm.delete_if { |key, value| ... }
+    # -->
+    # Calls the given block once for each `key`, `value` pair in the database.
+    # Deletes all entries for which the block returns true.
+    #
+    # Returns `self`.
+    #
+    def delete_if: () { (untyped, untyped) -> untyped } -> untyped
+
+    # <!--
+    #   rdoc-file=lib/yaml/dbm.rb
+    #   - ydbm.reject { |key, value| ... }
+    # -->
+    # Converts the contents of the database to an in-memory Hash, then calls
+    # Hash#reject with the specified code block, returning a new Hash.
+    #
+    def reject: () { (untyped, untyped) -> untyped } -> Hash[untyped, untyped]
+
+    # <!--
+    #   rdoc-file=lib/yaml/dbm.rb
+    #   - ydbm.each_pair { |key, value| ... }
+    # -->
+    # Calls the given block once for each `key`, `value` pair in the database.
+    #
+    # Returns `self`.
+    #
+    def each_pair: () { (untyped, untyped) -> untyped } -> untyped
+
+    # <!--
+    #   rdoc-file=lib/yaml/dbm.rb
+    #   - ydbm.each_value { |value| ... }
+    # -->
+    # Calls the given block for each value in database.
+    #
+    # Returns `self`.
+    #
+    def each_value: () { (untyped) -> untyped } -> untyped
+
+    # <!--
+    #   rdoc-file=lib/yaml/dbm.rb
+    #   - ydbm.values
+    # -->
+    # Returns an array of values from the database.
+    #
+    def values: () -> untyped
+
+    # <!--
+    #   rdoc-file=lib/yaml/dbm.rb
+    #   - ydbm.has_value?(value)
+    # -->
+    # Returns true if specified `value` is found in the database.
+    #
+    def has_value?: (untyped val) -> (::TrueClass | ::FalseClass)
+
+    # <!--
+    #   rdoc-file=lib/yaml/dbm.rb
+    #   - ydbm.invert -> hash
+    # -->
+    # Returns a Hash (not a DBM database) created by using each value in the
+    # database as a key, with the corresponding key as its value.
+    #
+    # Note that all values in the hash will be Strings, but the keys will be actual
+    # objects.
+    #
+    def invert: () -> Hash[untyped, untyped]
+
+    # <!--
+    #   rdoc-file=lib/yaml/dbm.rb
+    #   - ydbm.replace(hash) -> ydbm
+    # -->
+    # Replaces the contents of the database with the contents of the specified
+    # object. Takes any object which implements the each_pair method, including Hash
+    # and DBM objects.
+    #
+    def replace: (Hash[untyped, untyped] | DBM hsh) -> Psych::DBM
+
+    # <!--
+    #   rdoc-file=lib/yaml/dbm.rb
+    #   - ydbm.shift -> [key, value]
+    # -->
+    # Removes a [key, value] pair from the database, and returns it. If the database
+    # is empty, returns `nil`.
+    #
+    # The order in which values are removed/returned is not guaranteed.
+    #
+    def shift: () -> (Array[untyped] | untyped)
+
+    # <!--
+    #   rdoc-file=lib/yaml/dbm.rb
+    #   - ydbm.select { |key, value| ... }
+    #   - ydbm.select(*keys)
+    # -->
+    # If a block is provided, returns a new array containing [key, value] pairs for
+    # which the block returns true.
+    #
+    # Otherwise, same as #values_at
+    #
+    def select: (*untyped keys) { (untyped, untyped) -> untyped } -> Array[untyped]
+
+    # <!--
+    #   rdoc-file=lib/yaml/dbm.rb
+    #   - ydbm.store(key, value) -> value
+    # -->
+    # Stores `value` in database with `key` as the index. `value` is converted to
+    # YAML before being stored.
+    #
+    # Returns `value`
+    #
+    def store: (String key, untyped val) -> untyped
+
+    # <!--
+    #   rdoc-file=lib/yaml/dbm.rb
+    #   - ydbm.update(hash) -> ydbm
+    # -->
+    # Updates the database with multiple values from the specified object. Takes any
+    # object which implements the each_pair method, including Hash and DBM objects.
+    #
+    # Returns `self`.
+    #
+    def update: (Hash[untyped, untyped]) -> Psych::DBM
+
+    # <!--
+    #   rdoc-file=lib/yaml/dbm.rb
+    #   - ydbm.to_a -> array
+    # -->
+    # Converts the contents of the database to an array of [key, value] arrays, and
+    # returns it.
+    #
+    def to_a: () -> Array[untyped]
+
+    # <!--
+    #   rdoc-file=lib/yaml/dbm.rb
+    #   - ydbm.to_hash -> hash
+    # -->
+    # Converts the contents of the database to an in-memory Hash object, and returns
+    # it.
+    #
+    def to_hash: () -> Hash[untyped, untyped]
+  end
+end

data/vendor/bundle/ruby/3.4.0/gems/rbs-4.2.0/stdlib/psych/0/manifest.yaml

@@ -0,0 +1,3 @@
+dependencies:
+  - name: dbm
+  - name: pstore

data/vendor/bundle/ruby/3.4.0/gems/rbs-4.2.0/stdlib/psych/0/psych.rbs

@@ -0,0 +1,455 @@
+# <!-- rdoc-file=ext/psych/lib/psych.rb -->
+# # Overview
+#
+# Psych is a YAML parser and emitter. Psych leverages libyaml [Home page:
+# https://pyyaml.org/wiki/LibYAML] or [git repo:
+# https://github.com/yaml/libyaml] for its YAML parsing and emitting
+# capabilities. In addition to wrapping libyaml, Psych also knows how to
+# serialize and de-serialize most Ruby objects to and from the YAML format.
+#
+# # I NEED TO PARSE OR EMIT YAML RIGHT NOW!
+#
+#     # Parse some YAML
+#     Psych.load("--- foo") # => "foo"
+#
+#     # Emit some YAML
+#     Psych.dump("foo")     # => "--- foo\n...\n"
+#     { :a => 'b'}.to_yaml  # => "---\n:a: b\n"
+#
+# Got more time on your hands?  Keep on reading!
+#
+# ## YAML Parsing
+#
+# Psych provides a range of interfaces for parsing a YAML document ranging from
+# low level to high level, depending on your parsing needs.  At the lowest
+# level, is an event based parser.  Mid level is access to the raw YAML AST, and
+# at the highest level is the ability to unmarshal YAML to Ruby objects.
+#
+# ## YAML Emitting
+#
+# Psych provides a range of interfaces ranging from low to high level for
+# producing YAML documents.  Very similar to the YAML parsing interfaces, Psych
+# provides at the lowest level, an event based system, mid-level is building a
+# YAML AST, and the highest level is converting a Ruby object straight to a YAML
+# document.
+#
+# ## High-level API
+#
+# ### Parsing
+#
+# The high level YAML parser provided by Psych simply takes YAML as input and
+# returns a Ruby data structure.  For information on using the high level parser
+# see Psych.load
+#
+# #### Reading from a string
+#
+#     Psych.safe_load("--- a")             # => 'a'
+#     Psych.safe_load("---\n - a\n - b")   # => ['a', 'b']
+#     # From a trusted string:
+#     Psych.load("--- !ruby/range\nbegin: 0\nend: 42\nexcl: false\n") # => 0..42
+#
+# #### Reading from a file
+#
+#     Psych.safe_load_file("data.yml", permitted_classes: [Date])
+#     Psych.load_file("trusted_database.yml")
+#
+# #### Exception handling
+#
+#     begin
+#       # The second argument changes only the exception contents
+#       Psych.parse("--- `", "file.txt")
+#     rescue Psych::SyntaxError => ex
+#       ex.file    # => 'file.txt'
+#       ex.message # => "(file.txt): found character that cannot start any token"
+#     end
+#
+# ### Emitting
+#
+# The high level emitter has the easiest interface.  Psych simply takes a Ruby
+# data structure and converts it to a YAML document.  See Psych.dump for more
+# information on dumping a Ruby data structure.
+#
+# #### Writing to a string
+#
+#     # Dump an array, get back a YAML string
+#     Psych.dump(['a', 'b'])  # => "---\n- a\n- b\n"
+#
+#     # Dump an array to an IO object
+#     Psych.dump(['a', 'b'], StringIO.new)  # => #<StringIO:0x000001009d0890>
+#
+#     # Dump an array with indentation set
+#     Psych.dump(['a', ['b']], :indentation => 3) # => "---\n- a\n-  - b\n"
+#
+#     # Dump an array to an IO with indentation set
+#     Psych.dump(['a', ['b']], StringIO.new, :indentation => 3)
+#
+# #### Writing to a file
+#
+# Currently there is no direct API for dumping Ruby structure to file:
+#
+#     File.open('database.yml', 'w') do |file|
+#       file.write(Psych.dump(['a', 'b']))
+#     end
+#
+# ## Mid-level API
+#
+# ### Parsing
+#
+# Psych provides access to an AST produced from parsing a YAML document.  This
+# tree is built using the Psych::Parser and Psych::TreeBuilder.  The AST can be
+# examined and manipulated freely.  Please see Psych::parse_stream,
+# Psych::Nodes, and Psych::Nodes::Node for more information on dealing with YAML
+# syntax trees.
+#
+# #### Reading from a string
+#
+#     # Returns Psych::Nodes::Stream
+#     Psych.parse_stream("---\n - a\n - b")
+#
+#     # Returns Psych::Nodes::Document
+#     Psych.parse("---\n - a\n - b")
+#
+# #### Reading from a file
+#
+#     # Returns Psych::Nodes::Stream
+#     Psych.parse_stream(File.read('database.yml'))
+#
+#     # Returns Psych::Nodes::Document
+#     Psych.parse_file('database.yml')
+#
+# #### Exception handling
+#
+#     begin
+#       # The second argument changes only the exception contents
+#       Psych.parse("--- `", "file.txt")
+#     rescue Psych::SyntaxError => ex
+#       ex.file    # => 'file.txt'
+#       ex.message # => "(file.txt): found character that cannot start any token"
+#     end
+#
+# ### Emitting
+#
+# At the mid level is building an AST.  This AST is exactly the same as the AST
+# used when parsing a YAML document.  Users can build an AST by hand and the AST
+# knows how to emit itself as a YAML document.  See Psych::Nodes,
+# Psych::Nodes::Node, and Psych::TreeBuilder for more information on building a
+# YAML AST.
+#
+# #### Writing to a string
+#
+#     # We need Psych::Nodes::Stream (not Psych::Nodes::Document)
+#     stream = Psych.parse_stream("---\n - a\n - b")
+#
+#     stream.to_yaml # => "---\n- a\n- b\n"
+#
+# #### Writing to a file
+#
+#     # We need Psych::Nodes::Stream (not Psych::Nodes::Document)
+#     stream = Psych.parse_stream(File.read('database.yml'))
+#
+#     File.open('database.yml', 'w') do |file|
+#       file.write(stream.to_yaml)
+#     end
+#
+# ## Low-level API
+#
+# ### Parsing
+#
+# The lowest level parser should be used when the YAML input is already known,
+# and the developer does not want to pay the price of building an AST or
+# automatic detection and conversion to Ruby objects.  See Psych::Parser for
+# more information on using the event based parser.
+#
+# #### Reading to Psych::Nodes::Stream structure
+#
+#     parser = Psych::Parser.new(TreeBuilder.new) # => #<Psych::Parser>
+#     parser = Psych.parser                       # it's an alias for the above
+#
+#     parser.parse("---\n - a\n - b")             # => #<Psych::Parser>
+#     parser.handler                              # => #<Psych::TreeBuilder>
+#     parser.handler.root                         # => #<Psych::Nodes::Stream>
+#
+# #### Receiving an events stream
+#
+#     recorder = Psych::Handlers::Recorder.new
+#     parser = Psych::Parser.new(recorder)
+#
+#     parser.parse("---\n - a\n - b")
+#     recorder.events # => [list of [event, args] lists]
+#                     # event is one of: Psych::Handler::EVENTS
+#                     # args are the arguments passed to the event
+#
+# ### Emitting
+#
+# The lowest level emitter is an event based system.  Events are sent to a
+# Psych::Emitter object.  That object knows how to convert the events to a YAML
+# document.  This interface should be used when document format is known in
+# advance or speed is a concern.  See Psych::Emitter for more information.
+#
+# #### Writing to a Ruby structure
+#
+#     Psych.parser.parse("--- a")       # => #<Psych::Parser>
+#
+#     parser.handler.first              # => #<Psych::Nodes::Stream>
+#     parser.handler.first.to_ruby      # => ["a"]
+#
+#     parser.handler.root.first         # => #<Psych::Nodes::Document>
+#     parser.handler.root.first.to_ruby # => "a"
+#
+#     # You can instantiate an Emitter manually
+#     Psych::Visitors::ToRuby.new.accept(parser.handler.root.first)
+#     # => "a"
+#
+module Psych
+  # <!--
+  #   rdoc-file=ext/psych/lib/psych.rb
+  #   - Psych.dump(o)               -> string of yaml
+  #   - Psych.dump(o, options)      -> string of yaml
+  #   - Psych.dump(o, io)           -> io object passed in
+  #   - Psych.dump(o, io, options)  -> io object passed in
+  # -->
+  # Dump Ruby object `o` to a YAML string.  Optional `options` may be passed in to
+  # control the output format.  If an IO object is passed in, the YAML will be
+  # dumped to that IO object.
+  #
+  # Currently supported options are:
+  #
+  # <code>:indentation</code>
+  # :   Number of space characters used to indent. Acceptable value should be in
+  #     <code>0..9</code> range, otherwise option is ignored.
+  #
+  #     Default: `2`.
+  #
+  # <code>:line_width</code>
+  # :   Max character to wrap line at. For unlimited line width use
+  #     <code>-1</code>.
+  #
+  #     Default: `0` (meaning "wrap at 81").
+  #
+  # <code>:canonical</code>
+  # :   Write "canonical" YAML form (very verbose, yet strictly formal).
+  #
+  #     Default: `false`.
+  #
+  # <code>:header</code>
+  # :   Write <code>%YAML [version]</code> at the beginning of document.
+  #
+  #     Default: `false`.
+  #
+  #
+  # <code>:stringify_names</code>
+  # :   Dump symbol keys in Hash objects as string.
+  #
+  #     Default: `false`.
+  #
+  #
+  # Example:
+  #
+  #     # Dump an array, get back a YAML string
+  #     Psych.dump(['a', 'b'])  # => "---\n- a\n- b\n"
+  #
+  #     # Dump an array to an IO object
+  #     Psych.dump(['a', 'b'], StringIO.new)  # => #<StringIO:0x000001009d0890>
+  #
+  #     # Dump an array with indentation set
+  #     Psych.dump(['a', ['b']], indentation: 3) # => "---\n- a\n-  - b\n"
+  #
+  #     # Dump an array to an IO with indentation set
+  #     Psych.dump(['a', ['b']], StringIO.new, indentation: 3)
+  #
+  #     # Dump hash with symbol keys as string
+  #     Psych.dump({a: "b"}, stringify_names: true) # => "---\na: b\n"
+  #
+  %a{annotate:rdoc:copy:Psych.dump}
+  def self.dump: (untyped o, ?indentation: Integer, ?line_width: Integer, ?canonical: bool, ?header: bool) -> String
+               | [IO] (untyped o, IO, ?indentation: Integer, ?line_width: Integer, ?canonical: bool, ?header: bool) -> IO
+
+  # <!--
+  #   rdoc-file=ext/psych/lib/psych.rb
+  #   - load(yaml, permitted_classes: [Symbol], permitted_symbols: [], aliases: false, filename: nil, fallback: nil, symbolize_names: false, freeze: false, strict_integer: false, parse_symbols: true)
+  # -->
+  # Load `yaml` in to a Ruby data structure.  If multiple documents are provided,
+  # the object contained in the first document will be returned. `filename` will
+  # be used in the exception message if any exception is raised while parsing.  If
+  # `yaml` is empty, it returns the specified `fallback` return value, which
+  # defaults to `nil`.
+  #
+  # Raises a Psych::SyntaxError when a YAML syntax error is detected.
+  #
+  # Example:
+  #
+  #     Psych.load("--- a")             # => 'a'
+  #     Psych.load("---\n - a\n - b")   # => ['a', 'b']
+  #
+  #     begin
+  #       Psych.load("--- `", filename: "file.txt")
+  #     rescue Psych::SyntaxError => ex
+  #       ex.file    # => 'file.txt'
+  #       ex.message # => "(file.txt): found character that cannot start any token"
+  #     end
+  #
+  # When the optional `symbolize_names` keyword argument is set to a true value,
+  # returns symbols for keys in Hash objects (default: strings).
+  #
+  #     Psych.load("---\n foo: bar")                         # => {"foo"=>"bar"}
+  #     Psych.load("---\n foo: bar", symbolize_names: true)  # => {:foo=>"bar"}
+  #
+  # Raises a TypeError when `yaml` parameter is NilClass.  This method is similar
+  # to `safe_load` except that `Symbol` objects are allowed by default.
+  #
+  %a{annotate:rdoc:copy:Psych.load}
+  def self.load: (String yaml, ?filename: String | _ToStr | _ToS?, ?fallback: untyped, ?symbolize_names: bool, ?freeze: bool) -> untyped
+
+  # <!--
+  #   rdoc-file=ext/psych/lib/psych.rb
+  #   - load_file(filename, **kwargs)
+  # -->
+  # Loads the document contained in `filename`.  Returns the yaml contained in
+  # `filename` as a Ruby object, or if the file is empty, it returns the specified
+  # `fallback` return value, which defaults to `nil`. See load for options.
+  #
+  %a{annotate:rdoc:copy:Psych.load_file}
+  def self.load_file: (path, ?fallback: untyped, ?symbolize_names: bool, ?freeze: bool) -> untyped
+
+  # <!--
+  #   rdoc-file=ext/psych/lib/psych.rb
+  #   - safe_load(yaml, permitted_classes: [], permitted_symbols: [], aliases: false, filename: nil, fallback: nil, symbolize_names: false, freeze: false, strict_integer: false, parse_symbols: true)
+  # -->
+  # Safely load the yaml string in `yaml`.  By default, only the following classes
+  # are allowed to be deserialized:
+  #
+  # *   TrueClass
+  # *   FalseClass
+  # *   NilClass
+  # *   Integer
+  # *   Float
+  # *   String
+  # *   Array
+  # *   Hash
+  #
+  # Recursive data structures are not allowed by default.  Arbitrary classes can
+  # be allowed by adding those classes to the `permitted_classes` keyword
+  # argument.  They are additive.  For example, to allow Date deserialization:
+  #
+  #     Psych.safe_load(yaml, permitted_classes: [Date])
+  #
+  # Now the Date class can be loaded in addition to the classes listed above.
+  #
+  # Aliases can be explicitly allowed by changing the `aliases` keyword argument.
+  # For example:
+  #
+  #     x = []
+  #     x << x
+  #     yaml = Psych.dump x
+  #     Psych.safe_load yaml               # => raises an exception
+  #     Psych.safe_load yaml, aliases: true # => loads the aliases
+  #
+  # A Psych::DisallowedClass exception will be raised if the yaml contains a class
+  # that isn't in the `permitted_classes` list.
+  #
+  # A Psych::AliasesNotEnabled exception will be raised if the yaml contains
+  # aliases but the `aliases` keyword argument is set to false.
+  #
+  # `filename` will be used in the exception message if any exception is raised
+  # while parsing.
+  #
+  # When the optional `symbolize_names` keyword argument is set to a true value,
+  # returns symbols for keys in Hash objects (default: strings).
+  #
+  #     Psych.safe_load("---\n foo: bar")                         # => {"foo"=>"bar"}
+  #     Psych.safe_load("---\n foo: bar", symbolize_names: true)  # => {:foo=>"bar"}
+  #
+  %a{annotate:rdoc:copy:Psych.safe_load}
+  def self.safe_load: (String yaml, ?permitted_classes: Array[Class], ?permitted_symbols: Array[Symbol], ?aliases: bool, ?filename: String | _ToStr | _ToS?, ?fallback: untyped, ?symbolize_names: bool, ?freeze: bool) -> untyped
+
+  # <!--
+  #   rdoc-file=ext/psych/lib/psych.rb
+  #   - unsafe_load(yaml, filename: nil, fallback: false, symbolize_names: false, freeze: false, strict_integer: false, parse_symbols: true)
+  # -->
+  # Load `yaml` in to a Ruby data structure.  If multiple documents are provided,
+  # the object contained in the first document will be returned. `filename` will
+  # be used in the exception message if any exception is raised while parsing.  If
+  # `yaml` is empty, it returns the specified `fallback` return value, which
+  # defaults to `false`.
+  #
+  # Raises a Psych::SyntaxError when a YAML syntax error is detected.
+  #
+  # Example:
+  #
+  #     Psych.unsafe_load("--- a")             # => 'a'
+  #     Psych.unsafe_load("---\n - a\n - b")   # => ['a', 'b']
+  #
+  #     begin
+  #       Psych.unsafe_load("--- `", filename: "file.txt")
+  #     rescue Psych::SyntaxError => ex
+  #       ex.file    # => 'file.txt'
+  #       ex.message # => "(file.txt): found character that cannot start any token"
+  #     end
+  #
+  # When the optional `symbolize_names` keyword argument is set to a true value,
+  # returns symbols for keys in Hash objects (default: strings).
+  #
+  #     Psych.unsafe_load("---\n foo: bar")                         # => {"foo"=>"bar"}
+  #     Psych.unsafe_load("---\n foo: bar", symbolize_names: true)  # => {:foo=>"bar"}
+  #
+  # Raises a TypeError when `yaml` parameter is NilClass
+  #
+  # NOTE: This method *should not* be used to parse untrusted documents, such as
+  # YAML documents that are supplied via user input.  Instead, please use the load
+  # method or the safe_load method.
+  #
+  %a{annotate:rdoc:copy:Psych.unsafe_load}
+  def self.unsafe_load: (String yaml, ?filename: String | _ToStr | _ToS?, ?fallback: untyped, ?symbolize_names: bool, ?freeze: bool, ?strict_integer: bool) -> untyped
+
+  # <!--
+  #   rdoc-file=ext/psych/lib/psych.rb
+  #   - safe_load_file(filename, **kwargs)
+  # -->
+  # Safely loads the document contained in `filename`.  Returns the yaml contained
+  # in `filename` as a Ruby object, or if the file is empty, it returns the
+  # specified `fallback` return value, which defaults to `nil`. See safe_load for
+  # options.
+  #
+  %a{annotate:rdoc:copy:Psych.safe_load_file}
+  def self.safe_load_file: (path, ?permitted_classes: Array[Class], ?permitted_symbols: Array[Symbol], ?aliases: bool, ?fallback: untyped, ?symbolize_names: bool, ?freeze: bool) -> untyped
+
+  # <!--
+  #   rdoc-file=ext/psych/lib/psych.rb
+  #   - unsafe_load_file(filename, **kwargs)
+  # -->
+  # Load the document contained in `filename`.  Returns the yaml contained in
+  # `filename` as a Ruby object, or if the file is empty, it returns the specified
+  # `fallback` return value, which defaults to `false`.
+  #
+  # NOTE: This method *should not* be used to parse untrusted documents, such as
+  # YAML documents that are supplied via user input.  Instead, please use the
+  # safe_load_file method.
+  #
+  %a{annotate:rdoc:copy:Psych.unsafe_load_file}
+  def self.unsafe_load_file: (path, ?fallback: untyped, ?symbolize_names: bool, ?freeze: bool) -> untyped
+
+  class Exception < ::RuntimeError
+  end
+
+  class SyntaxError < ::Psych::Exception
+    attr_reader file: String?
+    attr_reader line: Integer?
+    attr_reader column: Integer?
+    attr_reader offset: Integer?
+    attr_reader problem: String?
+    attr_reader context: String?
+
+    # <!--
+    #   rdoc-file=ext/psych/lib/psych/syntax_error.rb
+    #   - new(file, line, col, offset, problem, context)
+    # -->
+    #
+    def initialize: (?String? file, ?Integer? line, ?Integer? column, ?Integer? offset, ?String? problem, ?String? context) -> void
+  end
+
+  class BadAlias < ::Psych::Exception
+  end
+
+  class DisallowedClass < ::Psych::Exception
+  end
+end