lunchmoney 1.4.0 → 1.5.0

data/sorbet/rbi/gems/{logger@1.6.0.rbi → logger@1.7.0.rbi}

@@ -133,7 +133,7 @@
 # when the entry is created.
 #
 # The logged timestamp is formatted by method
-# {Time#strftime}[rdoc-ref:Time#strftime]
+# {Time#strftime}[https://docs.ruby-lang.org/en/master/Time.html#method-i-strftime]
 # using this format string:
 #
 #   '%Y-%m-%dT%H:%M:%S.%6N'
@@ -350,7 +350,9 @@
 # You can set a different format using create-time option
 # +shift_period_suffix+;
 # see details and suggestions at
-# {Time#strftime}[rdoc-ref:Time#strftime].
+# {Time#strftime}[https://docs.ruby-lang.org/en/master/Time.html#method-i-strftime].
+#
+# source://logger//lib/logger/version.rb#3
 class Logger
   include ::Logger::Severity
 
@@ -367,10 +369,20 @@ class Logger
   # - A string filepath: entries are to be written
   #   to the file at that path; if the file at that path exists,
   #   new entries are appended.
-  # - An IO stream (typically +$stdout+, +$stderr+. or an open file):
-  #   entries are to be written to the given stream.
+  # - An IO stream (typically <tt>$stdout</tt>, <tt>$stderr</tt>. or
+  #   an open file): entries are to be written to the given stream.
   # - +nil+ or +File::NULL+: no entries are to be written.
   #
+  # Argument +shift_age+ must be one of:
+  #
+  # - The number of log files to be in the rotation.
+  #   See {Size-Based Rotation}[rdoc-ref:Logger@Size-Based+Rotation].
+  # - A string period indicator.
+  #   See {Periodic Rotation}[rdoc-ref:Logger@Periodic+Rotation].
+  #
+  # Argument +shift_size+ is the maximum size (in bytes) of each log file.
+  # See {Size-Based Rotation}[rdoc-ref:Logger@Size-Based+Rotation].
+  #
   # Examples:
   #
   #   Logger.new('t.log')
@@ -390,19 +402,29 @@ class Logger
   #
   # - +formatter+: sets the entry formatter; default is +nil+.
   #   See {formatter=}[Logger.html#attribute-i-formatter].
+  #
   # - +datetime_format+: sets the format for entry timestamp;
   #   default is +nil+.
   #   See #datetime_format=.
+  #
   # - +binmode+: sets whether the logger writes in binary mode;
   #   default is +false+.
+  #
   # - +shift_period_suffix+: sets the format for the filename suffix
   #   for periodic log file rotation; default is <tt>'%Y%m%d'</tt>.
   #   See {Periodic Rotation}[rdoc-ref:Logger@Periodic+Rotation].
   #
+  # - +reraise_write_errors+: An array of exception classes, which will
+  #   be reraised if there is an error when writing to the log device.
+  #   The default is to swallow all exceptions raised.
+  # - +skip_header+: If +true+, prevents the logger from writing a header
+  #   when creating a new log file. The default is +false+, meaning
+  #   the header will be written as usual.
+  #
   # @return [Logger] a new instance of Logger
   #
-  # source://logger//logger.rb#578
-  def initialize(logdev, shift_age = T.unsafe(nil), shift_size = T.unsafe(nil), level: T.unsafe(nil), progname: T.unsafe(nil), formatter: T.unsafe(nil), datetime_format: T.unsafe(nil), binmode: T.unsafe(nil), shift_period_suffix: T.unsafe(nil)); end
+  # source://logger//lib/logger.rb#598
+  def initialize(logdev, shift_age = T.unsafe(nil), shift_size = T.unsafe(nil), level: T.unsafe(nil), progname: T.unsafe(nil), formatter: T.unsafe(nil), datetime_format: T.unsafe(nil), binmode: T.unsafe(nil), shift_period_suffix: T.unsafe(nil), reraise_write_errors: T.unsafe(nil), skip_header: T.unsafe(nil)); end
 
   # Writes the given +msg+ to the log with no formatting;
   # returns the number of characters written,
@@ -415,7 +437,7 @@ class Logger
   #
   #   My message.
   #
-  # source://logger//logger.rb#684
+  # source://logger//lib/logger.rb#708
   def <<(msg); end
 
   # Creates a log entry, which may or may not be written to the log,
