Trash

When it's too hard to say goodbye... an alternative to rm.

A simple command line utility to move files/folders to a "trash" folder before deleting them.

Usage

From the command line:

trash [file/directory name(s)]
# example:
trash potentially-important-file.txt
trash this-folder that-folder some-random-file.txt

Handles multiple files with the same name

trash ~/Documents/Groceries/shopping-list.txt
trash ~/Documents/Christmas/shopping-list.txt
trash ~/Documents/AutoParts/shopping-list.txt

The trash will contain:

shopping-list.txt     # originally ~/Documents/Groceries/shopping-list.txt
shopping-list01.txt   # originally ~/Documents/Christmas/shopping-list.txt
shopping-list02.txt   # originally ~/Documents/AutoParts/shopping-list.txt

You will find the files that you've trashed in ~/.Trash.

Installation

gem install trash

Contributors

• ericmathison (Eric Mathison)
• brian-davis (Brian Davis)

Note on Patches/Pull Requests

• Fork the project.
• Make your feature addition or bug fix.
• Add tests for it. This is important so I don't break it in a future version unintentionally.
• Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
• Send me a pull request. Bonus points for topic branches.

Releasing a new version

• Start a Docker container:

  docker run --rm -it --volume="${PWD}:/app" --workdir /app ruby:2.7 bash

• Install dependencies:

  bundle install

• Bump the version in the VERSION file.

• Build the gem:

  gem build trash.gemspec

• Check that it's valid by installing it locally:

  gem install "./trash-$(cat VERSION).gem"

• Publish it:

  GEM_HOST_API_KEY=TODO gem push "trash-$(cat VERSION).gem"

• Commit the changes in Git.

  git add -p && git commit --message "Bump version to v$(cat VERSION)"

• Tag it:

  git tag "v$(cat VERSION)" && git push origin "v$(cat VERSION)"

Copyright

Copyright (c) 2010 Lee Jones. See LICENSE for details.