使用 gmail api 和 selenium 跟踪包的命令行工具
项目描述
包裹轨道
package-track 是一个易于使用的包裹跟踪器,可以自动跟踪您的交付和发货过程。该版本目前仅限于跟踪 USPS、UPS、FEDEX 和其他在美国境内发货的主要物流提供商的交付。
要知道的事情:
- 当您第一次运行该程序时,package-track 会要求您通过 Gmail 授予电子邮件访问权限。我们不会存储您的任何电子邮件信息。我们只是在 Gmail API 之上构建,以允许您的终端访问您的电子邮件。如果您不启用此功能,程序将无法正常运行。范围和 API 信息可在此处获得:https ://developers.google.com/gmail/api/guides 。
- package-track 是由一堆不同的依赖项拼凑而成的。请确保已全部安装,否则程序将无法正常运行。
依赖项
对于 Gmail 的 API 功能:
- pickle、操作系统、google-api-python-client、google-auth-httplib2、google-auth-oauthlib、电子邮件和 base64
对于在线搜索/网页抓取:
- 硒,bs4
对于其他一切:
- 熊猫、csv、re、itertools
验证
- 要允许 package-track 自动从电子邮件中查找跟踪号,您需要设置 Gmail API 并验证和授权您的应用程序。
使用 OAuth 客户端 ID
在这种情况下,package-track 将要求最终用户(或您自己,如果您正在运行它)授予对用户数据的访问权限。以下是授予访问权限的方法:
- 如果您尚未使用此链接为项目启用 API 访问权限:https ://developers.google.com/gmail/api/quickstart/python 。
- 点击“启用 Gmail API”。
- 当系统提示您配置 OAuth 客户端时,从下拉菜单中选择“桌面应用程序”。
- 将出现一条消息,告诉您凭据已成功创建。
- 单击“下载”按钮下载凭据。
- 将下载的文件移动到
~/.package-track/bin/credentials.json. *注意:此 OAuth 客户端的默认名称是 Quickstart。我们建议将名称更改为 package-track,但这对于程序的功能来说绝不是必需的。
安装
package-track 需要Python v3+ 才能运行。
要安装 package-track,只需使用 pip install:
$ pip install package-track
运行包跟踪
要运行 package-track,只需打开命令行并在package-track提示行输入!
发展
想贡献?伟大的!
package-track 肯定可以使用一些帮助。请随时通过idm2114@columbia.edu给我发送电子邮件或向 github 存储库发送拉取请求。
待办事项
- 重构代码
- 添加更多运输提供商
执照
麻省理工学院
谢谢你