@@ -445,7 +467,7 @@ class Logger
   # - #fatal.
   # - #unknown.
   #
-  # source://logger//logger.rb#651
+  # source://logger//lib/logger.rb#675
   def add(severity, message = T.unsafe(nil), progname = T.unsafe(nil)); end
 
   # Closes the logger; returns +nil+:
@@ -456,12 +478,12 @@ class Logger
   #
   # Related: Logger#reopen.
   #
-  # source://logger//logger.rb#731
+  # source://logger//lib/logger.rb#755
   def close; end
 
   # Returns the date-time format; see #datetime_format=.
   #
-  # source://logger//logger.rb#438
+  # source://logger//lib/logger.rb#438
   def datetime_format; end
 
   # Sets the date-time format.
@@ -469,21 +491,21 @@ class Logger
   # Argument +datetime_format+ should be either of these:
   #
   # - A string suitable for use as a format for method
-  #   {Time#strftime}[rdoc-ref:Time#strftime].
+  #   {Time#strftime}[https://docs.ruby-lang.org/en/master/Time.html#method-i-strftime].
   # - +nil+: the logger uses <tt>'%Y-%m-%dT%H:%M:%S.%6N'</tt>.
   #
-  # source://logger//logger.rb#432
+  # source://logger//lib/logger.rb#432
   def datetime_format=(datetime_format); end
 
   # Equivalent to calling #add with severity <tt>Logger::DEBUG</tt>.
   #
-  # source://logger//logger.rb#690
+  # source://logger//lib/logger.rb#714
   def debug(progname = T.unsafe(nil), &block); end
 
   # Sets the log level to Logger::DEBUG.
   # See {Log Level}[rdoc-ref:Logger@Log+Level].
   #
-  # source://logger//logger.rb#487
+  # source://logger//lib/logger.rb#487
   def debug!; end
 
   # Returns +true+ if the log level allows entries with severity
@@ -492,18 +514,18 @@ class Logger
   #
   # @return [Boolean]
   #
-  # source://logger//logger.rb#482
+  # source://logger//lib/logger.rb#482
   def debug?; end
 
   # Equivalent to calling #add with severity <tt>Logger::ERROR</tt>.
   #
-  # source://logger//logger.rb#708
+  # source://logger//lib/logger.rb#732
   def error(progname = T.unsafe(nil), &block); end
 
   # Sets the log level to Logger::ERROR.
   # See {Log Level}[rdoc-ref:Logger@Log+Level].
   #
-  # source://logger//logger.rb#520
+  # source://logger//lib/logger.rb#520
   def error!; end
 
   # Returns +true+ if the log level allows entries with severity
@@ -512,18 +534,18 @@ class Logger
   #
   # @return [Boolean]
   #
-  # source://logger//logger.rb#515
+  # source://logger//lib/logger.rb#515
   def error?; end
 
   # Equivalent to calling #add with severity <tt>Logger::FATAL</tt>.
   #
-  # source://logger//logger.rb#714
+  # source://logger//lib/logger.rb#738
   def fatal(progname = T.unsafe(nil), &block); end
 
   # Sets the log level to Logger::FATAL.
   # See {Log Level}[rdoc-ref:Logger@Log+Level].
   #
-  # source://logger//logger.rb#531
+  # source://logger//lib/logger.rb#531
   def fatal!; end
 
   # Returns +true+ if the log level allows entries with severity
@@ -532,7 +554,7 @@ class Logger
   #
   # @return [Boolean]
   #
-  # source://logger//logger.rb#526
+  # source://logger//lib/logger.rb#526
   def fatal?; end
 
   # Sets or retrieves the logger entry formatter proc.
@@ -550,7 +572,7 @@ class Logger
   # The proc should return a string containing the formatted entry.
   #
   # This custom formatter uses
-  # {String#dump}[rdoc-ref:String#dump]
+  # {String#dump}[https://docs.ruby-lang.org/en/master/String.html#method-i-dump]
   # to escape the message string:
   #
   #   logger = Logger.new($stdout, progname: 'mung')
@@ -566,7 +588,7 @@ class Logger
   #   I, [2022-05-13T13:16:29.637488 #8492]  INFO -- mung: "hello \n ''"
   #   I, [2022-05-13T13:16:29.637610 #8492]  INFO -- mung: "\f\x00\xFF\\\""
   #
