Add method to export trash path (issue Byron#38)

src/freedesktop.rs

@@ -49,6 +49,21 @@ impl TrashContext {
         }
         Ok(())
     }
+
+    /// Retrieves the path of the Trash directory.
+    ///
+    /// # Example
+    ///
+    /// ```
+    /// use std::fs::File;
+    /// use trash::{ delete, trash_path };
+    /// File::create("mv_to_trash").unwrap();
+    /// delete("mv_to_trash").unwrap();
+    /// assert!(trash_path().unwrap().join("files").join("mv_to_trash").exists())
+    /// ```
+    pub fn trash_path(&self) -> Result<PathBuf, Error> {
+        home_trash()
+    }
 }
 
 pub fn list() -> Result<Vec<TrashItem>, Error> {

src/lib.rs

@@ -113,6 +113,13 @@ impl TrashContext {
     }
 }
 
+/// Convenience method for `DEFAULT_TRASH_CTX.trash_path()`
+///
+/// See: [`TrashContext::trash_path`](TrashContext::trash_path)
+pub fn trash_path() -> Result<PathBuf, Error> {
+    DEFAULT_TRASH_CTX.trash_path()
+}
+
 /// Convenience method for `DEFAULT_TRASH_CTX.delete()`.
 ///
 /// See: [`TrashContext::delete`](TrashContext::delete)

tests/trash.rs

@@ -4,7 +4,7 @@ use std::path::{Path, PathBuf};
 use log::trace;
 
 use serial_test::serial;
-use trash::{delete, delete_all};
+use trash::{delete, delete_all, trash_path};
 
 mod util {
     use std::sync::atomic::{AtomicI64, Ordering};
@@ -40,6 +40,20 @@ fn test_delete_file() {
     trace!("Finished test_delete_file");
 }
 
+#[test]
+#[serial]
+fn test_trash_path() {
+    init_logging();
+    trace!("Started test_trash_path");
+
+    let path = PathBuf::from(get_unique_name());
+    File::create(&path).unwrap();
+
+    delete(&path).unwrap();
+    assert!(trash_path().unwrap().join("files").join(path).exists());
+    trace!("Finished test_trash_path");
+}
+
 #[test]
 #[serial]
 fn test_delete_folder() {