tauri-plugin-fs 3.0.0-alpha.2

Access the file system.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51

// Copyright 2019-2023 Tauri Programme within The Commons Conservancy
// SPDX-License-Identifier: Apache-2.0
// SPDX-License-Identifier: MIT

use std::path::PathBuf;

use serde::{Serialize, Serializer};

/// Errors that can happen while using the file system plugin.
#[derive(Debug, thiserror::Error)]
#[non_exhaustive]
pub enum Error {
    /// JSON serialization or deserialization error.
    #[error(transparent)]
    Json(#[from] serde_json::Error),
    /// Error from the Tauri APIs, usually raised while resolving a path or a scope entry.
    #[error(transparent)]
    Tauri(#[from] tauri::Error),
    /// Error from the underlying file system operation.
    #[error(transparent)]
    Io(#[from] std::io::Error),
    /// The path is denied by the plugin scope or is not allowed by it.
    #[error("forbidden path: {0}")]
    PathForbidden(PathBuf),
    /// Invalid glob pattern.
    #[error("invalid glob pattern: {0}")]
    GlobPattern(#[from] glob::PatternError),
    /// Watcher error.
    #[cfg(feature = "watch")]
    #[error(transparent)]
    Watch(#[from] notify::Error),
    /// Error invoking the Android plugin implementation.
    #[cfg(target_os = "android")]
    #[error(transparent)]
    PluginInvoke(#[from] tauri::plugin::mobile::PluginInvokeError),
    /// The URL cannot be converted to a file system path.
    #[error("URL is not a valid path")]
    InvalidPathUrl,
    /// The path is not safe to use, for instance because it traverses parent directories.
    #[error("Unsafe PathBuf: {0}")]
    UnsafePathBuf(&'static str),
}

impl Serialize for Error {
    fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
    where
        S: Serializer,
    {
        serializer.serialize_str(self.to_string().as_ref())
    }
}