getargv 0.3.0-universal-darwin → 0.3.3-universal-darwin

data/vendor/bundle/ruby/3.3.0/gems/rbs-2.8.4/COPYING

@@ -0,0 +1,56 @@
+rbs is copyrighted free software by Soutaro Matsumoto <matsumoto@soutaro.com>.
+You can redistribute it and/or modify it under either the terms of the
+2-clause BSDL (see the file BSDL), or the conditions below:
+
+1. You may make and give away verbatim copies of the source form of the
+   software without restriction, provided that you duplicate all of the
+   original copyright notices and associated disclaimers.
+
+2. You may modify your copy of the software in any way, provided that
+   you do at least ONE of the following:
+
+   a. place your modifications in the Public Domain or otherwise
+      make them Freely Available, such as by posting said
+      modifications to Usenet or an equivalent medium, or by allowing
+      the author to include your modifications in the software.
+
+   b. use the modified software only within your corporation or
+      organization.
+
+   c. give non-standard binaries non-standard names, with
+      instructions on where to get the original software distribution.
+
+   d. make other distribution arrangements with the author.
+
+3. You may distribute the software in object code or binary form,
+   provided that you do at least ONE of the following:
+
+   a. distribute the binaries and library files of the software,
+      together with instructions (in the manual page or equivalent)
+      on where to get the original distribution.
+
+   b. accompany the distribution with the machine-readable source of
+      the software.
+
+   c. give non-standard binaries non-standard names, with
+      instructions on where to get the original software distribution.
+
+   d. make other distribution arrangements with the author.
+
+4. You may modify and include the part of the software into any other
+   software (possibly commercial).  But some files in the distribution
+   are not written by the author, so that they are not under these terms.
+
+   For the list of those files and their copying conditions, see the
+   file LEGAL.
+
+5. The scripts and library files supplied as input to or produced as
+   output from the software do not automatically fall under the
+   copyright of the software, but belong to whomever generated them,
+   and may be sold commercially, and may be aggregated with this
+   software.
+
+6. THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR
+   IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+   WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+   PURPOSE.

data/vendor/bundle/ruby/3.3.0/gems/rbs-2.8.4/Gemfile

@@ -0,0 +1,33 @@
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in rbs.gemspec
+gemspec
+
+# Development dependencies
+gem "rake"
+gem "rake-compiler"
+gem "test-unit"
+gem "rspec"
+gem "rubocop"
+gem "rubocop-rubycw"
+gem "json"
+gem "json-schema"
+gem 'stackprof'
+gem "goodcheck"
+gem "dbm"
+gem 'digest'
+gem 'tempfile'
+gem "prime"
+gem "rdoc"
+
+# Test gems
+gem "rbs-amber", path: "test/assets/test-gem"
+
+group :ide, optional: true do
+  gem "ruby-debug-ide"
+  gem "debase", ">= 0.2.5.beta2"
+end
+
+group :minitest do
+  gem "minitest"
+end

data/vendor/bundle/ruby/3.3.0/gems/rbs-2.8.4/Gemfile.lock

