# dumail

**Repository Path**: imechy/dumail

## Basic Information

- **Project Name**: dumail
- **Description**: 基于python的命令行收发邮件
- **Primary Language**: Python
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-07-10
- **Last Updated**: 2024-07-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# dumail

#### 介绍
基于python的命令行收发邮件

做这个小程序的目的是因为在ubuntu上配置和使用mailx 或者其他软件有点麻烦，所以自己做一个符合自己想法的程序，用起来更加贴心。

计划做成没有UI界面，可以命令行发送带有附件或者没有附件的邮件，可以命令行查看收件箱，可以下载并查看指定的邮件及附件。

#### 软件架构
代码有点乱，毕竟业余菜鸟水平，如果有人看到这个程序并想要提供宝贵的想法或意见，欢迎联系



#### 安装教程

1.  下载dumail.py,修改为可运行权限
2.  下载dumail.rc到“/etc”下（建议）或者home文件夹或者运行dumail.py的文件夹
3.  在dumail.rc 里面根据自己需要设置参数
4.  使用了第三方库bs4,需要自行安装pip install bs4

#### 使用说明

1.  目前实现发送单个附件，文本邮件
2.  能查看收件箱信息列表，在命令行界面查看html的邮件只能查看文字内容和下载附件，美观就不能提了，后面尽量慢慢优化
3.  目前收信功能因为某易邮箱的IMAP协议需要认证客户端，所以用的POP3协议，发信用的SMTP
4.  主体是一个mail（）类
方法：
	.from_cmd(self)
	       对于命令行的支持主要在这个方法里面实现：
	    -c  --Content    :添加邮件文本内容（字符串）或者包含内容的文件路径（字符串）
	    -s  --Subject    :邮件主题（字符串）
	    -f  --From       :邮件的from 字段的内容，发送人
	    -t  --To         :收件人，可以是单个邮箱地址（字符串）也可以是多个邮箱地址列表（字符串列表）-t reciever1 [reciever2] .....
	    -a  --Attachments:邮件附件路径，-a path1  [path2] [path3]......
	    -l  --List       :邮件列表，默认每次显示8条邮件 ，-l /num可以将每次显示的邮件数量修改为num
	    -r  --read       :阅读由参数指定的邮件，-r index   阅读编号为index 的邮件
	    -d  --delete     :删除本地和服务器端指定编号的邮件 ，-d index1 [index2] [index3]......
	    
    .send_mail(self,From='',To='',Content='',Subject='',Attachments1=[],**Attachments2)
        发送邮件
        Attachments1:邮件附件的路径列表，或者单个文件路径
        **Attachments2：需要发送二进制文件时 ，使用 filename1=Bytes1,filename2=Bytes2,......的形式
    .list_msg(self,flags='')
        显示邮件列表
        flag:根据邮件标志位筛选邮件
                            N:new msg
                            U:unread msg
                            D:writing
                            F:marked
                            P:retrieve
                            R:replied
                            S:seen
                            T:deleted
                            L:new load*
                        
    .read(self,index_r)
        阅读邮件
        index_r:邮件编号，如果编号不存在会显示编号错误
    .del_msg(self,index)
        删除服务器和本地的编号为index 的邮件
#### 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request


#### 特技

1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
2.  Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
4.  [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
5.  Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6.  Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)