bitclust-core 1.6.1 → 1.7.0

data/test/test_preprocessor.rb

@@ -516,6 +516,32 @@ HERE
       assert_equal "",       process(src, '4.0')
     end
 
+    def test_single_version
+      # 単一版のみの省略記法(#%if (version == "V") と同義)
+      src = gated('#%version 3.1')
+      assert_equal "out\n", process(src, '3.0')
+      assert_equal "in\n",  process(src, '3.1')
+      assert_equal "out\n", process(src, '3.2')
+    end
+
+    def test_single_version_quoted
+      src = gated('#%version "3.1"')
+      assert_equal "in\n",  process(src, '3.1')
+      assert_equal "out\n", process(src, '3.2')
+    end
+
+    def test_single_version_old_prefix
+      src = gated("\#@version 3.1")
+      assert_equal "in\n", process(src, '3.1')
+    end
+
+    def test_single_version_teeny
+      # 版名は文字列一致(teeny 付き版名は teeny まで一致したときのみ)
+      src = gated('#%version 2.7.0')
+      assert_equal "in\n",  process(src, '2.7.0')
+      assert_equal "out\n", process(src, '2.7')
+    end
+
     def test_two_dot_range_is_error
       # .. (終端を含む Range)は誤解を招くため受け付けない(#285)
       assert_raise(BitClust::ParseError) { process(gated('#%version 3.1..3.4'), '3.2') }

data/test/test_rbs_overload_matcher.rb

