Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 16 additions & 4 deletions architecture.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,13 @@ selection signals blocked and preserve the selected rule identity without refill
observation strings never feed persistence. Limit-version mismatch retains dated old usage with an
explicit waiting state and unknown excess. The settings schema and reminder state remain unchanged.

Actions that read or change the scanned entries (`main_window._WAIT_FOR_SCAN`) stay enabled while a scan or a
source operation runs; `MainWindow._run_action` and `_explain_busy` intercept them and `gui.busy_notice` says
why they wait, in the status bar and next to the pointer. Actions that start a scan themselves
(`_WAIT_FOR_OPERATION`) wait only for operations. `move_to_trash`, `delete_permanently` and the context menu's
folder rescan explain the same way, so panel buttons never fail silently; authority checks are unchanged
(U-20261118-02).

`MainWindow.folder_context` resolves a typed `FolderContext` from the current result and selection,
checking scan ownership, shared operation busy state, closing, links and virtual roots. Files use
their containing folder. `DetailsPanel.set_folder_context` displays its copyable path and unavailable
Expand Down Expand Up @@ -768,6 +775,9 @@ unusable dates. New selections/scan roots invalidate old replies; MainWindow joi
ChartStack navigation updates all charts and records one visit; stepping history does not append it.
Detached nodes are pruned after edits, new scans reset references, and deep ancestor paths use a
scroll area with a collapsed menu instead of widening the chart. Shortcuts apply while Chart is visible.
The Up, Back, Forward and ancestor buttons take no focus, so `ResultsView.focus_chart` gives it to the
chart after each; `MainWindow._leave_path_box` moves focus from the path box or start page to the tree
when a scan begins. Enter meant for the chart therefore never reaches the path box (U-20261119-01).

`printing` captures the visible results before opening QPrintDialog, then QPrinter fits those pixels
on one printable page. PDF export uses the same fitted layout via QPdfWriter on ExportWorker, avoiding
Expand Down Expand Up @@ -1202,10 +1212,12 @@ on Windows by default the size rounded up to the volume's clusters, the system a
files, 0 for files whose data is elsewhere (cloud placeholders, offline), never opening those.
Each finished folder's files are added to the running totals of every folder above it. The root is handed
out first (`started`), so `FolderTreeModel` shows the tree in live mode while it grows: each folder's
children are a sorted copy frozen until the next `refresh()`, which the window calls every 700 ms (a layout
change that moves persistent indexes, so expanded folders, selection and scroll position survive). A tick
whose shown folders keep their members, sorted order and child presence only notifies the root and folder
rows and repaints the visible tree, since file rows' own values are final when added (U-20261017-76). The
children are a sorted copy frozen until the next `refresh()` (a layout change that moves persistent indexes,
so expanded folders, selection and scroll position survive). `gui.live_refresh.LiveRefresh` calls it every
700 ms at the fastest; each call is timed until the event loop is about to wait, and the next one waits four
times that, up to 5 s, so live refreshes take at most about a fifth of the window's time however many rows
are expanded (U-20261118-01). A tick whose shown folders keep their members, sorted order and child presence
only notifies the root row and repaints the visible tree (U-20261017-76, U-20261118-01). The
calling thread reports progress about ten times a second and watches the cancel event. When every folder
is read, totals are added up again bottom-up and children sorted largest first; `analyse()` (largest
files, per-type totals) runs still off the GUI thread and `succeeded(ScanOutcome)` ends live mode. Stop
Expand Down
5 changes: 4 additions & 1 deletion docs/guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -365,7 +365,10 @@ To give FileTree to someone without Python, compile it with Nuitka into a progra
Dropping a folder scans it in place and accepts only the Copy action, preserving the source even when Shift requests Move.
2. **Watch it fill in**: the tree appears right away and the biggest folders move to the top while
FileTree works; the largest files and file types follow when the scan ends. *Stop* (or Esc) ends the
scan at any time and keeps what was read so far, marked as incomplete.
scan at any time and keeps what was read so far, marked as incomplete. While it runs, actions that read
or change the scanned files (Move to Recycle Bin, Rescan, exports and the like) wait for it: using one
says so in the status bar and next to the pointer instead of doing nothing. With many folders open the
tree refreshes less often, so the window stays responsive.
3. **Find what takes the space**: the biggest folders are at the top of the tree. Open a folder with the
arrow next to it, or explore the chart on the right.

Expand Down
2 changes: 1 addition & 1 deletion docs/guide_ja.md
Original file line number Diff line number Diff line change
Expand Up @@ -288,7 +288,7 @@ FileTree を Python を持たない人に渡すには、Nuitka を使用して

