rbs 0.13.1 → 0.18.0

data/lib/rbs/version.rb

@@ -1,3 +1,3 @@
 module RBS
-  VERSION = "0.13.1"
+  VERSION = "0.18.0"
 end

data/lib/rbs/writer.rb

@@ -305,7 +305,7 @@ module RBS
       if prev_loc && decl_loc
         prev_end_line = prev_loc.end_line
         start_line = decl_loc.start_line
-  
+
         if start_line - prev_end_line > 1
           puts
         end

data/sig/cli.rbs

@@ -0,0 +1,58 @@
+module RBS
+  class CLI
+    class LibraryOptions
+      attr_accessor core_root: Pathname?
+
+      attr_reader libs: Array[String]
+      attr_reader dirs: Array[String]
+      attr_reader repos: Array[String]
+
+      def initialize: () -> void
+                    
+      def loader: () -> EnvironmentLoader
+    end
+
+    attr_reader stdout: IO
+    attr_reader stderr: IO
+
+    def initialize: (stdout: IO, stderr: IO) -> void
+                  
+    COMMANDS: Array[Symbol]
+
+    def library_parse: (OptionParser, options: LibraryOptions) -> void
+                     
+    def parse_logging_options: (OptionParser) -> void
+                             
+    def has_parser?: () -> bool
+                   
+    def run: (Array[String] args) -> void
+           
+    def run_ast: (Array[String], LibraryOptions) -> void
+               
+    def run_list: (Array[String], LibraryOptions) -> void
+                
+    def run_ancestors: (Array[String], LibraryOptions) -> void
+                     
+    def run_methods: (Array[String], LibraryOptions) -> void
+                   
+    def run_method: (Array[String], LibraryOptions) -> void
+                  
+    def run_validate: (Array[String], LibraryOptions) -> void
+                    
+    def run_constant: (Array[String], LibraryOptions) -> void
+                    
+    def run_paths: (Array[String], LibraryOptions) -> void
+                 
+    def run_prototype: (Array[String], LibraryOptions) -> void
+                     
+    def run_prototype_file: (String format, Array[String]) -> void
+                          
+    def run_vendor: (Array[String], LibraryOptions) -> void
+                  
+    def run_parse: (Array[String], LibraryOptions) -> void
+                 
+    def run_test: (Array[String], LibraryOptions) -> void
+                
+    def test_opt: (LibraryOptions) -> String?
+  end
+end

data/sig/constant.rbs

@@ -11,9 +11,9 @@ module RBS
     attr_reader entry: constant_entry
 
     def initialize: (name: TypeName, type: Types::t, entry: constant_entry) -> void
-                  
+
     def ==: (untyped other) -> bool
-          
+
     alias eql? ==
 
     def hash: () -> Integer

data/sig/constant_table.rbs

@@ -6,25 +6,25 @@ module RBS
     attr_reader env(): Environment
 
     def initialize: (builder: DefinitionBuilder) -> void
-                  
+
     def absolute_type: (Types::t, context: Array[Namespace]) -> Types::t
-                     
+
     def absolute_type_name: (TypeName, context: Array[Namespace], location: Location?) -> TypeName
-                          
+
     def name_to_constant: (TypeName) -> Constant?
-                        
+
     def split_name: (TypeName) -> Array[Symbol]
-                  
+
     def resolve_constant_reference: (TypeName name, context: Array[Namespace]) -> Constant?
-                                  
+
     def resolve_constant_reference_context: (Symbol, context: Array[Namespace]) -> Constant?
-                                          
-    def resolve_constant_reference_inherit: (Symbol, scopes: Array[Namespace], ?no_object: bool) -> Constant?
-                                          
+
+    def resolve_constant_reference_inherit: (Symbol, scopes: Array[Namespace], ?no_object: boolish) -> Constant?
+
     def constant_scopes: (TypeName) -> Array[Namespace]
-                       
+
     def constant_scopes_module: (TypeName, scopes: Array[Namespace]) -> Array[Namespace]
-                       
+
     def constant_scopes0: (TypeName, ?scopes: Array[Namespace]) -> Array[Namespace]
   end
 end

data/sig/declarations.rbs

@@ -2,7 +2,7 @@ module RBS
   module AST
     module Declarations
       type t = Class | Module | Interface | Constant | Global | Alias
-      
+
       class Base
       end
 
@@ -14,7 +14,7 @@ module RBS
           attr_reader variance: variance
           attr_reader skip_validation: bool
 
