Skip to content

古い bitclust が使われている場合に rake が案内を出すようにする#3055

Merged
znz merged 3 commits into
rurema:masterfrom
znz:bitclust-version-guard
Jul 11, 2026
Merged

古い bitclust が使われている場合に rake が案内を出すようにする#3055
znz merged 3 commits into
rurema:masterfrom
znz:bitclust-version-guard

Conversation

@znz

@znz znz commented Jul 11, 2026

Copy link
Copy Markdown
Member

fix rurema/bitclust#230

チュートリアルどおりに進めても、過去に clone した古い bitclust が隣のディレクトリ(BITCLUST_PATH、既定値 ../bitclust)に残っていると Gemfile がそれを優先し、cannot load such file -- drb(Ruby 3.4 の bundled gems 化)や invalid option: --markdowntree(Markdown 移行前)といった分かりにくいエラーでビルドに失敗します(rurema/bitclust#230 の原因)。

  • Rakefile: generate / statichtml の前に bitclust のバージョンを検査し、1.5.0 未満なら使用中の bitclust のパスと対処(git pull / 削除 / BITCLUST_PATH)を表示して中断する。閾値は Gem::Version で比較
  • Tutorial: 「Sync fork してから clone する」と「古い ../bitclust が残っている場合の症状と対処」を追記
  • Gemfile.lock: DB 不要サブコマンドの回帰修正・doc/usage.md 更新・バージョン 1.5.0 bitclust#233(回帰修正 + 1.5.0)マージ後の master 247aa751 にバンプ済み。ガードはこのピンで通ります

検証

  • ガード発火: ../bitclust の version.rb を一時的に 1.3.1 にして rake generate:3.4 → 案内メッセージで exit 1
  • 正常系: bitclust 1.5.0(ローカル path)で rake generate:3.4 が最後まで成功
  • Gemfile.lock は fetch 不可環境のため手で更新(revision と 1.4.0 → 1.5.0 のみ。Add skip_lines option to CSV::DEFAULT_OPTIONS #233 は依存を変更していないため bundle lock と同結果。Bundler::LockfileParser でのパースは確認済み)

🤖 Generated with Claude Code

znz and others added 3 commits July 12, 2026 01:28
doctree の Gemfile は BITCLUST_PATH (既定値 ../bitclust) にディレクトリが
存在するとそちらの bitclust を優先する。過去に clone した古いチェック
アウトが残っていると、rake generate が
`cannot load such file -- drb` (Ruby 3.4 の bundled gems 化) や
`invalid option: --markdowntree` (Markdown 移行前) といった分かりにくい
エラーで失敗する。

generate / statichtml の前に bitclust のバージョンを検査し、1.5.0 未満
なら原因 (使用中の bitclust のパス) と対処を示して中断する。

fix rurema/bitclust#230

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
チュートリアルどおりに進めても、(1) 以前の fork の master が古いまま、
(2) 過去に clone した古い bitclust が隣のディレクトリに残っている、の
いずれかで分かりにくいエラーになる (rurema/bitclust#230)。

- fork の項に「Sync fork」で最新化してから進む手順を追加
- bundle install の項に、Gemfile が BITCLUST_PATH (既定値 ../bitclust) を
  優先する仕組みと、古い場合の症状・対処を追加

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
DB 不要サブコマンドの回帰修正とバージョン 1.5.0 (rurema/bitclust#233)
を含む master に更新する。Rakefile のバージョンガード (>= 1.5.0) は
このピンで通る。

この環境は git fetch 不可のため bundle lock ではなく手で更新した
(変更点は revision と 1.4.0 → 1.5.0 のみで、rurema#233 は依存を変えていない)。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@znz znz merged commit e06807d into rurema:master Jul 11, 2026
9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

チュートリアルどおりにやってもエラー

1 participant