Go to file
gbn d090156c45 Use realpath to find mountpoint 2011-03-13 14:38:03 -04:00
send2trash Use realpath to find mountpoint 2011-03-13 14:38:03 -04:00
.hgignore Updated package metadata. 2010-07-07 11:59:11 +02:00
.hgtags Added tag 1.1.0 for changeset de5f43fcce5e 2010-10-18 12:13:42 +02:00
CHANGES v1.1.0 2010-10-18 12:13:37 +02:00
LICENSE Licensed under BSD. 2010-04-07 08:52:24 +02:00
MANIFEST.in Adjusted packaging metadata for 1.1.0. 2010-10-18 12:22:13 +02:00
README v1.1.0 2010-10-18 12:13:37 +02:00
setup.py Adjusted packaging metadata for 1.1.0. 2010-10-18 12:22:13 +02:00
test_plat_other.py Made a few minor style fixes, and added a proper error in cases where the target path of send2trash() doesn't exist. 2011-03-12 11:48:19 +01:00

README

==================================================
Send2Trash -- Send files to trash on all platforms
==================================================

This is a Python 3 package. The Python 2 package is at http://pypi.python.org/pypi/Send2Trash .

Send2Trash is a small package that sends files to the Trash (or Recycle Bin) *natively* and on
*all platforms*. On OS X, it uses native ``FSMoveObjectToTrashSync`` Cocoa calls, on Windows, it uses native (and ugly) ``SHFileOperation`` win32 calls. On other platforms, it moves the file to the first folder it finds that looks like a trash (so far, it's known to work on Ubuntu).

``ctypes`` is used to access native libraries, so no compilation is necessary.

Installation
------------

Download the source from http://hg.hardcoded.net/send2trash and install it with::

>>> python setup.py install

Usage
-----

>>> from send2trash import send2trash
>>> send2trash('some_file')

When there's a problem ``OSError`` is raised.