-          def initialize: (name: Symbol, variance: variance, skip_validation: bool) -> void
+          def initialize: (name: Symbol, variance: variance, skip_validation: boolish) -> void
 
           include _ToJson
         end

data/sig/definition.rbs

@@ -18,17 +18,17 @@ module RBS
       class TypeDef
         attr_reader type: MethodType
         attr_reader member: method_member
-        attr_reader defined_in: TypeName?
+        attr_reader defined_in: TypeName
         attr_reader implemented_in: TypeName?
 
-        def initialize: (type: MethodType, member: method_member, defined_in: TypeName?, implemented_in: TypeName?) -> void
+        def initialize: (type: MethodType, member: method_member, defined_in: TypeName, implemented_in: TypeName?) -> void
 
         def comment: () -> AST::Comment?
 
         def annotations: () -> Array[AST::Annotation]
 
-        def update: (?type: MethodType, ?member: method_member, ?defined_in: TypeName?, ?implemented_in: TypeName?) -> TypeDef
-        
+        def update: (?type: MethodType, ?member: method_member, ?defined_in: TypeName, ?implemented_in: TypeName?) -> TypeDef
+
         def overload?: () -> bool
       end
 
@@ -42,8 +42,13 @@ module RBS
       attr_reader comments: Array[AST::Comment]
       attr_reader annotations: Array[AST::Annotation]
       attr_reader members: Array[method_member]
+      attr_reader alias_of: Method?
 
-      def initialize: (super_method: Method?, defs: Array[TypeDef], accessibility: accessibility, ?annotations: Array[AST::Annotation]) -> void
+      def initialize: (super_method: Method?,
+                       defs: Array[TypeDef],
+                       accessibility: accessibility,
+                       alias_of: Method?,
+                       ?annotations: Array[AST::Annotation]) -> void
 
       def public?: () -> bool
 

data/sig/definition_builder.rbs

@@ -61,6 +61,8 @@ module RBS
 
     def ensure_namespace!: (Namespace, location: Location?) -> void
 
+    def build_singleton: (TypeName) -> Definition
+
     def build_instance: (TypeName) -> Definition
 
     def build_interface: (TypeName) -> Definition
@@ -69,11 +71,12 @@ module RBS
 
     def build_one_singleton: (TypeName) -> Definition
 
+    type ancestors = Definition::InstanceAncestors | Definition::SingletonAncestors | nil
     def merge_definitions: (TypeName,
                             Array[[Definition::Ancestor::t, Definition]],
                             entry: Environment::ModuleEntry | Environment::ClassEntry,
                             self_type: Definition::self_type,
-                            ancestors: Array[Definition::Ancestor::t]) -> Definition
+                            ancestors: ancestors) -> Definition
 
     type method_kind = :instance | :singleton
     def merge_method: (TypeName, Hash[Symbol, Definition::Method], Symbol, Definition::Method, Substitution, kind: method_kind) -> void

data/sig/environment_loader.rbs

@@ -1,58 +1,104 @@
 module RBS
+  # EnvironmentLoader is an object to load RBS files from filesystem.
+  # 
+  # Set up your configuration through repository and `#add` method.
+  # 
+  #   # Set up the repository to load library RBSs from.
+  #   repo = RBS::Repository.default
+  #   repo.add(Pathname("vendor/rbs/gem-rbs"))
+  #   repo.add(Pathname("vendor/rbs/internal-rbs"))
+  # 
+  #   loader = RBS::EnvironmentLoader.new(repository: repo)
+  # 
+  #   # Add libraries to load RBS files.
+  #   loader.add(library: "minitest")
+  #   loader.add(library: "rbs", version: "1.0.0")
+  # 
+  #   # Add dirs to load RBS files from.
+  #   loader.add(path: Pathname("sig"))
+  # 
+  #   # Load RBSs into an environment.
+  #   environment = RBS::Environment.new()
+  #   loader.load(env: environment)
+  # 
   class EnvironmentLoader
-    class UnknownLibraryNameError < StandardError
-      attr_reader name: String
-
-      def initialize: (name: String) -> void
-    end
-
-    class LibraryPath
-      attr_reader name: String
-      attr_reader path: Pathname
+    class UnknownLibraryError < StandardError
+      attr_reader library: Library
 
-      def initialize: (name: String, path: Pathname) -> void
+      def initialize: (lib: Library) -> void
     end
 
