bitclust-core 1.6.0 → 1.6.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ea74921a9df5a9e7009ee4d7b4219ab4bf9f28fa369c1e8fd558a4ee5b661fdf
-  data.tar.gz: 35847d933f8ca3a73a60c2333f084555b301d46d790187020f79830749a60b60
+  metadata.gz: 8c50953e0ecaf38a9d4c6187b22eaccedd4b9f52029bb638e026fbbfc655d8a2
+  data.tar.gz: c5ce94f2931f5472651e6bd425c766ba19b9ff4acc87d8fd5ae8e57f384db3d6
 SHA512:
-  metadata.gz: 0ebd81dbaf1ccb47c60b46297cae6067a6708e3eb686f47b8d7890b49149f2018ce977cf762e30f5b7dda6c70b793edb5bf688c755c36b25b626e4f2b6b16cf8
-  data.tar.gz: 2fbfddeb46e668c1a3c3e2bcf9b36f844cde0b6c4056c7e38a79863d7a6ee378db7b78093b47031910eb948e6fb2c13f29141cd053366e500a88b6b0f8337ace
+  metadata.gz: 4766a837042d881e63e96264338d7e04aa6e10e63db1b2ff22ca0e53e6f6e97f766efadbe9c1a6ff8c4b89bfac996eb4c060c9b9abfd8c4aff420c57a987a3f7
+  data.tar.gz: e64091ccdeddf09ed18339d2be46af88abc28c6d9aaf6ae9da888c4125c5ab47b526c315d9f630e76389258fe56f950600b1265d42c10d98a2d595b3892f02d8

data/lib/bitclust/methoddatabase.rb

@@ -202,6 +202,10 @@ module BitClust
         # lib ファイルの値へ戻す
         lib_entry.source_location = lib_location
       end
+    rescue ParseError => e
+      # manual/ には今後もより新しい bitclust を必要とする記法が入りうる。
+      # 古い gem でパースに失敗したとき原因へたどり着けるよう案内を添える
+      raise ParseError, "#{e.message} (ヒント: マニュアルがより新しい bitclust を必要とする記法を含んでいる可能性があります。bitclust の gem を更新すると解決するかもしれません)", e.backtrace
     end
 
     # since は「その版以降」、until は「その版未満」（ブリッジの

data/lib/bitclust/version.rb

@@ -1,4 +1,4 @@
 # frozen_string_literal: true
 module BitClust
-  VERSION = "1.6.0"
+  VERSION = "1.6.1"
 end

data/test/test_mdparser.rb

@@ -341,6 +341,41 @@ class TestMDParser < Test::Unit::TestCase
     end
   end
 
+  def test_update_by_markdowntree_parse_error_suggests_gem_update
+    # manual/ が新しい bitclust を必要とする記法を含むとき、古い gem では
+    # パースエラーになる。原因へたどり着けるよう gem 更新の案内を添える
+    require 'tmpdir'
+    Dir.mktmpdir do |root|
+      write = ->(rel, s) {
+        path = File.join(root, rel)
+        FileUtils.mkdir_p(File.dirname(path))
+        File.write(path, s)
+      }
+      write.call('mylib.md', "---\ntype: library\n---\nmylib。\n")
+      write.call('mylib/Foo.md', <<~MD)
+        ---
+        library: mylib
+        ---
+        # class Foo < Object
+
+        クラス。
+
+        ## Instance Methods
+
+        ### def bar: (Integer) -> String
+
+        RBS 形式のシグネチャ(未対応)。
+      MD
+
+      db = BitClust::MethodDatabase.dummy(PARAMS)
+      error = assert_raise(BitClust::ParseError) do
+        db.update_by_markdowntree(root)
+      end
+      assert_include error.message, "unsupported method signature"
+      assert_include error.message, "bitclust の gem を更新すると解決するかもしれません"
+    end
+  end
+
   def test_copy_doc_md_keeps_relative_location
     # Windows CI 対応: doc エントリの source_location は md_root と同じ形
     # （相対で渡せば相対 manual/doc/...）で格納する。絶対パス化すると

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bitclust-core
 version: !ruby/object:Gem::Version
-  version: 1.6.0
+  version: 1.6.1
 platform: ruby
 authors:
 - https://github.com/rurema