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
License-File: LICENSE
Requires-Dist: imap-tools (>=0.55.0)
Provides-Extra: dev
Requires-Dist: imap-tools (>=0.55.0) ; extra == 'dev'
Requires-Dist: pytest (>=7.1.2) ; extra == 'dev'
Requires-Dist: black (>=22.3.0) ; extra == 'dev'
Requires-Dist: mypy (>=0.960) ; extra == 'dev'
Requires-Dist: isort (>=5.10.1) ; extra == 'dev'
Requires-Dist: pylama (>=8.3.8) ; extra == 'dev'
Requires-Dist: types-pkg-resources (>=0.1.3) ; extra == 'dev'
Requires-Dist: types-setuptools (>=57.4.17) ; extra == 'dev'
Requires-Dist: pylint (==2.14.4) ; extra == 'dev'
Provides-Extra: test
Requires-Dist: pytest (>=7.1.2) ; extra == 'test'

# 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.