-    class GemPath
+    class Library < Struct[String | String?]
       attr_reader name: String
       attr_reader version: String?
-      attr_reader path: Pathname
 
-      def initialize: (name: String, version: String?, path: Pathname) -> void
+      def initialize: (name: String, version: String?) -> void
     end
 
-    STDLIB_ROOT: Pathname
-
-    type path = Pathname | LibraryPath | GemPath
-
-    attr_reader paths: Array[path]
-    attr_reader stdlib_root: Pathname
-    attr_reader gem_vendor_path: Pathname?
-
-    def self.gem_sig_path: (String, String?) -> Pathname?
-
-    def initialize: (?stdlib_root: Pathname, ?gem_vendor_path: Pathname?) -> void
-
-    def add: (path: Pathname?) -> void
-           | (library: String?) -> void
-
-    def self.parse_library: (String) -> [String, String?]
-
-    def stdlib?: (String) -> Pathname?
-
-    def gem?: (String, String?) -> Pathname?
-
-    def each_signature: (Pathname, ?immediate: bool) { (Pathname) -> void } -> void
-                      | (Pathname, ?immediate: bool) -> Enumerator[Pathname, void]
-
-    def each_library_path: { (path, Pathname) -> void } -> void
-
-    def no_builtin!: (?bool) -> self
-
-    def no_builtin?: () -> bool
-
-    def each_decl: () { (AST::Declarations::t, Buffer, Pathname, path | :stdlib) -> void } -> void
-
-    def load: (env: Environment) -> Array[[AST::Declarations::t, Pathname, path | :stdlib]]
+    DEFAULT_CORE_ROOT: Pathname
+
+    attr_reader core_root: Pathname?
+    attr_reader repository: Repository
+
+    attr_reader libs: Array[Library]
+    attr_reader dirs: Array[Pathname]
+
+    # The source where the RBS comes from.
+    # 
+    # `:core` means it is part of core library.
+    # `Library` means it is from library.
+    # `Pathname` means it is loaded from a directory.
+    # 
+    type source = :core
+                | Library
+                | Pathname
+
+    # Accepts two optional keyword arguments.
+    # 
+    # `core_root` is the path to the directory with RBSs for core classes.
+    # The default value is the core library included in RBS gem. (EnvironmentLoader::DEFAULT_CORE_ROOT)
+    # Passing `nil` means it skips loading core class definitions.
+    # 
+    # `repository` is the repository for library classes.
+    # The default value is repository only with stdlib classes. (Repository.new)
+    # 
+    def initialize: (?core_root: Pathname?, ?repository: Repository) -> void
+    
+    # Add a path or library to load RBSs from.
+    # 
+    # `path` can be a file or a directory.
+    # All `.rbs` files from the given directory will be loaded.
+    # Specifying a file will load the file regardless the extension of the file is.
+    # 
+    # `library` can be a name of a gem.
+    # Specifying `nil` to `version` will load any version available.
+    # It first tries to load RBS files from gem with specified version.
+    # If RBS files cannot be found in the gem, it tries to load RBSs from repository.
+    # 
+    def add: (path: Pathname) -> void
+           | (library: String, version: String?) -> void
+
+    # This is helper function to test if RBS for a library is available or not.
+    # 
+    def has_library?: (library: String, version: String?) -> bool
+
+    # Add all declarations to environment.
+    # 
+    # Raises `UnknownLibraryError` if RBS cannot be loaded from a library.
+    # 
+    # Returns an array of tuples of the declaration, path to the file, and the source.
+    # 
+    def load: (env: Environment) -> Array[[AST::Declarations::t, Pathname, source]]
+
+    # Returns a pair of spec and path for a gem with RBS.
+    # Returns nil if the gem is not installed, or the gem doesn't provide RBS.
+    # 
+    def self.gem_sig_path: (String name, String? version) -> [Gem::Specification, Pathname]?
+
+    def each_decl: () { (AST::Declarations::t, Buffer, source, Pathname) -> void } -> void
+                 
+    def each_dir: { (source, Pathname) -> void } -> void
+                
+    def each_file: (Pathname path, immediate: boolish, skip_hidden: boolish) { (Pathname) -> void } -> void
   end
 end

data/sig/members.rbs

@@ -23,7 +23,7 @@ module RBS
         attr_reader comment: Comment?
         attr_reader overload: bool
 