@@ -0,0 +1,170 @@
+# frozen_string_literal: true
+require 'test/unit'
+require 'bitclust/rbs_overload_matcher'
+
+# RbsOverloadMatcher(RBS シグネチャ表示)。引数パターンごとに説明チャンクが
+# 分かれているメソッド(Array.new / Array#[] 等)で、RBS の各オーバーロードを
+# 「ブロック有無 → 引数名の一致 → アリティ範囲の重なり」のスコアで最も近い
+# チャンクへ振り分ける。RBS の引数名は rdoc の call-seq 由来で rurema の
+# 引数名とよく一致するのが根拠。確実な対応が取れない場合は先頭チャンクに
+# 寄せる(重複表示はしない)。
+#
+# オーバーロードは rbs_sig property の JSON をそのまま(文字列キーの Hash)
+# 受け取る。チャンクは正規化済みシグネチャ行("--- " 始まり)の配列の配列。
+#
+# テストリスト:
+# [x] チャンクが 1 つなら全オーバーロードをそこへ(スコア不要)
+# [x] メタの無いオーバーロード(旧形式・attr・(?))は先頭チャンクへ
+# [x] Array#[] 型: 引数名 range / start+length で振り分け・名前が合わない
+#     ものはアリティ同点 → 先頭チャンク
+# [x] Array.new 型: () はアリティで・(ary) は名前で・ブロック付きは
+#     ブロックチャンクへ
+# [x] ブロック必須オーバーロードはブロック無しチャンクより有りを選ぶ
+# [x] チャンク側の引数解析: 省略可能引数・*rest・キーワード・&block・
+#     引数リスト無し
+# [x] 解析できないシグネチャ行だけのチャンクには振り分けない
+class TestRbsOverloadMatcher < Test::Unit::TestCase
+  M = BitClust::RbsOverloadMatcher
+
+  def test_single_chunk_takes_everything
+    overloads = [
+      {'segments' => [], 'params' => ['x'], 'arity' => [1, 1]},
+      {'segments' => [], 'params' => [], 'arity' => [0, 0], 'block' => 'req'},
+    ]
+    assert_equal [[0, 1]], M.assign(overloads, [['--- foo(x) -> nil']])
+  end
+
+  def test_overload_without_meta_goes_to_first_chunk
+    overloads = [{'segments' => []}]
+    chunks = [['--- foo(x) -> nil'], ['--- foo(x, y) -> nil']]
+    assert_equal [[0], []], M.assign(overloads, chunks)
+  end
+
+  # Array#[] の実データ(rbs v3.10.0)。(int index) は nth/range どちらとも
+  # 名前が合わずアリティも同点 → 先頭の nth チャンクへ。range と
+  # start+length は引数名で決まる
+  def test_aref_like_assignment
+    chunks = [
+      ['--- [](nth) -> object | nil'],
+      ['--- [](range) -> Array | nil'],
+      ['--- [](start, length) -> Array | nil'],
+    ]
+    overloads = [
+      {'segments' => [], 'params' => ['index'], 'arity' => [1, 1]},
+      {'segments' => [], 'params' => ['start', 'length'], 'arity' => [2, 2]},
+      {'segments' => [], 'params' => ['range'], 'arity' => [1, 1]},
+    ]
+    assert_equal [[0], [2], [1]], M.assign(overloads, chunks)
+  end
+
+  # Array.new の実データ(rbs v3.10.0)。() はアリティ 0 を含む先頭チャンク
+  # だけに重なる。(ary) と (size, ?val) は引数名で分かれ、ブロック付きは
+  # ブロックチャンクへ
+  def test_new_like_assignment
+    chunks = [
+      ['--- new(size = 0, val = nil) -> Array'],
+      ['--- new(ary) -> Array'],
+      ['--- new(size) {|index| ... } -> Array'],
+    ]
+    overloads = [
+      {'segments' => [], 'params' => [], 'arity' => [0, 0]},
+      {'segments' => [], 'params' => ['ary'], 'arity' => [1, 1]},
+      {'segments' => [], 'params' => ['size', 'val'], 'arity' => [1, 2]},
+      {'segments' => [], 'params' => ['size'], 'arity' => [1, 1], 'block' => 'req'},
+    ]
+    assert_equal [[0, 2], [1], [3]], M.assign(overloads, chunks)
+  end
+
+  def test_required_block_prefers_block_chunk
+    chunks = [
+      ['--- each -> Enumerator'],
+      ['--- each {|item| ... } -> self'],
+    ]
+    overloads = [
+      {'segments' => [], 'params' => [], 'arity' => [0, 0]},
+      {'segments' => [], 'params' => [], 'arity' => [0, 0], 'block' => 'req'},
+    ]
+    assert_equal [[0], [1]], M.assign(overloads, chunks)
+  end
+
+  # 省略可能ブロック(?{ ... })はどちらのチャンクとも矛盾しない。
+  # 引数名の一致で決まる
+  def test_optional_block_is_neutral
+    chunks = [
+      ['--- open(path) -> IO'],
+      ['--- open(fd) {|io| ... } -> object'],
+    ]
+    overloads = [
+      {'segments' => [], 'params' => ['fd'], 'arity' => [1, 1], 'block' => 'opt'},
+    ]
+    assert_equal [[], [0]], M.assign(overloads, chunks)
+  end
+
+  # チャンク側の引数リスト解析。省略可能引数で最小アリティが下がり、
+  # *rest で上限が消え、キーワード名も名前照合に使われる
+  def test_chunk_parsing_of_optional_rest_and_keywords
+    chunks = [
+      ['--- foo(a, b = 1, *rest, key: 0) -> nil'],
+      ['--- foo(x, y) -> nil'],
+    ]
+    overloads = [
+      {'segments' => [], 'params' => ['key'], 'arity' => [5, 5]},
+      {'segments' => [], 'params' => ['x', 'y'], 'arity' => [2, 2]},
+    ]
+    assert_equal [[0], [1]], M.assign(overloads, chunks)
+  end
+
+  # &block 引数はブロック有りとして扱う
+  def test_chunk_block_argument_counts_as_block
+    chunks = [
+      ['--- foo -> Enumerator'],
+      ['--- foo(&block) -> object'],
+    ]
+    overloads = [
+      {'segments' => [], 'params' => [], 'arity' => [0, 0], 'block' => 'req'},
+    ]
+    assert_equal [[], [0]], M.assign(overloads, chunks)
+  end
+
+  # 引数リストの無いシグネチャはアリティ 0 扱い
+  def test_chunk_without_params_is_zero_arity
+    chunks = [
+      ['--- size -> Integer'],
+      ['--- size(n) -> Integer'],
+    ]
+    overloads = [
+      {'segments' => [], 'params' => [], 'arity' => [0, 0]},
+      {'segments' => [], 'params' => ['n'], 'arity' => [1, 1]},
+    ]
+    assert_equal [[0], [1]], M.assign(overloads, chunks)
+  end
+
+  # 同一チャンクに複数シグネチャ行(別名など)がある場合は特徴を合算する
+  def test_multiple_signature_lines_in_one_chunk
+    chunks = [
+      ['--- collect {|item| ... } -> [object]', '--- map {|item| ... } -> [object]'],
+      ['--- collect -> Enumerator', '--- map -> Enumerator'],
+    ]
+    overloads = [
+      {'segments' => [], 'params' => [], 'arity' => [0, 0], 'block' => 'req'},
+      {'segments' => [], 'params' => [], 'arity' => [0, 0]},
+    ]
+    assert_equal [[0], [1]], M.assign(overloads, chunks)
+  end
+
+  # 解析できない行だけのチャンクは振り分け先にならない
+  def test_unparseable_chunk_is_skipped
+    chunks = [
+      ['?????'],
+      ['--- foo(x) -> nil'],
+    ]
+    overloads = [
+      {'segments' => [], 'params' => [], 'arity' => [0, 0]},
+    ]
+    assert_equal [[], [0]], M.assign(overloads, chunks)
+  end
+
+  def test_empty_chunks_returns_empty
+    assert_equal [], M.assign([{'segments' => []}], [])
+  end
+end

