rbs 2.8.4 → 3.8.1

data/stdlib/resolv/0/resolv.rbs

@@ -74,8 +74,6 @@ class Resolv
   #
   def self.getnames: (String address) -> Array[String]
 
-  public
-
   # <!--
   #   rdoc-file=lib/resolv.rb
   #   - each_address(name) { |name| ... }
@@ -128,10 +126,14 @@ class Resolv
 
   # <!--
   #   rdoc-file=lib/resolv.rb
-  #   - new(resolvers=[Hosts.new, DNS.new])
+  #   - new(resolvers=(arg_not_set = true; nil), use_ipv6: (keyword_not_set = true; nil))
   # -->
   # Creates a new Resolv using `resolvers`.
   #
+  # If `resolvers` is not given, a hash, or `nil`, uses a Hosts resolver and and a
+  # DNS resolver.  If `resolvers` is a hash, uses the hash as configuration for
+  # the DNS resolver.
+  #
   def initialize: (?Resolv::Hosts | Resolv::DNS resolvers) -> untyped
 end
 
@@ -179,8 +181,6 @@ class Resolv::DNS
 
   def self.random: (Integer arg) -> (Integer | Float)
 
-  public
-
   # <!--
   #   rdoc-file=lib/resolv.rb
   #   - close()
@@ -296,7 +296,6 @@ class Resolv::DNS
   # *   Resolv::DNS::Resource::IN::TXT
   # *   Resolv::DNS::Resource::IN::WKS
   #
-  #
   # Returned resource is represented as a Resolv::DNS::Resource instance, i.e.
   # Resolv::DNS::Resource::IN::A.
   #
@@ -345,24 +344,26 @@ class Resolv::DNS
   #
   # nil
   # :   Uses /etc/resolv.conf.
+  #
   # String
   # :   Path to a file using /etc/resolv.conf's format.
+  #
   # Hash
   # :   Must contain :nameserver, :search and :ndots keys.
   #
   # :nameserver_port can be used to specify port number of nameserver address.
+  # :raise_timeout_errors can be used to raise timeout errors as exceptions
+  # instead of treating the same as an NXDOMAIN response.
   #
   # The value of :nameserver should be an address string or an array of address
   # strings.
   # *   :nameserver => '8.8.8.8'
   # *   :nameserver => ['8.8.8.8', '8.8.4.4']
   #
-  #
   # The value of :nameserver_port should be an array of pair of nameserver address
   # and port number.
   # *   :nameserver_port => [['8.8.8.8', 53], ['8.8.4.4', 53]]
   #
-  #
   # Example:
   #
   #     Resolv::DNS.new(:nameserver => ['210.251.121.21'],
@@ -393,8 +394,6 @@ class Resolv::DNS::Config
 
   def self.parse_resolv_conf: (String filename) -> Hash[Symbol, untyped]
 
-  public
-
   def generate_candidates: (String name) -> Array[Resolv::DNS::Name]
 
   def generate_timeouts: () -> Array[Integer | Float]
@@ -445,8 +444,6 @@ module Resolv::DNS::Label
 end
 
 class Resolv::DNS::Label::Str
-  public
-
   def eql?: (Resolv::DNS::Label::Str other) -> bool
 
   def downcase: () -> String
@@ -469,8 +466,6 @@ end
 class Resolv::DNS::Message
   def self.decode: (String m) -> instance
 
-  public
-
   def ==: (instance other) -> bool
 
   def aa: () -> Integer
@@ -539,8 +534,6 @@ class Resolv::DNS::Message
 end
 
 class Resolv::DNS::Message::MessageDecoder
-  public
-
   def get_bytes: (?Integer len) -> String
 
   def get_label: () -> Resolv::DNS::Label::Str
@@ -569,8 +562,6 @@ class Resolv::DNS::Message::MessageDecoder
 end
 
 class Resolv::DNS::Message::MessageEncoder
-  public
-
   def put_bytes: (string d) -> void
 
   def put_label: (_ToS d) -> void
