bitclust-core 1.3.0 → 1.6.0

data/test/test_method_since_calculator.rb

@@ -0,0 +1,290 @@
+# frozen_string_literal: true
+require 'test/unit'
+require 'bitclust'
+require 'bitclust/methoddatabase'
+require 'bitclust/method_since_calculator'
+require 'tmpdir'
+require 'fileutils'
+
+# メソッド名別 since/until の算出(bitclust#132 P2)。
+#
+# テストリスト:
+# [x] フロア(ラダー最古版から存在)のメソッドは since も until も付かない
+# [x] #@since ゲート付きメソッドは、追加された版以降の対象すべてで
+#     since が付く
+# [x] 別名グループ: シグネチャごとに異なるゲートを持てば名前ごとに
+#     別の since になる(-@ は 2.0.0、dedup は 3.0)。ゲートが効いて
+#     いない版の対象ではその別名自体が存在しない
+# [x] #@until ゲート付きメソッドは、消える1つ前の版の対象で until が付き、
+#     消えた後の対象にはエントリ自体が存在しない
+# [x] インスタンスメソッドとシンゲルトンメソッドは同名でも別キー
+# [x] kind=:undefined のエントリは走査で無視される: {: undef} → 実メソッド化
+#     したものは実メソッド化した版が since になり、逆に undef 化は削除扱いで
+#     前の版の対象に until が付く
+# [x] kind=:undefined のエントリには適用でも書き込まない
+# [x] ラダーに同じバージョンが重複していれば .new で UserError
+# [x] apply は冪等: 2回目は floor_skipped 以外すべて0
+# [x] 既に値がある名前は上書きしない(著者値が算出値より優先)
+# [x] 対象DBのバージョンがラダーに無ければ apply は UserError
+# [x] 統合: `{: since="X"}` 属性行(#132 P4)でパース時に記録された値は
+#     算出結果で上書きされない(RD ソース上の明示注記が算出値より優先)
+class TestMethodSinceCalculator < Test::Unit::TestCase
+  RD = <<~'RD'
+    description
+
+    = class MSCTest
+    == Instance Methods
+    --- old_timer
+
+    説明
+
+    #@since 2.0.0
+    --- newmeth
+
+    説明
+    #@end
+
+    #@since 3.0
+    --- overridden
+    {: since="2.5"}
+
+    説明
+    #@end
+
+    #@since 2.0.0
+    --- suppressed
+    {: since=""}
+
+    説明
+    #@end
+
+    #@since 2.0.0
+    --- -@
+    #@since 3.0
+    --- dedup
+    #@end
+
+    説明
+    #@end
+
+    #@until 3.0
+    --- legacy
+
+    説明
+    #@end
+
+    --- undefmeth
+    {: undef}
+
+    説明
+
+    --- undef_then_real
+    #@until 2.0.0
+    {: undef}
+    #@end
+
+    説明
+
+    #@since 2.0.0
+    --- real_then_undef
+    #@since 3.0
+    {: undef}
+    #@end
+
+    説明
+    #@end
+
+    --- marker
+
+    説明
+
+    == Singleton Methods
+    #@since 2.0.0
+    --- marker
+
+    説明
+    #@end
+  RD
+
+  LADDER_VERSIONS = %w[1.8.7 2.0.0 3.0]
+
+  def setup
+    @tmpdir = Dir.mktmpdir
+    @paths = {}
+    LADDER_VERSIONS.each {|v| build_db(v) }
+  end
+
+  def teardown
+    FileUtils.rm_rf(@tmpdir)
+  end
+
+  def test_floor_method_has_no_since_or_until
+    run_calculator('2.0.0')
+    run_calculator('3.0')
+    assert_nil find_entry('2.0.0', 'i', 'old_timer').since_of('old_timer')
+    assert_nil find_entry('2.0.0', 'i', 'old_timer').until_of('old_timer')
+    assert_nil find_entry('3.0', 'i', 'old_timer').since_of('old_timer')
+    assert_nil find_entry('3.0', 'i', 'old_timer').until_of('old_timer')
+  end
+
+  def test_since_gated_method_gets_since_in_every_later_target
+    run_calculator('2.0.0')
+    run_calculator('3.0')
+    assert_equal '2.0.0', find_entry('2.0.0', 'i', 'newmeth').since_of('newmeth')
+    assert_equal '2.0.0', find_entry('3.0', 'i', 'newmeth').since_of('newmeth')
+  end
+
+  def test_alias_group_since_is_split_by_name
+    run_calculator('2.0.0')
+    run_calculator('3.0')
+
+    at_2_0_0 = find_entry('2.0.0', 'i', '-@')
+    assert_equal ['-@'], at_2_0_0.names
+    assert_equal '2.0.0', at_2_0_0.since_of('-@')
+
+    at_3_0 = find_entry('3.0', 'i', '-@')
+    assert_equal ['-@', 'dedup'], at_3_0.names.sort
+    assert_equal '2.0.0', at_3_0.since_of('-@')
+    assert_equal '3.0', at_3_0.since_of('dedup')
+  end
+
+  def test_until_gated_method
+    run_calculator('2.0.0')
+    assert_equal '3.0', find_entry('2.0.0', 'i', 'legacy').until_of('legacy')
+    assert_nil find_entry('3.0', 'i', 'legacy')
+  end
+
+  def test_singleton_and_instance_method_are_distinct_keys
+    run_calculator('2.0.0')
+    assert_nil find_entry('2.0.0', 'i', 'marker').since_of('marker')
+    assert_equal '2.0.0', find_entry('2.0.0', 's', 'marker').since_of('marker')
+  end
+
+  def test_undefined_entries_are_ignored_in_scan
+    run_calculator('3.0')
+    # 全版 {: undef} の undefmeth は presence ゼロ → 何も書かれない
+    e = find_entry('3.0', 'i', 'undefmeth')
+    assert_equal :undefined, e.kind
+    assert_nil e.since_of('undefmeth')
+    assert_nil e.until_of('undefmeth')
+    # 1.8.7 では {: undef}(存在しない印)なので presence に数えず、実メソッド化
+    # した 2.0.0 が since になる(scan がフィルタしなければ floor 扱いで nil)
+    assert_equal '2.0.0',
+                 find_entry('3.0', 'i', 'undef_then_real').since_of('undef_then_real')
+  end
+
+  def test_undefined_entries_are_ignored_in_apply
+    run_calculator('2.0.0')
+    run_calculator('3.0')
+    # 3.0 で undef 化 → presence は 2.0.0 のみ。2.0.0 の対象では削除扱いで
+    # until が付く
+    at_2_0_0 = find_entry('2.0.0', 'i', 'real_then_undef')
+    assert_equal '2.0.0', at_2_0_0.since_of('real_then_undef')
+    assert_equal '3.0', at_2_0_0.until_of('real_then_undef')
+    # 3.0 の :undefined エントリ自体には(算出値があっても)書き込まない
+    at_3_0 = find_entry('3.0', 'i', 'real_then_undef')
+    assert_equal :undefined, at_3_0.kind
+    assert_nil at_3_0.since_of('real_then_undef')
+    assert_nil at_3_0.until_of('real_then_undef')
+  end
+
+  def test_duplicate_version_in_ladder_raises
+    dbs = ladder_dbs + [fresh_db('2.0.0')]
+    assert_raise(BitClust::UserError) { BitClust::MethodSinceCalculator.new(dbs) }
+  end
+
+  def test_apply_is_idempotent
+    calc = BitClust::MethodSinceCalculator.new(ladder_dbs)
+    calc.scan
+    first_stats = calc.apply(fresh_db('2.0.0'))
+    second_stats = calc.apply(fresh_db('2.0.0'))
+
+    assert_operator first_stats[:since_filled], :>, 0
+    assert_equal 0, second_stats[:since_filled]
+    assert_equal 0, second_stats[:until_filled]
+    assert_equal 0, second_stats[:entries_updated]
+    assert_equal first_stats[:floor_skipped], second_stats[:floor_skipped]
+  end
+
+  def test_author_value_takes_precedence_over_computed_value
+    pre = fresh_db('3.0')
+    entry = pre.get_class('MSCTest').entries.find {|m| m.typechar == 'i' && m.name?('newmeth') } or raise
+    entry.fill_since('newmeth', '1.9.9')
+    entry.save
+
+    calc = BitClust::MethodSinceCalculator.new(ladder_dbs)
+    calc.scan
+    calc.apply(fresh_db('3.0'))
+
+    assert_equal '1.9.9', find_entry('3.0', 'i', 'newmeth').since_of('newmeth')
+  end
+
+  def test_author_since_attribute_parsed_from_source_survives_apply
+    # overridden は #@since 3.0 でゲートされているのでラダー上は 3.0 と算出
+    # されるが、RD ソースの {: since="2.5"} がパース時点(update_by_stdlibtree)
+    # で既に記録されているため、apply(fill_since は未設定時のみ書く)では
+    # 上書きされずそのまま残る
+    run_calculator('2.0.0')
+    run_calculator('3.0')
+
+    assert_nil find_entry('2.0.0', 'i', 'overridden')
+    assert_equal '2.5', find_entry('3.0', 'i', 'overridden').since_of('overridden')
+  end
+
+  def test_explicit_empty_since_suppresses_computed_value
+    # suppressed は #@since 2.0.0 ゲートによりラダー上は 2.0.0 と算出されるが、
+    # {: since=""}(明示的に不明=バッジ非表示)がパース時に記録されているため
+    # apply は上書きしない(bitclust#132: ドキュメント追加がメソッド追加より
+    # 遅れて算出が誤る場合の抑止)
+    run_calculator('3.0')
+    assert_equal '', find_entry('3.0', 'i', 'suppressed').since_of('suppressed')
+  end
+
+  def test_apply_rejects_target_whose_version_is_not_in_ladder
+    build_db('4.0')
+    calc = BitClust::MethodSinceCalculator.new(ladder_dbs)
+    calc.scan
+    assert_raise(BitClust::UserError) { calc.apply(fresh_db('4.0')) }
+  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)
+    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
+    @paths[version] = prefix
+    prefix
+  end
+
+  def fresh_db(version)
+    BitClust::MethodDatabase.new(@paths[version] || raise("no such db: #{version}"))
+  end
+
+  def ladder_dbs
+    LADDER_VERSIONS.map {|v| fresh_db(v) }
+  end
+
+  def run_calculator(target_version)
+    calc = BitClust::MethodSinceCalculator.new(ladder_dbs)
+    calc.scan
+    calc.apply(fresh_db(target_version))
+  end
+
+  def find_entry(version, typechar, name)
+    fresh_db(version).get_class('MSCTest').entries.find {|m|
+      m.typechar == typechar && m.name?(name)
+    }
+  end
+end