data/test/test_rbs_sig_importer.rb

@@ -0,0 +1,237 @@
+# frozen_string_literal: true
+require 'test/unit'
+require 'bitclust'
+require 'bitclust/methoddatabase'
+require 'bitclust/rbs_sig_importer'
+require 'tmpdir'
+require 'fileutils'
+require 'json'
+
+# RbsSigImporter(RBS シグネチャ表示)。.rbs 群から
+# "Class#method"/"Class.method" キー → オーバーロード配列の対応を作り、
+# MethodEntry の rbs_sig property に書き込む。
+#
+# オーバーロード = {"segments" => 行, "params" => 引数名, "arity" =>
+# [最小, 最大|nil], "block" => "req"|"opt"} の Hash(segments 以外は
+# チャンク振り分け=RbsOverloadMatcher 用のメタ情報で、無い形式もある)。
+# 行は [種別, テキスト] の配列で、種別 "t" は素のテキスト、"c" は
+# クラス/モジュール名(描画側が DB に存在すればリンク化する)。行の
+# テキストを連結すると元の型シグネチャ文字列に戻る(往復可能)。
+#
+# テストリスト:
+# [x] instance/singleton メソッドが # / . キーになる
+# [x] overload はオーバーロードごとに分かれ、テキスト連結で元に戻る
+# [x] 型名は ["c", name] セグメントになる(引数・戻り値・ジェネリクスの中も)
+# [x] 名前空間付き型名は :: が直前のテキスト側に残る
+# [x] メタ情報: 引数名(位置+キーワード)・アリティ範囲・ブロック有無
+# [x] メタ情報: 引数の無いオーバーロードは params=[]・arity=[0,0]
+# [x] def self?. は # と . の両キーに登録される
+# [x] alias メンバーは元メソッドのシグネチャを共有する
+# [x] attr_reader/attr_writer は name / name= キーになり、型だけの
+#     オーバーロード(メタ無し)になる
+# [x] lookup: typechar i/s/m で引ける(m は # → . の順)
+# [x] lookup: new は Class.new → Class#initialize の順でフォールバック
+# [x] lookup: 別名リストの後ろの名前でもヒットする
+# [x] lookup: 対応が無ければ nil(定数・特殊変数も nil)
+# [x] apply: DB のエントリに rbs_sig(overloads 形式の JSON)が書き込まれる
+# [x] apply: 対応が無いメソッドには書き込まれない
+# [x] apply: 2 回目は無変更(entries_updated=0)
+class TestRbsSigImporter < Test::Unit::TestCase
+  def setup
+    @tmpdir = Dir.mktmpdir
+    @sig_dir = File.join(@tmpdir, 'sig')
+    FileUtils.mkdir_p(@sig_dir)
+    File.write(File.join(@sig_dir, 'foo.rbs'), <<~RBS)
+      class Foo
+        def initialize: (String) -> void
+        def bar: (Integer base) -> String
+               | (::Enumerator::Lazy) -> Array[Integer]
+        def self.build: () -> Foo
+        def self?.mf: () -> bool
+        alias car bar
+        attr_reader label: String
+        attr_writer width: Integer
+        def pairs: (hash[Symbol, String]) -> void
+        def meta: (Integer x, ?String y, *Integer rest, size: Integer, ?name: String) { (Integer) -> void } -> void
+                | (Integer a, Integer b) ?{ () -> void } -> void
+      end
+    RBS
+    @importer = BitClust::RbsSigImporter.new(sig_dirs: [@sig_dir])
+  end
+
+  def teardown
+    FileUtils.rm_rf(@tmpdir)
+  end
+
+  def test_instance_and_singleton_methods_are_keyed
+    sigs = @importer.signatures
+    assert sigs.key?('Foo#bar')
+    assert sigs.key?('Foo#initialize')
+    assert sigs.key?('Foo.build')
+    assert_false sigs.key?('Foo#build')
+  end
+
+  def test_overload_lines_roundtrip_to_original_signature
+    overloads = @importer.signatures['Foo#bar']
+    assert_equal 2, overloads.size
+    assert_equal '(Integer base) -> String', join_text(overloads[0])
+    assert_equal '(::Enumerator::Lazy) -> Array[Integer]', join_text(overloads[1])
+  end
+
+  def test_type_names_become_class_segments
+    overloads = @importer.signatures['Foo#bar']
+    assert_equal(
+      [['t', '('], ['c', 'Integer'], ['t', ' base) -> '], ['c', 'String']],
+      overloads[0]['segments'])
+  end
+
+  def test_namespace_prefix_stays_in_text_segment
+    overloads = @importer.signatures['Foo#bar']
+    assert_equal(
+      [['t', '(::'], ['c', 'Enumerator::Lazy'], ['t', ') -> '],
+       ['c', 'Array'], ['t', '['], ['c', 'Integer'], ['t', ']']],
+      overloads[1]['segments'])
+  end
+
+  # 小文字のエイリアス型(hash 等)自体はテキストのままだが、その
+  # ジェネリクス引数の中のクラス名はリンク化候補にする
+  def test_alias_type_args_become_class_segments
+    overloads = @importer.signatures['Foo#pairs']
+    assert_equal(
+      [['t', '(hash['], ['c', 'Symbol'], ['t', ', '], ['c', 'String'],
+       ['t', ']) -> void']],
+      overloads[0]['segments'])
+  end
+
+  # チャンク振り分け用のメタ情報。引数名は位置引数(rest 含む)+
+  # キーワード名、アリティは位置引数の [最小, 最大](rest があれば nil)、
+  # block は必須 "req" / 省略可能 "opt"(無ければキー自体無し)
+  def test_overload_meta
+    overloads = @importer.signatures['Foo#meta']
+    assert_equal %w[x y rest size name], overloads[0]['params']
+    assert_equal [1, nil], overloads[0]['arity']
+    assert_equal 'req', overloads[0]['block']
+    assert_equal %w[a b], overloads[1]['params']
+    assert_equal [2, 2], overloads[1]['arity']
+    assert_equal 'opt', overloads[1]['block']
+  end
+
+  def test_overload_meta_without_params
+    overloads = @importer.signatures['Foo.build']
+    assert_equal [], overloads[0]['params']
+    assert_equal [0, 0], overloads[0]['arity']
+    assert_nil overloads[0]['block']
+    # 名前の無い位置引数はアリティにだけ数える
+    assert_equal [], @importer.signatures['Foo#initialize'][0]['params']
+    assert_equal [1, 1], @importer.signatures['Foo#initialize'][0]['arity']
+  end
+
+  def test_self_question_registers_both_keys
+    sigs = @importer.signatures
+    assert_equal sigs['Foo#mf'], sigs['Foo.mf']
+    assert_equal '() -> bool', join_text(sigs['Foo#mf'][0])
+  end
+
+  def test_alias_member_shares_signature
+    sigs = @importer.signatures
+    assert_equal sigs['Foo#bar'], sigs['Foo#car']
+  end
+
+  def test_attr_members
+    sigs = @importer.signatures
+    assert_equal 'String', join_text(sigs['Foo#label'][0])
+    assert_equal 'Integer', join_text(sigs['Foo#width='][0])
+    assert_equal({'segments' => [['c', 'String']]}, sigs['Foo#label'][0])
+  end
+
+  def test_lookup_by_typechar
+    sigs = @importer.signatures
+    assert_equal sigs['Foo#bar'], @importer.lookup('Foo', 'i', ['bar'])
+    assert_equal sigs['Foo.build'], @importer.lookup('Foo', 's', ['build'])
+    assert_equal sigs['Foo#mf'], @importer.lookup('Foo', 'm', ['mf'])
+  end
+
+  def test_lookup_new_falls_back_to_initialize
+    assert_equal @importer.signatures['Foo#initialize'],
+                 @importer.lookup('Foo', 's', ['new'])
+  end
+
+  def test_lookup_tries_every_alias_name
+    assert_equal @importer.signatures['Foo#bar'],
+                 @importer.lookup('Foo', 'i', ['zzz', 'bar'])
+  end
+
+  def test_lookup_misses_return_nil
+    assert_nil @importer.lookup('Foo', 'i', ['nope'])
+    assert_nil @importer.lookup('Bar', 'i', ['bar'])
+    assert_nil @importer.lookup('Foo', 'c', ['BAR'])
+    assert_nil @importer.lookup('Foo', 'v', ['$bar'])
+  end
+
+  def test_apply_writes_rbs_sig_property
+    prefix = build_db('4.0')
+    stats = @importer.apply(BitClust::MethodDatabase.new(prefix))
+
+    bar = find_entry(prefix, 'bar')
+    assert_equal({'overloads' => @importer.signatures['Foo#bar']},
+                 JSON.parse(bar.rbs_sig))
+    assert_equal 1, stats[:entries_updated]
+    assert_equal 1, stats[:sigs_matched]
+    assert_equal 1, stats[:methods_missed]
+  end
+
+  def test_apply_leaves_unmatched_methods_untouched
+    prefix = build_db('4.0')
+    @importer.apply(BitClust::MethodDatabase.new(prefix))
+    assert_nil find_entry(prefix, 'nope').rbs_signature_overloads
+  end
+
+  def test_apply_twice_is_idempotent
+    prefix = build_db('4.0')
+    @importer.apply(BitClust::MethodDatabase.new(prefix))
+    stats = @importer.apply(BitClust::MethodDatabase.new(prefix))
+    assert_equal 0, stats[:entries_updated]
+    assert_equal 1, stats[:sigs_matched]
+  end
+
+  private
+
+  def join_text(overload)
+    overload['segments'].map {|_kind, text| text }.join
+  end
+
+  def build_db(version)
+    root = "#{@tmpdir}/tree-#{version}/refm/api/src"
+    FileUtils.mkdir_p("#{root}/_builtin")
+    File.write("#{root}/LIBRARIES", "_builtin\n")
+    File.write("#{root}/_builtin.rd", <<~RD)
+      description
+
+      = class Foo < Object
+      == Instance Methods
+      --- bar(base) -> String
+
+      説明
+
+      --- nope -> nil
+
+      説明
+    RD
+    prefix = "#{@tmpdir}/db-#{version}"
+    db = BitClust::MethodDatabase.new(prefix)
+    db.init
+    db.transaction do
+      db.propset('version', version)
+      db.propset('encoding', 'utf-8')
+    end
+    db.transaction do
+      db.update_by_stdlibtree(root)
+    end
+    prefix
+  end
+
+  def find_entry(prefix, name)
+    db = BitClust::MethodDatabase.new(prefix)
+    db.get_class('Foo').entries.find {|m| m.name?(name) }
+  end
+end