@@ -606,13 +597,12 @@ class Resolv::DNS::Name
   #
   # Name
   # :   returns `arg`.
+  #
   # String
   # :   Creates a new Name.
   #
   def self.create: (Resolv::DNS::dns_name arg) -> untyped
 
-  public
-
   def ==: (instance other) -> bool
 
   def []: (Integer i) -> Resolv::DNS::Label::Str?
@@ -693,8 +683,6 @@ Resolv::DNS::OpCode::Update: Integer
 class Resolv::DNS::Query
   def self.decode_rdata: (Resolv::DNS::Message::MessageDecoder msg) -> instance
 
-  public
-
   def encode_rdata: (Resolv::DNS::Message::MessageEncoder msg) -> void
 end
 
@@ -738,8 +726,6 @@ Resolv::DNS::RCode::YXDomain: Integer
 Resolv::DNS::RCode::YXRRSet: Integer
 
 class Resolv::DNS::Requester
-  public
-
   def close: () -> void
 
   def request: (Resolv::DNS::Requester::Sender sender, Numeric tout) -> [ Resolv::DNS::Message, String ]
@@ -752,8 +738,6 @@ class Resolv::DNS::Requester
 end
 
 class Resolv::DNS::Requester::ConnectedUDP < Resolv::DNS::Requester
-  public
-
   def close: () -> void
 
   def lazy_initialize: () -> void
@@ -768,16 +752,12 @@ class Resolv::DNS::Requester::ConnectedUDP < Resolv::DNS::Requester
 end
 
 class Resolv::DNS::Requester::ConnectedUDP::Sender < Resolv::DNS::Requester::Sender
-  public
-
   def data: () -> String
 
   def send: () -> void
 end
 
 class Resolv::DNS::Requester::MDNSOneShot < Resolv::DNS::Requester::UnconnectedUDP
-  public
-
   def sender: (Resolv::DNS::Message msg, String data, ?String host, ?Integer port) -> Resolv::DNS::Requester::Sender
 
   def recv_reply: (Array[UDPSocket] readable_socks) -> [ String, String ]
@@ -796,8 +776,6 @@ class Resolv::DNS::Requester::Sender
 end
 
 class Resolv::DNS::Requester::TCP < Resolv::DNS::Requester
-  public
-
   def close: () -> untyped
 
   def recv_reply: (Array[TCPSocket] readable_socks) -> [ String, String ]
@@ -810,16 +788,12 @@ class Resolv::DNS::Requester::TCP < Resolv::DNS::Requester
 end
 
 class Resolv::DNS::Requester::TCP::Sender < Resolv::DNS::Requester::Sender
-  public
-
   def data: () -> String
 
   def send: () -> void
 end
 
 class Resolv::DNS::Requester::UnconnectedUDP < Resolv::DNS::Requester
-  public
-
   def close: () -> void
 
   def lazy_initialize: () -> void
@@ -834,8 +808,6 @@ class Resolv::DNS::Requester::UnconnectedUDP < Resolv::DNS::Requester
 end
 
 class Resolv::DNS::Requester::UnconnectedUDP::Sender < Resolv::DNS::Requester::Sender
-  public
-
   def data: () -> String
 
   def send: () -> void
@@ -853,8 +825,6 @@ class Resolv::DNS::Resource < Resolv::DNS::Query
 
   def self.get_class: (Integer type_value, Integer class_value) -> self
 
-  public
-
   def eql?: (Resolv::DNS::Resource other) -> bool
 
   def encode_rdata: (Resolv::DNS::Message::MessageEncoder msg) -> void
@@ -897,8 +867,6 @@ Resolv::DNS::Resource::CNAME::TypeValue: Integer
 class Resolv::DNS::Resource::DomainName < Resolv::DNS::Resource
   def self.decode_rdata: (Resolv::DNS::Message::MessageDecoder msg) -> instance
 
-  public
-
   def encode_rdata: (Resolv::DNS::Message::MessageEncoder msg) -> void
 
   # <!-- rdoc-file=lib/resolv.rb -->
