Repository navigation
v3開発ロードマップとブランチ運用を整備し、devの文書CIを省略 - #113
Merged
Merged
Conversation
PyYoshi
marked this pull request as ready for review
September 20, 2026 09:29
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
概要
cChardet v3を、実データの取り込みに適したnative detectorとして改善するための開発ロードマップを追加します。必要な設計変更を互換性が妨げる場合は、移行方法を用意したうえで破壊的変更を選べる方針です。
本文は日本語で管理し、現状の2.3.0に既にある基盤と今後の実装を区別しています。9段階の依存関係・成果物・完了条件、最初の12作業、性能と精度の評価方法、corpus/modelの再現性・由来、失敗分析、API移行、条件付きのRust/SIMD研究を具体化しました。3.0のリリース条件と、v3系列全体の長期計画は分けています。
masterを安定版、devをv3開発の統合先とし、このPRもdev向けです。開発文書は日本語、利用者向け文書は英語を基本とする方針を明記し、READMEからロードマップへリンクしました。C++20を有力候補として配布環境で検証し、RAII・借用buffer・型・compile時検証でmemory safetyを改善する方針を含みます。規格更新、所有権の整理、検出algorithmの変更は別の作業として扱います。
旧model生成scriptは参考調査に留め、新規generatorを基本方針とします。過去の再現性・品質問題の報告を記録し、決定性、再実行時のべき等性、生成modelの品質を別々に検証します。旧scriptの修復は前提にしません。
新規fileのlicenseは未決定と明示し、LGPL/MIT/Apache-2.0等を候補に、Phase 1でcomponent別に判断します。新規generatorを含む対象の実装・外部contribution受入れ前に方針を確定し、既存code、corpus、生成modelの条件は別々に確認します。このPRで既存licenseの変更や旧scriptの削除は行いません。
uchardetも
cchardetをv2保守、devをv3開発として分離します。分岐点はcChardet 2.3.0が固定する7993e0afe3b6c64f0ea3b43c7d4987118f6c5c12です。共通修正の相互反映、PRのbase、release時のcommit固定を文書化しました。v3側の.gitmodulesは追跡branchをdevへ変更しますが、PyYoshi forkのURLとgitlinkは変更しません。dev向けPRとpushでは、変更がMarkdown/reStructuredTextだけの場合にCIを起動しないようにします。master向けの既存必須チェックは維持します。テスト本体は再利用workflow、wheel生成は共通のcomposite actionを利用し、release tagと手動実行の動作は維持します。コード・設定・submodule変更を含むPRは通常どおり検証します。v3の作業はcChardet側のIssueへ集約し、実装先repositoryと依存関係を明記して追跡する運用を追加しました。検出器の実装やRules設定の変更は含みません。
確認
devとcchardetの分岐時commit、submoduleのURLとgitlinkを確認。git diff --check。更新commitのGitHub Actionsでテスト・配布物を検証。