data/test/test_methoddatabase.rb

@@ -57,6 +57,22 @@ class TestMethodDatabase < Test::Unit::TestCase
                  @db.get_class("B").dynamically_included.map{|m| m.name})
   end
 
+  # source_location must be stored without a line number so that regenerating
+  # the database does not churn the persisted entries (and the generated HTML).
+  def test_source_location_serialized_without_line_number
+    entry = @db.search_methods(BitClust::MethodNamePattern.new(nil, nil, 'at_exit')).records.first.entry
+    entry.source_location = BitClust::Location.new('refm/api/src/_builtin/Kernel', 42)
+    assert_equal('refm/api/src/_builtin/Kernel', entry._get_properties['source_location'])
+  end
+
+  def test_source_location_roundtrip_drops_line_number
+    entry = @db.search_methods(BitClust::MethodNamePattern.new(nil, nil, 'at_exit')).records.first.entry
+    entry.source_location = BitClust::Location.new('refm/api/src/_builtin/Kernel', 42)
+    entry._set_properties(entry._get_properties)
+    assert_equal('refm/api/src/_builtin/Kernel', entry.source_location.file)
+    assert_nil(entry.source_location.line)
+  end
+
   private
   def setup_files
     FileUtils.mkdir_p("#{@root}/_builtin")

