cmdg项目使用与配置教程

1. 项目目录结构及介绍

cmdg 是一个命令行的 Gmail 客户端，它的目录结构如下所示：

• cmd: 包含了生成可执行文件的 Go 代码。
• cmd/cmdg: cmdg 命令的具体实现。
• hooks: 包含了代码提交钩子，例如运行 golint 的钩子。
• html-renderer: 用于渲染 HTML 邮件的内容。
• pkg: 包含了项目的核心逻辑和库。
• .gitignore: 指定了哪些文件和目录应该被 Git 忽略。
• .travis.yml: Travis CI 的配置文件，用于自动化测试。
• LICENSE: 项目的许可证信息。
• README.md: 项目的自述文件，包含了项目的描述、安装和使用说明。
• go.mod 和 go.sum: Go 项目的依赖管理文件。

2. 项目的启动文件介绍

项目的启动文件位于 cmd/cmdg 目录下。主要文件是 main.go，它是程序的入口点。在这个文件中，定义了应用程序的命令行接口，并处理了用户的输入。

启动项目的命令如下：

$ go build ./cmd/cmdg
$ sudo cp cmdg /usr/local/bin

或者在 macOS 系统上，可以使用 Homebrew 安装：

$ brew tap cutzenfriend/homebrew-cmdg
$ brew install cmdg

启动之后，可以通过命令行运行 cmdg，进入程序的交互界面。

3. 项目的配置文件介绍

cmdg 需要配置文件来提供与 Gmail API 交互所需的认证信息。配置文件位于 ~/.cmdg/cmdg.conf。

配置文件的生成步骤如下：

1. 在 Google Developers Console 创建项目并启用 Gmail API、Google Drive API 和 People API。
2. 在 "OAuth consent screen" 页面填写信息，并添加所需的 API 范围（scopes）。
3. 在 "Credentials" 页面创建 OAuth 客户端 ID 和客户端密钥。
4. 使用 cmdg -configure 命令配置 cmdg，并按照提示输入客户端 ID 和客户端密钥。
5. 按照提示在浏览器中访问授权 URL，并复制返回的授权码到命令行中。

完成这些步骤后，cmdg 会生成一个配置文件 ~/.cmdg/cmdg.conf，其中包含了访问 Gmail 所需的 OAuth 令牌。之后，就可以使用 cmdg 命令行客户端来管理你的 Gmail 账户了。