mangrove 0.24.0 → 0.29.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aa2f22dcbb9d2f0da9e28c414cb0c5031ca0e85efae1fb1ff43f9f7fedb27467
-  data.tar.gz: ee48cde475b14fd8d1f558b77b9208c597d39ed6e94280008c08b722bc870ad2
+  metadata.gz: 664bbac8105d664cdea4ffc16072f956cc8268eedaccdd5b22082a84acc3d26e
+  data.tar.gz: e905b62cf22c734639f085c421d5c3d4fd76612187c7e3abdcadc336b8dd387a
 SHA512:
-  metadata.gz: bc8872e6bc079a3ff532212477cced1f87f09fc0f600c0a6a2abad0ce4ba46689dcafda6f9ec7519f33b76c45cdc0bfde527c60f85a25cbea069d3c68e64d981
-  data.tar.gz: 22092ce2f3907e1419efb6686e5fd588ed39d37d40f6fa1a0a5b446655fd2e90e6466cace05ec7e993b3d2d57bc1a994698d531c2fe7102cfc6f016f5164134f
+  metadata.gz: fe4154f82a4c9d2a5cdba0470f7eae09a1fec76dc0b03f562b90b101bfacfa5cf5c47b2463935c066aa5630a6a4ec070d2dbe7d89c22aa18e4a1b283d783e292
+  data.tar.gz: e9ca01c44f84ce9e9ae2d633ea4db4ec2315045bef47ce4cc8a5d52c3cf7b0db18f5f75687e4d5daf34454518b13004926e5d718039f71ba8084736258e806e5

data/README.md

@@ -1,14 +1,12 @@
 # Mangrove
-Mangrove provides type utility to use with Sorbet.
 
 Mangrove is a Ruby Gem designed to be the definitive toolkit for leveraging Sorbet's type system in Ruby applications. It's designed to offer a robust, statically-typed experience, focusing on solid types, a functional programming style, and an interface-driven approach.
 
