docspring 3.0.0 → 3.1.0

data/vendor/bundle/ruby/3.3.0/gems/io-console-0.8.0/lib/io/console/size.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: false
+# fallback to console window size
+def IO.default_console_size
+  [
+    ENV["LINES"].to_i.nonzero? || 25,
+    ENV["COLUMNS"].to_i.nonzero? || 80,
+  ]
+end
+
+begin
+  require 'io/console'
+rescue LoadError
+  class << IO
+    alias console_size default_console_size
+  end
+else
+  # returns console window size
+  def IO.console_size
+    console.winsize
+  rescue NoMethodError
+    default_console_size
+  end
+end

data/vendor/bundle/ruby/3.3.0/gems/irb-1.15.1/Gemfile

@@ -0,0 +1,29 @@
+source "https://rubygems.org"
+
+gemspec
+
+is_unix = RUBY_PLATFORM =~ /(aix|darwin|linux|(net|free|open)bsd|cygwin|solaris|irix|hpux)/i
+is_truffleruby = RUBY_DESCRIPTION =~ /truffleruby/
+
+if is_unix && ENV['WITH_VTERM']
+  gem "vterm", github: "ruby/vterm-gem"
+  gem "yamatanooroti", github: "ruby/yamatanooroti"
+end
+
+gem "stackprof" if is_unix && !is_truffleruby
+
+gem "reline", github: "ruby/reline" if ENV["WITH_LATEST_RELINE"] == "true"
+gem "rake"
+gem "test-unit"
+gem "test-unit-ruby-core"
+
+gem "rubocop"
+
+gem "tracer" if !is_truffleruby
+gem "debug", github: "ruby/debug", platforms: [:mri, :mswin]
+
+gem "rdoc", ">= 6.11.0"
+
+if RUBY_VERSION >= "3.0.0" && !is_truffleruby
+  gem "repl_type_completor"
+end

data/vendor/bundle/ruby/3.3.0/gems/irb-1.15.1/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (C) 1993-2013 Yukihiro Matsumoto. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+1. Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in the
+   documentation and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+SUCH DAMAGE.

data/vendor/bundle/ruby/3.3.0/gems/irb-1.15.1/README.md

