Skip to content

Commit

Permalink
update readme with use instructions
Browse files Browse the repository at this point in the history
  • Loading branch information
aidencullo committed Mar 18, 2024
1 parent 533d359 commit d751cb7
Show file tree
Hide file tree
Showing 3 changed files with 31 additions and 26 deletions.
34 changes: 21 additions & 13 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,42 +1,50 @@
# NoMail


## Table of Contents

* **[Description](#description)**
* **[Why?](#why)**
* **[Usage](#usage)**
* **[Contributing](#contributing)**


## Description

Customizable email filter for Gmail with Python.


## Why?

I am personally tired of sifting through the deluge of emails I
receive. I wanted to make a customizable email filter to extract
I wanted to make a customizable email filter to extract
pertinent information and ignore the rest.


## Installation

1. Install with [`pip`](https://pypi.org/project/nomail/)
+ `$ pip install nomail`
```bash
pip install nomail
```

## Usage

```
Usage: nomail.py [OPTIONS]
Filter out the noise.
Developed by Aiden Cullo -> (Github: aidencullo)
`nomail` can be used move emails to your trash:

```python
import nomail

Options:
-v Display version.
-help, -h Show this message.
# by default, email addresses in blacklist.csv will be moved to your trash folder
nomail.filter()
```


## Contributing

1. Clone repo and create a new branch: `$ git checkout https://github.com/aidencullo/nomail -b name_for_new_branch`.
2. Make changes and test
3. Submit pull request with description of proposed changes
3. Submit pull request with description of proposed changes


## License

`nomail` was created by Aiden Cullo. It is licensed under the terms of the MIT license.
13 changes: 0 additions & 13 deletions requirements.txt

This file was deleted.

10 changes: 10 additions & 0 deletions src/nomail/__init__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
# read version from installed package
from importlib.metadata import version
__version__ = version("nomail")

__all__ = [
'filter',
]

def filter():
print(f'{__name__=}')

0 comments on commit d751cb7

Please sign in to comment.