@@ -13,6 +13,26 @@ Pythonモジュールの依存関係を解析して、再帰的にリロード
1313- ** 相対インポート対応** : パッケージ内の相対インポートを正しく処理
1414- ** 循環参照対応** : Pythonで動作する循環インポートを正しくリロード
1515
16+ ## インストール
17+
18+ Pythonパスが通っている場所であればどこでも配置可能です。
19+ 本READMEでは一般的なMayaのscriptsフォルダーを例として説明します。
20+
21+ ```
22+ ~/Documents/maya/scripts/ (例)
23+ └── deep_reloader/
24+ ├── __init__.py
25+ ├── _metadata.py
26+ ├── deep_reloader.py
27+ ├── from_clause.py
28+ ├── import_clause.py
29+ ├── module_info.py
30+ ├── symbol_extractor.py
31+ ├── LICENSE
32+ ├── README.md
33+ └── tests/
34+ ```
35+
1636## 使用方法
1737
1838### 基本的な使用方法
@@ -46,25 +66,6 @@ deep_reload(your_module)
4666- ` logging.INFO ` : モジュールリロードの状況を表示(デフォルト)
4767- ` logging.WARNING ` : エラーと警告のみ表示
4868
49- ## インストール
50-
51- Pythonパスが通っている場所であればどこでも配置可能です。
52- 本READMEでは一般的なMayaのscriptsフォルダーを例として説明します。
53-
54- ```
55- ~/Documents/maya/scripts/ (例)
56- └── deep_reloader/
57- ├── __init__.py
58- ├── _metadata.py
59- ├── deep_reloader.py
60- ├── imported_symbols.py
61- ├── module_info.py
62- ├── symbol_extractor.py
63- ├── LICENSE
64- ├── README.md
65- └── tests/ # テストファイル(開発・デバッグ用)
66- ```
67-
6869## テスト実行
6970
7071** 注意: テストはpytestで実行してください。Maya内部での実行はサポートしていません。**
@@ -81,7 +82,7 @@ cd ~/Documents/maya/scripts/
8182python -m pytest deep_reloader/tests/ -v
8283
8384# 特定のテストファイル実行
84- python -m pytest deep_reloader/tests/test_absolute_import_basic .py -v
85+ python -m pytest deep_reloader/tests/integration/test_absolute_import .py -v
8586
8687# より詳細な出力
8788python -m pytest deep_reloader/tests/ -vv
@@ -146,17 +147,20 @@ python -m pytest deep_reloader/tests/ -q
146147 - 例外クラスをリロード対象から除外する
147148 - アプリケーションを再起動する
148149
149- - ** import 文非対応** (仕様 )
150- - `import module` 形式の依存関係は解析対象外です
151- - 現在対応しているのはfrom - import 形式です。具体的には、
150+ - ** import 文非対応** (将来的に対応予定 )
151+ - `import module` 形式の依存関係は現在は解析対象外です
152+ - 現在対応しているのはfrom - import 形式のみです:
152153 - `from xxx import yyy` 形式
153154 - `from .xxx import yyy` 形式
154155 - `from . import yyy` 形式
155- - の3 つです
156156
157- - ** 理由** :
158- - `import xxx` は主に標準ライブラリや外部ライブラリで使用され、これらはリロード対象外です
159- - 自作パッケージ内では from - import を使うのが一般的な慣習です
157+ - ** 現状の推奨** :
158+ - from - import を使用してください(例: `from deep_reloader import deep_reload` )
159+ - `import xxx` 形式は将来のバージョンで対応予定です
160+
161+ - ** 将来の対応予定** :
162+ - `import mypackage` のような同一パッケージ内のモジュールインポートを検出し、依存関係として追跡
163+ - 標準ライブラリや外部ライブラリは引き続き除外
160164
161165- ** 単一パッケージのみリロード** (仕様)
162166 - `deep_reload()` は、指定されたモジュールと同じパッケージに属するモジュールのみをリロードします
@@ -171,7 +175,7 @@ python -m pytest deep_reloader/tests/ -q
171175
172176# ## リリース状況
173177- ✅ コア機能実装完了(from - import 対応)
174- - ✅ テストスイート( 12 テスト)
178+ - ✅ テストスイート
175179- ✅ ドキュメント整備
176180- ✅ Maya環境での動作検証
177181- ✅ 循環インポート対応
0 commit comments