-        def initialize: (name: Symbol, kind: kind, types: Array[MethodType], annotations: Array[Annotation], location: Location?, comment: Comment?, overload: bool) -> void
+        def initialize: (name: Symbol, kind: kind, types: Array[MethodType], annotations: Array[Annotation], location: Location?, comment: Comment?, overload: boolish) -> void
 
         include _HashEqual
         include _ToJson
@@ -34,7 +34,7 @@ module RBS
 
         def overload?: () -> bool
 
-        def update: (?name: Symbol, ?kind: kind, ?types: Array[MethodType], ?annotations: Array[Annotation], ?location: Location?, ?comment: Comment?, ?overload: bool) -> MethodDefinition
+        def update: (?name: Symbol, ?kind: kind, ?types: Array[MethodType], ?annotations: Array[Annotation], ?location: Location?, ?comment: Comment?, ?overload: boolish) -> MethodDefinition
       end
 
       module Var

data/sig/method_types.rbs

@@ -4,7 +4,7 @@ module RBS
       attr_reader type: Types::Function
       attr_reader required: bool
 
-      def initialize: (type: Types::Function, required: bool) -> void
+      def initialize: (type: Types::Function, required: boolish) -> void
 
       def ==: (untyped other) -> bool
 

data/sig/namespace.rbs

@@ -1,6 +1,6 @@
 module RBS
   # Namespace instance represents a _prefix of module names_.
-  # 
+  #
   #    vvvvvvvvvvvvvv  TypeName
   #    RBS::Namespace
   #    ^^^^^           Namespace
@@ -28,7 +28,7 @@ module RBS
   class Namespace
     attr_reader path: Array[Symbol]
 
-    def initialize: (path: Array[Symbol], absolute: bool) -> void
+    def initialize: (path: Array[Symbol], absolute: boolish) -> void
 
     # Returns new _empty_ namespace.
     def self.empty: () -> Namespace
@@ -44,7 +44,7 @@ module RBS
     # If `other` is an absolute namespace, it returns `other`.
     #
     #   Namespace("Foo::") + Namespace("::Bar::")  # =>  ::Bar::
-    # 
+    #
     def +: (Namespace other) -> Namespace
 
     # Add one path component to self.
@@ -62,7 +62,7 @@ module RBS
 
     # Returns true if self is absolute namespace.
     def absolute?: () -> bool
-    
+
     # Returns true if self is relative namespace.
     def relative?: () -> bool
 

data/sig/parser.rbs

@@ -0,0 +1,25 @@
+module RBS
+  class Parser
+    class SyntaxError < StandardError
+      attr_reader token_str: String
+      attr_reader error_value: untyped
+      attr_reader value_stack: untyped?
+
+      def initialize: (token_str: String, error_value: untyped, ?value_stack: untyped?) -> void
+    end
+
+    class SemanticsError < StandardError
+      attr_reader subject: untyped
+      attr_reader location: Location
+      attr_reader original_message: String
+
+      def initialize: (String message, subject: untyped, location: Location) -> void
+    end
+
+    def self.parse_method_type: (String | Buffer, ?variables: Array[Symbol], ?eof_re: Regexp?) -> MethodType
+                              
+    def self.parse_type: (String | Buffer, ?variables: Array[Symbol], ?eof_re: Regexp?) -> Types::t
+                       
+    def self.parse_signature: (String | Buffer, ?eof_re: Regexp?) -> Array[AST::Declarations::t]
+  end
+end

data/sig/polyfill.rbs

@@ -1,3 +1,45 @@
 module Kernel
   def to_json: (*untyped) -> String
 end
+
+module Gem
+  class Version
+    def self.correct?: (String) -> bool
+
+    def self.create: (String?) -> instance?
+
+    include Comparable
+
+    def prerelease?: () -> bool
+
+    def release: () -> self
+
+    def version: () -> String
+  end
+
+  class Specification
+    attr_reader version (): Version
+
+    attr_reader gem_dir (): String
+
+    def self.find_by_name: (String name, ?String? version) -> instance
+  end
+end
+
+class OptionParser
+  def initialize: () ?{ (instance) -> void } -> void
+                
+  def on: (*String) { (String) -> void } -> void
+        
+  attr_accessor version: String
+  
+  attr_accessor banner: String
+
+  def order!: (Array[String]) -> void
+            
+  def parse!: (Array[String]) -> void
+            
+  def ver: () -> String
+         
+  def help: () -> String
+end