# rmd
[](https://travis-ci.com/FilippoRanza/rmd)  [](https://opensource.org/licenses/MIT)
An improved rm implementation able to remove duplicate files
## Description
**rmd** is an **rm** reimplementation made in pure Rust. It
is able to remove files and directories as usual but
it also able to remove duplicate file in given directories recursively.
Duplicate file are found by comparing **SHA256** hashes.
When a file has an hash that has already been found it is removed immediately.
## Installation
This tool can be easly installed from sources:
```bash
cargo install rmd
```
## Usage
It works in an almost compatible way with the standard rm. To get a full help run:
```bash
rmd --help
```
But the most common scenarios includes:
- remove files, for example:
```bash
rmd FILE_A FILE_B
```
- remove a directory, for example:
```bash
rmd -rf DIR_A
```
### Additional Features
#### Remove Duplicates
- remove duplicates files in the current directory, and all sub directoris:
```bash
rmd -d
```
or remove duplicates files in a specified directory:
```bash
rmd -d /PATH/TO/DIRECTORY
```
#### Remove by Last Access
This functionality allows to remove file **older** or **newer** then a given
*time-specification*.
Remove File *older* then *time-spec*
```bash
rmd --older <time-spec> [directory...]
```
Remove File *newer* then *time-spec*
```bash
rmd --newer <time-spec> [directory...]
```
**rmd** checks if the last access is **before** (so the file is **older**) or **after**
(so the file is **newer**) then the time described by the *time-specification*.
*time-specification* describes a relative amount of time (in **seconds**) in the past
from the moment when the program is run.
*time-specification* format
```
[N+T]+
```
Where:
- **N** is a number (1-9)
- **T** is a time descriptor
- **+** means one or more
Time Descriptor Table
| s | second | second | 1 second |
| m | minute | minute | 60 seconds |
| h | hour | hour | 60 minutes |
| d | day | day | 24 hours |
| w | week | week | 7 days |
| M | month | month | 30 days |
| y | year | year | 365 days |
##### Examples
```bash
rmd --older 2y4M5d
```
will remove in the current directory, and recursivelly in all sub directories, file
with a last access time equal or before *2 year, 4 month and 5 days* in the past from
the time when the program is run.
```bash
rmd --newer '4h+30m'
```
will remove in the current directory, and recursivelly in all sub directories, file
with a last access time equal or after *4 hour and 30 minutes* in the past from
the time when the program is run.
```bash
rmd --older '1M 15d' /home/user/temp-store
```
will remove in **/home/user/temp-store** and recursivelly in all sub directories, file
with a last access time equal or before *1 mounth and 15 days* in the past from
the time when the program is run.
```bash
rmd --newer 30s /home/user/wrong-downloads
```
will remove in **/home/user/wrong-downloads** and recursivelly in all sub directories, file
with a last access time equal or after *30 seconds* in the past from
the time when the program is run.
#### Remove by Size
This functionality allows to remove file **smaller** or **larger** then a given
*size-specification*.
Remove File *smaller* then *size-spec*
```bash
rmd --smaller <size-spec> [directory...]
```
Remove File *larger* then *size-spec*
```bash
rmd --larger <size-spec> [directory...]
```
**rmd** checks if the file size, in bytes. If **larger** mode is used **rmd** checks,
for each file in the specified directory, and recursivelly in all sub directories,
if the size is **larger or equal** to the size decribed in *size-spec* and if so **rmd**
remove the file. Of course if **smaller** mode is used **rmd** checks for file **smaller or equal** to the size in *size-spec*.
*size-specification* format
```
[N+S]+
```
Where:
- **N** is a number (1-9)
- **T** is a size descriptor
- **+** means one or more
Deciamal Size Descriptor Table
| b | | byte | 1 byte |
|kb |kilo |kilobyte |1000 byte |
|mb |mega |megabyte |1000 kilobyte |
|gb |giga |gigabyte |1000 megabyte |
|tb |tera |terabyte |1000 gigabyte |
|pb |peta |petabyte |1000 terabyte |
Binary Size Descriptor Table
| b | | byte | 1 byte |
|kib |kibi |kibibyte |1024 byte |
|mib |mebi |mebibyte |1024 kibibyte |
|gib |gibi |gibibyte |1024 mebibyte |
|tib |tebi |tebibyte |1024 gibibyte |
|pib |pebi |pebibyte |1024 tebibyte |
Decimal and Binary size descriptor **can** be use together
##### Examples
```bash
rmd --smaller '2kb,56mib'
```
will remove in the current directory, and recursivelly in all sub directories, file
with a size smaller or equal to *56 Mebibytes and 2 Kilobytes*.
```bash
rmd --larger 4gb30mb
```
will remove in the current directory, and recursivelly in all sub directories, file
with a size larger or equal to *4 Gibabytes and 30 Megabytes*.
```bash
rmd --larger '1 mebi 15 kibi' /home/user/temp-store
```
will remove in **/home/user/temp-store** and recursivelly in all sub directories, file
with a size larger or equal to *1 Mebibytes and 15 Kibibytes*.
```bash
rmd --smaller 30kb /home/user/useless-files
```
will remove in **/home/user/useless-files** and recursivelly in all sub directories, file
with a size smaller or equal to *30 Kilobytes*.
### Note
- When working in *interactive* mode and a remove file is a
directory **rmd** prompts only once for the root directory
- *newer*, *older*, *recursive*, *smaller*, *larger* are mutually exclusive.
- Specification String, in both time and size remove, can contain any number of
non alphanumeric characters between a number and a descriptor or between a descriptor and
a number, those characters are simply treated as separators.
The important thing are to **NOT** put sperators into numbers or into descriptors and to
properly quote the specification string so it will be treated as a unique argument.