Trashman. A Python trash manager.

Note

This documentation is for Trashman version 1.5.0. Some parts of this documentation might not apply to other versions.

Trashman is a trash manager, i.e. an application which manages trash folders. It provides several backends.

How to use

Install it from PyPI or the AUR.

To trash a file, just type trash FILE [FILE ...] into your shell. To restore a file from the trash, add the -r (--restore) argument. To empty the trash and delete the files forever, use the -e (--empty) switch. Verbose output can be provided by -v (--verbose). The location of your trash will be printed by -w (--trash-location) and the files location will be presented by -W (--files-location); w as in where. Other switches, related to Trashman, are -V (--version) and -h (--help).

Features

Currently implemented in most backends:

• trashing
• trash conflict resolution
• restore
• localization support
• tests

Not yet ready:

• restore to inexisting directory (KDE refuses to do that, so we’ll probably do so, too)

Useless features that are planned:

• CLI
• Qt GUI

Developers using Trashman as a library may want to look at the Global functions list or Backends info (and maybe TODO). Other people may want to look at the README.

Additional documents, indices and tables

• 1. Trashman
  • 1.1. SYNOPSIS
  • 1.2. DESCRIPTION
  • 1.3. OPERATIONS
  • 1.4. OPTIONS
  • 1.5. EXAMPLES
  • 1.6. BUGS
• 2. README for Trashman
  • 2.1. PURPOSE
  • 2.2. INSTALLATION
  • 2.3. COPYRIGHT
• 3. Global Functions and Modules List
  • 3.1. __init__.py
  • 3.2. tmds.py (TMDS — Trashman Data Storage)
  • 3.3. main.py (main())
• 4. Backends
  • 4.1. Functions
  • 4.2. Existing backends
• 5. Appendix A. Contribution rules
  • 5.1. Issue reporting
  • 5.2. General preparations, rules and pull process
  • 5.3. Details for specific contribution types
• 6. Appendix A. License for Trashman
• 7. CHANGELOG for Trashman
  • 7.1. GitHub holds releases, too
  • 7.2. Version History

• Index
• Module Index
• Search Page