Python を python/ 配下に統一し、Linguist ルールを作り直す

.gitattributes

@@ -1,4 +1,3 @@
-# Shipped product is C++ / WebView2. Keep the Python prototype and legacy
-# benchmarks in the repository, but exclude them from GitHub Linguist stats.
-prototype/** linguist-vendored
-benchmark/legacy_python/** linguist-vendored
+# Shipped product is C++ / WebView2.
+# All non-build Python lives under python/ and is excluded from Linguist.
+python/** linguist-vendored

.gitignore

@@ -26,13 +26,13 @@ dist/binary/*
 dist/*.zip
 
 # Benchmark data generated on local machines
-benchmark/testdata/
-benchmark/**/results/*.json
+python/benchmark/testdata/
+python/benchmark/**/results/*.json
 
 # Prototype build outputs
-prototype/python/*.dist/
-prototype/python/*.build/
-prototype/python/*.onefile-build/
+python/prototype/*.dist/
+python/prototype/*.build/
+python/prototype/*.onefile-build/
 
 # Reference repositories and logs
 reference/

README.md

@@ -81,22 +81,23 @@ The default WebView2 SDK root is `C:\tools\webview2\build\native`. Override it w
 Build outputs are written to `dist\binary`. Run the smoke tests after building:
 
 ```powershell
-python core\native\tests\native_smoke.py
+python python\tests\native_smoke.py
 ```
 
 Detailed specifications and build notes are in [`document/`](document/).
 
 ## Project layout
 
 ```text
-core/native/       C++ engine, GUI host, CLI, resources, and native tests
+core/native/       C++ engine, GUI host, CLI, and resources
+python/prototype/  archived Python/PySide6 prototype
+python/tests/      native CLI smoke and benchmark runners
+python/benchmark/  historical Python prototype measurements
 templates/         self-contained WebView2 development UI
 static/            reserved CSS/JS/image source area
 assets/            icon sources and future public screenshots
 document/          specification, environment, and version information
 plans/             dated implementation plans and results
-benchmark/         reproducible benchmarks and measurement notes
-prototype/python/  archived Python/PySide6 prototype
 dist/binary/       generated binaries, excluded from source control
 dist/documents/    user-facing distribution documents
 ```

README_jp.md

@@ -81,22 +81,23 @@ WebView2 SDKの既定ルートは`C:\tools\webview2\build\native`です。別の
 成果物は`dist\binary`へ出力されます。ビルド後のスモークテスト:
 
 ```powershell
-python core\native\tests\native_smoke.py
+python python\tests\native_smoke.py
 ```
 
 詳しい仕様とビルド情報は[`document/`](document/)にあります。
 
 ## フォルダ構成
 
 ```text
-core/native/       C++エンジン、GUIホスト、CLI、リソース、ネイティブテスト
+core/native/       C++エンジン、GUIホスト、CLI、リソース
+python/prototype/  旧Python/PySide6プロトタイプ
+python/tests/      ネイティブCLIのスモークとベンチマーク
+python/benchmark/  旧Python試作の計測記録
 templates/         自己完結WebView2開発用UI
 static/            CSS/JS/画像を分離する場合の配置先
 assets/            アイコン原本と今後の公開用スクリーンショット
 document/          仕様、開発環境、バージョン情報
 plans/             日付付きの計画書と実施結果
-benchmark/         再現可能なベンチマークと計測記録
-prototype/python/  旧Python/PySide6プロトタイプ
 dist/binary/       生成バイナリ（ソース管理対象外）
 dist/documents/    配布用ユーザー文書
 ```

core/native/README.md

@@ -10,15 +10,13 @@ src/copy_engine.cpp        scanner, queue, copy paths, verification, metadata
 src/webview_main.cpp       Win32 window, WebView2 host, UAC worker, WebMessage
 src/main_cli.cpp            command-line application
 resources/                  resource script, VERSIONINFO, generated embedded HTML
-tests/native_smoke.py       functional smoke tests
-tests/benchmark_native.py   reproducible performance runner
 ```
 
-The standard build entry point is the repository-root `build.bat` or `build_native.py`.
+Python smoke tests live in `python/tests/`. The standard build entry point is the repository-root `build.bat` or `build_native.py`.
 
 ```powershell
 build.bat
-python core\native\tests\native_smoke.py
+python python\tests\native_smoke.py
 ```
 
 Outputs:

document/environment.md

@@ -65,13 +65,13 @@ An external `index.html` or engine DLL is not required.
 ## Tests
 
 ```powershell
-python core\native\tests\native_smoke.py
+python python\tests\native_smoke.py
 ```
 
 Benchmark:
 
 ```powershell
-python core\native\tests\benchmark_native.py --profile small --destination-root D:\qfc-bench --workers 1,4,8,16
+python python\tests\benchmark_native.py --profile small --destination-root D:\qfc-bench --workers 1,4,8,16
 ```
 
 ## Troubleshooting
@@ -91,13 +91,14 @@ python core\native\tests\benchmark_native.py --profile small --destination-root
 core/native/include/qfc/  Public engine headers
 core/native/src/          Engine, WebView2 host, and CLI
 core/native/resources/    RC files and icon/HTML resource definitions
-core/native/tests/        Smoke tests and benchmarks
+python/prototype/         Legacy Python prototype
+python/tests/             Native CLI smoke tests and benchmarks
+python/benchmark/         Historical Python prototype measurements
 templates/                WebView2 UI used during development
 static/                   Future location for separated CSS/JS/images
 assets/                   Original icons and public images
 document/                 Developer documentation
 plans/                    Plans and implementation results
-prototype/python/         Legacy Python prototype
 dist/binary/              Generated binaries
 dist/documents/           Distribution documentation
 ```

document/environment_jp.md

@@ -65,13 +65,13 @@ build.bat
 ## テスト
 
 ```powershell
-python core\native\tests\native_smoke.py
+python python\tests\native_smoke.py
 ```
 
 性能測定:
 
 ```powershell
-python core\native\tests\benchmark_native.py --profile small --destination-root D:\qfc-bench --workers 1,4,8,16
+python python\tests\benchmark_native.py --profile small --destination-root D:\qfc-bench --workers 1,4,8,16
 ```
 
 ## トラブルシューティング
@@ -91,13 +91,14 @@ python core\native\tests\benchmark_native.py --profile small --destination-root
 core/native/include/qfc/  公開エンジンヘッダー
 core/native/src/          エンジン、WebView2ホスト、CLI
 core/native/resources/    RC、アイコン/HTMLのリソース定義
-core/native/tests/        スモークテストとベンチマーク
+python/prototype/         旧Pythonプロトタイプ
+python/tests/             ネイティブCLIのスモークとベンチマーク
+python/benchmark/         旧Python試作の計測記録
 templates/                開発用WebView2 UI
 static/                   将来のCSS/JS/画像分離先
 assets/                   アイコン原本・公開用画像
 document/                 開発者向け文書
 plans/                    計画・実施結果
-prototype/python/         旧Pythonプロトタイプ
 dist/binary/              生成バイナリ
 dist/documents/           配布同梱文書
 ```

python/benchmark/README.md

@@ -0,0 +1,11 @@
+# Benchmarks
+
+The production native benchmark runner is:
+
+```powershell
+python python\tests\benchmark_native.py --profile small --destination-root D:\qfc-bench --workers 1,4,8,16
+```
+
+This directory holds the data generator, runner, and reports created for the former
+Python prototype. They are historical measurements and should not be presented as
+results from the current QuickFileCopy native engine.

core/native/tests/benchmark_native.py → python/tests/benchmark_native.py

@@ -12,7 +12,7 @@
 import uuid
 
 
-ROOT = Path(__file__).resolve().parents[3]
+ROOT = Path(__file__).resolve().parents[2]
 QFC = ROOT / "dist" / "binary" / "QuickFileCopy_cli.exe"
 ELAPSED = re.compile(r"elapsed:\s+([0-9.]+)\s+s")
 

core/native/tests/native_smoke.py → python/tests/native_smoke.py

@@ -8,7 +8,7 @@
 import unittest
 
 
-ROOT = Path(__file__).resolve().parents[3]
+ROOT = Path(__file__).resolve().parents[2]
 QFC = ROOT / "dist" / "binary" / "QuickFileCopy_cli.exe"