@@ -0,0 +1,118 @@
+PATH
+  remote: .
+  specs:
+    rbs (2.8.4)
+
+PATH
+  remote: test/assets/test-gem
+  specs:
+    rbs-amber (1.0.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.8.0)
+      public_suffix (>= 2.0.2, < 5.0)
+    ast (2.4.2)
+    dbm (1.1.0)
+    debase (0.2.5.beta2)
+      debase-ruby_core_source (>= 0.10.12)
+    debase-ruby_core_source (0.10.16)
+    diff-lcs (1.5.0)
+    digest (3.1.0)
+    forwardable (1.3.2)
+    goodcheck (3.1.0)
+      marcel (>= 1.0, < 2.0)
+      psych (>= 3.1, < 5.0)
+      rainbow (>= 3.0, < 4.0)
+      strong_json (>= 1.1, < 2.2)
+    json (2.6.2)
+    json-schema (3.0.0)
+      addressable (>= 2.8)
+    marcel (1.0.2)
+    minitest (5.16.3)
+    parallel (1.22.1)
+    parser (3.1.2.1)
+      ast (~> 2.4.1)
+    power_assert (2.0.1)
+    prime (0.1.2)
+      forwardable
+      singleton
+    psych (4.0.4)
+      stringio
+    public_suffix (4.0.7)
+    rainbow (3.1.1)
+    rake (13.0.6)
+    rake-compiler (1.2.0)
+      rake
+    rdoc (6.4.0)
+      psych (>= 4.0.0)
+    regexp_parser (2.6.0)
+    rexml (3.2.5)
+    rspec (3.12.0)
+      rspec-core (~> 3.12.0)
+      rspec-expectations (~> 3.12.0)
+      rspec-mocks (~> 3.12.0)
+    rspec-core (3.12.0)
+      rspec-support (~> 3.12.0)
+    rspec-expectations (3.12.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.12.0)
+    rspec-mocks (3.12.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.12.0)
+    rspec-support (3.12.0)
+    rubocop (1.39.0)
+      json (~> 2.3)
+      parallel (~> 1.10)
+      parser (>= 3.1.2.1)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8, < 3.0)
+      rexml (>= 3.2.5, < 4.0)
+      rubocop-ast (>= 1.23.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 1.4.0, < 3.0)
+    rubocop-ast (1.23.0)
+      parser (>= 3.1.1.0)
+    rubocop-rubycw (0.1.6)
+      rubocop (~> 1.0)
+    ruby-debug-ide (0.7.3)
+      rake (>= 0.8.1)
+    ruby-progressbar (1.11.0)
+    singleton (0.1.1)
+    stackprof (0.2.22)
+    stringio (3.0.2)
+    strong_json (2.1.2)
+    tempfile (0.1.2)
+    test-unit (3.5.5)
+      power_assert
+    unicode-display_width (2.3.0)
+
+PLATFORMS
+  ruby
+  x86_64-darwin-20
+
+DEPENDENCIES
+  dbm
+  debase (>= 0.2.5.beta2)
+  digest
+  goodcheck
+  json
+  json-schema
+  minitest
+  prime
+  rake
+  rake-compiler
+  rbs!
+  rbs-amber!
+  rdoc
+  rspec
+  rubocop
+  rubocop-rubycw
+  ruby-debug-ide
+  stackprof
+  tempfile
+  test-unit
+
+BUNDLED WITH
+   2.3.14

data/vendor/bundle/ruby/3.3.0/gems/rbs-2.8.4/README.md

