tapioca 0.17.10 → 0.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fd0aedb9a8295fc96a30b43e9a3da1f84bebdf3f97bb2fbd1fd99375fdad6fc1
-  data.tar.gz: 2c649b047df9cb012f7ed8502c9206e419e70a6bc7c1d2d07785aaad51af649e
+  metadata.gz: 1af20de26e446268513156110cac416ce7ba2b35f96f4bb7898960d640aa4333
+  data.tar.gz: 4d760ed85be418d9c9dc166d61ea59ccaf312c929bd4930709abc4b946f3876f
 SHA512:
-  metadata.gz: d1fe2a59d4570b065179f64d6de4e6bd27f494b2c23545c4a2ccf64a9cf33383ca5fd99a5eaf1ac3d93ff720b68780504b09beb501ad5567c6ea5c917d9004fe
-  data.tar.gz: '08514a0edef06b920cc2a07493f86f9a428e33554d1509210cfc4a0d044735303043efceb1a14f3ce2d18b29d4693bcd8e36a9153c4c4c836aa0fcbacd5110ef'
+  metadata.gz: 1bf6bbf64b782f072a23109ca90cf9c3743b82501bf304badcd97b816583f2fff3ec3574d58df22f05af716d750ba86589074f43a1ee5d3f9e383fdb83c8ee02
+  data.tar.gz: a4d066179177ee84ee349bb7a8514d9b2ad8836051b33adc45ca3708948ddc01a002d6d54fd9c42cc0993ca5e30f74a61f5f5ad8a603ef493b50bee0c7d6ef93

data/README.md

@@ -87,6 +87,7 @@ Commands:
   tapioca init               # Get project ready for type checking
   tapioca require            # Generate the list of files to be required by tapioca
   tapioca todo               # Generate the list of unresolved constants
+  tapioca tree               # Print a tree of all available commands
 
 Options:
   -c, [--config=<config file path>]                  # Path to the Tapioca configuration file
@@ -160,7 +161,7 @@ All operations performed in working directory.
 Please review changes and commit them.
 ```
 
-This will load your application, find all the gems required by it and generate an RBI file for each gem under the `sorbet/rbi/gems` directory for each of those gems. This process will also import signatures that can be found inside each gem sources, and, optionally, any YARD documentation inside the gem.
+This will load your application, find all the gems required by it and generate an RBI file for each gem under the `sorbet/rbi/gems` directory for each of those gems. This process will also import signatures that can be found inside each gem sources, and, optionally, any documentation inside the gem.
 
 <!-- START_HELP_COMMAND_GEM -->
 ```shell
@@ -186,7 +187,7 @@ Options:
                                                                                                      # Default: {"activesupport" => "false"}
                [--verify], [--no-verify], [--skip-verify]                                            # Verify RBIs are up-to-date
                                                                                                      # Default: false
-               [--doc], [--no-doc], [--skip-doc]                                                     # Include YARD documentation from sources when generating RBIs. Warning: this might be slow
+               [--doc], [--no-doc], [--skip-doc]                                                     # Include documentation from sources when generating RBIs
                                                                                                      # Default: true
                [--loc], [--no-loc], [--skip-loc]                                                     # Include comments with source location when generating RBIs
                                                                                                      # Default: true

data/lib/tapioca/bundler_ext/auto_require_hook.rb

@@ -8,13 +8,10 @@ module Tapioca
     # `Bundler.require`.
     # @requires_ancestor: ::Bundler::Dependency
     module AutoRequireHook
-      extend T::Sig
       @exclude = [] #: Array[String]
       @enabled = false #: bool
 
       class << self
-        extend T::Sig
-
         #: (untyped name) -> bool
         def excluded?(name)
           @exclude.include?(name)

data/lib/tapioca/cli.rb

@@ -225,7 +225,7 @@ module Tapioca
       default: false
     option :doc,
       type: :boolean,
