Metadata-Version: 2.1
Name: mailshell
Version: 1.4.10
Summary: Send and check emails faster from the terminal
Home-page: https://github.com/malkiAbdoo/mailshell
Author: Malki Abderrahman
Author-email: abdo.malkiep@gmail.com
License: UNKNOWN
Project-URL: Source, https://github.com/malkiAbdoo/mailshell
Project-URL: Tracker, https://github.com/joelibaceta/mailshell/issues
Description: 
        # Mailshell - msl
        
        <div align=center>
        
        
        
        send and check emails :email: faster from the terminal using Mailshell
        
        [![PyPI](https://img.shields.io/pypi/v/mailshell?label=release%20version&logo=pypi)](https://pypi.org/project/mailshell/)
        [![GitHub issues](https://img.shields.io/github/issues/malkiAbdoo/mailshell)](https://github.com/malkiAbdoo/mailshell/issues)
        [![GitHub](https://img.shields.io/github/license/malkiAbdoo/mailshell?label=Mailshell%20license&color=yellow)](https://github.com/malkiAbdoo/mailshell/blob/master/LICENSE)
        [![Get started](https://img.shields.io/badge/Get%20started-DOC-2fbe50)](https://github.com/malkiAbdoo/mailshell/blob/master/doc/documentation.md)
        
        </div>
        
        ## Requirements
        
        - python 3.7+
        - Linux or MacOS
        
        ## Installation
        
        python `pip` install
        ```bash
        $ python -m pip install mailshell
        ```
        Support python 3.7+
        
        ## Usage
        
        just type `msl` followed by one of the mailshell commands
        See how to use mailshell and find all the arguments, option in the [Documentation][doc].
        - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
        type `msl login` to log in with gamil [app password][appp], and `msl new` to create a new message
        ```bash
        $ msl login
        Email addres: user@example.com
        Email app password: ****************
        ```
        use `msl set` command to write your email using [nano][GNU-nano] editor or `msl html` to add html message, and you can also add a text from a txt file with `-f` option in `set` and `html` command.
        ```bash
        $ msl set -f ./your_text.txt
        ```
        use `msl add` with a file or image to include it and `msl rm` to remove it from your message.
        ```bash
        $ msl add file.pdf
        $ msl add image.jpg
        $ msl rm file.pdf
        ```
        use `msl content` to see your message content, and add `--files` or `--images` to see a list of the message attachments. 
        ```bash
        $ msl content
        ============= Your message =============
        Subject:    message
        From:       name <user@example.com>
        
        the message...
        ----------------------------------------
        - includes:
        	file.xlsx
        	image.png
        	...
        ```
        run `msl send` to send your message to specified accounts.
        ```bash
        $ msl send -T other@example.com
        ```
        you can use `msl check` command to check your emails with a specified mailbox with `-b` option (`Inbox` is the default) and some [selection options][Options] such as `--all` and `--from`, and use `-l` to display the output as a list.
        ```bash
        $ msl check -b sent --date 18-09-2015
        email(1)
        email(2)
        email(3)
         ...
        ```
        use the same selection options in `msl delete` to delete the selected emails in the mailbox
        ```bash
        $ msl delete -t "You won.." -n
        ```
        
        ## Commands
        
        Use **`--help`** in mailshell to see the available commands:
        
        | Command                    | Description                                                                   |
        |----------------------------|-------------------------------------------------------------------------------|
        | `login`                    | log in to your gmail using email address and the [app password][appp]         |
        | `cred`                     | print your current email address and app password                             |
        | `new`                      | create new email message                                                      |
        | `subject`                  | set a new subject to the message                                              |
        | `from`                     | set a new sender name                                                         |
        | `html`                     | add [html][html] message                                                      |
        | `content`                  | see the current message content with the included files                       |
        | `set`                      | add a text manually or from **.txt** file to you current message              |
        | `add`                      | add a file or image to your message                                           |
        | `rm`                       | remove a file or image from your message                                      |
        | `to`                       | set your contact that you will send to                                        |
        | `send`                     | send the current message                                                      |
        | `check`                    | check your emails in a mailbox using [selection options][Options]             |
        | `delete`                   | delete the selected email with the delete [options][Options] in mailbox       |
        | `logout`                   | log out from mailshell                                                        |
        
        ```bash
        $ msl --help
        ```
        add **`--version`** option to see your current version.
        
        ## Support
        
        For support, Follow on twitter [@malkiAbdoo](https://twitter.com/malkiAbdoo).
        
        
        <!-- References -->
        
        [appp]:https://support.google.com/accounts/answer/185833?hl=en#app-passwords
        [sc]:https://www.marshallsoft.com/ImapSearch.htm
        [GNU-nano]:https://en.wikipedia.org/wiki/GNU_nano
        [html]:https://en.wikipedia.org/wiki/HTML
        [doc]:https://github.com/malkiAbdoo/mailshell/blob/master/doc/documentation.md
        [Options]:https://github.com/malkiAbdoo/mailshell/blob/master/doc/documentation.md#arguments-and-options
        
        
Keywords: terminal,app,email,gmail,shell
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.10
Classifier: License :: OSI Approved :: MIT License
Description-Content-Type: text/markdown