data/test/test_methodentry.rb

@@ -0,0 +1,328 @@
+require 'test/unit'
+require 'bitclust'
+require 'bitclust/methoddatabase'
+require 'tmpdir'
+require 'fileutils'
+
+class TestMethodEntryTitleLabels < Test::Unit::TestCase
+  def test_title_labels_matches_label_when_no_alias
+    lib, db = BitClust::RRDParser.parse(<<HERE, 'dummy')
+= class Enumerable2
+== Instance Methods
+--- select -> Array
+
+説明のためのエントリ
+HERE
+    _ = lib
+    m = db.get_method(BitClust::MethodSpec.parse('Enumerable2#select'))
+    assert_equal(['Enumerable2#select'], m.title_labels)
+    assert_equal(m.label, m.title_labels.join(', '))
+  end
+
+  def test_title_labels_lists_every_alias
+    lib, db = BitClust::RRDParser.parse(<<HERE, 'dummy')
+= class Enumerable2
+== Instance Methods
+--- collect -> Array
+--- map -> Array
+
+説明のためのエントリ
+HERE
+    _ = lib
+    m = db.get_method(BitClust::MethodSpec.parse('Enumerable2#collect'))
+    assert_equal(['Enumerable2#collect', 'Enumerable2#map'], m.title_labels)
+  end
+
+  # #label omits the class prefix for special variables (e.g. "$;", not
+  # "Kernel$;"); #title_labels must keep that convention for every alias,
+  # unlike #labels which always includes the prefix.
+  def test_title_labels_omits_class_prefix_for_special_variables
+    lib, db = BitClust::RRDParser.parse(<<HERE, 'dummy')
+= module Kernel
+description
+== Special Variables
+--- $;
+--- $FIELD_SEPARATOR
+
+区切り文字。
+HERE
+    _ = lib
+    m = db.get_method(BitClust::MethodSpec.parse('Kernel$;'))
+    assert_equal('$;', m.label)
+    assert_equal(['$;', '$FIELD_SEPARATOR'], m.title_labels)
+    assert_equal(['Kernel$;', 'Kernel$FIELD_SEPARATOR'], m.labels)
+  end
+
+  def test_title_labels_matches_label_for_single_special_variable
+    lib, db = BitClust::RRDParser.parse(<<HERE, 'dummy')
+= module Kernel
+description
+== Special Variables
+--- $stdout -> IO
+
+標準出力。
+HERE
+    _ = lib
+    m = db.get_method(BitClust::MethodSpec.parse('Kernel$stdout'))
+    assert_equal(['$stdout'], m.title_labels)
+    assert_equal(m.label, m.title_labels.join(', '))
+  end
+end
+
+# bitclust#250: Ruby 4.0 以降のドキュメントでは module function の表記を
+# 独自の「.#」から「?.」に変える(表示のみ。識別子は変えない)。
+#
+# label/short_label/labels/title_labels 自身は refsdatabase.rb の
+# [[a:...]] アンカー解決キー(labels)や `bitclust methods --diff` の
+# expand_mf マッチング(labels)が literal ".#" を前提にしているため、
+# 一切変更しない。表示用には display_label/display_short_label/
+# display_title_labels/display_typemark を新設し、テンプレート側の
+# 実際の表示箇所だけがそちらを呼ぶようにする。
+class TestMethodEntryDisplayTypemark < Test::Unit::TestCase
+  SRC = <<HERE
+= module Kernel
+description
+== Module Functions
+--- mf
+--- mf2
+
+説明
+
+== Instance Methods
+--- im
+
+説明
+
+== Special Variables
+--- $stdout -> IO
+
+標準出力。
+HERE
+
+  def build(version)
+    _lib, db = BitClust::RRDParser.parse(SRC, 'testlib', {'version' => version})
+    db
+  end
+
+  def test_module_function_display_stays_dot_hash_before_4_0
+    db = build('3.4')
+    m = db.get_method(BitClust::MethodSpec.parse('Kernel.#mf'))
+    assert_equal('.#', m.display_typemark)
+    assert_equal('Kernel.#mf', m.display_label)
+    assert_equal('.#mf', m.display_short_label)
+    assert_equal(['Kernel.#mf', 'Kernel.#mf2'], m.display_title_labels)
+  end
+
+  def test_module_function_display_switches_to_question_dot_at_4_0
+    db = build('4.0')
+    m = db.get_method(BitClust::MethodSpec.parse('Kernel.#mf'))
+    assert_equal('?.', m.display_typemark)
+    assert_equal('Kernel?.mf', m.display_label)
+    assert_equal('?.mf', m.display_short_label)
+    assert_equal(['Kernel?.mf', 'Kernel?.mf2'], m.display_title_labels)
+  end
+
+  # 識別子として使われる label/labels/short_label/title_labels は、
+  # 表示版とは無関係に version が 4.0 以降でも従来どおり ".#" のまま
+  def test_identity_methods_are_unaffected_by_version
+    db = build('4.0')
+    m = db.get_method(BitClust::MethodSpec.parse('Kernel.#mf'))
+    assert_equal('.#', m.typemark)
+    assert_equal('Kernel.#mf', m.label)
+    assert_equal('.#mf', m.short_label)
+    assert_equal(['Kernel.#mf', 'Kernel.#mf2'], m.title_labels)
+    assert_equal(['Kernel.#mf', 'Kernel.#mf2'], m.labels)
+  end
+
+  def test_instance_method_and_special_variable_display_are_unaffected_by_version
+    db = build('4.0')
+    im = db.get_method(BitClust::MethodSpec.parse('Kernel#im'))
+    assert_equal('#', im.display_typemark)
+    assert_equal('Kernel#im', im.display_label)
+    assert_equal('im', im.display_short_label)
+
+    sv = db.get_method(BitClust::MethodSpec.parse('Kernel$stdout'))
+    assert_equal('$', sv.display_typemark)
+    assert_equal('$stdout', sv.display_label)
+    assert_equal('$stdout', sv.display_short_label)
+  end
+end
+
+# meta description（コンパイラを通さない表示テキスト）内の module function
+# 参照 [[m:Kernel.#mf2]] のラベルも、可視ページの bracket_link と同様に
+# DB バージョン 4.0 以降では "?." で表示する（bitclust#282/#283 の続き。
+# 従来この経路だけ ".#" のまま残っていた）
+class TestMethodEntryDescriptionQdot < Test::Unit::TestCase
+  SRC = <<HERE
+= module Kernel
+
+== Module Functions
+
+--- mf
+
+[[m:Kernel.#mf2]] を参照してください。
+
+--- mf2
+
+説明。
+HERE
+
+  def description(version)
+    _lib, db = BitClust::RRDParser.parse(SRC, 'testlib', {'version' => version})
+    db.get_method(BitClust::MethodSpec.parse('Kernel.#mf')).description
+  end
+
+  def test_meta_description_keeps_dot_hash_before_4_0
+    assert_equal('Kernel.#mf2 を参照してください。', description('3.4'))
+  end
+
+  def test_meta_description_uses_question_dot_at_4_0
+    assert_equal('Kernel?.mf2 を参照してください。', description('4.0'))
+  end
+end
+
+# メソッド名別の since/until (bitclust#132 P1)。
+#
+# テストリスト:
+# [x] 新規エントリの since_map/until_map は空、since_of/until_of は nil
+# [x] fill_since は初回のみ追加して true を返す。既に値があれば false で上書きしない
+# [x] fill_until も同様
+# [x] fill_since/fill_until は version に '=' や ',' を含むと ArgumentError
+# [x] 実ディスク DB への保存→別インスタンスで再読込しても since_of/until_of が一致
+# [x] 名前に '=' を含む（"==", "foo="）・',' を含む（"," ）・"-@" が
+#     エンコード/デコードを経て正しく往復する
+# [x] since_by_name/until_by_name のキー自体がプロパティファイルに無い
+#     （旧DB）場合も落ちずに空配列として読める（Entry の '[String]' デシリアライザの
+#     nil 安全化）
+class TestMethodEntrySinceUntil < Test::Unit::TestCase
+  def setup
+    @dir = Dir.mktmpdir
+    @db = BitClust::MethodDatabase.new(@dir)
+    @db.init
+    @db.transaction do
+      @db.propset('version', '2.0')
+      @db.propset('encoding', 'utf-8')
+    end
+  end
+
+  def teardown
+    FileUtils.rm_rf(@dir)
+  end
+
+  def test_defaults_are_empty
+    m = build_entry('marker')
+    assert_equal({}, m.since_map)
+    assert_equal({}, m.until_map)
+    assert_nil m.since_of('marker')
+    assert_nil m.until_of('marker')
+  end
+
+  def test_fill_since_adds_once
+    m = build_entry('marker')
+    assert_equal(true, m.fill_since('marker', '2.0'))
+    assert_equal('2.0', m.since_of('marker'))
+    # 既に値があるので上書きされず false
+    assert_equal(false, m.fill_since('marker', '3.0'))
+    assert_equal('2.0', m.since_of('marker'))
+  end
+
+  def test_fill_until_adds_once
+    m = build_entry('marker')
+    assert_equal(true, m.fill_until('marker', '3.0'))
+    assert_equal('3.0', m.until_of('marker'))
+    assert_equal(false, m.fill_until('marker', '4.0'))
+    assert_equal('3.0', m.until_of('marker'))
+  end
+
+  def test_fill_since_rejects_version_with_equal_or_comma
+    m = build_entry('marker')
+    assert_raise(ArgumentError) { m.fill_since('marker', '2.0=1') }
+    assert_raise(ArgumentError) { m.fill_since('marker', '2.0,1') }
+  end
+
+  def test_fill_until_rejects_version_with_equal_or_comma
+    m = build_entry('marker')
+    assert_raise(ArgumentError) { m.fill_until('marker', '2.0=1') }
+    assert_raise(ArgumentError) { m.fill_until('marker', '2.0,1') }
+  end
+
+  def test_roundtrip_through_disk
+    m = build_entry('marker')
+    m.fill_since('marker', '2.0')
+    m.fill_until('marker', '3.0')
+    m.save
+
+    reloaded = reload_entry(m.id)
+    assert_equal('2.0', reloaded.since_of('marker'))
+    assert_equal('3.0', reloaded.until_of('marker'))
+    assert_equal({'marker' => '2.0'}, reloaded.since_map)
+    assert_equal({'marker' => '3.0'}, reloaded.until_map)
+  end
+
+  def test_roundtrip_names_with_special_characters
+    [ '==', 'foo=', '-@', ',' ].each do |name|
+      m = build_entry(name)
+      m.fill_since(name, '2.0')
+      m.save
+
+      reloaded = reload_entry(m.id)
+      assert_equal('2.0', reloaded.since_of(name),
+                   "since_of(#{name.inspect}) should round-trip")
+    end
+  end
+
+  def test_multiple_names_share_one_entry
+    m = build_entry_with_names(['-@', 'dedup'])
+    m.fill_since('-@', '2.0')
+    m.fill_since('dedup', '3.0')
+    m.save
+
+    reloaded = reload_entry(m.id)
+    assert_equal('2.0', reloaded.since_of('-@'))
+    assert_equal('3.0', reloaded.since_of('dedup'))
+    assert_equal({'-@' => '2.0', 'dedup' => '3.0'}, reloaded.since_map)
+  end
+
+  def test_missing_since_by_name_key_is_backward_compatible
+    m = build_entry('old_method')
+    m.save
+    strip_property_line(m.id, 'since_by_name')
+    strip_property_line(m.id, 'until_by_name')
+
+    reloaded = reload_entry(m.id)
+    assert_equal([], reloaded.since_by_name)
+    assert_equal([], reloaded.until_by_name)
+    assert_nil reloaded.since_of('old_method')
+  end
+
+  private
+
+  def build_entry(name)
+    build_entry_with_names([name])
+  end
+
+  def build_entry_with_names(names)
+    id = BitClust::NameUtils.build_method_id('_builtin', 'Foo', :instance_method, names.first)
+    m = BitClust::MethodEntry.new(@db, id)
+    m.names = names
+    m.visibility = :public
+    m.kind = :defined
+    m.source = "説明\n"
+    m
+  end
+
+  def reload_entry(id)
+    fresh_db = BitClust::MethodDatabase.new(@dir)
+    BitClust::MethodEntry.new(fresh_db, id)
+  end
+
+  def property_file_path(id)
+    File.join(@dir, BitClust::NameUtils.encodeid("method/#{id}"))
+  end
+
+  def strip_property_line(id, key)
+    path = property_file_path(id)
+    lines = File.readlines(path).reject {|l| l.start_with?("#{key}=") }
+    File.write(path, lines.join)
+  end
+end

data/test/test_methodsignature.rb

@@ -4,7 +4,9 @@ require 'bitclust/methodsignature'
 class TestMethodSignature < Test::Unit::TestCase
 
   data("special var" => ["$_ -> String | nil", "--- $_ -> String | nil"],
-       "backquote"   => ["`command` -> String", "--- `(command) -> String"])
+       "backquote"   => ["`command` -> String", "--- `(command) -> String"],
+       "aset"        => ["self[key] = value", "--- []=(key, value)"],
+       "aset splat"  => ["[]=(*idxary)", "--- []=(*idxary)"])
   def test_friendlyname(data)
     friendly_string, method_signature = data
     assert_equal(friendly_string, BitClust::MethodSignature.parse(method_signature).friendly_string)