@@ -0,0 +1,125 @@
+# IRB
+
+[![Gem Version](https://badge.fury.io/rb/irb.svg)](https://badge.fury.io/rb/irb)
+[![Static Badge](https://img.shields.io/badge/RDoc-flat?style=flat&label=documentation&link=https%3A%2F%2Fruby.github.io%2Firb%2F)](https://ruby.github.io/irb/)
+[![build](https://github.com/ruby/irb/actions/workflows/test.yml/badge.svg)](https://github.com/ruby/irb/actions/workflows/test.yml)
+
+
+IRB stands for "interactive Ruby" and is a tool to interactively execute Ruby expressions read from the standard input.
+
+The `irb` command from your shell will start the interpreter.
+
+## Installation
+
+> [!Note]
+>
+> IRB is a default gem of Ruby so you shouldn't need to install it separately.
+>
+> But if you're using Ruby 2.6 or later and want to upgrade/install a specific version of IRB, please follow these steps.
+
+To install it with `bundler`, add this line to your application's Gemfile:
+
+```ruby
+gem 'irb'
+```
+
+And then execute:
+
+```shell
+$ bundle
+```
+
+Or install it directly with:
+
+```shell
+$ gem install irb
+```
+
+## Usage
+
+> [!Note]
+>
+> We're working hard to match Pry's variety of powerful features in IRB, and you can track our progress or find contribution ideas in [this document](https://ruby.github.io/irb/COMPARED_WITH_PRY_md.html).
+
+### The `irb` Executable
+
+You can start a fresh IRB session by typing `irb` in your terminal.
+
+In the session, you can evaluate Ruby expressions or even prototype a small Ruby script. An input is executed when it is syntactically complete.
+
+```shell
+$ irb
+irb(main):001> 1 + 2
+=> 3
+irb(main):002* class Foo
+irb(main):003*   def foo
+irb(main):004*     puts 1
+irb(main):005*   end
+irb(main):006> end
+=> :foo
+irb(main):007> Foo.new.foo
+1
+=> nil
+```
+
+### The `binding.irb` Breakpoint
+
+If you use Ruby 2.5 or later versions, you can also use `binding.irb` in your program as breakpoints.
+
+Once a `binding.irb` is evaluated, a new IRB session will be started with the surrounding context:
+
+```shell
+$ ruby test.rb
+
+From: test.rb @ line 2 :
+
+    1: def greet(word)
+ => 2:   binding.irb
+    3:   puts "Hello #{word}"
+    4: end
+    5:
+    6: greet("World")
+
+irb(main):001:0> word
+=> "World"
+irb(main):002:0> exit
+Hello World
+```
+
+### Debugging
+
+You can use IRB as a debugging console with `debug.gem` with these options:
+
+- In `binding.irb`, use the `debug` command to start an `irb:rdbg` session with access to all `debug.gem` commands.
+- Use the `RUBY_DEBUG_IRB_CONSOLE=1` environment variable to make `debug.gem` use IRB as the debugging console.
+
+To learn more about debugging with IRB, see [Debugging with IRB](https://ruby.github.io/irb/#label-Debugging+with+IRB).
+
+## Documentation
+
+https://ruby.github.io/irb/ provides a comprehensive guide to IRB's features and usage.
+
+## Configuration
+
+See the [Configuration page](https://ruby.github.io/irb/Configurations_md.html) in the documentation.
+
+## Extending IRB
+
+IRB `v1.13.0` and later versions allows users/libraries to extend its functionality through official APIs.
+
+For more information, please visit the [IRB Extension Guide](https://ruby.github.io/irb/EXTEND_IRB_md.html).
+
+## Contributing
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for more information.
+
+## Releasing
+
+```
+rake release
+gh release create vX.Y.Z --generate-notes
+```
+
+## License
+
+The gem is available as open source under the terms of the [2-Clause BSD License](https://opensource.org/licenses/BSD-2-Clause).

data/vendor/bundle/ruby/3.3.0/gems/irb-1.15.1/Rakefile

@@ -0,0 +1,52 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+require "rdoc/task"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test" << "test/lib"
+  t.libs << "lib"
+  t.ruby_opts << "-rhelper"
+  t.test_files = FileList["test/irb/**/test_*.rb"]
+end
+
+# To make sure they have been correctly setup for Ruby CI.
+desc "Run each irb test file in isolation."
+task :test_in_isolation do
+  failed = false
+
+  FileList["test/irb/**/test_*.rb"].each do |test_file|
+    ENV["TEST"] = test_file
+    begin
+      Rake::Task["test"].execute
+    rescue
+      failed = true
+      msg = "Test '#{test_file}' failed when being executed in isolation. Please make sure 'rake test TEST=#{test_file}' passes."
+      separation_line = '=' * msg.length
+
+      puts <<~MSG
+        #{separation_line}
+        #{msg}
+        #{separation_line}
+      MSG
+    end
+  end
+
+  fail "Some tests failed when being executed in isolation" if failed
+end
+
+Rake::TestTask.new(:test_yamatanooroti) do |t|
+  t.libs << 'test' << "test/lib"
+  t.libs << 'lib'
+  #t.loader = :direct
+  t.ruby_opts << "-rhelper"
+  t.pattern = 'test/irb/yamatanooroti/test_*.rb'
+end
+
+task :default => :test
+
+RDoc::Task.new do |rdoc|
+  rdoc.title = "IRB Documentation"
+  rdoc.main = "Index.md"
+  rdoc.rdoc_dir = "_site"
+  rdoc.options.push("lib")
+end

data/vendor/bundle/ruby/3.3.0/gems/irb-1.15.1/bin/console

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require_relative "../lib/irb"
+
+IRB.start(__FILE__)

data/vendor/bundle/ruby/3.3.0/gems/irb-1.15.1/bin/setup

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install

data/vendor/bundle/ruby/3.3.0/gems/irb-1.15.1/doc/irb/irb-tools.rd.ja

@@ -0,0 +1,184 @@
+irb関連おまけコマンドとライブラリ
+				$Release Version: 0.7.1 $
+			   	$Revision$
+			   	by Keiju ISHITSUKA(Nihon Rational Co.,Ltd.)
+
+=begin
+
+:コマンド:
+* rtags		-- ruby tags command
+
+:関数ライブラリ:
+* xmp		-- irb version of gotoken xmp-function
+
+:クラスライブラリ:
+* frame.rb      -- frame tracer
+* completion.rb -- irb completor
+
+= rtags
+
+rtagsはemacs及びvi用の, TAGファイルをつくるコマンドです.
+
+== 使い方
+
+   rtags [-vi] file....
+
+カレントディレクトリにemacs用のTAGSファイルができます. -viオプションを
+つけた時にはvi用のtagsファイルを作成します.
+
+emacsの場合, 通常のetags.elがそのまま使えます. 検索可能なのは,
+
+* クラス
+* メソッド
+* 特異メソッド
+* alias
+* attrで宣言されたアクセサ(パラメータがシンボルか文字列リテラルに限る)
+* attr_XXXで宣言されたアクセサ(パラメータがシンボルか文字列リテラルに限る)
+
+です.
+
+Cなどで使っているのと違うのは, コンプリーションに関する部分で,
+
+関数名は,
+
+  関数名(
+
+クラスは,
+
+  ::クラス名::....::クラス名
+
+メソッドは,
+
+  ::クラス名::....::クラス名#メソッド名
+
+特異メソッド(クラスメソッド)は
+
+  ::クラス名::....::クラス名.メソッド名
+
+でコンプリーションを行なうところです.
+
+= xmp.rb
+
+ごとけんxmpの上位互換バージョンです. ただ, 非常に重いのでごとけんxmpで
+は対応できない時に, 使用すると良いでしょう.
+
+== 使い方
+
+=== 関数として使う.
+
+    require "irb/xmp"
+    xmp <<END
+    foo = 1
+    foo
+    END
+    ---
+    foo = 1
+        ==>1
+    foo
+	==>1
+
+=== XMPインスタンスを用いる.
+
+この場合は, XMPがコンテキスト情報を持つので, 変数の値などを保持してい
+ます.
+
+  require "irb/xmp"
+  xmp = XMP.new
+  xmp.puts <<END
+  foo = 1
+  foo
+  END
+  xmp.puts <<END
+  foo
+  END
+  ===
+  foo = 1
+      ==>1
+  foo
+      ==>1
+  foo
+      ==>1
+
+== コンテキストに関して
+
+XMPメソッド群のコンテキストは, 呼び出す前のコンテキストで評価されます.
+明示的にコンテキストを指定するとそのコンテキストで評価します.
+
+例:
+
+  xmp "foo", an_binding
+
+:注:
+マルチスレッドには対応していません.
+
+= frame.rb
+現在実行中のフレーム情報を取り扱うためのクラスです.
+
+* IRB::Frame.top(n = 0)
+  上からn番目のコンテキストを取り出します. nは0が最上位になります.
+* IRB::Frame.bottom(n = 0)
+  下からn番目のコンテキストを取り出します. nは0が最下位になります.
+* IRB::Frame.sender
+  センダになっているオブジェクトを取り出します. センダとは, そのメソッ
+  ドを呼び出した側のselfのことです.
+
+:注:
+set_trace_funcを用いてRubyの実行をトレースしています. マルチスレッドに
+は対応していません.
+
+= completion.rb
+irbのcompletion機能を提供するものです.
+
+== 使い方
+
+   % irb -r irb/completion
+
+とするか, ~/.irbrc 中に
+
+   require "irb/completion"
+
+を入れてください. irb実行中に require "irb/completion" してもよいです.
+
+irb実行中に (TAB) を押すとコンプレーションします.
+
+トップレベルで(TAB)を押すとすべての構文要素, クラス, メソッドの候補がで
+ます. 候補が唯一ならば完全に補完します.
+
+  irb(main):001:0> in
+  in                    inspect               instance_eval
+  include               install_alias_method  instance_of?
+  initialize            install_aliases       instance_variables
+  irb(main):001:0> inspect
+  "main"
+  irb(main):002:0> foo = Object.new
+  #<Object:0x4027146c>
+
+  ((|変数名.|))の後に(TAB)を押すと, そのオブジェクトのメソッド一覧がでま
+  す.
+
+  irb(main):003:0> foo.
+  foo.==                  foo.frozen?             foo.protected_methods
+  foo.===                 foo.hash                foo.public_methods
+  foo.=~                  foo.id                  foo.respond_to?
+  foo.__id__              foo.inspect             foo.send
+  foo.__send__            foo.instance_eval       foo.singleton_methods
+  foo.class               foo.instance_of?        foo.taint
+  foo.clone               foo.instance_variables  foo.tainted?
+  foo.display             foo.is_a?               foo.to_a
+  foo.dup                 foo.kind_of?            foo.to_s
+  foo.eql?                foo.method              foo.type
+  foo.equal?              foo.methods             foo.untaint
+  foo.extend              foo.nil?
+  foo.freeze              foo.private_methods
+
+=end
+
+% Begin Emacs Environment
+% Local Variables:
+% mode: text
+% comment-column: 0
+% comment-start: "%"
+% comment-end: "\n"
+% End:
+%
+