@@ -921,12 +889,10 @@ end
 # A generic resource abstract class.
 #
 class Resolv::DNS::Resource::Generic < Resolv::DNS::Resource
-  def self.create: (Integer type_value, Integer class_value) -> instance
+  def self.create: (Integer type_value, Integer class_value) -> Class
 
   def self.decode_rdata: (Resolv::DNS::Message::MessageDecoder msg) -> instance
 
-  public
-
   # <!-- rdoc-file=lib/resolv.rb -->
   # Data for this generic resource.
   #
@@ -951,8 +917,6 @@ end
 class Resolv::DNS::Resource::HINFO < Resolv::DNS::Resource
   def self.decode_rdata: (Resolv::DNS::Message::MessageDecoder msg) -> instance
 
-  public
-
   # <!-- rdoc-file=lib/resolv.rb -->
   # CPU architecture for this resource.
   #
@@ -992,8 +956,6 @@ Resolv::DNS::Resource::IN::ClassValue: Integer
 class Resolv::DNS::Resource::IN::A < Resolv::DNS::Resource
   def self.decode_rdata: (Resolv::DNS::Message::MessageDecoder msg) -> instance
 
-  public
-
   # <!-- rdoc-file=lib/resolv.rb -->
   # The Resolv::IPv4 address for this A.
   #
@@ -1022,8 +984,6 @@ Resolv::DNS::Resource::IN::A::TypeValue: Integer
 class Resolv::DNS::Resource::IN::AAAA < Resolv::DNS::Resource
   def self.decode_rdata: (Resolv::DNS::Message::MessageDecoder msg) -> instance
 
-  public
-
   # <!-- rdoc-file=lib/resolv.rb -->
   # The Resolv::IPv6 address for this AAAA.
   #
@@ -1117,8 +1077,6 @@ Resolv::DNS::Resource::IN::SOA::TypeValue: Integer
 class Resolv::DNS::Resource::IN::SRV < Resolv::DNS::Resource
   def self.decode_rdata: (Resolv::DNS::Message::MessageDecoder msg) -> instance
 
-  public
-
   def encode_rdata: (Resolv::DNS::Message::MessageEncoder msg) -> void
 
   # <!-- rdoc-file=lib/resolv.rb -->
@@ -1189,8 +1147,6 @@ Resolv::DNS::Resource::IN::TXT::TypeValue: Integer
 class Resolv::DNS::Resource::IN::WKS < Resolv::DNS::Resource
   def self.decode_rdata: (Resolv::DNS::Message::MessageDecoder msg) -> instance
 
-  public
-
   # <!-- rdoc-file=lib/resolv.rb -->
   # The host these services run on.
   #
@@ -1232,8 +1188,6 @@ Resolv::DNS::Resource::IN::WKS::TypeValue: Integer
 class Resolv::DNS::Resource::LOC < Resolv::DNS::Resource
   def self.decode_rdata: (Resolv::DNS::Message::MessageDecoder msg) -> instance
 
-  public
-
   # <!-- rdoc-file=lib/resolv.rb -->
   # The altitude of the LOC above a reference sphere whose surface sits 100km
   # below the WGS84 spheroid in centimeters as an unsigned 32bit integer
@@ -1295,8 +1249,6 @@ Resolv::DNS::Resource::LOC::TypeValue: Integer
 class Resolv::DNS::Resource::MINFO < Resolv::DNS::Resource
   def self.decode_rdata: (Resolv::DNS::Message::MessageDecoder msg) -> instance
 
-  public
-
   # <!-- rdoc-file=lib/resolv.rb -->
   # Mailbox to use for error messages related to the mail list or mailbox.
   #
@@ -1327,8 +1279,6 @@ Resolv::DNS::Resource::MINFO::TypeValue: Integer
 class Resolv::DNS::Resource::MX < Resolv::DNS::Resource
   def self.decode_rdata: (Resolv::DNS::Message::MessageDecoder msg) -> instance
 
