email_vocabulary 的安装和配置教程

项目基础介绍

email_vocabulary 是一个开源项目，旨在自动化发送包含三个词汇（可选语言和难度）的每日邮件，同时提供这些词汇的翻译和例句。这个项目可以帮助语言学习者在日常生活中保持对语言的接触和兴趣。

主要编程语言

该项目主要使用以下编程语言：

• Python：用于编写 Lambda 函数和脚本，以处理词汇的选择、存储和邮件发送等。
• HCL（HashiCorp Configuration Language）：用于编写 Terraform 配置文件，以部署 AWS 基础设施。
• Shell：用于编写部署脚本。

项目使用的关键技术和框架

• ChatGPT：作为词汇来源，提供词汇建议。
• AWS服务：包括 Lambda、DynamoDB、CloudWatch 和 SES，用于存储、触发和发送邮件。
• Terraform：用于自动化 AWS 基础设施的部署。
• Python 包：用于处理邮件发送和其他任务。

准备工作

在开始安装和配置之前，请确保以下准备工作已经完成：

• 安装 Python（测试版本为 Python 3.12.8）和 pip（测试版本为 pip 24.3.1）。
• 安装 Terraform（测试版本为 Terraform 1.10.3）。
• 安装 AWS CLI（测试版本为 2.15.58）。
• 如果您打算贡献代码，还需要安装 requirements.txt 文件中列出的包和 tflint。
• AWS CLI 用户需要有足够的权限来部署资源，请参考 Terraform 文件并应用最小权限原则。
• 在 Amazon SES 中验证您的电子邮件地址，确保它可以用于发送邮件。

安装步骤

1. 克隆项目到本地：

   git clone https://github.com/ThReinecke/email_vocabulary.git
   cd email_vocabulary
   

2. 准备配置文件：

   cp terraform.tfvars.example terraform.tfvars
   

   然后编辑 terraform.tfvars 和 variables.py 文件，填写所需的值。

3. 初始化 Terraform：

   terraform init
   

4. 规划 Terraform 变更：

   terraform plan
   

5. 应用 Terraform 变更：

   terraform apply
   

完成以上步骤后，项目应该已经成功部署，可以开始自动化发送邮件了。

请注意，这些邮件不能替代课程学习、应用程序或专门的词汇训练。它们只是保持语言接触的一个好方法。