Metadata-Version: 2.4
Name: rebin-cli
Version: 1.1.1
Summary: Terminal Trash Tool with ASCII UI
Author: Mehmet
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Dynamic: author
Dynamic: description
Dynamic: description-content-type
Dynamic: requires-python
Dynamic: summary

# Rebin - Terminal Trash Tool

```
██████╗ ███████╗██████╗ ██╗███╗   ██╗         
██╔══██╗██╔════╝██╔══██╗██║████╗  ██║        
██████╔╝█████╗  ██████╔╝██║██╔██╗ ██║       
██╔══██╗██╔══╝  ██╔══██╗██║██║╚██╗██║       
██║  ██║███████╗██████╔╝██║██║ ╚████║       
╚═╝  ╚═╝╚══════╝╚═════╝ ╚═╝╚═╝  ╚═══╝ 
```

**Rebin** is a lightweight, cross-platform terminal trash management tool written in Python. It provides a safer way to manage file deletions with a premium terminal aesthetic.

## Installation

```bash
pip install rebin_cli
```

---

## Features

- 🗑️ **Safe Deletion**: Move files and directories to a managed trash instead of immediate removal.
- 📂 **Directory Support**: Automatically handles folders, calculating recursive sizes and tracking internal contents.
- 🌲 **Tree Visualization**: View the structure of deleted folders directly within the trash list.
- 🔄 **One-Command Restore**: Effortlessly restore items to their original locations.
- 📊 **Detailed Metadata**: Track file size, type, and exact deletion timestamps.
- 🎨 **Premium UI**: Clean ASCII art headers and intuitive tree-style visualizations.

---

## Usage

Rebin provides a simple set of commands to manage your trash:

### Delete a file or folder
Moves the specified item to the trash.
```bash
rebin delete <path>
```

### List trash contents
Displays all items currently in the trash with their metadata. Folder contents are shown in a nested tree view.
```bash
rebin list
```

### Restore an item
Restores a file or folder from the trash to its original path.
```bash
rebin restore <name>
```

### Permanently remove an item
Deletes a specific item from the trash permanently.
```bash
rebin remove <name>
```

### Empty the trash
Permanently removes all items from the trash.
```bash
rebin empty
```

---

## Technical Details

- **Storage**: Items are stored in `~/.trash/` (automatically created).
- **Metadata**: A `metadata.json` file tracks original paths and deletion details.
- **Compatibility**: Works on Linux, macOS, and Windows.