-      desc: "Include YARD documentation from sources when generating RBIs. Warning: this might be slow",
+      desc: "Include documentation from sources when generating RBIs",
       default: true
     option :loc,
       type: :boolean,
@@ -378,8 +378,6 @@ module Tapioca
       @addon_mode = false
 
       class << self
-        extend T::Sig
-
         # Indicates that we are running from the LSP, set using the `addon_mode!` method
         attr_reader :addon_mode
 

data/lib/tapioca/commands/annotations.rb

@@ -4,8 +4,6 @@
 module Tapioca
   module Commands
     class Annotations < CommandWithoutTracker
-      extend T::Sig
-
       #: (
       #|   central_repo_root_uris: Array[String],
       #|   ?auth: String?,

data/lib/tapioca/commands/check_shims.rb

@@ -4,7 +4,6 @@
 module Tapioca
   module Commands
     class CheckShims < CommandWithoutTracker
-      extend T::Sig
       include SorbetHelper
       include RBIFilesHelper
 

data/lib/tapioca/commands/command.rb

@@ -5,7 +5,6 @@ module Tapioca
   module Commands
     # @abstract
     class Command
-      extend T::Sig
       class FileWriter < Thor
         include Thor::Actions
       end

data/lib/tapioca/dsl/compiler.rb

@@ -6,8 +6,6 @@ module Tapioca
     # @abstract
     #: [ConstantType < T::Module[top]]
     class Compiler
-      extend T::Sig
-
       include RBIHelper
       include Runtime::Reflection
       extend Runtime::Reflection
@@ -24,8 +22,6 @@ module Tapioca
       @@requested_constants = [] #: Array[T::Module[top]] # rubocop:disable Style/ClassVars
 
       class << self
-        extend T::Sig
-
         #: (T::Module[top] constant) -> bool
         def handles?(constant)
           processable_constants.include?(constant)
@@ -143,11 +139,16 @@ module Tapioca
 
       #: (RBI::Scope scope, (Method | UnboundMethod) method_def, ?class_method: bool) -> void
       def create_method_from_def(scope, method_def, class_method: false)
+        parameters = compile_method_parameters_to_rbi(method_def)
+        return_type = compile_method_return_type_to_rbi(method_def)
+        type_params = extract_type_parameters(parameters.map(&:type).push(return_type))
+
         scope.create_method(
           method_def.name.to_s,
-          parameters: compile_method_parameters_to_rbi(method_def),
-          return_type: compile_method_return_type_to_rbi(method_def),
+          parameters: parameters,
+          return_type: return_type,
           class_method: class_method,
+          type_params: type_params,
         )
       end
 

data/lib/tapioca/dsl/compilers/aasm.rb

@@ -34,8 +34,6 @@ module Tapioca
       #
       #: [ConstantType = (Class[::AASM] & ::AASM::ClassMethods)]
       class AASM < Compiler