-  # source://logger//logger.rb#473
+  # source://logger//lib/logger.rb#473
   def formatter; end
 
   # Sets or retrieves the logger entry formatter proc.
@@ -584,7 +606,7 @@ class Logger
   # The proc should return a string containing the formatted entry.
   #
   # This custom formatter uses
-  # {String#dump}[rdoc-ref:String#dump]
+  # {String#dump}[https://docs.ruby-lang.org/en/master/String.html#method-i-dump]
   # to escape the message string:
   #
   #   logger = Logger.new($stdout, progname: 'mung')
@@ -600,18 +622,18 @@ class Logger
   #   I, [2022-05-13T13:16:29.637488 #8492]  INFO -- mung: "hello \n ''"
   #   I, [2022-05-13T13:16:29.637610 #8492]  INFO -- mung: "\f\x00\xFF\\\""
   #
-  # source://logger//logger.rb#473
+  # source://logger//lib/logger.rb#473
   def formatter=(_arg0); end
 
   # Equivalent to calling #add with severity <tt>Logger::INFO</tt>.
   #
-  # source://logger//logger.rb#696
+  # source://logger//lib/logger.rb#720
   def info(progname = T.unsafe(nil), &block); end
 
   # Sets the log level to Logger::INFO.
   # See {Log Level}[rdoc-ref:Logger@Log+Level].
   #
-  # source://logger//logger.rb#498
+  # source://logger//lib/logger.rb#498
   def info!; end
 
   # Returns +true+ if the log level allows entries with severity
@@ -620,12 +642,12 @@ class Logger
   #
   # @return [Boolean]
   #
-  # source://logger//logger.rb#493
+  # source://logger//lib/logger.rb#493
   def info?; end
 
   # Logging severity threshold (e.g. <tt>Logger::INFO</tt>).
   #
-  # source://logger//logger.rb#383
+  # source://logger//lib/logger.rb#383
   def level; end
 
   # Sets the log level; returns +severity+.
@@ -640,7 +662,7 @@ class Logger
   #
   # Logger#sev_threshold= is an alias for Logger#level=.
   #
-  # source://logger//logger.rb#399
+  # source://logger//lib/logger.rb#399
   def level=(severity); end
 
   # Creates a log entry, which may or may not be written to the log,
@@ -670,17 +692,17 @@ class Logger
   # - #fatal.
   # - #unknown.
   #
-  # source://logger//logger.rb#651
+  # source://logger//lib/logger.rb#675
   def log(severity, message = T.unsafe(nil), progname = T.unsafe(nil)); end
 
   # Program name to include in log messages.
   #
-  # source://logger//logger.rb#422
+  # source://logger//lib/logger.rb#422
   def progname; end
 
   # Program name to include in log messages.
   #
-  # source://logger//logger.rb#422
+  # source://logger//lib/logger.rb#422
   def progname=(_arg0); end
 
   # Sets the logger's output stream:
@@ -706,12 +728,12 @@ class Logger
   #   #  "E, [2022-05-12T14:21:27.596726 #22428] ERROR -- : one\n",
   #   #  "E, [2022-05-12T14:23:05.847241 #22428] ERROR -- : three\n"]
   #
-  # source://logger//logger.rb#619
-  def reopen(logdev = T.unsafe(nil)); end
+  # source://logger//lib/logger.rb#642
+  def reopen(logdev = T.unsafe(nil), shift_age = T.unsafe(nil), shift_size = T.unsafe(nil), shift_period_suffix: T.unsafe(nil), binmode: T.unsafe(nil)); end
 
   # Logging severity threshold (e.g. <tt>Logger::INFO</tt>).
   #
-  # source://logger//logger.rb#383
+  # source://logger//lib/logger.rb#383
   def sev_threshold; end
 
   # Sets the log level; returns +severity+.
@@ -726,23 +748,23 @@ class Logger
   #
   # Logger#sev_threshold= is an alias for Logger#level=.
   #
-  # source://logger//logger.rb#399
+  # source://logger//lib/logger.rb#399
   def sev_threshold=(severity); end
 
   # Equivalent to calling #add with severity <tt>Logger::UNKNOWN</tt>.
   #
-  # source://logger//logger.rb#720
+  # source://logger//lib/logger.rb#744
   def unknown(progname = T.unsafe(nil), &block); end
 
   # Equivalent to calling #add with severity <tt>Logger::WARN</tt>.
   #
