Releases: igapyon/miku-xlsx2md-java
Release list
v1.3.0
v1.2.0
v1.0.0.1
v1.0.0
miku-xlsx2md-java v0.9.0 release
miku-xlsx2md-java v0.9.0 release
ストレートコンバージョン後に git log 内容を集約整理
ストレートコンバージョン後に git log 内容を集約整理
Java版 `miku-xlsx2md` の release に向けた最終調整。CLI / Maven plugin の実用面、fixture coverage、Release asset workflow、利用者向け README を強化
Java版 miku-xlsx2md の release に向けた最終調整。CLI / Maven plugin の実用面、fixture coverage、Release asset workflow、利用者向け README を強化しました。
概要
Java版 miku-xlsx2md の release version を 0.9.0 に更新し、CLI / Maven plugin の実用面、fixture coverage、Release asset workflow、利用者向け README を強化しました。
主な変更
- Maven project version を
0.9.0に更新 - Java CLI に
--verboseを追加- 処理中の workbook path を stderr に出力
- Maven plugin に
miku-xlsx2md.verboseを追加convert/convert-directorygoal で処理中 workbook path を Maven log へ出力
DirectoryConverterに progress listener を追加- GitHub Actions release workflow を追加
v*tag push または manual dispatch でmvn -B packageを実行- shaded runtime jar を GitHub Release asset として添付
original-*.jarは release asset から除外
- Node CLI と Java CLI の Markdown 出力を byte-level 比較する
scripts/compare-node-java-markdown.shを追加- 初期比較対象は
xlsx2md-basic-sample01.xlsxとlink/hyperlink-basic-sample01.xlsx
- 初期比較対象は
- README をリリース利用者向けに再構成
- Java CLI の利用例とオプション一覧を追加
- Maven plugin の利用例とパラメータ一覧を追加
- 機能概要、対応状況、用途、必要環境を整理
- 英語説明と日本語説明を併記
- 開発者向けの実装状況メモを
docs/development-status.mdに移動
Fixture / Regression Coverage
この範囲では、runtime 実装差分なしの coverage 拡張が複数追加されています。
SheetMarkdownTestの upstream fixture parity coverage を拡張- display
- hyperlink
- rich / rich markdown escape
- merge / merge multiline / merge pattern
- formula basic / spill / cross-sheet / shared
- chart basic / mixed
- image-basic-sample01 / image-basic-sample02
- edge-empty
- named-range
- narrative
- table-border-priority
- table-basic / grid-layout
- shape 系 fixture
WorksheetParserTestのformula-crosssheet/formula-sharedfixture coverage を拡張- value type
- raw value
- formula type
- cached value metadata
- CLI / Maven plugin の fixture conversion coverage を拡張
- hyperlink
- rich / rich-text-github
- merge / merge-pattern
- formula
- chart
- image
- edge-empty
- table-basic / grid-layout
- shape-flowchart / shape-block-arrow / shape-callout
Maven Plugin Smoke
scripts/smoke-maven-plugin.shを0.9.0用の full-coordinate 実行に更新- smoke coverage に
convert-directorygoal を追加
確認記録
範囲内のドキュメント記録では、以下の確認が pass とされています。
mvn testmvn packagesh scripts/smoke-maven-plugin.shscripts/compare-node-java-markdown.sh- CLI / Maven plugin / SheetMarkdown / WorksheetParser の focused regression test 群
既知の未確認・未対応事項
- actual GitHub tag 上での release workflow 実行は未確認
- ZIP / assets の Node / Java byte-level parity は未着手
- 初期選定 fixture 以外への Node / Java Markdown byte-level 比較拡張は今後の作業
- future upstream fixture additions に対する追加 coverage は今後の作業
CLI / Maven plugin のディレクトリ一括変換と planner-aware 対応
CLI / Maven plugin のディレクトリ一括変換と planner-aware 対応
概要
CLI / Maven plugin の fixture coverage 拡張、upstream の planner-aware テーブル検知モード反映、Maven plugin version 管理の親 pom 集約、ディレクトリ一括変換機能の追加と共通化を行いました。
主な変更
- CLI / Maven plugin の upstream fixture conversion coverage に
shape-flowchart-sample01、shape-block-arrow-sample01、shape-callout-sample01を追加 SheetMarkdownTestの fixture parity coverage を shape 系と table-basic 系へ拡張- upstream
planner-awaretable detection mode を Java 側へ反映 - Java CLI の既定
formattingModeをgithubへ同期 - CLI help に
planner-awareと GUI-aligned defaults 表記を追加 - root
pom.xmlに Maven plugin version 管理を集約 - Maven plugin に
convert-directorygoal を追加 - CLI に
--input-directory、--output-directory、--recursiveを追加 - directory batch conversion を runtime helper
DirectoryConverterへ共通化 - README、TODO、follow-up log、remaining items、upstream test mapping、straight conversion guide を更新
ディレクトリ一括変換
Maven plugin と Java CLI の両方で、ディレクトリ配下の .xlsx を Markdown へ一括変換できるようになりました。
- 探索対象は
.xlsxのみ recursiveの既定値はfalseoutputDirectory省略時は入力ディレクトリ側へ.mdを出力- 再帰有効時は入力ディレクトリからの相対ディレクトリ構造を維持
- CLI directory mode では
--out/--zipとの併用を禁止 - Maven plugin の
convert-directorygoal はDirectoryConverterへ委譲
テスト
以下の確認が記録されています。
mvn -pl miku-xlsx2md -Dtest=MikuXlsx2mdCliTest testpassmvn -pl miku-xlsx2md-maven-plugin -am -Dtest=MikuXlsx2mdMojoTest -Dsurefire.failIfNoSpecifiedTests=false testpassmvn -pl miku-xlsx2md -Dtest=SheetMarkdownTest testpassmvn -pl miku-xlsx2md -Dtest=MarkdownOptionsTest,TableDetectorTest,SheetMarkdownTest,MikuXlsx2mdCliTest testpassmvn -pl miku-xlsx2md-maven-plugin -am -Dtest=MikuXlsx2mdMojoTest,ConvertDirectoryMojoTest -Dsurefire.failIfNoSpecifiedTests=false testpassmvn -pl miku-xlsx2md,miku-xlsx2md-maven-plugin -am -Dtest=DirectoryConverterTest,MikuXlsx2mdCliTest,ConvertDirectoryMojoTest,MikuXlsx2mdMojoTest -Dsurefire.failIfNoSpecifiedTests=false testpassmvn testpass
`miku-xlsx2md-java` の初回リリースです
このリリースは、miku-xlsx2md-java の初回リリースです。
概要
Java 版は Maven multi-module 構成で整備され、miku-xlsx2md runtime module と miku-xlsx2md-maven-plugin module を含みます。あわせて、workbook parsing、sheet-to-markdown conversion、CLI、Maven plugin、upstream fixture ベースの focused regression、関連ドキュメント整備が進んでいます。
この時点で確認できる内容
- Java source / target compatibility は
1.8 - Build tool は
Maven - Test framework は
JUnit Jupiter - runtime / CLI は
miku-xlsx2mdmodule - Maven plugin は
miku-xlsx2md-maven-pluginmodule - workbook parsing minimum path は実装済み
sheet-markdownの最小変換導線は実装済み- Java CLI は Node 版互換の option vocabulary を意識した initial conversion に接続済み
- Maven plugin は runtime core conversion に接続済み
- upstream fixture ベースの focused regression が追加済み
README.md、TODO.md、docs/remaining-items.md、docs/upstream-test-mapping.md、docs/follow-up-log.mdで進捗管理が更新済み