-        extend T::Sig
-
         # Taken directly from the AASM::Core::Event class, here:
         # https://github.com/aasm/aasm/blob/0e03746/lib/aasm/core/event.rb#L21-L29
         EVENT_CALLBACKS = [
@@ -92,7 +90,10 @@ module Tapioca
               end
 
               # Create all of the methods for each event
-              parameters = [create_rest_param("opts", type: "T.untyped")]
+              parameters = [
+                create_rest_param("opts", type: "T.untyped"),
+                create_block_param("block", type: "T.nilable(T.proc.void)"),
+              ]
               state_machine.events.each do |event|
                 model.create_method(event.name.to_s, parameters: parameters)
                 model.create_method("#{event.name}!", parameters: parameters)
@@ -200,8 +201,6 @@ module Tapioca
         end
 
         class << self
-          extend T::Sig
-
           # @override
           #: -> Enumerable[T::Module[top]]
           def gather_constants

data/lib/tapioca/dsl/compilers/action_controller_helpers.rb

@@ -63,8 +63,6 @@ module Tapioca
       # ~~~
       #: [ConstantType = singleton(::ActionController::Base)]
       class ActionControllerHelpers < Compiler
-        extend T::Sig
-
         # @override
         #: -> void
         def decorate
@@ -118,8 +116,6 @@ module Tapioca
         end
 
         class << self
-          extend T::Sig
-
           # @override
           #: -> Enumerable[T::Module[top]]
           def gather_constants

data/lib/tapioca/dsl/compilers/action_mailer.rb

@@ -31,8 +31,6 @@ module Tapioca
       # ~~~
       #: [ConstantType = singleton(::ActionMailer::Base)]
       class ActionMailer < Compiler
-        extend T::Sig
-
         # @override
         #: -> void
         def decorate
@@ -51,8 +49,6 @@ module Tapioca
         end
 
         class << self
-          extend T::Sig
-
           # @override
           #: -> Enumerable[T::Module[top]]
           def gather_constants

data/lib/tapioca/dsl/compilers/action_text.rb

@@ -45,8 +45,6 @@ module Tapioca
       # ~~~
       #: [ConstantType = singleton(::ActiveRecord::Base)]
       class ActionText < Compiler
-        extend T::Sig
-
         # @override
         #: -> void
         def decorate
@@ -73,8 +71,6 @@ module Tapioca
         end
 
         class << self
-          extend T::Sig
-
           #: (singleton(::ActiveRecord::Base) constant) -> Array[String]
           def action_text_associations(constant)
             # Implementation copied from https://github.com/rails/rails/blob/31052d0e518b9da103eea2f79d250242ed1e3705/actiontext/lib/action_text/attribute.rb#L66

data/lib/tapioca/dsl/compilers/active_job.rb

@@ -40,8 +40,6 @@ module Tapioca
       # ~~~
       #: [ConstantType = singleton(::ActiveJob::Base)]
       class ActiveJob < Compiler
-        extend T::Sig
-
         # @override
         #: -> void
         def decorate
@@ -85,8 +83,6 @@ module Tapioca
         end
 
         class << self
-          extend T::Sig
-
           # @override
           #: -> Enumerable[T::Module[top]]
           def gather_constants

data/lib/tapioca/dsl/compilers/active_model_attributes.rb

@@ -40,8 +40,6 @@ module Tapioca
       # ~~~
       #: [ConstantType = (Class[::ActiveModel::Attributes] & ::ActiveModel::Attributes::ClassMethods)]
       class ActiveModelAttributes < Compiler
-        extend T::Sig
-
         # @override
         #: -> void
         def decorate
@@ -60,8 +58,6 @@ module Tapioca
         end
 
         class << self
-          extend T::Sig
-
           # @override
           #: -> Enumerable[T::Module[top]]
           def gather_constants

data/lib/tapioca/dsl/compilers/active_model_secure_password.rb

@@ -55,8 +55,6 @@ module Tapioca
       # ~~~
       #: [ConstantType = (Class[::ActiveModel::SecurePassword] & ::ActiveModel::SecurePassword::ClassMethods)]
       class ActiveModelSecurePassword < Compiler
-        extend T::Sig
-
         # @override
         #: -> void
         def decorate
@@ -90,8 +88,6 @@ module Tapioca
         end
 
         class << self
-          extend T::Sig
-
           # @override
           #: -> Enumerable[T::Module[top]]
           def gather_constants

data/lib/tapioca/dsl/compilers/active_model_validations_confirmation.rb

@@ -42,8 +42,6 @@ module Tapioca
       # ~~~
       #: [ConstantType = (Class[ActiveModel::Validations] & ActiveModel::Validations::HelperMethods & ActiveModel::Validations::ClassMethods)]
       class ActiveModelValidationsConfirmation < Compiler
-        extend T::Sig
-
         class << self
           # @override
           #: -> Enumerable[T::Module[top]]

data/lib/tapioca/dsl/compilers/active_record_associations.rb

@@ -103,15 +103,12 @@ module Tapioca
       # ~~~
       #: [ConstantType = singleton(ActiveRecord::Base)]
       class ActiveRecordAssociations < Compiler
-        extend T::Sig
         include Helpers::ActiveRecordConstantsHelper
 
         class SourceReflectionError < StandardError
         end
 
         class MissingConstantError < StandardError
-          extend T::Sig
-
           #: String
           attr_reader :class_name
 
@@ -138,8 +135,6 @@ module Tapioca
         end
 
         class << self
-          extend T::Sig
-
           # @override
           #: -> Enumerable[T::Module[top]]
           def gather_constants

data/lib/tapioca/dsl/compilers/active_record_columns.rb

@@ -122,7 +122,6 @@ module Tapioca
       # ~~~
       #: [ConstantType = singleton(ActiveRecord::Base)]
       class ActiveRecordColumns < Compiler
-        extend T::Sig
         include Helpers::ActiveRecordConstantsHelper
 
         # @override
@@ -163,8 +162,6 @@ module Tapioca
         end
 
         class << self
-          extend T::Sig
-
           # @override
           #: -> Enumerable[T::Module[top]]
           def gather_constants

data/lib/tapioca/dsl/compilers/active_record_delegated_types.rb

@@ -65,7 +65,6 @@ module Tapioca
       # ~~~
       #: [ConstantType = (singleton(ActiveRecord::Base) & Extensions::ActiveRecord)]
       class ActiveRecordDelegatedTypes < Compiler
-        extend T::Sig
         include Helpers::ActiveRecordConstantsHelper
 
         # @override
@@ -88,8 +87,6 @@ module Tapioca
         end
 
         class << self
-          extend T::Sig
-
           # @override
           #: -> Enumerable[T::Module[top]]
           def gather_constants

data/lib/tapioca/dsl/compilers/active_record_enum.rb

@@ -51,8 +51,6 @@ module Tapioca
       # ~~~
       #: [ConstantType = singleton(::ActiveRecord::Base)]
       class ActiveRecordEnum < Compiler
-        extend T::Sig
-
         # @override
         #: -> void
         def decorate
@@ -75,8 +73,6 @@ module Tapioca
         end
 
         class << self
-          extend T::Sig
-
           # @override
           #: -> Enumerable[T::Module[top]]
           def gather_constants

data/lib/tapioca/dsl/compilers/active_record_fixtures.rb

@@ -35,8 +35,6 @@ module Tapioca
       # ~~~
       #: [ConstantType = singleton(ActiveSupport::TestCase)]
       class ActiveRecordFixtures < Compiler
-        extend T::Sig
-
         MISSING = Object.new
 
         # @override
@@ -59,8 +57,6 @@ module Tapioca
         end
 
         class << self
-          extend T::Sig
-
           # @override
           #: -> Enumerable[T::Module[top]]
           def gather_constants

data/lib/tapioca/dsl/compilers/active_record_relations.rb

@@ -151,7 +151,6 @@ module Tapioca
       # ~~~
       #: [ConstantType = singleton(::ActiveRecord::Base)]
       class ActiveRecordRelations < Compiler
-        extend T::Sig
         include Helpers::ActiveRecordConstantsHelper
         include SorbetHelper
 
@@ -181,8 +180,6 @@ module Tapioca
         end
 
         class << self
-          extend T::Sig
-
           # @override
           #: -> Enumerable[T::Module[top]]
           def gather_constants
@@ -224,7 +221,7 @@ module Tapioca
           batch_size: ["Integer", "1000"],
           of: ["Integer", "1000"],
           error_on_ignore: ["T.untyped", "nil"],
-          order: ["Symbol", ":asc"],
+          order: ["T.any(Symbol, T::Array[Symbol])", ":asc"],
           cursor: ["T.untyped", "primary_key"],
           use_ranges: ["T.untyped", "nil"],
         } #: Hash[Symbol, [String, String]]