@@ -0,0 +1,143 @@
+# RBS
+
+RBS is a language to describe the structure of Ruby programs.
+You can write down the definition of a class or module: methods defined in the class, instance variables and their types, and inheritance/mix-in relations.
+It also allows declaring constants and global variables.
+
+The following is a small example of RBS for a chat app.
+
+<!-- run-start:a.rbs:bundle exec rbs -I a.rbs validate -->
+```rb
+module ChatApp
+  VERSION: String
+
+  class User
+    attr_reader login: String
+    attr_reader email: String
+
+    def initialize: (login: String, email: String) -> void
+  end
+
+  class Bot
+    attr_reader name: String
+    attr_reader email: String
+    attr_reader owner: User
+
+    def initialize: (name: String, owner: User) -> void
+  end
+
+  class Message
+    attr_reader id: String
+    attr_reader string: String
+    attr_reader from: User | Bot                     # `|` means union types: `#from` can be `User` or `Bot`
+    attr_reader reply_to: Message?                   # `?` means optional type: `#reply_to` can be `nil`
+
+    def initialize: (from: User | Bot, string: String) -> void
+
+    def reply: (from: User | Bot, string: String) -> Message
+  end
+
+  class Channel
+    attr_reader name: String
+    attr_reader messages: Array[Message]
+    attr_reader users: Array[User]
+    attr_reader bots: Array[Bot]
+
+    def initialize: (name: String) -> void
+
+    def each_member: () { (User | Bot) -> void } -> void  # `{` and `}` means block.
+                   | () -> Enumerator[User | Bot, void]   # Method can be overloaded.
+  end
+end
+```
+<!-- run-end -->
+
+## The Target Version
+
+* The standard library signatures targets Ruby 3.1. (The latest release of Ruby.)
+* The library code targets Ruby 3.1, 3.0, and 2.7. (It runs on 2.6 in fact.)
+
+## Installation
+
+Install the `rbs` gem. `$ gem install rbs` from the command line, or add a line in your `Gemfile`.
+
+```rb
+gem "rbs"
+```
+
+## CLI
+
+The gem ships with the `rbs` command line tool to demonstrate what it can do and help develop RBS.
+
+```bash
+$ rbs version
+$ rbs list
+$ rbs ancestors ::Object
+$ rbs methods ::Object
+$ rbs method Object then
+```
+
+## Library
+
+There are two important concepts, _environment_ and _definition_.
+
+An _environment_ is a dictionary that keeps track of all declarations. What is the declaration associated with `String` class? An _environment_ will give you the answer.
+
+A _definition_ gives you the detail of the class. What is the type of the return value of `gsub` method of the `String` class? The _definition_ for `String` class knows the list of methods it provides and their types.
+
+The following is a small code to retrieve the definition of the `String#gsub` method.
+
+<!-- run-start:a.rb:bundle exec ruby a.rb -->
+```rb
+require "rbs"
+
+loader = RBS::EnvironmentLoader.new()
+
+# loader.add(path: Pathname("sig"))   # Load .rbs files from `sig` directory
+# loader.add(library: "pathname")     # Load pathname library
+
+environment = RBS::Environment.from_loader(loader).resolve_type_names
+
+# ::String
+string = RBS::TypeName.new(name: :String, namespace: RBS::Namespace.root)
+
+# Class declaration for ::String
+decl = environment.class_decls[string]
+
+# Builder provides the translation from `declaration` to `definition`
+builder = RBS::DefinitionBuilder.new(env: environment)
+
+# Definition of instance of String
+instance = builder.build_instance(string)
+
+# Print the types of `gsub` method:
+puts instance.methods[:gsub].method_types.join("\n")
+# Outputs =>
+#  (::Regexp | ::string pattern, ::string replacement) -> ::String
+#  (::Regexp | ::string pattern, ::Hash[::String, ::String] hash) -> ::String
+#  (::Regexp | ::string pattern) { (::String match) -> ::_ToS } -> ::String
+#  (::Regexp | ::string pattern) -> ::Enumerator[::String, self]
+
+# Definition of singleton of String
+singleton = builder.build_singleton(string)
+# No `gsub` method for String singleton
+puts singleton.methods[:gsub]
+```
+<!-- run-end -->
+
+## Guides
+
+- [Core and standard library signature contribution guide](docs/CONTRIBUTING.md)
+- [Writing signatures guide](docs/sigs.md)
+- [Stdlib signatures guide](docs/stdlib.md)
+- [Syntax](docs/syntax.md)
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `bundle exec rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/ruby/rbs.

data/vendor/bundle/ruby/3.3.0/gems/rbs-2.8.4/Rakefile

@@ -0,0 +1,235 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+require "rbconfig"
+require 'rake/extensiontask'
+
+$LOAD_PATH << File.join(__dir__, "test")
+
+ruby = ENV["RUBY"] || RbConfig.ruby
+rbs = File.join(__dir__, "exe/rbs")
+bin = File.join(__dir__, "bin")
+
+Rake::ExtensionTask.new("rbs_extension")
+
+Rake::TestTask.new(:test => :compile) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/**/*_test.rb"].reject do |path|
+    path =~ %r{test/stdlib/}
+  end
+end
+
+multitask :default => [:test, :stdlib_test, :rubocop, :validate, :test_doc]
+
+task :lexer do
+  sh "re2c -W --no-generation-date -o ext/rbs_extension/lexer.c ext/rbs_extension/lexer.re"
+end
+
+task :confirm_lexer => :lexer do
+  puts "Testing if lexer.c is updated with respect to lexer.re"
+  sh "git diff --exit-code ext/rbs_extension/lexer.c"
+end
+
+rule ".c" => ".re" do |t|
+  puts "⚠️⚠️⚠️ #{t.name} is older than #{t.source}. You may need to run `rake lexer` ⚠️⚠️⚠️"
+end
+
+task :annotate do
+  sh "bin/generate_docs.sh"
+end
+
+task :confirm_annotation do
+  puts "Testing if RBS docs are updated with respect to RDoc"
+  sh "git diff --exit-code core stdlib"
+end
+
+task :compile => "ext/rbs_extension/lexer.c"
+
+task :test_doc do
+  files = Dir.chdir(File.expand_path('..', __FILE__)) do
+    `git ls-files -z`.split("\x0").select do |file| Pathname(file).extname == ".md" end
+  end
+
+  sh "#{ruby} #{__dir__}/bin/run_in_md.rb #{files.join(" ")}"
+end
+
+task :validate => :compile do
+  require 'yaml'
+
+  sh "#{ruby} #{rbs} validate --silent"
+
+  FileList["stdlib/*"].each do |path|
+    lib = [File.basename(path).to_s]
+
+    sh "#{ruby} #{rbs} #{lib.map {|l| "-r #{l}"}.join(" ")} validate --silent"
+  end
+end
+
+FileList["test/stdlib/**/*_test.rb"].each do |test|
+  task test => :compile do
+    sh "#{ruby} -Ilib #{bin}/test_runner.rb #{test}"
+  end
+end
+
+task :stdlib_test do
+  test_files = FileList["test/stdlib/**/*_test.rb"].reject do |path|
+    path =~ %r{Ractor}
+  end
+  sh "#{ruby} -Ilib #{bin}/test_runner.rb #{test_files.join(' ')}"
+  # TODO: Ractor tests need to be run in a separate process
+  sh "#{ruby} -Ilib #{bin}/test_runner.rb test/stdlib/Ractor_test.rb"
+end
+
+task :rubocop do
+  sh "rubocop --parallel"
+end
+
+namespace :generate do
+  desc "Generate a test file for a stdlib class signatures"
+  task :stdlib_test, [:class] do |_task, args|
+    klass = args.fetch(:class) do
+      raise "Class name is necessary. e.g. rake 'generate:stdlib_test[String]'"
+    end
+
+    require "erb"
+    require "rbs"
+
+    class TestTarget
+      def initialize(klass)
+        @type_name = RBS::Namespace.parse(klass).to_type_name
+      end
+
+      def path
+        Pathname(ENV['RBS_GENERATE_TEST_PATH'] || "test/stdlib/#{file_name}_test.rb")
+      end
+
+      def file_name
+        @type_name.to_s.gsub(/\A::/, '').gsub(/::/, '_')
+      end
+
+      def to_s
+        @type_name.to_s
+      end
+
+      def absolute_type_name
+        @absolute_type_name ||= @type_name.absolute!
+      end
+    end
+
+    target = TestTarget.new(klass)
+    path = target.path
+    raise "#{path} already exists!" if path.exist?
+
+    class TestTemplateBuilder
+      attr_reader :target, :env
+
+      def initialize(target)
+        @target = target
+
+        loader = RBS::EnvironmentLoader.new
+        Dir['stdlib/*'].each do |lib|
+          next if lib.end_with?('builtin')
+
+          loader.add(library: File.basename(lib))
+        end
+        @env = RBS::Environment.from_loader(loader).resolve_type_names
+      end
+
+      def call
+        ERB.new(<<~ERB, trim_mode: "-").result(binding)
+          require_relative "test_helper"
+
+          <%- unless class_methods.empty? -%>
+          class <%= target %>SingletonTest < Test::Unit::TestCase
+            include TypeAssertions
+
+            # library "pathname", "set", "securerandom"     # Declare library signatures to load
+            testing "singleton(::<%= target %>)"
+
+          <%- class_methods.each do |method_name, definition| %>
+            def test_<%= test_name_for(method_name) %>
+          <%- definition.method_types.each do |method_type| -%>
+              assert_send_type  "<%= method_type %>",
+                                <%= target %>, :<%= method_name %>
+          <%- end -%>
+            end
+          <%- end -%>
+          end
+          <%- end -%>
+
+          <%- unless instance_methods.empty? -%>
+          class <%= target %>Test < Test::Unit::TestCase
+            include TypeAssertions
+
+            # library "pathname", "set", "securerandom"     # Declare library signatures to load
+            testing "::<%= target %>"
+
+          <%- instance_methods.each do |method_name, definition| %>
+            def test_<%= test_name_for(method_name) %>
+          <%- definition.method_types.each do |method_type| -%>
+              assert_send_type  "<%= method_type %>",
+                                <%= target %>.new, :<%= method_name %>
+          <%- end -%>
+            end
+          <%- end -%>
+          end
+          <%- end -%>
+        ERB
+      end
+
+      private
+
+      def test_name_for(method_name)
+        {
+          :==  => 'double_equal',
+          :!=  => 'not_equal',
+          :=== => 'triple_equal',
+          :[]  => 'square_bracket',
+          :[]= => 'square_bracket_assign',
+          :>   => 'greater_than',
+          :<   => 'less_than',
+          :>=  => 'greater_than_equal_to',
+          :<=  => 'less_than_equal_to',
+          :<=> => 'spaceship',
+          :+   => 'plus',
+          :-   => 'minus',
+          :*   => 'multiply',
+          :/   => 'divide',
+          :**  => 'power',
+          :%   => 'modulus',
+          :&   => 'and',
+          :|   => 'or',
+          :^   => 'xor',
+          :>>  => 'right_shift',
+          :<<  => 'left_shift',
+          :=~  => 'pattern_match',
+          :!~  => 'does_not_match',
+          :~   => 'tilde'
+        }.fetch(method_name, method_name)
+      end
+
+      def class_methods
+        @class_methods ||= RBS::DefinitionBuilder.new(env: env).build_singleton(target.absolute_type_name).methods.select {|_, definition|
+          definition.implemented_in == target.absolute_type_name
+        }
+      end
+
+      def instance_methods
+        @instance_methods ||= RBS::DefinitionBuilder.new(env: env).build_instance(target.absolute_type_name).methods.select {|_, definition|
+          definition.implemented_in == target.absolute_type_name
+        }
+      end
+    end
+
+    path.write TestTemplateBuilder.new(target).call
+
+    puts "Created: #{path}"
+  end
+end
+
+task :test_generate_stdlib do
+  sh "RBS_GENERATE_TEST_PATH=/tmp/Array_test.rb rake 'generate:stdlib_test[Array]'"
+  sh "ruby -c /tmp/Array_test.rb"
+  sh "RBS_GENERATE_TEST_PATH=/tmp/Thread_Mutex_test.rb rake 'generate:stdlib_test[Thread::Mutex]'"
+  sh "ruby -c /tmp/Thread_Mutex_test.rb"
+end

data/vendor/bundle/ruby/3.3.0/gems/rbs-2.8.4/Steepfile

@@ -0,0 +1,44 @@
+D = Steep::Diagnostic
+
+target :lib do
+  signature "sig"
+  check "lib"
+  ignore(
+    "lib/rbs/prototype/runtime.rb",
+    "lib/rbs/test",
+    "lib/rbs/test.rb"
+  )
+
+  library "set", "pathname", "json", "logger", "monitor", "tsort", "uri", 'dbm', 'pstore', 'singleton', 'shellwords', 'fileutils', 'find', 'digest'
+  signature 'stdlib/yaml/0'
+  signature "stdlib/strscan/0/"
+  signature "stdlib/optparse/0/"
+  signature "stdlib/rdoc/0/"
+
+  configure_code_diagnostics do |config|
+    config[D::Ruby::MethodDefinitionMissing] = :hint
+    config[D::Ruby::ElseOnExhaustiveCase] = :hint
+    config[D::Ruby::FallbackAny] = :hint
+  end
+end
+
+# target :lib do
+#   signature "sig"
+#
+#   check "lib"                       # Directory name
+#   check "Gemfile"                   # File name
+#   check "app/models/**/*.rb"        # Glob
+#   # ignore "lib/templates/*.rb"
+#
+#   # library "pathname", "set"       # Standard libraries
+#   # library "strong_json"           # Gems
+# end
+
+# target :spec do
+#   signature "sig", "sig-private"
+#
+#   check "spec"
+#
+#   # library "pathname", "set"       # Standard libraries
+#   # library "rspec"
+# end