## 使い方

1. **スキャン対象を選択**: クリック * フォルダーを選択します…* またはスタート ページのドライブの 1 つを選択し、フォルダーをウィンドウにドラッグするか、上部のボックスにパスを入力して Enter を押します。コマンド ライン `je-file-tree D:\Projects` (または `python start_file_tree.py D:\Projects`) からスキャンを開始することもできます。フォルダーをドロップすると、フォルダーがその場でスキャンされ、コピー アクションのみが受け入れられ、Shift キーが移動を要求した場合でもソースが保持されます。 2. **入力を見てください**: ツリーがすぐに表示され、FileTree が動作している間、最大のフォルダーが一番上に移動します。スキャンが終了すると、最大のファイルとファイルの種類が続きます。 *Stop* (または Esc) でいつでもスキャンを終了し、それまでに読み取った内容を保持し、不完全としてマークします。 3. **スペースを占めるものを見つけます**: 最大のフォルダーがツリーの一番上にあります。横にある矢印のあるフォルダーを開くか、右側のグラフを調べてください。
1. **スキャン対象を選択**: クリック * フォルダーを選択します…* またはスタート ページのドライブの 1 つを選択し、フォルダーをウィンドウにドラッグするか、上部のボックスにパスを入力して Enter を押します。コマンド ライン `je-file-tree D:\Projects` (または `python start_file_tree.py D:\Projects`) からスキャンを開始することもできます。フォルダーをドロップすると、フォルダーがその場でスキャンされ、コピー アクションのみが受け入れられ、Shift キーが移動を要求した場合でもソースが保持されます。 2. **入力を見てください**: ツリーがすぐに表示され、FileTree が動作している間、最大のフォルダーが一番上に移動します。スキャンが終了すると、最大のファイルとファイルの種類が続きます。 *Stop* (または Esc) でいつでもスキャンを終了し、それまでに読み取った内容を保持し、不完全としてマークします。スキャン中は、スキャン結果を読み取ったり変更したりする操作(ごみ箱への移動、再スキャン、エクスポートなど)はスキャンの完了を待ちます。その間に使うと、何も起きないのではなく、ステータス バーとポインターの横に理由が表示されます。展開したフォルダーが多いときは、ウィンドウを操作できるようにフォルダー ツリーの更新間隔を広げます。 3. **スペースを占めるものを見つけます**: 最大のフォルダーがツリーの一番上にあります。横にある矢印のあるフォルダーを開くか、右側のグラフを調べてください。

### 結果の読み取り

Expand Down
2 changes: 1 addition & 1 deletion docs/guide_ko.md
Original file line number Diff line number Diff line change
Expand Up @@ -288,7 +288,7 @@ Python이 없는 사람에게 FileTree를 제공하려면 Nuitka를 사용하여

## 사용방법

1. **검사 대상 선택**: *폴더 선택…* 또는 시작 페이지의 드라이브 중 하나를 클릭하거나 폴더를 창으로 드래그하거나 상단 상자에 경로를 입력하고 Enter 키를 누릅니다. `je-file-tree D:\Projects`(또는 `python start_file_tree.py D:\Projects`) 명령줄에서 스캔을 시작할 수도 있습니다. 폴더를 삭제하면 폴더가 제자리에 스캔되고 복사 작업만 허용되며 Shift가 이동을 요청하는 경우에도 소스가 유지됩니다. 2. **채워지는 것을 지켜보세요**: 트리가 즉시 나타나고 FileTree가 작동하는 동안 가장 큰 폴더가 맨 위로 이동합니다. 스캔이 끝나면 가장 큰 파일과 파일 형식이 따릅니다. *Stop*(또는 Esc)은 언제든지 스캔을 종료하고 지금까지 읽은 내용을 불완전으로 표시하여 유지합니다. 3. **공간을 차지하는 항목 찾기**: 가장 큰 폴더가 트리 상단에 있습니다. 옆에 화살표가 있는 폴더를 열거나 오른쪽에 있는 차트를 탐색하세요.
1. **검사 대상 선택**: *폴더 선택…* 또는 시작 페이지의 드라이브 중 하나를 클릭하거나 폴더를 창으로 드래그하거나 상단 상자에 경로를 입력하고 Enter 키를 누릅니다. `je-file-tree D:\Projects`(또는 `python start_file_tree.py D:\Projects`) 명령줄에서 스캔을 시작할 수도 있습니다. 폴더를 삭제하면 폴더가 제자리에 스캔되고 복사 작업만 허용되며 Shift가 이동을 요청하는 경우에도 소스가 유지됩니다. 2. **채워지는 것을 지켜보세요**: 트리가 즉시 나타나고 FileTree가 작동하는 동안 가장 큰 폴더가 맨 위로 이동합니다. 스캔이 끝나면 가장 큰 파일과 파일 형식이 따릅니다. *Stop*(또는 Esc)은 언제든지 스캔을 종료하고 지금까지 읽은 내용을 불완전으로 표시하여 유지합니다. 스캔 중에는 스캔 결과를 읽거나 바꾸는 작업(휴지통으로 이동, 다시 스캔, 내보내기 등)이 스캔이 끝날 때까지 기다립니다. 그동안 이런 작업을 누르면 아무 반응이 없는 대신 상태 표시줄과 포인터 옆에 이유가 표시됩니다. 펼친 폴더가 많으면 창이 계속 반응하도록 폴더 트리의 갱신 간격을 늘립니다. 3. **공간을 차지하는 항목 찾기**: 가장 큰 폴더가 트리 상단에 있습니다. 옆에 화살표가 있는 폴더를 열거나 오른쪽에 있는 차트를 탐색하세요.

