Metadata-Version: 1.0
Name: quickemail
Version: 0.2.0
Summary: Quick send email use python3.
Home-page: http://nmla.cn
Author: Clayboy
Author-email: clayboy@foxmail.com
License: UNKNOWN
Description: ===========
        QuickEmail
        ===========
        ---------
        项目介绍
        ---------
        
        简易的邮件发信工具。支持认证/不认证发信。
        使用UTF-8编码。可以一次连接声明多收件人、抄送人
        
        ---------
        安装
        ---------
        ::
        
            pip install quickemail
        
        ---------
        使用说明
        ---------
        
        简易的邮件发信工具。支持认证/不认证发信。
        使用UTF-8编码。
        
        ::
        
            from quickemail import QuickEmail
        
        1. 发信前先定义发信要素：
        
            - 指定主机和端口，必须参数：
            
            ::
            
                quicksend = QuickEmail('mail.nmla.cn', 25)    # SMTP发信端口，默认是25 SSL链接使用465
        
            - 定义HELO主机名，参数可省略：
            
            ::
            
                quicksend.helo('QuickEmail')                 # HELO主机名不能使用有空格的字符串
        
            - 认证用户名和密码，authsend()必须的参数：
            
            ::
            
                quicksend.mail_user('a')                     # 认证用户名
                quicksend.user_pass('test')                  # 认证用户的密码
        
            - 发信人、收信人为必须参数：
            
            ::
            
                quicksend.mail_from('AA高丽A<a@nmla.cn>')    # 发信人地址，格式为:   FullName<email address>
                quicksend.mail_to('一二三<123@nmla.cn>,ABC<abc@nmla.cn>')    # 格式同上，多地址使用逗号","分隔
        
            - 抄送人，可省略：
            
            ::
            
                quicksend.mail_cc('一二三<123@nmla.cn>,中语言C<abc@nmla.cn>,AA高丽A<a@nmla.cn>')
        
            - 邮件主题、内容，支持使用HTML：
            
            ::
            
                quicksend.mail_subject('mY subject还有中文!')
                quicksend.mail_content('<font color=red>red content一段中文</font>')
                quicksend.is_html(True)
        
            - 添加附件，可省略：
            
            ::
            
                quicksend.mail_attach(['abc.jpg'])           # 添加附件 类型为list
                
            - 高级定制，可省略：
            
            ::
            
                quicksend.content_from('邮件显示的假发件人<from@nmla.cn>')      # 定制邮件信体显示的发件人，一般为来隐藏实际的mail_from。
                quicksend.content_to('邮件显示的假收件人<to@nmla.cn>')      # 定制邮件信体显示的收件人，一般为来隐藏实际的mail_to。
                quicksend.content_cc('邮件显示的假抄送人<cc@nmla.cn>')      # 定制邮件信体显示的抄送人，一般为来隐藏实际的mail_cc。
        
        2. 使用creatmsg()建立邮件信体内容。
        
            ::
            
                msg = quicksend.creatmsg()
        
        3. 使用authsend()或者send()发送邮件。
        
            ::
            
                quicksend.authsend(msg)     # 认证发信
                quicksend.send(msg)     # 不认证发信
        
        4. 错误显示输出String
        
            ::
            
                result = quicksend.authsend(msg)
                if result != True:
                    print(result)
        
                result = quicksend.send(msg)
                if result != True:
                    print(result)
        
Platform: UNKNOWN
