// Copyright 2019-2023 Tauri Programme within The Commons Conservancy // SPDX-License-Identifier: Apache-2.0 // SPDX-License-Identifier: MIT //! [![](https://github.com/tauri-apps/plugins-workspace/raw/v2/plugins/fs/banner.png)](https://github.com/tauri-apps/plugins-workspace/tree/v2/plugins/fs) //! //! Access the file system. #![doc( html_logo_url = "https://github.com/tauri-apps/tauri/raw/dev/app-icon.png", html_favicon_url = "https://github.com/tauri-apps/tauri/raw/dev/app-icon.png" )] use tauri::{ ipc::ScopeObject, plugin::{Builder as PluginBuilder, TauriPlugin}, utils::acl::Value, AppHandle, DragDropEvent, Manager, RunEvent, Runtime, WindowEvent, }; mod commands; mod config; mod error; mod scope; #[cfg(feature = "watch")] mod watcher; pub use error::Error; pub use scope::{Event as ScopeEvent, Scope}; type Result = std::result::Result; // implement ScopeObject here instead of in the scope module because it is also used on the build script // and we don't want to add tauri as a build dependency impl ScopeObject for scope::Entry { type Error = Error; fn deserialize( app: &AppHandle, raw: Value, ) -> std::result::Result { let entry = serde_json::from_value(raw.into()).map(|raw| { let path = match raw { scope::EntryRaw::Value(path) => path, scope::EntryRaw::Object { path } => path, }; Self { path } })?; Ok(Self { path: app.path().parse(entry.path)?, }) } } pub trait FsExt { fn fs_scope(&self) -> &Scope; fn try_fs_scope(&self) -> Option<&Scope>; } impl> FsExt for T { fn fs_scope(&self) -> &Scope { self.state::().inner() } fn try_fs_scope(&self) -> Option<&Scope> { self.try_state::().map(|s| s.inner()) } } pub fn init() -> TauriPlugin> { PluginBuilder::>::new("fs") .invoke_handler(tauri::generate_handler![ commands::create, commands::open, commands::copy_file, commands::close, commands::mkdir, commands::read_dir, commands::read, commands::read_file, commands::read_text_file, commands::read_text_file_lines, commands::read_text_file_lines_next, commands::remove, commands::rename, commands::seek, commands::stat, commands::lstat, commands::fstat, commands::truncate, commands::ftruncate, commands::write, commands::write_file, commands::write_text_file, commands::exists, #[cfg(feature = "watch")] watcher::watch, #[cfg(feature = "watch")] watcher::unwatch ]) .setup(|app, api| { let mut scope = Scope::default(); scope.require_literal_leading_dot = api .config() .as_ref() .and_then(|c| c.require_literal_leading_dot); app.manage(scope); Ok(()) }) .on_event(|app, event| { if let RunEvent::WindowEvent { label: _, event: WindowEvent::DragDrop(DragDropEvent::Dropped { paths, position: _ }), .. } = event { let scope = app.fs_scope(); for path in paths { if path.is_file() { scope.allow_file(path); } else { scope.allow_directory(path, true); } } } }) .build() }