snapshot of https://github.com/tauri-apps/plugins-workspace.git (v2, 2026-09-23; blobs > 131072B omitted)

plugins/fs/src/desktop.rs

@@ -0,0 +1,44 @@
+// Copyright 2019-2023 Tauri Programme within The Commons Conservancy
+// SPDX-License-Identifier: Apache-2.0
+// SPDX-License-Identifier: MIT
+
+use std::path::PathBuf;
+
+use tauri::{AppHandle, Runtime};
+
+use crate::{FilePath, OpenOptions};
+
+/// Access to the file system APIs on desktop.
+///
+/// Retrieved with [`crate::FsExt::fs`].
+pub struct Fs<R: Runtime>(pub(crate) AppHandle<R>);
+
+fn path_or_err<P: Into<FilePath>>(p: P) -> std::io::Result<PathBuf> {
+    match p.into() {
+        FilePath::Path(p) => Ok(p),
+        FilePath::Url(u) if u.scheme() == "file" => u
+            .to_file_path()
+            .map_err(|_| std::io::Error::new(std::io::ErrorKind::InvalidInput, "invalid file URL")),
+        FilePath::Url(_) => Err(std::io::Error::new(
+            std::io::ErrorKind::InvalidInput,
+            "cannot use a URL to load files on desktop and iOS",
+        )),
+    }
+}
+
+impl<R: Runtime> Fs<R> {
+    /// Open a file.
+    ///
+    /// # Platform-specific
+    ///
+    /// - **iOS**: This method will automatically start accessing a security-scoped resource if the path is a file URL.
+    ///   You must call `stop_accessing_security_scoped_resource` when you're done accessing the file.
+    pub fn open<P: Into<FilePath>>(
+        &self,
+        path: P,
+        opts: OpenOptions,
+    ) -> std::io::Result<std::fs::File> {
+        let path = path_or_err(path)?;
+        std::fs::OpenOptions::from(opts).open(path)
+    }
+}