Browse Source

Update files to release a new package

tags/1.6.0b1
Andrew Senetar 8 months ago
parent
commit
49bc438546
Signed by: arsenetar <[email protected]> GPG Key ID: C63300DCE48AB2F1
3 changed files with 48 additions and 47 deletions
  1. +9
    -0
      CHANGES.rst
  2. +11
    -25
      README.rst
  3. +28
    -22
      setup.py

+ 9
- 0
CHANGES.rst View File

@@ -1,6 +1,15 @@
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
---------------------------



+ 11
- 25
README.rst 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
*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
`GIO`_ are available, it will use this. Otherwise, it will fallback to its own implementation
of the `trash specifications from freedesktop.org`_.
*all platforms*. On OS X, it uses native ``FSMoveObjectToTrashSync`` Cocoa calls. 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 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
care for those platforms as much as I used to. I also don't use this library
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.
Additional help is welcome for supporting this package. Specifically help with the OSX and Linux
issues and fixes would be most appreciated.

Installation
------------
@@ -41,7 +26,7 @@ You can download it with pip::

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

@@ -50,6 +35,7 @@ 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``


+ 28
- 22
setup.py View File

@@ -1,33 +1,39 @@
from setuptools import setup

CLASSIFIERS = [
'Development Status :: 5 - Production/Stable',
'Intended Audience :: Developers',
'License :: OSI Approved :: BSD License',
'Operating System :: MacOS :: MacOS X',
'Operating System :: Microsoft :: Windows',
'Operating System :: POSIX',
'Programming Language :: Python :: 2.7',
'Programming Language :: Python :: 3',
'Programming Language :: Python :: 3.4',
'Programming Language :: Python :: 3.5',
'Programming Language :: Python :: 3.6',
'Topic :: Desktop Environment :: File Managers',
"Development Status :: 5 - Production/Stable",
"Intended Audience :: Developers",
"License :: OSI Approved :: BSD License",
"Operating System :: MacOS :: MacOS X",
"Operating System :: Microsoft :: Windows",
"Operating System :: POSIX",
"Programming Language :: Python :: 2.7",
"Programming Language :: Python :: 3",
"Programming Language :: Python :: 3.4",
"Programming Language :: Python :: 3.5",
"Programming Language :: Python :: 3.6",
"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(
name='Send2Trash',
version='1.5.0',
author='Virgil Dupras',
author_email='[email protected]',
packages=['send2trash'],
name="Send2Trash",
version="1.6.0b1",
author="Andrew Senetar",
author_email="[email protected]",
packages=["send2trash"],
scripts=[],
test_suite='tests',
url='https://github.com/hsoft/send2trash',
license='BSD License',
description='Send file to trash natively under Mac OS X, Windows and Linux.',
test_suite="tests",
url="https://github.com/arsenetar/send2trash",
license="BSD License",
description="Send file to trash natively under Mac OS X, Windows and Linux.",
long_description=LONG_DESCRIPTION,
classifiers=CLASSIFIERS,
extras_require={"win32": ["pywin32"]},
project_urls={"Bug Reports": "https://github.com/arsenetar/send2trash/issues"},
)

Loading…
Cancel
Save