PyPI - Send2Trash - Versions diffs - 2.0.0__tar.gz → 2.2.0__tar.gz - Mend

Send2Trash 2.0.0tar.gz → 2.2.0tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (36) hide show

{send2trash-2.0.0 → send2trash-2.2.0}/CHANGES.rst RENAMED Viewed

@@ -1,119 +1,133 @@
-Changes
-=======
-Version 2.0.0 -- 2025/12/30
----------------------------
-* Drop suport for Python 2
-* Fix `test_trash_topdir` failing on macOS by @denini08 in https://github.com/arsenetar/send2trash/pull/100
-* Update source installation instructions by @gunSlaveUnit in https://github.com/arsenetar/send2trash/pull/102
-* Update gio implemenation, should fix #5 by no longer using deprecated GObject.GError
-Version 1.8.3 -- 2024/04/06
----------------------------
-* Add support for any iterable type as input by @PalmtopTiger in https://github.com/arsenetar/send2trash/pull/88
-* fix: Use os.fsdecode() for arguments to shutil.move() by @yogeshiitm in https://github.com/arsenetar/send2trash/pull/90
-Version 1.8.2 -- 2023/04/27
----------------------------
-* win/legacy: tiny logic simplification by @BoboTiG in https://github.com/arsenetar/send2trash/pull/77
-* TravisCI is not used anymore by @sobolevn in https://github.com/arsenetar/send2trash/pull/73
-* fix(ci): Update to latest actions, fix python versions by @arsenetar in https://github.com/arsenetar/send2trash/pull/78
-Version 1.8.1b0 -- 2021/09/20
------------------------------
-* Add fallback to HOMETRASH when cross device errors happen in plat_other (#26, #41, #63)
-Version 1.8.0 -- 2021/08/08
----------------------------
-* Add compatibility with pathlib paths (#49)
-* Fix thread compatibility of modern windows implementation (#59)
-* Fix handling of UNC names in legacy windows implementation  (#57)
-Version 1.7.1 -- 2021/06/21
----------------------------
-* Release stable version with changes from last 3 releases
-* Fix handling of UNC names (#57)
-Version 1.7.0a1 -- 2021/05/14
------------------------------
-* Changed conditional for when to try to use pyobjc version (#51)
-Version 1.7.0a0 -- 2021/04/20
------------------------------
-* Add console_script entry point (#50)
-* Increased python CI versions (#52, #54)
-* Fix minor issue in setup.py (#53)
-* Fix issue with windows tests importing modules on non-windows (#55)
-* Unit test cleanups, rewrites, and flake8 cleanups
-* Windows: Fix legacy windows platform for multi-byte unicode and add tests
-* macOS: Add alternative pyobjc version to potentially improve compatibility (#51)
-Version 1.6.0b1 -- 2020/06/18
------------------------------
-* Add main method which allows calling via ``python -m send2trash somefile``
-* Windows: Add support for using IFileOperation when pywin32 is present on Vista and newer
-* Add support for passing multiple files at once in a list
-* Windows: Batch multi-file calls to improve performance (#42)
-* Windows: Fix issue with SHFileOperation failing silently when path is not found (#33)
-Version 1.5.0 -- 2018/02/16
----------------------------
-* More specific error when failing to create XDG fallback trash directory (#20)
-* Windows: Workaround for long paths (#23)
-Version 1.4.2 -- 2017/11/17
----------------------------
-* Fix incompatibility with Python 3.6 on Windows. (#18)
-Version 1.4.1 -- 2017/08/07
----------------------------
-* Fix crash on Windows introduced in v1.4.0. Oops... (#14)
-Version 1.4.0 -- 2017/08/07
----------------------------
-* Use ``bytes`` instead of ``str`` for internal path handling in ``plat_other``. (#13)
-Version 1.3.1 -- 2017/07/31
----------------------------
-* Throw ``WindowsError`` instead of ``OSError`` in ``plat_win``. (#7)
-* Fix ``TypeError`` on python 2 in ``plat_other``. (#12)
-Version 1.3.0 -- 2013/07/19
----------------------------
-* Added support for Gnome's GIO.
-* Merged Python 3 and Python 2 versions in a single codebase.
-Version 1.2.0 -- 2011/03/16
----------------------------
-* Improved ``plat_other`` to follow freedesktop.org trash specification.
-Version 1.1.0 -- 2010/10/18
----------------------------
-* Converted compiled modules to ctypes so that cross-platform compilation isn't necessary anymore.
-Version 1.0.2 -- 2010/07/10
----------------------------
-* Fixed bugs with external volumes in plat_other.
-Version 1.0.1 -- 2010/04/19
----------------------------
-* Fixed memory leak in OS X module.
-Version 1.0.0 -- 2010/04/07
----------------------------
-* Initial Release
+Changes
+=======
+Version 2.2.0 -- 2026/11/11
+---------------------------
+* Resolve path validation flaw (https://github.com/arsenetar/send2trash/security/advisories/GHSA-fgv9-r74r-hqmx) in 522bafe
+* python2 removal: more clean up by @caspian-yez in https://github.com/arsenetar/send2trash/pull/107
+* Handle unavailable macOS version during backend selection by @Neallin-917 in https://github.com/arsenetar/send2trash/pull/114
+* Improve legacy Windows error diagnostics by @dajiaohuang in https://github.com/arsenetar/send2trash/pull/120
+* Resolve symlink homes when choosing the trash device by @ac1982 in https://github.com/arsenetar/send2trash/pull/117
+Version 2.1.0 -- 2026/01/14
+---------------------------
+* Add `conftest.py` to source distribution by @mgorny in https://github.com/arsenetar/send2trash/pull/106
+* Replacing elif, which is always True, with else by @PalmtopTiger in https://github.com/arsenetar/send2trash/pull/104
+* Migrate to pyproject.toml from setup.cfg
+Version 2.0.0 -- 2025/12/30
+---------------------------
+* Drop suport for Python 2
+* Fix `test_trash_topdir` failing on macOS by @denini08 in https://github.com/arsenetar/send2trash/pull/100
+* Update source installation instructions by @gunSlaveUnit in https://github.com/arsenetar/send2trash/pull/102
+* Update gio implemenation, should fix #5 by no longer using deprecated GObject.GError
+Version 1.8.3 -- 2024/04/06
+---------------------------
+* Add support for any iterable type as input by @PalmtopTiger in https://github.com/arsenetar/send2trash/pull/88
+* fix: Use os.fsdecode() for arguments to shutil.move() by @yogeshiitm in https://github.com/arsenetar/send2trash/pull/90
+Version 1.8.2 -- 2023/04/27
+---------------------------
+* win/legacy: tiny logic simplification by @BoboTiG in https://github.com/arsenetar/send2trash/pull/77
+* TravisCI is not used anymore by @sobolevn in https://github.com/arsenetar/send2trash/pull/73
+* fix(ci): Update to latest actions, fix python versions by @arsenetar in https://github.com/arsenetar/send2trash/pull/78
+Version 1.8.1b0 -- 2021/09/20
+-----------------------------
+* Add fallback to HOMETRASH when cross device errors happen in plat_other (#26, #41, #63)
+Version 1.8.0 -- 2021/08/08
+---------------------------
+* Add compatibility with pathlib paths (#49)
+* Fix thread compatibility of modern windows implementation (#59)
+* Fix handling of UNC names in legacy windows implementation  (#57)
+Version 1.7.1 -- 2021/06/21
+---------------------------
+* Release stable version with changes from last 3 releases
+* Fix handling of UNC names (#57)
+Version 1.7.0a1 -- 2021/05/14
+-----------------------------
+* Changed conditional for when to try to use pyobjc version (#51)
+Version 1.7.0a0 -- 2021/04/20
+-----------------------------
+* Add console_script entry point (#50)
+* Increased python CI versions (#52, #54)
+* Fix minor issue in setup.py (#53)
+* Fix issue with windows tests importing modules on non-windows (#55)
+* Unit test cleanups, rewrites, and flake8 cleanups
+* Windows: Fix legacy windows platform for multi-byte unicode and add tests
+* macOS: Add alternative pyobjc version to potentially improve compatibility (#51)
+Version 1.6.0b1 -- 2020/06/18
+-----------------------------
+* Add main method which allows calling via ``python -m send2trash somefile``
+* Windows: Add support for using IFileOperation when pywin32 is present on Vista and newer
+* Add support for passing multiple files at once in a list
+* Windows: Batch multi-file calls to improve performance (#42)
+* Windows: Fix issue with SHFileOperation failing silently when path is not found (#33)
+Version 1.5.0 -- 2018/02/16
+---------------------------
+* More specific error when failing to create XDG fallback trash directory (#20)
+* Windows: Workaround for long paths (#23)
+Version 1.4.2 -- 2017/11/17
+---------------------------
+* Fix incompatibility with Python 3.6 on Windows. (#18)
+Version 1.4.1 -- 2017/08/07
+---------------------------
+* Fix crash on Windows introduced in v1.4.0. Oops... (#14)
+Version 1.4.0 -- 2017/08/07
+---------------------------
+* Use ``bytes`` instead of ``str`` for internal path handling in ``plat_other``. (#13)
+Version 1.3.1 -- 2017/07/31
+---------------------------
+* Throw ``WindowsError`` instead of ``OSError`` in ``plat_win``. (#7)
+* Fix ``TypeError`` on python 2 in ``plat_other``. (#12)
+Version 1.3.0 -- 2013/07/19
+---------------------------
+* Added support for Gnome's GIO.
+* Merged Python 3 and Python 2 versions in a single codebase.
+Version 1.2.0 -- 2011/03/16
+---------------------------
+* Improved ``plat_other`` to follow freedesktop.org trash specification.
+Version 1.1.0 -- 2010/10/18
+---------------------------
+* Converted compiled modules to ctypes so that cross-platform compilation isn't necessary anymore.
+Version 1.0.2 -- 2010/07/10
+---------------------------
+* Fixed bugs with external volumes in plat_other.
+Version 1.0.1 -- 2010/04/19
+---------------------------
+* Fixed memory leak in OS X module.
+Version 1.0.0 -- 2010/04/07
+---------------------------
+* Initial Release

{send2trash-2.0.0 → send2trash-2.2.0}/LICENSE RENAMED Viewed

@@ -1,10 +1,10 @@
-Copyright (c) 2017, Virgil Dupras
-All rights reserved.
-Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
-    * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
-    * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
-    * Neither the name of Hardcoded Software Inc. nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+Copyright (c) 2017, Virgil Dupras
+All rights reserved.
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+    * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+    * Neither the name of Hardcoded Software Inc. nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

send2trash-2.2.0/MANIFEST.in ADDED Viewed

	@@ -0,0 +1 @@
1	+ include CHANGES.rst LICENSE tests/conftest.py

{send2trash-2.0.0/Send2Trash.egg-info → send2trash-2.2.0}/PKG-INFO RENAMED Viewed

@@ -1,106 +1,104 @@
-Metadata-Version: 2.4
-Name: Send2Trash
-Version: 2.0.0
-Summary: Send file to trash natively under Mac OS X, Windows and Linux
-Home-page: https://github.com/arsenetar/send2trash
-Author: Andrew Senetar
-Author-email: arsenetar@voltaicideas.net
-License: BSD License
-Project-URL: Bug Reports, https://github.com/arsenetar/send2trash/issues
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: BSD License
-Classifier: Operating System :: MacOS :: MacOS X
-Classifier: Operating System :: Microsoft :: Windows
-Classifier: Operating System :: POSIX
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3.14
-Classifier: Topic :: Desktop Environment :: File Managers
-Requires-Python: !=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,!=3.5.*,!=3.6.*,!=3.7.*
-Description-Content-Type: text/x-rst
-License-File: LICENSE
-Provides-Extra: win32
-Requires-Dist: pywin32; sys_platform == "win32" and extra == "win32"
-Provides-Extra: objc
-Requires-Dist: pyobjc-framework-Cocoa; sys_platform == "darwin" and extra == "objc"
-Provides-Extra: nativelib
-Requires-Dist: pywin32; sys_platform == "win32" and extra == "nativelib"
-Requires-Dist: pyobjc-framework-Cocoa; sys_platform == "darwin" and extra == "nativelib"
-Dynamic: license-file
-==================================================
-Send2Trash -- Send files to trash on all platforms
-==================================================
-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 or can use pyobjc
-with NSFileManager. On Windows, it uses native ``IFileOperation`` call if on Vista or newer and
-pywin32 is installed or falls back to ``SHFileOperation`` calls. On other platforms, if `PyGObject`_
-and `GIO`_ are available, it will use this.  Otherwise, it will fallback to its own implementation of
-the `trash specifications from freedesktop.org`_.
-``ctypes`` is used to access native libraries, so no compilation is necessary.
-Send2Trash supports Python 3 (versions before 2.x support Python 2).
-Status: Additional Help Welcome
--------------------------------
-Additional help is welcome for supporting this package.  Specifically help with the OSX and Linux
-issues and fixes would be most appreciated.
-Installation
-------------
-You can download it with pip:
-    python -m pip install -U send2trash
-To install with pywin32 or pyobjc required specify the extra `nativeLib`:
-    python -m pip install -U send2trash[nativeLib]
-or download the source from https://github.com/arsenetar/send2trash and install it with:
-    python -m pip install -e .
-On systems where Python enforces PEP 668 (e.g., recent Linux distributions),
-installing packages into the system Python may be restricted.
-Use a virtual environment:
-    python -m venv .venv
-    GNU/Linux / macOS:
-        source .venv/bin/activate
-    Windows:
-        .venv\Scripts\activate
-Usage
------
->>> from send2trash import send2trash
->>> send2trash('some_file')
->>> send2trash(['some_file1', 'some_file2'])
-On Freedesktop platforms (Linux, BSD, etc.), you may not be able to efficiently
-trash some files. In these cases, an exception ``send2trash.TrashPermissionError``
-is raised, so that the application can handle this case. This inherits from
-``PermissionError``. Specifically, this affects
-files on a different device to the user's home directory, where the root of the
-device does not have a ``.Trash`` directory, and we don't have permission to
-create a ``.Trash-$UID`` directory.
-For any other problem, ``OSError`` is raised.
-.. _PyGObject: https://wiki.gnome.org/PyGObject
-.. _GIO: https://developer.gnome.org/gio/
-.. _trash specifications from freedesktop.org: http://freedesktop.org/wiki/Specifications/trash-spec/
+Metadata-Version: 2.4
+Name: Send2Trash
+Version: 2.2.0
+Summary: Send file to trash natively under Mac OS X, Windows and Linux
+Author-email: Andrew Senetar <arsenetar@voltaicideas.net>
+License-Expression: BSD-3-Clause
+Project-URL: Homepage, https://github.com/arsenetar/send2trash
+Project-URL: Repository, https://github.com/arsenetar/send2trash.git
+Project-URL: Issues, https://github.com/arsenetar/send2trash/issues
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Classifier: Topic :: Desktop Environment :: File Managers
+Requires-Python: >=3.8
+Description-Content-Type: text/x-rst
+License-File: LICENSE
+Provides-Extra: test
+Requires-Dist: pytest>=8; extra == "test"
+Provides-Extra: nativelib
+Requires-Dist: pywin32>=305; sys_platform == "win32" and extra == "nativelib"
+Requires-Dist: pyobjc>=9.0; sys_platform == "darwin" and extra == "nativelib"
+Dynamic: license-file
+==================================================
+Send2Trash -- Send files to trash on all platforms
+==================================================
+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 or can use pyobjc
+with NSFileManager. On Windows, it uses native ``IFileOperation`` call if on Vista or newer and
+pywin32 is installed or falls back to ``SHFileOperation`` calls. On other platforms, if `PyGObject`_
+and `GIO`_ are available, it will use this.  Otherwise, it will fallback to its own implementation of
+the `trash specifications from freedesktop.org`_.
+``ctypes`` is used to access native libraries, so no compilation is necessary.
+Send2Trash supports Python 3 (versions before 2.x support Python 2).
+Status: Additional Help Welcome
+-------------------------------
+Additional help is welcome for supporting this package.  Specifically help with the OSX and Linux
+issues and fixes would be most appreciated.
+Installation
+------------
+You can download it with pip:
+    python -m pip install -U send2trash
+To install with pywin32 or pyobjc required specify the extra `nativeLib`:
+    python -m pip install -U send2trash[nativeLib]
+or download the source from https://github.com/arsenetar/send2trash and install it with:
+    python -m pip install -e .
+On systems where Python enforces PEP 668 (e.g., recent Linux distributions),
+installing packages into the system Python may be restricted.
+Use a virtual environment:
+    python -m venv .venv
+    GNU/Linux / macOS:
+        source .venv/bin/activate
+    Windows:
+        .venv\Scripts\activate
+Usage
+-----
+>>> from send2trash import send2trash
+>>> send2trash('some_file')
+>>> send2trash(['some_file1', 'some_file2'])
+On Freedesktop platforms (Linux, BSD, etc.), you may not be able to efficiently
+trash some files. In these cases, an exception ``send2trash.TrashPermissionError``
+is raised, so that the application can handle this case. This inherits from
+``PermissionError``. Specifically, this affects
+files on a different device to the user's home directory, where the root of the
+device does not have a ``.Trash`` directory, and we don't have permission to
+create a ``.Trash-$UID`` directory.
+For any other problem, ``OSError`` is raised.
+.. _PyGObject: https://wiki.gnome.org/PyGObject
+.. _GIO: https://developer.gnome.org/gio/
+.. _trash specifications from freedesktop.org: http://freedesktop.org/wiki/Specifications/trash-spec/

{send2trash-2.0.0 → send2trash-2.2.0}/README.rst RENAMED Viewed

@@ -1,70 +1,70 @@
-==================================================
-Send2Trash -- Send files to trash on all platforms
-==================================================
-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 or can use pyobjc
-with NSFileManager. On Windows, it uses native ``IFileOperation`` call if on Vista or newer and
-pywin32 is installed or falls back to ``SHFileOperation`` calls. On other platforms, if `PyGObject`_
-and `GIO`_ are available, it will use this.  Otherwise, it will fallback to its own implementation of
-the `trash specifications from freedesktop.org`_.
-``ctypes`` is used to access native libraries, so no compilation is necessary.
-Send2Trash supports Python 3 (versions before 2.x support Python 2).
-Status: Additional Help Welcome
--------------------------------
-Additional help is welcome for supporting this package.  Specifically help with the OSX and Linux
-issues and fixes would be most appreciated.
-Installation
-------------
-You can download it with pip:
-    python -m pip install -U send2trash
-To install with pywin32 or pyobjc required specify the extra `nativeLib`:
-    python -m pip install -U send2trash[nativeLib]
-or download the source from https://github.com/arsenetar/send2trash and install it with:
-    python -m pip install -e .
-On systems where Python enforces PEP 668 (e.g., recent Linux distributions),
-installing packages into the system Python may be restricted.
-Use a virtual environment:
-    python -m venv .venv
-    GNU/Linux / macOS:
-        source .venv/bin/activate
-    Windows:
-        .venv\Scripts\activate
-Usage
------
->>> from send2trash import send2trash
->>> send2trash('some_file')
->>> send2trash(['some_file1', 'some_file2'])
-On Freedesktop platforms (Linux, BSD, etc.), you may not be able to efficiently
-trash some files. In these cases, an exception ``send2trash.TrashPermissionError``
-is raised, so that the application can handle this case. This inherits from
-``PermissionError``. Specifically, this affects
-files on a different device to the user's home directory, where the root of the
-device does not have a ``.Trash`` directory, and we don't have permission to
-create a ``.Trash-$UID`` directory.
-For any other problem, ``OSError`` is raised.
-.. _PyGObject: https://wiki.gnome.org/PyGObject
-.. _GIO: https://developer.gnome.org/gio/
-.. _trash specifications from freedesktop.org: http://freedesktop.org/wiki/Specifications/trash-spec/
+==================================================
+Send2Trash -- Send files to trash on all platforms
+==================================================
+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 or can use pyobjc
+with NSFileManager. On Windows, it uses native ``IFileOperation`` call if on Vista or newer and
+pywin32 is installed or falls back to ``SHFileOperation`` calls. On other platforms, if `PyGObject`_
+and `GIO`_ are available, it will use this.  Otherwise, it will fallback to its own implementation of
+the `trash specifications from freedesktop.org`_.
+``ctypes`` is used to access native libraries, so no compilation is necessary.
+Send2Trash supports Python 3 (versions before 2.x support Python 2).
+Status: Additional Help Welcome
+-------------------------------
+Additional help is welcome for supporting this package.  Specifically help with the OSX and Linux
+issues and fixes would be most appreciated.
+Installation
+------------
+You can download it with pip:
+    python -m pip install -U send2trash
+To install with pywin32 or pyobjc required specify the extra `nativeLib`:
+    python -m pip install -U send2trash[nativeLib]
+or download the source from https://github.com/arsenetar/send2trash and install it with:
+    python -m pip install -e .
+On systems where Python enforces PEP 668 (e.g., recent Linux distributions),
+installing packages into the system Python may be restricted.
+Use a virtual environment:
+    python -m venv .venv
+    GNU/Linux / macOS:
+        source .venv/bin/activate
+    Windows:
+        .venv\Scripts\activate
+Usage
+-----
+>>> from send2trash import send2trash
+>>> send2trash('some_file')
+>>> send2trash(['some_file1', 'some_file2'])
+On Freedesktop platforms (Linux, BSD, etc.), you may not be able to efficiently
+trash some files. In these cases, an exception ``send2trash.TrashPermissionError``
+is raised, so that the application can handle this case. This inherits from
+``PermissionError``. Specifically, this affects
+files on a different device to the user's home directory, where the root of the
+device does not have a ``.Trash`` directory, and we don't have permission to
+create a ``.Trash-$UID`` directory.
+For any other problem, ``OSError`` is raised.
+.. _PyGObject: https://wiki.gnome.org/PyGObject
+.. _GIO: https://developer.gnome.org/gio/
+.. _trash specifications from freedesktop.org: http://freedesktop.org/wiki/Specifications/trash-spec/

Send2Trash 2.0.0__tar.gz → 2.2.0__tar.gz

Send2Trash 2.0.0tar.gz → 2.2.0tar.gz