### 결과 읽기

Expand Down
2 changes: 1 addition & 1 deletion docs/guide_zh-CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -290,7 +290,7 @@ python start_file_tree.py

1. **选择要扫描的地方**:在起始页点“选择文件夹…”或其中一个磁盘、把文件夹拖到窗口上,或在上方的输入框输入路径后按 Enter。也可以从命令行直接开始扫描:`je-file-tree D:\Projects`(或 `python start_file_tree.py D:\Projects`)。
拖动文件夹会在原位置扫描,且只接受复制操作;即使用 Shift 请求移动,也会保留来源。
2. **边扫边看**:文件夹树会立刻出现,FileTree 一边加总,最大的文件夹一边往上排;最大的文件与文件类型在扫描结束时补上。随时可以点“停止”(或按 Esc)结束扫描,已经读到的部分会留下来并标示为不完整。
2. **边扫边看**:文件夹树会立刻出现,FileTree 一边加总,最大的文件夹一边往上排;最大的文件与文件类型在扫描结束时补上。随时可以点“停止”(或按 Esc)结束扫描,已经读到的部分会留下来并标示为不完整。扫描进行中,会读取或更改扫描结果的操作(移到回收站、重新扫描、导出等)须等扫描完成;这时点击它们,状态栏与鼠标指针旁会说明原因,而不是没有反应。展开的文件夹很多时,文件夹树会放慢刷新频率,让窗口保持可操作。
3. **找出占空间的东西**:最大的文件夹排在最上面。点文件夹旁的箭头看里面的内容,或在右边的图表里浏览。

### 看懂结果
Expand Down
2 changes: 1 addition & 1 deletion docs/guide_zh-TW.md
Original file line number Diff line number Diff line change
Expand Up @@ -290,7 +290,7 @@ python start_file_tree.py

1. **選擇要掃描的地方**:在起始頁按「選擇資料夾…」或其中一顆磁碟、把資料夾拖曳到視窗上,或在上方的方框輸入路徑後按 Enter。也可以從命令列直接開始掃描:`je-file-tree D:\Projects`(或 `python start_file_tree.py D:\Projects`)。
拖曳資料夾會在原位置掃描,且只接受複製動作;即使用 Shift 要求移動,也會保留來源。
2. **邊掃邊看**:資料夾樹會立刻出現,FileTree 一邊加總,最大的資料夾一邊往上排;最大的檔案與檔案類型在掃描結束時補上。隨時可以按「停止」(或 Esc)結束掃描,已經讀到的部分會留下來並標示為不完整。
2. **邊掃邊看**:資料夾樹會立刻出現,FileTree 一邊加總,最大的資料夾一邊往上排;最大的檔案與檔案類型在掃描結束時補上。隨時可以按「停止」(或 Esc)結束掃描,已經讀到的部分會留下來並標示為不完整。掃描進行中,會讀取或變更掃描結果的操作(移到資源回收筒、重新掃描、匯出等)須等掃描完成;這時按下它們,狀態列與滑鼠指標旁會說明原因,而不是沒有反應。展開的資料夾很多時,資料夾樹會放慢更新頻率,讓視窗保持可操作。
3. **找出佔空間的東西**:最大的資料夾排在最上面。按資料夾旁的箭頭看裡面的內容,或在右邊的圖表裡瀏覽。

### 看懂結果
Expand Down
Loading
Loading