@@ -541,6 +538,7 @@ module Tapioca
         #: -> void
         def create_relation_methods
           create_relation_method("all")
+          create_unscoped_relation_method
 
           QUERY_METHODS.each do |method_name|
             case method_name
@@ -947,7 +945,7 @@ module Tapioca
               common_relation_methods_module.create_method(
                 method_name.to_s,
                 parameters: [
-                  create_param("args", type: "T.untyped"),
+                  create_rest_param("args", type: "T.untyped"),
                 ],
                 return_type: method_name == :delete_by ? "Integer" : "T::Array[#{constant_name}]",
               )
@@ -976,7 +974,7 @@ module Tapioca
           when :find_each
             [constant_name, "T::Enumerator[#{constant_name}]"]
           when :find_in_batches
-            ["T::Array[#{constant_name}]", "T::Enumerator[T::Enumerator[#{constant_name}]]"]
+            ["T::Array[#{constant_name}]", "T::Enumerator[T::Array[#{constant_name}]]"]
           when :in_batches
             [RelationClassName, "::ActiveRecord::Batches::BatchEnumerator"]
           else
@@ -1056,6 +1054,35 @@ module Tapioca
             return_type: association_return_type,
           )
         end
+
+        #: -> void
+        def create_unscoped_relation_method
+          relation_methods_module.create_method("unscoped") do |method|
+            method.add_block_param("block")
+
+            method.add_sig do |sig|
+              sig.return_type = RelationClassName
+            end
+
+            method.add_sig(type_params: ["U"]) do |sig|
+              sig.add_param("block", "T.proc.returns(T.type_parameter(:U))")
+              sig.return_type = "T.type_parameter(:U)"
+            end
+          end
+
+          association_relation_methods_module.create_method("unscoped") do |method|
+            method.add_block_param("block")
+
+            method.add_sig do |sig|
+              sig.return_type = AssociationRelationClassName
+            end
+
+            method.add_sig(type_params: ["U"]) do |sig|
+              sig.add_param("block", "T.proc.returns(T.type_parameter(:U))")
+              sig.return_type = "T.type_parameter(:U)"
+            end
+          end
+        end
       end
     end
   end

