Update files to release a new package

This commit is contained in:
Andrew Senetar 2020-06-18 21:49:42 -05:00
parent 2e9fa38f56
commit 49bc438546
Signed by: arsenetar
GPG Key ID: C63300DCE48AB2F1
3 changed files with 48 additions and 47 deletions

View File

@ -1,6 +1,15 @@
Changes Changes
======= =======
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 Version 1.5.0 -- 2018/02/16
--------------------------- ---------------------------

View File

@ -3,36 +3,21 @@ 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 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 *all platforms*. On OS X, it uses native ``FSMoveObjectToTrashSync`` Cocoa calls. On Windows, it
uses native (and ugly) ``SHFileOperation`` win32 calls. On other platforms, if `PyGObject`_ and uses native ``IFileOperation`` call if on Vista or newer and pywin32 is installed or falls back
`GIO`_ are available, it will use this. Otherwise, it will fallback to its own implementation to ``SHFileOperation`` calls. On other platforms, if `PyGObject`_ and `GIO`_ are available, it
of the `trash specifications from freedesktop.org`_. 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. ``ctypes`` is used to access native libraries, so no compilation is necessary.
Send2Trash supports Python 2.7 and up (Python 3 is supported). Send2Trash supports Python 2.7 and up (Python 3 is supported).
Status: Maintainer needed Status: Additional Help Welcome
------------------------- -------------------------------
I haven't had access to a Windows or MacOS environment for years now. I don't Additional help is welcome for supporting this package. Specifically help with the OSX and Linux
care for those platforms as much as I used to. I also don't use this library issues and fixes would be most appreciated.
any more.
This is the most popular library I've authored and many people and projects
rely on it. I don't intend on letting it go broken. I am, however, wanting to
get rid of its maintainership burden.
It's not a big burden, but without access to Windows or MacOS, it can make
reviewing PRs a but tricky: I have to blind-merge them. That makes me a rather
bad maintainer for this library. So, for the good of the project, it should be
someone else.
However, being a relatively popular library makes this task a little tricky.
As we've seen in the NPM world recently, it has security implications.
Therefore, I don't intend on passing this to anyone. If you have some clout or
if I can otherwise have confidence that you'll handle the library responsibly,
then please contact me and I'll gladly pass this on.
Installation Installation
------------ ------------
@ -41,7 +26,7 @@ You can download it with pip::
pip install Send2Trash pip install Send2Trash
or you can download the source from http://github.com/hsoft/send2trash and install it with:: or you can download the source from http://github.com/arsenetar/send2trash and install it with::
>>> python setup.py install >>> python setup.py install
@ -50,6 +35,7 @@ Usage
>>> from send2trash import send2trash >>> from send2trash import send2trash
>>> send2trash('some_file') >>> send2trash('some_file')
>>> send2trash(['some_file1', 'some_file2'])
On Freedesktop platforms (Linux, BSD, etc.), you may not be able to efficiently On Freedesktop platforms (Linux, BSD, etc.), you may not be able to efficiently
trash some files. In these cases, an exception ``send2trash.TrashPermissionError`` trash some files. In these cases, an exception ``send2trash.TrashPermissionError``

View File

@ -1,33 +1,39 @@
from setuptools import setup from setuptools import setup
CLASSIFIERS = [ CLASSIFIERS = [
'Development Status :: 5 - Production/Stable', "Development Status :: 5 - Production/Stable",
'Intended Audience :: Developers', "Intended Audience :: Developers",
'License :: OSI Approved :: BSD License', "License :: OSI Approved :: BSD License",
'Operating System :: MacOS :: MacOS X', "Operating System :: MacOS :: MacOS X",
'Operating System :: Microsoft :: Windows', "Operating System :: Microsoft :: Windows",
'Operating System :: POSIX', "Operating System :: POSIX",
'Programming Language :: Python :: 2.7', "Programming Language :: Python :: 2.7",
'Programming Language :: Python :: 3', "Programming Language :: Python :: 3",
'Programming Language :: Python :: 3.4', "Programming Language :: Python :: 3.4",
'Programming Language :: Python :: 3.5', "Programming Language :: Python :: 3.5",
'Programming Language :: Python :: 3.6', "Programming Language :: Python :: 3.6",
'Topic :: Desktop Environment :: File Managers', "Programming Language :: Python :: 3.7",
"Programming Language :: Python :: 3.8",
"Topic :: Desktop Environment :: File Managers",
] ]
LONG_DESCRIPTION = open('README.rst', 'rt').read() + '\n\n' + open('CHANGES.rst', 'rt').read() LONG_DESCRIPTION = (
open("README.rst", "rt").read() + "\n\n" + open("CHANGES.rst", "rt").read()
)
setup( setup(
name='Send2Trash', name="Send2Trash",
version='1.5.0', version="1.6.0b1",
author='Virgil Dupras', author="Andrew Senetar",
author_email='hsoft@hardcoded.net', author_email="arsenetar@voltaicideas.net",
packages=['send2trash'], packages=["send2trash"],
scripts=[], scripts=[],
test_suite='tests', test_suite="tests",
url='https://github.com/hsoft/send2trash', url="https://github.com/arsenetar/send2trash",
license='BSD License', license="BSD License",
description='Send file to trash natively under Mac OS X, Windows and Linux.', description="Send file to trash natively under Mac OS X, Windows and Linux.",
long_description=LONG_DESCRIPTION, long_description=LONG_DESCRIPTION,
classifiers=CLASSIFIERS, classifiers=CLASSIFIERS,
extras_require={"win32": ["pywin32"]},
project_urls={"Bug Reports": "https://github.com/arsenetar/send2trash/issues"},
) )