-  # source://logger//logger.rb#702
+  # source://logger//lib/logger.rb#726
   def warn(progname = T.unsafe(nil), &block); end
 
   # Sets the log level to Logger::WARN.
   # See {Log Level}[rdoc-ref:Logger@Log+Level].
   #
-  # source://logger//logger.rb#509
+  # source://logger//lib/logger.rb#509
   def warn!; end
 
   # Returns +true+ if the log level allows entries with severity
@@ -751,7 +773,7 @@ class Logger
   #
   # @return [Boolean]
   #
-  # source://logger//logger.rb#504
+  # source://logger//lib/logger.rb#504
   def warn?; end
 
   # Adjust the log level during the block execution for the current Fiber only
@@ -760,144 +782,182 @@ class Logger
   #     logger.debug { "Hello" }
   #   end
   #
-  # source://logger//logger.rb#408
+  # source://logger//lib/logger.rb#408
   def with_level(severity); end
 
   private
 
-  # source://logger//logger.rb#744
+  # source://logger//lib/logger.rb#786
   def format_message(severity, datetime, progname, msg); end
 
-  # source://logger//logger.rb#740
+  # source://logger//lib/logger.rb#764
   def format_severity(severity); end
+
+  # source://logger//lib/logger.rb#782
+  def level_key; end
+
+  # Guarantee the existence of this ivar even when subclasses don't call the superclass constructor.
+  #
+  # source://logger//lib/logger.rb#769
+  def level_override; end
 end
 
 # Default formatter for log messages.
+#
+# source://logger//lib/logger/formatter.rb#5
 class Logger::Formatter
   # @return [Formatter] a new instance of Formatter
   #
-  # source://logger//logger/formatter.rb#11
+  # source://logger//lib/logger/formatter.rb#11
   def initialize; end
 
-  # source://logger//logger/formatter.rb#15
+  # source://logger//lib/logger/formatter.rb#15
   def call(severity, time, progname, msg); end
 
   # Returns the value of attribute datetime_format.
   #
-  # source://logger//logger/formatter.rb#9
+  # source://logger//lib/logger/formatter.rb#9
   def datetime_format; end
 
   # Sets the attribute datetime_format
   #
   # @param value the value to set the attribute datetime_format to.
   #
-  # source://logger//logger/formatter.rb#9
+  # source://logger//lib/logger/formatter.rb#9
   def datetime_format=(_arg0); end
 
   private
 
-  # source://logger//logger/formatter.rb#21
+  # source://logger//lib/logger/formatter.rb#21
   def format_datetime(time); end
 
-  # source://logger//logger/formatter.rb#25
+  # source://logger//lib/logger/formatter.rb#25
   def msg2str(msg); end
 end
 
-# source://logger//logger/formatter.rb#7
+# source://logger//lib/logger/formatter.rb#7
 Logger::Formatter::DatetimeFormat = T.let(T.unsafe(nil), String)
 
-# source://logger//logger/formatter.rb#6
+# source://logger//lib/logger/formatter.rb#6
 Logger::Formatter::Format = T.let(T.unsafe(nil), String)
 
 # Device used for logging messages.
+#
+# source://logger//lib/logger/log_device.rb#7
 class Logger::LogDevice
   include ::Logger::Period
   include ::MonitorMixin
 
   # @return [LogDevice] a new instance of LogDevice
   #
-  # source://logger//logger/log_device.rb#14
-  def initialize(log = T.unsafe(nil), shift_age: T.unsafe(nil), shift_size: T.unsafe(nil), shift_period_suffix: T.unsafe(nil), binmode: T.unsafe(nil)); end
+  # source://logger//lib/logger/log_device.rb#14
+  def initialize(log = T.unsafe(nil), shift_age: T.unsafe(nil), shift_size: T.unsafe(nil), shift_period_suffix: T.unsafe(nil), binmode: T.unsafe(nil), reraise_write_errors: T.unsafe(nil), skip_header: T.unsafe(nil)); end
 
-  # source://logger//logger/log_device.rb#52
+  # source://logger//lib/logger/log_device.rb#38
   def close; end
 
   # Returns the value of attribute dev.
   #
-  # source://logger//logger/log_device.rb#10
+  # source://logger//lib/logger/log_device.rb#10
   def dev; end
 
   # Returns the value of attribute filename.
   #