data/lib/tapioca/dsl/compilers/active_record_scope.rb

@@ -40,7 +40,6 @@ module Tapioca
       # ~~~
       #: [ConstantType = singleton(::ActiveRecord::Base)]
       class ActiveRecordScope < Compiler
-        extend T::Sig
         include Helpers::ActiveRecordConstantsHelper
 
         # @override

data/lib/tapioca/dsl/compilers/active_record_secure_token.rb

@@ -34,7 +34,6 @@ module Tapioca
       # ~~~
       #: [ConstantType = (singleton(ActiveRecord::Base) & Extensions::ActiveRecord)]
       class ActiveRecordSecureToken < Compiler
-        extend T::Sig
         include Helpers::ActiveRecordConstantsHelper
 
         # @override
@@ -57,8 +56,6 @@ module Tapioca
         end
 
         class << self
-          extend T::Sig
-
           # @override
           #: -> Enumerable[T::Module[top]]
           def gather_constants

data/lib/tapioca/dsl/compilers/active_record_store.rb

@@ -80,7 +80,6 @@ module Tapioca
       # ~~~
       #: [ConstantType = (singleton(ActiveRecord::Base) & Extensions::ActiveRecord)]
       class ActiveRecordStore < Compiler
-        extend T::Sig
         include Helpers::ActiveRecordConstantsHelper
 
         # @override
@@ -132,8 +131,6 @@ module Tapioca
         end
 
         class << self
-          extend T::Sig
-
           # @override
           #: -> Enumerable[T::Module[top]]
           def gather_constants