-Use `rubocop-mangrove` to statically check rescuing ControlSignal is done
-
 - [Documentation](https://kazzix14.github.io/mangrove/docs/)
 - [Coverage](https://kazzix14.github.io/mangrove/coverage/index.html#_AllFiles)
 
 ## Features
+
 - Option Type
 - Result Type
 - Enums with inner types (ADTs)
@@ -36,9 +34,38 @@ my_ok = Result::Ok.new("my value")
 my_err = Result::Err.new("my err")
 my_some = Option::Some.new(1234)
 my_none = Option::None.new
+
+##############################
+
+response = MyClient
+  .new
+  .and_then { |client| client.get_response() }
+  .and_then { |response| response.body }
+
+case response
+when Mangrove::Result::Ok
+  puts response.ok_inner
+when Mangrove::Result::Err
+  puts response.err_inner
+end
+
+##############################
+
+class MyEnum
+  extend Mangrove::Enum
+
+  variants do
+    variant VariantWithInteger, Integer
+    variant VariantWithString, String
+    variant VariantWithException, Exception
+    variant VariantWithTuple, [Integer, String]
+    variant VariantWithShape, { name: String, age: Integer }
+  end
+end
 ```
 
 ## Commands for Development
+
 ```
 git config core.hooksPath hooks
 bundle install

data/lib/mangrove/result.rb

@@ -51,7 +51,7 @@ module Mangrove
     sig { abstract.type_parameters(:NewOkType, :NewErrType).params(block: T.proc.params(this: Result[OkType, ErrType]).returns(Result[T.type_parameter(:NewOkType), T.type_parameter(:NewErrType)])).returns(Result[T.type_parameter(:NewOkType), T.type_parameter(:NewErrType)]) }
     def map(&block); end
 
-    sig { abstract.type_parameters(:NewOkType, :NewErrType).params(_t_new_ok: T.type_parameter(:NewOkType), _t_new_err: T.type_parameter(:NewErrType), block: T.proc.params(this: Result[OkType, ErrType]).returns(Result[T.type_parameter(:NewOkType), T.type_parameter(:NewErrType)])).returns(Result[T.type_parameter(:NewOkType), T.type_parameter(:NewErrType)]) }
+    sig { abstract.type_parameters(:NewOkType, :NewErrType).params(_t_new_ok: T::Class[T.type_parameter(:NewOkType)], _t_new_err: T::Class[T.type_parameter(:NewErrType)], block: T.proc.params(this: Result[OkType, ErrType]).returns(Result[T.type_parameter(:NewOkType), T.type_parameter(:NewErrType)])).returns(Result[T.type_parameter(:NewOkType), T.type_parameter(:NewErrType)]) }
     def map_wt(_t_new_ok, _t_new_err, &block); end
 
     sig { abstract.type_parameters(:NewOkType).params(block: T.proc.params(this: OkType).returns(T.type_parameter(:NewOkType))).returns(Result[T.type_parameter(:NewOkType), ErrType]) }
@@ -225,7 +225,7 @@ module Mangrove
         block.call(self)
       end
 
-      sig { override.type_parameters(:NewOkType, :NewErrType).params(_t_new_ok: T.type_parameter(:NewOkType), _t_new_err: T.type_parameter(:NewErrType), block: T.proc.params(this: Result[OkType, ErrType]).returns(Result[T.type_parameter(:NewOkType), T.type_parameter(:NewErrType)])).returns(Result[T.type_parameter(:NewOkType), T.type_parameter(:NewErrType)]) }
+      sig { override.type_parameters(:NewOkType, :NewErrType).params(_t_new_ok: T::Class[T.type_parameter(:NewOkType)], _t_new_err: T::Class[T.type_parameter(:NewErrType)], block: T.proc.params(this: Result[OkType, ErrType]).returns(Result[T.type_parameter(:NewOkType), T.type_parameter(:NewErrType)])).returns(Result[T.type_parameter(:NewOkType), T.type_parameter(:NewErrType)]) }
       def map_wt(_t_new_ok, _t_new_err, &block)
         block.call(self)
       end
@@ -396,7 +396,7 @@ module Mangrove
         block.call(self)
       end
 
-      sig { override.type_parameters(:NewOkType, :NewErrType).params(_t_new_ok: T.type_parameter(:NewOkType), _t_new_err: T.type_parameter(:NewErrType), block: T.proc.params(this: Result[OkType, ErrType]).returns(Result[T.type_parameter(:NewOkType), T.type_parameter(:NewErrType)])).returns(Result[T.type_parameter(:NewOkType), T.type_parameter(:NewErrType)]) }
+      sig { override.type_parameters(:NewOkType, :NewErrType).params(_t_new_ok: T::Class[T.type_parameter(:NewOkType)], _t_new_err: T::Class[T.type_parameter(:NewErrType)], block: T.proc.params(this: Result[OkType, ErrType]).returns(Result[T.type_parameter(:NewOkType), T.type_parameter(:NewErrType)])).returns(Result[T.type_parameter(:NewOkType), T.type_parameter(:NewErrType)]) }
       def map_wt(_t_new_ok, _t_new_err, &block)
         block.call(self)
       end

data/lib/mangrove/version.rb

@@ -2,5 +2,5 @@
 # frozen_string_literal: true
 
 module Mangrove
-  VERSION = "0.24.0"
+  VERSION = "0.29.0"
 end

data/rbi/mangrove.rbi

@@ -0,0 +1,20 @@
+# typed: true
+
+module Mangrove
+  # Result is a type that represents either success (`Ok`) or failure (`Err`).
+  module Result
+    class Err
+      class << self
+        sig { type_parameters(:ErrType).params(inner: T.type_parameter(:ErrType)).returns(Mangrove::Result::Err[T.untyped, T.type_parameter(:ErrType)]) }
+        def new(inner); end
+      end
+    end
+
+    class Ok
+      class << self
+        sig { type_parameters(:OkType).params(inner: T.type_parameter(:OkType)).returns(Mangrove::Result::Ok[T.type_parameter(:OkType), T.untyped]) }
+        def new(inner); end
+      end
+    end
+  end
+end

data/sorbet/rbi/gems/{json@2.6.3.rbi → json@2.7.1.rbi}

@@ -1,4 +1,4 @@
-# typed: true
+# typed: false
 
 # DO NOT EDIT MANUALLY
 # This is an autogenerated file for types exported from the `json` gem.
@@ -6,7 +6,7 @@
 
 # Extends any Class to include _json_creatable?_ method.
 #
-# source://json//lib/json/common.rb#695
+# source://json//lib/json/common.rb#689
 class Class < ::Module
   # Returns true if this class can be used to create an instance
   # from a serialised JSON string. The class has to implement a class
@@ -15,7 +15,7 @@ class Class < ::Module
   #
   # @return [Boolean]
   #
-  # source://json//lib/json/common.rb#700
+  # source://json//lib/json/common.rb#694
   def json_creatable?; end
 end
 
@@ -302,6 +302,15 @@ end
 #   # Raises JSON::NestingError (nesting of 2 is too deep):
 #   JSON.generate(obj, max_nesting: 2)
 #
+# ====== Escaping Options
+#
+# Options +script_safe+ (boolean) specifies wether <tt>'\u2028'</tt>, <tt>'\u2029'</tt>
+# and <tt>'/'</tt> should be escaped as to make the JSON object safe to interpolate in script
+# tags.
+#
+# Options +ascii_only+ (boolean) specifies wether all characters outside the ASCII range
+# should be escaped.
+#
 # ====== Output Options
 #
 # The default formatting options generate the most compact
@@ -621,8 +630,8 @@ module JSON
   # Output:
   #   {"foo":[0,1],"bar":{"baz":2,"bat":3},"bam":"bad"}
   #
-  # source://json//lib/json/common.rb#631
-  def dump(obj, anIO = T.unsafe(nil), limit = T.unsafe(nil)); end
+  # source://json//lib/json/common.rb#614
+  def dump(obj, anIO = T.unsafe(nil), limit = T.unsafe(nil), kwargs = T.unsafe(nil)); end
 
   # :call-seq:
   #   JSON.fast_generate(obj, opts) -> new_string
@@ -638,13 +647,13 @@ module JSON
   #   # Raises SystemStackError (stack level too deep):
   #   JSON.fast_generate(a)
   #
-  # source://json//lib/json/common.rb#335
+  # source://json//lib/json/common.rb#328
   def fast_generate(obj, opts = T.unsafe(nil)); end
 
   # :stopdoc:
   # I want to deprecate these later, so I'll first be silent about them, and later delete them.
   #
-  # source://json//lib/json/common.rb#335
+  # source://json//lib/json/common.rb#328
   def fast_unparse(obj, opts = T.unsafe(nil)); end
 
   # :call-seq:
@@ -683,7 +692,7 @@ module JSON
   #   # Raises JSON::NestingError (nesting of 100 is too deep):
   #   JSON.generate(a)
   #
-  # source://json//lib/json/common.rb#296
+  # source://json//lib/json/common.rb#299
   def generate(obj, opts = T.unsafe(nil)); end
 
   # :call-seq:
@@ -814,7 +823,7 @@ module JSON
   #      #<Admin:0x00000000064c41f8
   #      @attributes={"type"=>"Admin", "password"=>"0wn3d"}>}
   #
-  # source://json//lib/json/common.rb#557
+  # source://json//lib/json/common.rb#540
   def load(source, proc = T.unsafe(nil), options = T.unsafe(nil)); end
 
   # :call-seq:
@@ -825,7 +834,7 @@ module JSON
   #
   # See method #parse.
   #
-  # source://json//lib/json/common.rb#245
+  # source://json//lib/json/common.rb#248
   def load_file(filespec, opts = T.unsafe(nil)); end
 
   # :call-seq:
@@ -836,9 +845,12 @@ module JSON
   #
   # See method #parse!
   #
-  # source://json//lib/json/common.rb#256
+  # source://json//lib/json/common.rb#259
   def load_file!(filespec, opts = T.unsafe(nil)); end
 
+  # source://json//lib/json/common.rb#642
+  def merge_dump_options(opts, strict: T.unsafe(nil)); end
+
   # :call-seq:
   #   JSON.parse(source, opts) -> object
   #
@@ -887,7 +899,7 @@ module JSON
   #   # Raises JSON::ParserError (783: unexpected token at ''):
   #   JSON.parse('')
   #
-  # source://json//lib/json/common.rb#215
+  # source://json//lib/json/common.rb#218
   def parse(source, opts = T.unsafe(nil)); end
 
   # :call-seq:
@@ -902,7 +914,7 @@ module JSON
   #   which disables checking for nesting depth.
   # - Option +allow_nan+, if not provided, defaults to +true+.
   #
-  # source://json//lib/json/common.rb#230
+  # source://json//lib/json/common.rb#233
   def parse!(source, opts = T.unsafe(nil)); end
 
   # :call-seq:
@@ -935,28 +947,28 @@ module JSON
   #     }
   #   }
   #
-  # source://json//lib/json/common.rb#390
+  # source://json//lib/json/common.rb#373
   def pretty_generate(obj, opts = T.unsafe(nil)); end
 
   # :stopdoc:
   # I want to deprecate these later, so I'll first be silent about them, and later delete them.
   #
-  # source://json//lib/json/common.rb#390
+  # source://json//lib/json/common.rb#373
   def pretty_unparse(obj, opts = T.unsafe(nil)); end
 
   # Recursively calls passed _Proc_ if the parsed data structure is an _Array_ or _Hash_
   #
-  # source://json//lib/json/common.rb#575
+  # source://json//lib/json/common.rb#558
   def recurse_proc(result, &proc); end
 
-  # source://json//lib/json/common.rb#557
+  # source://json//lib/json/common.rb#540
   def restore(source, proc = T.unsafe(nil), options = T.unsafe(nil)); end
 
   # :stopdoc:
   # I want to deprecate these later, so I'll first be silent about them, and
   # later delete them.
   #
-  # source://json//lib/json/common.rb#296
+  # source://json//lib/json/common.rb#299
   def unparse(obj, opts = T.unsafe(nil)); end
 
   class << self
@@ -972,26 +984,26 @@ module JSON
     #   ruby = [0, 1, nil]
     #   JSON[ruby] # => '[0,1,null]'
     #
-    # source://json//lib/json/common.rb#18
+    # source://json//lib/json/common.rb#21
     def [](object, opts = T.unsafe(nil)); end
 
-    # source://json//lib/json/common.rb#81
+    # source://json//lib/json/common.rb#84
     def create_fast_state; end
 
     # Returns the current create identifier.
     # See also JSON.create_id=.
     #
-    # source://json//lib/json/common.rb#126
+    # source://json//lib/json/common.rb#129
     def create_id; end
 
     # Sets create identifier, which is used to decide if the _json_create_
     # hook of a class should be called; initial value is +json_class+:
     #   JSON.create_id # => 'json_class'
     #
-    # source://json//lib/json/common.rb#120
+    # source://json//lib/json/common.rb#123
     def create_id=(new_value); end
 
-    # source://json//lib/json/common.rb#91
+    # source://json//lib/json/common.rb#94
     def create_pretty_state; end
 
     # Return the constant located at _path_. The format of _path_ has to be
@@ -999,7 +1011,7 @@ module JSON
     # level (absolute namespace path?). If there doesn't exist a constant at
     # the given path, an ArgumentError is raised.
     #
-    # source://json//lib/json/common.rb#42
+    # source://json//lib/json/common.rb#45
     def deep_const_get(path); end
 
     # :call-seq:
@@ -1030,23 +1042,23 @@ module JSON
     # Output:
     #   {"foo":[0,1],"bar":{"baz":2,"bat":3},"bam":"bad"}
     #
-    # source://json//lib/json/common.rb#631
-    def dump(obj, anIO = T.unsafe(nil), limit = T.unsafe(nil)); end
+    # source://json//lib/json/common.rb#614
+    def dump(obj, anIO = T.unsafe(nil), limit = T.unsafe(nil), kwargs = T.unsafe(nil)); end
 
     # Sets or returns the default options for the JSON.dump method.
     # Initially:
     #   opts = JSON.dump_default_options
-    #   opts # => {:max_nesting=>false, :allow_nan=>true, :escape_slash=>false}
+    #   opts # => {:max_nesting=>false, :allow_nan=>true, :script_safe=>false}
     #
-    # source://json//lib/json/common.rb#596
+    # source://json//lib/json/common.rb#579
     def dump_default_options; end
 
     # Sets or returns the default options for the JSON.dump method.
     # Initially:
     #   opts = JSON.dump_default_options
-    #   opts # => {:max_nesting=>false, :allow_nan=>true, :escape_slash=>false}
+    #   opts # => {:max_nesting=>false, :allow_nan=>true, :script_safe=>false}
     #
-    # source://json//lib/json/common.rb#596
+    # source://json//lib/json/common.rb#579
     def dump_default_options=(_arg0); end
 
     # :call-seq:
@@ -1063,13 +1075,13 @@ module JSON
     #   # Raises SystemStackError (stack level too deep):
     #   JSON.fast_generate(a)
     #
-    # source://json//lib/json/common.rb#335
+    # source://json//lib/json/common.rb#328
     def fast_generate(obj, opts = T.unsafe(nil)); end
 
     # :stopdoc:
     # I want to deprecate these later, so I'll first be silent about them, and later delete them.
     #
-    # source://json//lib/json/common.rb#335
+    # source://json//lib/json/common.rb#328
     def fast_unparse(obj, opts = T.unsafe(nil)); end
 
     # :call-seq:
@@ -1108,24 +1120,24 @@ module JSON
     #   # Raises JSON::NestingError (nesting of 100 is too deep):
     #   JSON.generate(a)
     #
-    # source://json//lib/json/common.rb#296
+    # source://json//lib/json/common.rb#299
     def generate(obj, opts = T.unsafe(nil)); end
 
     # Returns the JSON generator module that is used by JSON. This is
     # either JSON::Ext::Generator or JSON::Pure::Generator:
     #   JSON.generator # => JSON::Ext::Generator
     #
-    # source://json//lib/json/common.rb#103
+    # source://json//lib/json/common.rb#106
     def generator; end
 
     # Set the module _generator_ to be used by JSON.
     #
-    # source://json//lib/json/common.rb#58
+    # source://json//lib/json/common.rb#61
     def generator=(generator); end
 
     # Encodes string using String.encode.
     #
-    # source://json//lib/json/common.rb#653
+    # source://json//lib/json/common.rb#638
     def iconv(to, from, string); end
 
     # :call-seq:
@@ -1256,7 +1268,7 @@ module JSON
     #      #<Admin:0x00000000064c41f8
     #      @attributes={"type"=>"Admin", "password"=>"0wn3d"}>}
     #
-    # source://json//lib/json/common.rb#557
+    # source://json//lib/json/common.rb#540
     def load(source, proc = T.unsafe(nil), options = T.unsafe(nil)); end
 
     # Sets or returns default options for the JSON.load method.
@@ -1264,7 +1276,7 @@ module JSON
     #   opts = JSON.load_default_options
     #   opts # => {:max_nesting=>false, :allow_nan=>true, :allow_blank=>true, :create_additions=>true}
     #
-    # source://json//lib/json/common.rb#420
+    # source://json//lib/json/common.rb#403
     def load_default_options; end
 
     # Sets or returns default options for the JSON.load method.
@@ -1272,7 +1284,7 @@ module JSON
     #   opts = JSON.load_default_options
     #   opts # => {:max_nesting=>false, :allow_nan=>true, :allow_blank=>true, :create_additions=>true}
     #
-    # source://json//lib/json/common.rb#420
+    # source://json//lib/json/common.rb#403
     def load_default_options=(_arg0); end
 
     # :call-seq:
@@ -1283,7 +1295,7 @@ module JSON
     #
     # See method #parse.
     #
-    # source://json//lib/json/common.rb#245
+    # source://json//lib/json/common.rb#248
     def load_file(filespec, opts = T.unsafe(nil)); end
 
     # :call-seq:
@@ -1294,7 +1306,7 @@ module JSON
     #
     # See method #parse!
     #
-    # source://json//lib/json/common.rb#256
+    # source://json//lib/json/common.rb#259
     def load_file!(filespec, opts = T.unsafe(nil)); end
 
     # :call-seq:
@@ -1345,7 +1357,7 @@ module JSON
     #   # Raises JSON::ParserError (783: unexpected token at ''):
     #   JSON.parse('')
     #
-    # source://json//lib/json/common.rb#215
+    # source://json//lib/json/common.rb#218
     def parse(source, opts = T.unsafe(nil)); end
 
     # :call-seq:
@@ -1360,19 +1372,19 @@ module JSON
     #   which disables checking for nesting depth.
     # - Option +allow_nan+, if not provided, defaults to +true+.
     #
-    # source://json//lib/json/common.rb#230
+    # source://json//lib/json/common.rb#233
     def parse!(source, opts = T.unsafe(nil)); end
 
     # Returns the JSON parser class that is used by JSON. This is either
     # JSON::Ext::Parser or JSON::Pure::Parser:
     #   JSON.parser # => JSON::Ext::Parser
     #
-    # source://json//lib/json/common.rb#29
+    # source://json//lib/json/common.rb#32
     def parser; end
 
     # Set the JSON parser class _parser_ to be used by JSON.
     #
-    # source://json//lib/json/common.rb#32
+    # source://json//lib/json/common.rb#35
     def parser=(parser); end
 
     # :call-seq:
@@ -1405,50 +1417,55 @@ module JSON
     #     }
     #   }
     #
-    # source://json//lib/json/common.rb#390
+    # source://json//lib/json/common.rb#373
     def pretty_generate(obj, opts = T.unsafe(nil)); end
 
     # :stopdoc:
     # I want to deprecate these later, so I'll first be silent about them, and later delete them.
     #
-    # source://json//lib/json/common.rb#390
+    # source://json//lib/json/common.rb#373
     def pretty_unparse(obj, opts = T.unsafe(nil)); end
 
     # Recursively calls passed _Proc_ if the parsed data structure is an _Array_ or _Hash_
     #
-    # source://json//lib/json/common.rb#575
+    # source://json//lib/json/common.rb#558
     def recurse_proc(result, &proc); end
 
-    # source://json//lib/json/common.rb#557
+    # source://json//lib/json/common.rb#540
     def restore(source, proc = T.unsafe(nil), options = T.unsafe(nil)); end
 
     # Sets or Returns the JSON generator state class that is used by JSON. This is
     # either JSON::Ext::Generator::State or JSON::Pure::Generator::State:
     #   JSON.state # => JSON::Ext::Generator::State
     #
-    # source://json//lib/json/common.rb#108
+    # source://json//lib/json/common.rb#111
     def state; end
 
     # Sets or Returns the JSON generator state class that is used by JSON. This is
     # either JSON::Ext::Generator::State or JSON::Pure::Generator::State:
     #   JSON.state # => JSON::Ext::Generator::State
     #
-    # source://json//lib/json/common.rb#108
+    # source://json//lib/json/common.rb#111
     def state=(_arg0); end
 
     # :stopdoc:
     # I want to deprecate these later, so I'll first be silent about them, and
     # later delete them.
     #
-    # source://json//lib/json/common.rb#296
+    # source://json//lib/json/common.rb#299
     def unparse(obj, opts = T.unsafe(nil)); end
+
+    private
+
+    # source://json//lib/json/common.rb#642
+    def merge_dump_options(opts, strict: T.unsafe(nil)); end
   end
 end
 
-# source://json//lib/json/common.rb#114
+# source://json//lib/json/common.rb#117
 JSON::CREATE_ID_TLS_KEY = T.let(T.unsafe(nil), String)
 
-# source://json//lib/json/common.rb#111
+# source://json//lib/json/common.rb#114
 JSON::DEFAULT_CREATE_ID = T.let(T.unsafe(nil), String)
 
 # source://json//lib/json/generic_object.rb#5
@@ -1494,26 +1511,29 @@ end
 
 # The base exception for JSON errors.
 #
-# source://json//lib/json/common.rb#137
+# source://json//lib/json/common.rb#140
 class JSON::JSONError < ::StandardError
   class << self
-    # source://json//lib/json/common.rb#138
+    # source://json//lib/json/common.rb#141
     def wrap(exception); end
   end
 end
 
-# source://json//lib/json/common.rb#35
+# source://json//lib/json/common.rb#6
+JSON::NOT_SET = T.let(T.unsafe(nil), Object)
+
+# source://json//lib/json/common.rb#38
 JSON::Parser = JSON::Ext::Parser
 
-# source://json//lib/json/common.rb#73
+# source://json//lib/json/common.rb#76
 JSON::State = JSON::Ext::Generator::State
 
 # For backwards compatibility
 #
-# source://json//lib/json/common.rb#159
+# source://json//lib/json/common.rb#162
 JSON::UnparserError = JSON::GeneratorError
 
-# source://json//lib/json/common.rb#658
+# source://json//lib/json/common.rb#652
 module Kernel
   private
 
@@ -1524,18 +1544,18 @@ module Kernel
   # The _opts_ argument is passed through to generate/parse respectively. See
   # generate and parse for their documentation.
   #
-  # source://json//lib/json/common.rb#685
+  # source://json//lib/json/common.rb#679
   def JSON(object, *args); end
 
   # Outputs _objs_ to STDOUT as JSON strings in the shortest form, that is in
   # one line.
   #
-  # source://json//lib/json/common.rb#663
+  # source://json//lib/json/common.rb#657
   def j(*objs); end
 
   # Outputs _objs_ to STDOUT as JSON strings in a pretty format, with
   # indentation and over many lines.
   #
-  # source://json//lib/json/common.rb#672
+  # source://json//lib/json/common.rb#666
   def jj(*objs); end
 end