data/test/test_rbssig_command.rb

@@ -0,0 +1,186 @@
+# frozen_string_literal: true
+require 'test/unit'
+require 'bitclust'
+require 'bitclust/methoddatabase'
+require 'bitclust/subcommands/rbssig_command'
+require 'stringio'
+require 'tmpdir'
+require 'fileutils'
+require 'json'
+
+# rbssig サブコマンド(RBS シグネチャ表示)。
+#
+#   bitclust rbssig --sig-dir=DIR <dbpath>
+#   bitclust rbssig --sig-root=RBS_CHECKOUT <dbpath>
+#
+# RBS シグネチャは 4.0 以降のドキュメント専用なので、DB の version が
+# 4.0 未満ならエラーにする(比較は display_typemark と同じく Gem::Version。
+# 文字列比較だと "10.0" が "4.0" より小さく見える)。
+#
+# テストリスト:
+# [x] グローバル --database 不要(needs_database? が false)
+# [x] --sig-root/--sig-dir がどちらも無いとエラー
+# [x] dbpath がちょうど 1 個でないとエラー
+# [x] DB の version が 4.0 未満だとエラー
+# [x] version 10.0 は 4.0 以降として通る(Gem::Version 比較)
+# [x] 4.0 の DB に rbs_sig が書き込まれ、統計行が出力される
+# [x] --dry-run は統計だけ表示して実 DB には書き込まない
+# [x] --sig-root は core/ と stdlib/ を持つチェックアウトを読める
+# [x] Runner に登録されている(bitclust rbssig として呼べる)
+class TestRbssigCommand < Test::Unit::TestCase
+  def setup
+    @tmpdir = Dir.mktmpdir
+    @sig_dir = File.join(@tmpdir, 'sig')
+    FileUtils.mkdir_p(@sig_dir)
+    File.write(File.join(@sig_dir, 'foo.rbs'), <<~RBS)
+      class Foo
+        def bar: (Integer) -> String
+      end
+    RBS
+  end
+
+  def teardown
+    FileUtils.rm_rf(@tmpdir)
+  end
+
+  def test_needs_no_global_database_option
+    cmd = BitClust::Subcommands::RbssigCommand.new
+    assert_false cmd.needs_database?
+  end
+
+  def test_no_sig_source_is_an_error
+    db = build_db('4.0')
+    assert_command_error([db])
+  end
+
+  def test_requires_exactly_one_dbpath
+    db = build_db('4.0')
+    assert_command_error(["--sig-dir=#{@sig_dir}"])
+    assert_command_error(["--sig-dir=#{@sig_dir}", db, db])
+  end
+
+  def test_old_database_version_is_an_error
+    db = build_db('3.4')
+    assert_command_error(["--sig-dir=#{@sig_dir}", db])
+  end
+
+  def test_version_10_passes_the_gate
+    db = build_db('10.0')
+    out = run_command(["--sig-dir=#{@sig_dir}", db])
+    assert_match(/version 10\.0/, out)
+    assert_equal [['t', '('], ['c', 'Integer'], ['t', ') -> '], ['c', 'String']],
+                 find_entry(db, 'bar').rbs_signature_overloads[0]['segments']
+  end
+
+  def test_fills_rbs_sig_and_prints_stats
+    db = build_db('4.0')
+    out = run_command(["--sig-dir=#{@sig_dir}", db])
+    assert_equal '(Integer) -> String',
+                 find_entry(db, 'bar').rbs_signature_overloads[0]['segments'].map {|_k, t| t }.join
+    assert_nil find_entry(db, 'nope').rbs_signature_overloads
+    assert_match(
+      /\Adb-4\.0 \(version 4\.0\): entries_updated=1 sigs_matched=1 methods_missed=1\n\z/,
+      out)
+  end
+
+  def test_dry_run_leaves_database_untouched
+    db = build_db('4.0')
+    out = run_command(["--sig-dir=#{@sig_dir}", db, '--dry-run'])
+    assert_nil find_entry(db, 'bar').rbs_signature_overloads
+    assert_match(/entries_updated=1/, out)
+  end
+
+  def test_sig_root_reads_core_and_stdlib_layout
+    root = File.join(@tmpdir, 'rbs-checkout')
+    FileUtils.mkdir_p("#{root}/core")
+    File.write("#{root}/core/foo.rbs", <<~RBS)
+      class Foo
+        def bar: (String) -> Integer
+      end
+    RBS
+    # core_root を与えると rbs は stringio を暗黙に要求するので、
+    # 本物のチェックアウトと同じく stdlib/ も置く
+    FileUtils.mkdir_p("#{root}/stdlib/stringio/0")
+    File.write("#{root}/stdlib/stringio/0/stringio.rbs", "class StringIO\nend\n")
+
+    db = build_db('4.0')
+    run_command(["--sig-root=#{root}", db])
+    assert_equal '(String) -> Integer',
+                 find_entry(db, 'bar').rbs_signature_overloads[0]['segments'].map {|_k, t| t }.join
+  end
+
+  def test_registered_in_runner
+    require 'bitclust/runner'
+    runner = BitClust::Runner.new
+    runner.prepare
+    subcommands = runner.instance_variable_get(:@subcommands)
+    assert_kind_of BitClust::Subcommands::RbssigCommand, subcommands['rbssig']
+  end
+
+  private
+
+  def build_db(version)
+    root = "#{@tmpdir}/tree-#{version}/refm/api/src"
+    FileUtils.mkdir_p("#{root}/_builtin")
+    File.write("#{root}/LIBRARIES", "_builtin\n")
+    File.write("#{root}/_builtin.rd", <<~RD)
+      description
+
+      = class Foo < Object
+      == Instance Methods
+      --- bar(val) -> String
+
+      説明
+
+      --- nope -> nil
+
+      説明
+    RD
+    prefix = "#{@tmpdir}/db-#{version}"
+    db = BitClust::MethodDatabase.new(prefix)
+    db.init
+    db.transaction do
+      db.propset('version', version)
+      db.propset('encoding', 'utf-8')
+    end
+    db.transaction do
+      db.update_by_stdlibtree(root)
+    end
+    prefix
+  end
+
+  def find_entry(prefix, name)
+    db = BitClust::MethodDatabase.new(prefix)
+    db.get_class('Foo').entries.find {|m| m.name?(name) }
+  end
+
+  def run_command(argv)
+    cmd = BitClust::Subcommands::RbssigCommand.new
+    cmd.parse(argv)
+    out = StringIO.new
+    orig_stdout = $stdout
+    $stdout = out
+    begin
+      cmd.exec(argv, { prefix: nil, capi: false })
+    ensure
+      $stdout = orig_stdout
+    end
+    out.string
+  end
+
+  def assert_command_error(argv)
+    cmd = BitClust::Subcommands::RbssigCommand.new
+    cmd.parse(argv)
+    assert_raise(SystemExit) do
+      capture_stderr { cmd.exec(argv, { prefix: nil, capi: false }) }
+    end
+  end
+
+  def capture_stderr
+    orig = $stderr
+    $stderr = StringIO.new
+    yield
+  ensure
+    $stderr = orig
+  end
+end