CompositeBackend

List directory contents (non-recursive).

If path matches a route, lists only that backend. If path is "/", aggregates default backend plus virtual route directories. Otherwise lists default backend.

Async version of ls.

Read file content, routing to appropriate backend.

Async version of read.

Search files for literal text pattern.

Routes to backends based on path: specific route searches one backend, "/" or None searches all backends, otherwise searches default backend.

Async version of grep.

See grep() for detailed documentation on routing behavior and parameters.

Find files matching a glob pattern, routing by path prefix.

Async version of glob.

Create a new file, routing to appropriate backend.

Async version of write.

Edit a file, routing to appropriate backend.

Async version of edit.

Execute a shell command via the default backend.

Unlike file operations, execution is not path-routable — it always delegates to the default backend.

Async version of execute.

See execute() for detailed documentation on parameters and behavior.

Upload multiple files, batching by backend for efficiency.

Groups files by their target backend, calls each backend's upload_files once with all files for that backend, then merges results in original order.

Async version of upload_files.

Download multiple files, batching by backend for efficiency.

Groups paths by their target backend, calls each backend's download_files once with all paths for that backend, then merges results in original order.

Async version of download_files.