Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/freeslave/trashcan

Move files to trash can in D programming language
https://github.com/freeslave/trashcan

d dlang freedesktop recycle-bin trashcan

Last synced: about 1 month ago
JSON representation

Move files to trash can in D programming language

Host: GitHub
URL: https://github.com/freeslave/trashcan
Owner: FreeSlave
License: bsl-1.0
Created: 2016-06-21T19:17:13.000Z (over 8 years ago)
Default Branch: master
Last Pushed: 2024-07-18T10:41:41.000Z (6 months ago)
Last Synced: 2024-07-18T13:17:01.014Z (6 months ago)
Topics: d, dlang, freedesktop, recycle-bin, trashcan
Language: D
Homepage:
Size: 168 KB
Stars: 5
Watchers: 2
Forks: 1
Open Issues: 2
Metadata Files:
- Readme: README.md
- License: LICENSE_1_0.txt

Awesome Lists containing this project

README

        # Trash can

[![Build Status](https://github.com/FreeSlave/trashcan/actions/workflows/ci.yml/badge.svg)](https://github.com/FreeSlave/trashcan/actions/workflows/ci.yml)

[![Windows Build Status](https://ci.appveyor.com/api/projects/status/github/FreeSlave/trashcan?branch=master&svg=true)](https://ci.appveyor.com/project/FreeSlave/trashcan)

Trash can operations implemented in D programming language.

The **moveToTrash** function places a passed file or directory to trash can. The **Trashcan** class allows to list trashcan contents, restore or delete items.

[Online documentation](https://freeslave.github.io/trashcan/trashcan.html)

## Platform support and implementation details

On Freedesktop environments (e.g. GNU/Linux) the library follows [Trash Can Specification](https://www.freedesktop.org/wiki/Specifications/trash-spec/).

On Windows [SHFileOperation](https://docs.microsoft.com/en-us/windows/win32/api/shellapi/nf-shellapi-shfileoperationw) is used to move files to trash, and [IShellFolder2](https://docs.microsoft.com/en-us/windows/win32/api/shobjidl_core/nn-shobjidl_core-ishellfolder2) is used as an interface to recycle bin to list, delete and undelete items.

On OSX FSMoveObjectToTrashSync is used to move files to trash. Listing, deleting and undeleting items in the trash can are not currently supported on macOS.

Other platforms are not supported.

## Currently missing features

* Notifying changes in trash can contents (or at least providing the data required to implement this feature for the library user).

## Examples

### [Put to trash can](examples/put.d)

Run to put file or directory to trash can:

    dub examples/put.d path/to/file

### [Manage items in trash can](examples/manage.d)

Interactively delete items from trashcan or restore them to their original location.

    dub examples/manage.d