sorbet-runtime 0.5.10461 → 0.5.10470

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ad78cb1ef08fe9a8f5ac0fe6f69d56ee931dc7768b21761177ea093153a00f7a
-  data.tar.gz: befebc526f225a590a907eac2b05270c09c62c9be7cd59b3a4a14d8f2fc183ac
+  metadata.gz: 379d84e84abe1b5c02ec69fa64d931ad61c1b8d52e9f9fc03dc4123c37f3299f
+  data.tar.gz: 3531d39402cd628392b8a17a80c207fcfc0ac3a82c3409e6445da8178fc87fc9
 SHA512:
-  metadata.gz: 9aa012c622c636cef39a643ce67d0ab5df6ea20326cdc5564c82ca278407ae629e3b786d46ebaee41e79dc533e92bbe08e3f41c23af0a4e12fcfb097a87df245
-  data.tar.gz: 52ee3c205e58e786cab5d1eaa7a4f94addce8a29f6822ca133c55fd817b22666d7bfb8d9bd95ff6e8edada7f442aa07100ce6c8edbfd24b448fc5942d4eff38c
+  metadata.gz: edd9ae63bc0220474cf4210514ed2563e7b77eab79704a9e845f23d8a1023ae13238159bddba0174de7467f2dffc05757c4c346a0a4fa0fc5605ffb571b78849
+  data.tar.gz: bb5e4c7796c5270f49e1b935ae4627c2e6891f2b39eb4adca3421964c8819e7c61e77fa1c2ae590d38810dc5936dd391dce13447565e508ce06179f53167bf65

data/lib/types/_types.rb

@@ -221,6 +221,34 @@ module T
     end
   end
 
+  # A convenience method to `raise` with a provided error reason when the argument
+  # is `nil` and return it otherwise.
+  #
+  # Intended to be used as:
+  #
+  #   needs_foo(T.must_because(maybe_gives_foo) {"reason_foo_should_not_be_nil"})
+  #
+  # Equivalent to:
+  #
+  #   foo = maybe_gives_foo
+  #   raise "reason_foo_should_not_be_nil" if foo.nil?
+  #   needs_foo(foo)
+  #
+  # Intended to be used to promise sorbet that a given nilable value happens
+  # to contain a non-nil value at this point.
+  #
+  # `sig {params(arg: T.nilable(A), reason_blk: T.proc.returns(String)).returns(A)}`
+  def self.must_because(arg)
+    return arg if arg
+    return arg if arg == false
+
+    begin
+      raise TypeError.new("Unexpected `nil` because #{yield}")
+    rescue TypeError => e # raise into rescue to ensure e.backtrace is populated
+      T::Configuration.inline_type_error_handler(e, {kind: 'T.must_because', value: arg, type: nil})
+    end
+  end
+
   # A way to ask Sorbet to show what type it thinks an expression has.
   # This can be useful for debugging and checking assumptions.
   # In the runtime, merely returns the value passed in.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sorbet-runtime
 version: !ruby/object:Gem::Version
-  version: 0.5.10461
+  version: 0.5.10470
 platform: ruby
 authors:
 - Stripe
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-09-28 00:00:00.000000000 Z
+date: 2022-09-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest
@@ -151,7 +151,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: 1.5.3
 description: Sorbet's runtime type checking component
-email: 
+email:
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -245,7 +245,7 @@ licenses:
 - Apache-2.0
 metadata:
   source_code_uri: https://github.com/sorbet/sorbet
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -253,15 +253,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.3.0
+      version: 2.7.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.4
-signing_key: 
+rubygems_version: 3.3.7
+signing_key:
 specification_version: 4
 summary: Sorbet runtime
 test_files: []