-  public
-
   def encode_rdata: (Resolv::DNS::Message::MessageEncoder msg) -> void
 
   # <!-- rdoc-file=lib/resolv.rb -->
@@ -1376,8 +1326,6 @@ Resolv::DNS::Resource::PTR::TypeValue: Integer
 class Resolv::DNS::Resource::SOA < Resolv::DNS::Resource
   def self.decode_rdata: (Resolv::DNS::Message::MessageDecoder msg) -> instance
 
-  public
-
   def encode_rdata: (Resolv::DNS::Message::MessageEncoder msg) -> void
 
   # <!-- rdoc-file=lib/resolv.rb -->
@@ -1438,8 +1386,6 @@ Resolv::DNS::Resource::SOA::TypeValue: Integer
 class Resolv::DNS::Resource::TXT < Resolv::DNS::Resource
   def self.decode_rdata: (Resolv::DNS::Message::MessageDecoder msg) -> instance
 
-  public
-
   # <!--
   #   rdoc-file=lib/resolv.rb
   #   - data()
@@ -1471,8 +1417,6 @@ Resolv::DNS::Resource::TXT::TypeValue: Integer
 # Resolv::Hosts is a hostname resolver that uses the system hosts file.
 #
 class Resolv::Hosts
-  public
-
   # <!--
   #   rdoc-file=lib/resolv.rb
   #   - each_address(name, &proc)
@@ -1547,8 +1491,6 @@ class Resolv::IPv4
   #
   def self.create: (String | instance arg) -> instance
 
-  public
-
   def ==: (instance other) -> bool
 
   # <!-- rdoc-file=lib/resolv.rb -->
@@ -1596,13 +1538,12 @@ class Resolv::IPv6
   #
   # IPv6
   # :   returns `arg`.
+  #
   # String
   # :   `arg` must match one of the IPv6::Regex* constants
   #
   def self.create: (String | instance arg) -> instance
 
-  public
-
   def ==: (instance other) -> bool
 
   # <!-- rdoc-file=lib/resolv.rb -->
@@ -1681,13 +1622,12 @@ class Resolv::LOC::Alt
   #
   # LOC::Alt
   # :   returns `arg`.
+  #
   # String
   # :   `arg` must match the LOC::Alt::Regex constant
   #
   def self.create: (Resolv::LOC::Alt | String arg) -> instance
 
-  public
-
   def eql?: (Resolv::LOC::Alt other) -> bool
 
   # <!-- rdoc-file=lib/resolv.rb -->
@@ -1729,13 +1669,12 @@ class Resolv::LOC::Coord
   #
   # LOC::Coord
   # :   returns `arg`.
+  #
   # String
   # :   `arg` must match the LOC::Coord::Regex constant
   #
   def self.create: (Resolv::LOC::Coord | String arg) -> instance
 
-  public
-
   def eql?: (Resolv::LOC::Coord other) -> bool
 
   # <!-- rdoc-file=lib/resolv.rb -->
@@ -1780,13 +1719,12 @@ class Resolv::LOC::Size
   #
   # LOC::Size
   # :   returns `arg`.
+  #
   # String
   # :   `arg` must match the LOC::Size::Regex constant
   #
   def self.create: (Resolv::LOC::Size | String arg) -> instance
 
-  public
-
   def eql?: (Resolv::LOC::Size other) -> bool
 
   alias == eql?
@@ -1824,8 +1762,6 @@ Resolv::LOC::Size::Regex: Regexp
 # *   RFC 6762
 #
 class Resolv::MDNS < Resolv::DNS
-  public
-
   # <!--
   #   rdoc-file=lib/resolv.rb
   #   - each_address(name)
@@ -1854,6 +1790,7 @@ class Resolv::MDNS < Resolv::DNS
   # nil
   # :   Uses the default mDNS addresses
   #
+  #
   # Hash
   # :   Must contain :nameserver or :nameserver_port like Resolv::DNS#initialize.
   #