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.

Delete a file, routing to the appropriate backend.

CompositeBackend always advertises delete support (it overrides this method), so the delete tool is never filtered out for it. A route may still point at a backend that does not implement delete; rather than letting NotImplementedError escape to the caller, that case is converted into a DeleteResult error.

Async version of delete.

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.