Skip to main content

max / audiofiles

Add module headers to the browser crate The 15 files that lacked a //! header: the DirectBackend trait-impl split, the BrowserState method split, and the import wizard screens. Each says what its slice covers, so the module list reads as a map rather than a set of filenames. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Author: Max Johnson <me@maxj.phd> · 2026-07-20 18:53 UTC
Commit: 973a4e3e45148de265704053deaadc89305df39d
Parent: e17c94f
15 files changed, +42 insertions, -0 deletions
@@ -1,3 +1,6 @@
1 + //! `DirectBackend` analysis and rules: stored analysis results, batch saves,
2 + //! feature backfill queries, and rule application over one or many samples.
3 +
1 4 use super::*;
2 5
3 6 impl AnalysisBackend for DirectBackend {
@@ -1,3 +1,6 @@
1 + //! `DirectBackend` search and classification: folder-scoped and global search,
2 + //! plus the k-NN classifier head (training, info, and auto-apply).
3 +
1 4 use super::*;
2 5
3 6 impl SearchBackend for DirectBackend {
@@ -1,3 +1,6 @@
1 + //! `DirectBackend` Sample Forge: chop and conform, in both the synchronous form
2 + //! and the worker-backed form that streams progress back to the UI.
3 +
1 4 use super::*;
2 5
3 6 impl ForgeBackend for DirectBackend {
@@ -1,3 +1,6 @@
1 + //! `DirectBackend` library structure: VFS create/rename/delete, directory
2 + //! listing (plain and analysis-enriched), tags, and collections.
3 +
1 4 use super::*;
2 5
3 6 impl VfsBackend for DirectBackend {
@@ -1,3 +1,7 @@
1 + //! `DirectBackend` long-running operations: import, analysis, export, and VFS
2 + //! mirror sync. These spawn workers and report progress through event channels
3 + //! rather than blocking, and each carries a matching cancel path.
4 +
1 5 use super::*;
2 6
3 7 impl OperationsBackend for DirectBackend {
@@ -1,3 +1,6 @@
1 + //! `DirectBackend` content-addressed store access: importing files, resolving a
2 + //! hash to its path/extension/original name, and removing samples or orphans.
3 +
1 4 use super::*;
2 5
3 6 impl StoreBackend for DirectBackend {
@@ -1,3 +1,5 @@
1 + //! Tests for the direct backend.
2 +
1 3 use super::*;
2 4
3 5 fn setup() -> DirectBackend {
@@ -1,3 +1,6 @@
1 + //! `BrowserState` multi-selection and bulk actions: the selection model and the
2 + //! confirm-then-execute path for destructive operations over many nodes.
3 +
1 4 use tracing::warn;
2 5
3 6 use super::*;
@@ -1,3 +1,6 @@
1 + //! `BrowserState` import workflow: drives the import wizard from source folder
2 + //! through preflight, configuration, tagging, and analysis to the final review.
3 +
1 4 use std::path::{Path, PathBuf};
2 5
3 6 use tracing::{error, warn};
@@ -1,3 +1,6 @@
1 + //! `BrowserState` navigation and listing: current VFS position, refreshing
2 + //! directory contents, and the search/sort applied to the visible list.
3 +
1 4 use tracing::{error, warn};
2 5
3 6 use super::*;
@@ -1,3 +1,5 @@
1 + //! Tests for browser state.
2 +
1 3 use super::*;
2 4 use audiofiles_core::vfs::NodeType;
3 5
@@ -1,3 +1,5 @@
1 + //! Import wizard configure screens: import options and analysis settings.
2 +
1 3 use egui;
2 4 use super::super::{theme, widgets};
3 5
@@ -1,3 +1,6 @@
1 + //! Import wizard progress screens: import, cleanup, and analysis progress, plus
2 + //! the cancelled-operation screen.
3 +
1 4 use egui;
2 5
3 6 use crate::state::{BrowserState, CancelKind, ImportMode};
@@ -1,3 +1,5 @@
1 + //! Import wizard error summary screen: what failed during the run.
2 +
1 3 use egui;
2 4
3 5 use crate::state::{BrowserState, ConfirmAction, ImportMode};
@@ -1,3 +1,6 @@
1 + //! Import wizard tagging screens: per-folder tag entry and review of suggested
2 + //! tags before they are applied.
3 +
1 4 use std::collections::BTreeMap;
2 5
3 6 use egui;