Skip to content

fix: Patternsの公開依存と規則保持・利用文書を整備 - #28

Merged
lambig merged 2 commits into
mainfrom
feat/public-contract-and-consumers
Nov 7, 2026
Merged

lambig merged 2 commits into
mainfrom
feat/public-contract-and-consumers

Conversation

@lambig

@lambig lambig commented Nov 6, 2026

Copy link
Copy Markdown
Owner

Patternsだけの依存宣言で、Tuple2を含む公開APIをMaven/Gradleから利用できる1.3.2候補を整備しました。FIE 1.1.3、Tuplite 1.0.1に続く依存先の整備として、lambig/ABService#567 のL3に対応する実装・利用文書・独立した導入例を揃えます。

今回の変更

  • Tuplite 1.0.1をAPI依存として公開し、POMとGradle Module Metadataに反映。functional-interface-extension 1.1.3も推移的に解決されます。Lombokはビルド時の依存に変更しました。
  • Patternsの公開コンストラクタとConsumingPatternsのリスト経由の作成で、元のリストを変更しても規則の組合せ・順序が保たれるようにしました。Patternsの既存ファクトリと同じ扱いになります。
  • 日本語Javadoc・READMEを、分類結果、処理の振り分け、優先順位、未一致、Optional、null、例外の意味に沿って整備。例外の4コンストラクタも既存のシグネチャ・メッセージ・原因の扱いを保って明示しました。
  • Java 11を実行時の最低版として維持し、Gradle Wrapper 9.7.1、候補リポジトリ、署名付きCentral bundle、Java 11/25のCI検証を用意しました。

検証

ビルドJDK 25で生成し、Java 11/25それぞれで以下を確認しました。

  • 35試験が成功。規則保持、最初の一致、空の規則、null結果、型条件、例外の伝播を含みます。
  • 1.3.1と3公開型のジェネリック宣言・JVMシグネチャが一致。旧版でコンパイルした利用コードは旧依存・更新後の依存・候補版で実行成功。
  • 一時キャッシュを使った独立したMaven/Gradle導入例が成功。Patternsのみを宣言し、外部パッケージからTuple2を含むAPIをコンパイル・実行できました。
  • READMEの2プログラムは記載どおりの結果。Javadoc警告なし、sources JARの3ファイルは対象ソースと一致。
  • 一時的な検証鍵を用いてbundleの5公開物・5署名・20チェックサムとModule Metadataの参照先を確認。

再実行は sh ./verify-consumers.sh candidate。CIではビルドJDK 17と実行Java 11/25を使用し、試験・導入・文書の結果をartifactに保存します。

残工程・レビュー観点

残工程はレビュー、マージ後CI、1.3.2の正式署名・Maven Central公開、公開版の導入確認です。toolboxへの集約とABServiceでの採用は後続工程にあります。

元のリストを変更して規則を更新していた利用コードでは、作成済みインスタンスの規則が保持されるようになります。この変更が既存ファクトリとの一貫性を満たすか、文書から未一致・null結果・副作用の扱いを判断できるか、独立した導入例が公開APIの依存情報を十分に検証できているかを確認してください。

@lambig lambig left a comment

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

レビュー結果

L3の1.3.2公開候補として実装・依存関係は妥当です。 公開前のREADMEへの軽微な互換性・移行案内を1件推奨します(インライン指摘)。

  • api 'io.github.lambig:Tuplite:1.0.1' としたことで、公開APIに現れる Tuple2 がPatternsの単独依存宣言から解決できます。FIE 1.1.3もTupliteから推移解決されます。候補POMのcompile依存、Gradle Module Metadata、独立Maven/Gradle consumerで確認する構成は適切です。
  • 1.3.1の公開型・メソッド(ジェネリクス・JVMシグネチャを含む)との比較、および旧版でコンパイルしたclientの旧依存/更新依存/候補版での実行により、バイナリ互換性の確認ができています。
  • Patternsの公開コンストラクタとConsumingPatternsのリスト受け取り口におけるコピーは、元からコピーしていたPatterns.of(List)との整合を回復します。コピー対象は規則のリストであり、述語・関数・Consumerの参照先の状態は引き続き反映されます。
  • 先勝ち、最初の一致結果がnullの場合は後続に進まずOptional空、未一致、元の例外の伝播、副作用の既実行部分の保持が、コード・テスト・READMEで対応しています。NoSuchPatternExceptionのLombok置換も4コンストラクタのメッセージ/原因契約に配慮しています。
  • 現HEAD c9e341e の CI でJava 11/25の両contract and consumersジョブが成功し、成果物のHEAD SHAが一致することを確認しました。
  • 一時鍵を使った実bundle検証の結果はPR本文の記録として確認しています。正式署名・Central公開・公開版の取得確認、toolbox/ABServiceへの適用は後続工程と区別できています。

追加のコード変更要求はありません。 READMEに1.3.1→1.3.2での規則リスト更新の意味差と移行方法を明示できれば、本レビューの指摘は解消と判断します。

Comment thread README.md Resolved
@lambig
lambig merged commit c706bbd into main Nov 7, 2026
2 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