Metadata-Version: 2.1
Name: mailbox-cleaner
Version: 0.1.0
Summary: Command line utility to clean IMAP folders
Home-page: https://github.com/adbenitez/mailbox_cleaner
Author: adbenitez
Author-email: adbenitez@hispanilandia.net
License: UNKNOWN
Keywords: cli email imap cleaner
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Provides-Extra: test
Provides-Extra: dev
License-File: LICENSE

# mailbox-cleaner

a simple CLI tool to clean IMAP folders

[![Latest Release](https://img.shields.io/pypi/v/mailbox-cleaner.svg)](https://pypi.org/project/mailbox-cleaner)
[![Supported Versions](https://img.shields.io/pypi/pyversions/mailbox-cleaner.svg)](https://pypi.org/project/mailbox-cleaner)
[![Downloads](https://pepy.tech/badge/mailbox-cleaner)](https://pepy.tech/project/mailbox-cleaner)
[![License](https://img.shields.io/pypi/l/mailbox-cleaner.svg)](https://pypi.org/project/mailbox-cleaner)
[![CI](https://github.com/adbenitez/mailbox-cleaner/actions/workflows/python-ci.yml/badge.svg)](https://github.com/adbenitez/mailbox-cleaner/actions/workflows/python-ci.yml)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)

## Installation

To install with pip:

```
$ pip install -U mailbox-cleaner
```

After installation the command `mailbox-cleaner` should be available.
You can also just download the `mailbox_cleaner.py` file and execute it directly.

## Usage

To delete emails older than 15 days in the INBOX folder:
```
mailbox-cleaner imap.example.com me@example.com myPassword -d 15
```

To delete emails older than 30 days in the Trash folder using a STARTTLS connection to a host with non-standard port:
```
mailbox-cleaner imap.example.com:9999 me@example.com myPassword -c STARTTLS -f Trash -d 30
```

To see all available options and more information use:
```
mailbox-cleaner --help
```

## License

Licensed GPLv3+, see the LICENSE file for details.

Copyright © 2022 Asiel Díaz Benítez.