-  # source://logger//logger/log_device.rb#11
+  # source://logger//lib/logger/log_device.rb#11
   def filename; end
 
-  # source://logger//logger/log_device.rb#62
-  def reopen(log = T.unsafe(nil)); end
+  # source://logger//lib/logger/log_device.rb#48
+  def reopen(log = T.unsafe(nil), shift_age: T.unsafe(nil), shift_size: T.unsafe(nil), shift_period_suffix: T.unsafe(nil), binmode: T.unsafe(nil)); end
 
-  # source://logger//logger/log_device.rb#31
+  # source://logger//lib/logger/log_device.rb#27
   def write(message); end
 
   private
 
-  # source://logger//logger/log_device.rb#119
+  # source://logger//lib/logger/log_device.rb#156
   def add_log_header(file); end
 
-  # source://logger//logger/log_device.rb#125
+  # source://logger//lib/logger/log_device.rb#162
   def check_shift_log; end
 
-  # source://logger//logger/log_device.rb#103
+  # source://logger//lib/logger/log_device.rb#132
   def create_logfile(filename); end
 
-  # source://logger//logger/log_device.rb#145
+  # source://logger//lib/logger/log_device.rb#104
+  def fixup_mode(dev); end
+
+  # source://logger//lib/logger/log_device.rb#148
+  def handle_write_errors(mesg); end
+
+  # source://logger//lib/logger/log_device.rb#177
   def lock_shift_log; end
 
-  # source://logger//logger/log_device.rb#95
+  # source://logger//lib/logger/log_device.rb#119
   def open_logfile(filename); end
 
-  # source://logger//logger/log_device.rb#79
+  # source://logger//lib/logger/log_device.rb#78
   def set_dev(log); end
 
-  # source://logger//logger/log_device.rb#176
+  # source://logger//lib/logger/log_device.rb#92
+  def set_file(shift_age, shift_size, shift_period_suffix); end
+
+  # source://logger//lib/logger/log_device.rb#207
   def shift_log_age; end
 
-  # source://logger//logger/log_device.rb#188
+  # source://logger//lib/logger/log_device.rb#232
+  def shift_log_file(shifted); end
+
+  # source://logger//lib/logger/log_device.rb#216
   def shift_log_period(period_end); end
 end
 
+# :stopdoc:
+#
+# source://logger//lib/logger/log_device.rb#69
+Logger::LogDevice::MODE = T.let(T.unsafe(nil), Integer)
+
+# source://logger//lib/logger/log_device.rb#76
+Logger::LogDevice::MODE_TO_CREATE = T.let(T.unsafe(nil), Integer)
+
+# source://logger//lib/logger/log_device.rb#72
+Logger::LogDevice::MODE_TO_OPEN = T.let(T.unsafe(nil), Integer)
+
+# source://logger//lib/logger/period.rb#4
 module Logger::Period
   private
 
-  # source://logger//logger/period.rb#9
+  # source://logger//lib/logger/period.rb#9
   def next_rotate_time(now, shift_age); end
 
-  # source://logger//logger/period.rb#31
+  # source://logger//lib/logger/period.rb#31
   def previous_period_end(now, shift_age); end
 
   class << self
-    # source://logger//logger/period.rb#9
+    # source://logger//lib/logger/period.rb#9
     def next_rotate_time(now, shift_age); end
 
-    # source://logger//logger/period.rb#31
+    # source://logger//lib/logger/period.rb#31
     def previous_period_end(now, shift_age); end
   end
 end
 
-# source://logger//logger/period.rb#7
+# source://logger//lib/logger/period.rb#7
 Logger::Period::SiD = T.let(T.unsafe(nil), Integer)
 
 # \Severity label for logging (max 5 chars).
 #
-# source://logger//logger.rb#738
+# source://logger//lib/logger.rb#762
 Logger::SEV_LABEL = T.let(T.unsafe(nil), Array)
 
 # Logging severity.
+#
+# source://logger//lib/logger/severity.rb#5
 module Logger::Severity
   class << self
-    # source://logger//logger/severity.rb#29
+    # source://logger//lib/logger/severity.rb#29
     def coerce(severity); end
   end
 end
 
-# source://logger//logger/severity.rb#19
+# source://logger//lib/logger/severity.rb#19
 Logger::Severity::LEVELS = T.let(T.unsafe(nil), Hash)