# bin - Console trash bin management

`bin` is a POSIX shell implementation of the Freedesktop.org trashcan
specification. It lets you run `bin <file>` to move a file to the trash bin
instead of just `rm <file>`, which permanently deletes it immediately. Later,
the file can be recovered with `bin -u <file>` or permanently erased with
`bin -e <file>`. More details are in the Usage section. This is based off of
[bashtrash](https://github.com/robrwo/bashtrash), but with a few more features
and a little bit cleaned up and tweaked to be fully POSIX-compliant, rather
than relying on bashisms.

## Requirements

`bin` requires the following utilities in addition to the standard tools
(`mv`, `rm`, etc.): `awk`, `basename`, `date`, `df`, `du`, `dirname`, `find`,
`mktemp`, `perl` (for URL encoding filenames), `readlink`, `sed`, `stty`,
`tput`.

Optionally, if you install my other tools `ask` and `arg`, you'll get slightly
nicer behavior, although `bin` should work perfectly fine without them.
(ask)[https://bitbucket.org/spilt/ask] will get you slightly cleaner
confirmation prompts, and (arg)[https://bitbucket.org/spilt/arg] will get more
robust command line flag parsing (without `arg`, you must use `bin -f -v -E`
instead of `bin -fvE`).

## Usage

Basic usage: `bin [OPTIONS]... FILES...`

Options:

* `-h`, `--help`           Show the program usage and exit
* `-V`, `--version`        Show program's version number and exit
* `-v`, `--verbose`        Explain what is being done
* `-i`, `--interactive`    Prompt before moving every file
* `-f`, `--force`          Ignore non-existent files, never prompt
* `-r`, `-R`, `--recursive`  Ignored (for compatability with `rm`)
* `-u`, `--untrash`        Restore file(s) from the trash
* `-e`, `--empty`          Choose files to empty from the trash
* `-E`, `--empty-all`      Empty all the files in the trash folder(s) (default: ~)
* `-l`, `--list`           List files in trash folder(s) (default: ~)
* `--`                     Any arguments after `--` will be treated as filenames

See `man bin` for full documentation.

## License

Copyright (c) 2020, Bruce Hill <bruce@bruce-hill.com>

Copyright (c) 2009-2011, Robert Rothenberg <robrwo@gmail.com>

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.