data/lib/tapioca/dsl/compilers/active_record_typed_store.rb

@@ -83,8 +83,6 @@ module Tapioca
       # ~~~
       #: [ConstantType = singleton(::ActiveRecord::Base)]
       class ActiveRecordTypedStore < Compiler
-        extend T::Sig
-
         # @override
         #: -> void
         def decorate
@@ -108,8 +106,6 @@ module Tapioca
         end
 
         class << self
-          extend T::Sig
-
           # @override
           #: -> Enumerable[T::Module[top]]
           def gather_constants

data/lib/tapioca/dsl/compilers/active_resource.rb

@@ -56,8 +56,6 @@ module Tapioca
       # ~~~
       #: [ConstantType = singleton(::ActiveResource::Base)]
       class ActiveResource < Compiler
-        extend T::Sig
-
         # @override
         #: -> void
         def decorate
@@ -71,8 +69,6 @@ module Tapioca
         end
 
         class << self
-          extend T::Sig
-
           # @override
           #: -> Enumerable[T::Module[top]]
           def gather_constants

data/lib/tapioca/dsl/compilers/active_storage.rb

@@ -40,8 +40,6 @@ module Tapioca
       # ~~~
       #: [ConstantType = (T::Module[top] & ::ActiveStorage::Reflection::ActiveRecordExtensions::ClassMethods)]
       class ActiveStorage < Compiler
-        extend T::Sig
-
         # @override
         #: -> void
         def decorate
@@ -65,8 +63,6 @@ module Tapioca
         end
 
         class << self
-          extend T::Sig
-
           # @override
           #: -> Enumerable[T::Module[top]]
           def gather_constants

data/lib/tapioca/dsl/compilers/active_support_concern.rb

@@ -39,8 +39,6 @@ module Tapioca
       # ~~~
       #: [ConstantType = T::Module[top]]
       class ActiveSupportConcern < Compiler
-        extend T::Sig
-
         # @override
         #: -> void
         def decorate
@@ -62,8 +60,6 @@ module Tapioca
         end
 
         class << self
-          extend T::Sig
-
           # @override
           #: -> Enumerable[T::Module[top]]
           def gather_constants

data/lib/tapioca/dsl/compilers/active_support_current_attributes.rb

@@ -61,8 +61,6 @@ module Tapioca
       # ~~~
       #: [ConstantType = singleton(::ActiveSupport::CurrentAttributes)]
       class ActiveSupportCurrentAttributes < Compiler
-        extend T::Sig
-
         # @override
         #: -> void
         def decorate
@@ -74,11 +72,11 @@ module Tapioca
             current_attributes_methods_name = "GeneratedAttributeMethods"
             current_attributes.create_module(current_attributes_methods_name) do |generated_attribute_methods|
               dynamic_methods.each do |method|
-                method = method.to_s
+                method = constant.instance_method(method)
                 # We want to generate each method both on the class
-                generate_method(current_attributes, method, class_method: true)
+                create_method_from_def(current_attributes, method, class_method: true)
                 # and on the instance
-                generate_method(generated_attribute_methods, method, class_method: false)
+                create_method_from_def(generated_attribute_methods, method, class_method: false)
               end
 
               instance_methods.each do |method|
@@ -94,8 +92,6 @@ module Tapioca
         end
 
         class << self
-          extend T::Sig
-
           # @override
           #: -> Enumerable[T::Module[top]]
           def gather_constants
@@ -114,17 +110,6 @@ module Tapioca
         def instance_methods_of_constant
           constant.instance_methods(false)
         end
-
-        #: (RBI::Scope klass, String method, class_method: bool) -> void
-        def generate_method(klass, method, class_method:)
-          method_def = if class_method
-            constant.method(method)
-          else
-            constant.instance_method(method)
-          end
-
-          create_method_from_def(klass, method_def, class_method: class_method)
-        end
       end
     end
   end