鸽子

鸽子是一个用于以经济高效的方式自动化您的电子邮件工作流程的命令行工具。利用您最熟悉的开发工具。

例如，查询您的时事通讯的订阅者，从模板文件创建纯文本和 html 电子邮件，并全部发送给他们

pigeon send-bulk \
    sender@your-domain.com \
    --receiver-query "select email from user where newsletter_confirmed = true" \
    --message-file "message.yaml" \
    --display \
    --assume-yes

> Display query result: shape: (4, 1)
+------------------------------+
| email                        |
| ---                          |
| str                          |
+==============================+
| "marie@curie.com"            |
+------------------------------+
| "alexandre@grothendieck.com" |
+------------------------------+
| "emmy@noether.com"           |
+------------------------------+
| "elie@cartan.com"            |
+------------------------------+
> Sending email to 4 receivers ...
marie@curie.com ... ok
alexandre@grothendieck.com ... ok
emmy@noether.com ... ok
elie@cartan.com ... ok

• 安装 Pigeon
  • 从 crates.io 安装 Pigeon
  • 从 github.com 安装 Pigeon
• 获取帮助
• 用法
  • 向单个接收者发送电子邮件
  • 向多个接收者发送批量电子邮件
  • 个性化您的电子邮件
• 如何连接
  • 如何连接到 SMTP 服务器
  • 如何连接到电子邮件提供商 API
  • 如何连接到 postgres 数据库
• 集成
  • 电子邮件协议
  • 第三方 API
  • 数据源
• 与 Mailchimp、Sendgrid 和 ConvertKit 的比较
• 测试

安装 Pigeon

从 crates.io 安装 Pigeon

# Build and install pigeon binary to ~/.cargo/bin
cargo install pigeon-rs

注意： 再次运行 cargo install pigeon-rs 以更新到最新版本。使用 cargo uninstall pigeon-rs 卸载 pigeon 二进制文件。

从 github.com 安装 Pigeon

# Clone repository
git clone git@github.com:quambene/pigeon-rs.git
cd pigeon-rs

# Build and install pigeon binary to ~/.cargo/bin
cargo install --path .

注意： 如果缺少，请将 $HOME/.cargo/bin 添加到您的 PATH

export PATH="$HOME/.cargo/bin:$PATH"

获取帮助

要获取帮助，请尝试以下方法之一

# Check version
pigeon --version

# Print help
pigeon --help

# Print help for subcommand
pigeon help send
pigeon help send-bulk
pigeon help connect
pigeon help init
pigeon help query
pigeon help simple-query
pigeon help read

用法

使用 pigeon connect 检查与您的 SMTP 服务器的连接

pigeon connect

正在连接到 SMTP 服务器 'email-smtp.eu-west-1.amazonaws.com' ... ok

请参阅以下支持的 集成 和 连接方法。

注意： 您还可以检查连接到第三方 API，而不仅仅是使用 SMTP 协议。例如，使用 AWS Simple Email Service (SES)：pigeon connect aws。

向单个接收者发送电子邮件

使用主题和内容发送单个电子邮件

pigeon send \
    sender@your-domain.com \
    receiver@gmail.com \
    --subject "Test subject" \
    --content "This is a test email."

使用单独的模板文件定义的消息发送单个电子邮件

pigeon send \
    sender@your-domain.com \
    receiver@gmail.com \
    --message-file "message.yaml"

消息模板 message.yaml 是使用子命令 init 创建的

pigeon init

注意： --message-file 的一项优点是您还可以草拟电子邮件的 HTML 版本。相比之下，使用选项 --subject 和 --content，电子邮件将以纯文本格式发送。

如果您更喜欢用于草拟电子邮件的专用 HTML 文件，请使用以下命令

pigeon send \
    sender@your-domain.com \
    receiver@gmail.com \
    --subject "Test subject" \
    --text-file "./message.txt" \
    --html-file "./message.html"

其中，--text-file 定义纯文本，而 --html-file 定义电子邮件的 HTML 版本。

向多个接收者发送批量电子邮件

例如，查询已确认接收您的时事通讯的相关用户，并向他们所有人发送电子邮件。

让我们首先通过 pigeon query 检查查询

pigeon query --display "select email from user where newsletter_confirmed = true"

> Display query result: shape: (4, 1)
+------------------------------+
| email                        |
| ---                          |
| str                          |
+==============================+
| "marie@curie.com"            |
+------------------------------+
| "alexandre@grothendieck.com" |
+------------------------------+
| "emmy@noether.com"           |
+------------------------------+
| "elie@cartan.com"            |
+------------------------------+

请参阅下面的 如何连接 以连接到您的数据库。

注意： 您还可以将查询保存为 CSV 文件：pigeon query --save <my-query>。

现在向查询到的接收者发送时事通讯。如果表列名不同于 "email"，请使用 --receiver-column 定义不同的列名。让我们首先尝试一个没有确认的 --dry-run 和 --assume-yes。

pigeon send-bulk \
    albert@einstein.com \
    --receiver-query "select email from user where newsletter_confirmed = true" \
    --message-file "message.yaml" \
    --assume-yes \
    --dry-run

> Sending email to 4 receivers ...
marie@curie.com ... dry run
alexandre@grothendieck.com ... dry run
emmy@noether.com ... dry run
elie@cartan.com ... dry run

在双重检查后，您可以提交相同的命令而不使用 --dry-run。还要删除 --assume-yes 以进行明确的确认。

注意： 您还可以向定义在 CSV 文件中的电子邮件地址发送批量电子邮件，而不是查询结果。在这种情况下，请使用选项 --receiver-file 而不是 --receiver-query。您可以通过子命令 read 检查 CSV 文件的内容，例如 pigeon read recipients.csv。

个性化您的电子邮件

如果您需要更多个人电子邮件，您可以使用选项 --personalize 来个性化您的电子邮件。让我们首先检查相关的查询

pigeon query --display "select first_name, last_name, email from user where newsletter_confirmed = true"

> Display query result: shape: (4, 3)
+-------------+----------------+------------------------------+
| first_name  | last_name      | email                        |
| ---         | ---            | ---                          |
| str         | str            | str                          |
+=============+================+==============================+
| "Marie"     | "Curie"        | "marie@curie.com"            |
+-------------+----------------+------------------------------+
| "Alexandre" | "Grothendieck" | "alexandre@grothendieck.com" |
+-------------+----------------+------------------------------+
| "Emmy"      | "Noether"      | "emmy@noether.com"           |
+-------------+----------------+------------------------------+
| "Elie"      | "Cartan"       | "elie@cartan.com"            |
+-------------+----------------+------------------------------+

在您的消息模板 message.yaml 中，使用大括号中的变量，例如 {first_name} 和 {last_name}。然后定义个人列作为选项 --personalize 的参数。最后，让我们使用 --display 显示一切。

pigeon send-bulk \
    albert@einstein.com \
    --receiver-query "select first_name, last_name, email from user where newsletter_confirmed = true" \
    --message-file "message.yaml" \
    --personalize "first_name" "last_name" \
    --display

> Display message file: MessageTemplate {
    message: Message {
        subject: "Issue No. 1",
        text: "Dear {first_name} {last_name},
            Welcome to my newsletter. We are doing hard sciences here.
            Sincerely, Albert Einstein",
        html: "Dear {first_name} {last_name},
            Welcome to my newsletter. We are doing hard sciences here.
            Sincerely, Albert Einstein",
    },
}
> Display emails: BulkEmail {
    emails: [
        Email {
            sender: "albert@einstein.com",
            receiver: "marie@curie.com",
            message: Message {
                subject: "Issue No. 1",
                text: "Dear Marie Curie,
                    Welcome to my newsletter. We are doing hard sciences here.
                    Sincerely, Albert Einstein",
                html: "Dear Marie Curie,
                    Welcome to my newsletter. We are doing hard sciences here.
                    Sincerely, Albert Einstein",
                },
        },
        Email {
            sender: "albert@einstein.com",
            receiver: "alexandre@grothendieck.com",
            message: Message {
                subject: "Issue No. 1",
                text: "Dear Alexandre Grothendieck,
                    Welcome to my newsletter. We are doing hard sciences here.
                    Sincerely, Albert Einstein",
                html: "Dear Alexandre Grothendieck,
                    Welcome to my newsletter. We are doing hard sciences here.
                    Sincerely, Albert Einstein",
            },
        },
        Email {
            sender: "albert@einstein.com",
            receiver: "emmy@noether.com",
            message: Message {
                subject: "Issue No. 1",
                text: "Dear Emmy Noether,
                    Welcome to my newsletter. We are doing hard sciences here.
                    Sincerely, Albert Einstein",
                html: "Dear Emmy Noether,
                    Welcome to my newsletter. We are doing hard sciences here.
                    Sincerely, Albert Einstein",
            },
        },
        Email {
            sender: "albert@einstein.com",
            receiver: "elie@cartan.com",
            message: Message {
                subject: "Issue No. 1",
                text: "Dear Elie Cartan,
                    Welcome to my newsletter. We are doing hard sciences here.
                    Sincerely, Albert Einstein",
                html: "Dear Elie Cartan,
                    Welcome to my newsletter. We are doing hard sciences here.
                    Sincerely, Albert Einstein",
            },
        },
    ],
}
> Should an email be sent to 4 recipients? Yes (y) or no (n)
>

如果您准备好出发，请确认 y。

如何连接

如何连接到 SMTP 服务器

要连接到 SMTP 服务器，请定义环境变量 SMTP_SERVER、SMTP_USERNAME 和 SMTP_PASSWORD。例如，使用 AWS SES

SMTP_SERVER=email-smtp.eu-west-1.amazonaws.com
SMTP_USERNAME=...
SMTP_PASSWORD=...

在您的当前 shell 中源环境 .env

set -a && source .env && set +a

如何连接到电子邮件提供商 API

您还可以通过特定电子邮件提供商的 API 发送电子邮件而不是使用 SMTP。

使用 AWS SES，请定义以下环境变量

AWS_ACCESS_KEY_ID=...
AWS_SECRET_ACCESS_KEY=...
AWS_REGION=eu-west-1

其中，AWS_REGION 依赖于您的 AWS SES 账户指定的区域。

再次源环境

set -a && source .env && set +a

使用 --connection 发送电子邮件

pigeon send \
    sender@your-domain.com \
    receiver@gmail.com \
    --connection aws \
    --message-file "message.yaml"

如何连接到 postgres 数据库

对于 postgres，数据库 URL 的构造如下：postgresql://db_user:db_password@db_host:db_port/db_name。

因此，在您的环境 .env 中设置以下环境变量

• DB_HOST
• DB_PORT
• DB_USER
• DB_PASSWORD
• DB_NAME

再次源环境

set -a && source .env && set +a

注意： 目前不支持通过 TLS 连接。请通过 SSH 隧道转发本地端口，例如：

pigeon query "select email from user where newsletter_confirmed = true" --display --ssh-tunnel 5437

除了上述环境变量外，还需要设置 SERVER_USER 和 SERVER_HOST 以进行 SSH 连接（ssh user@host）。

集成

电子邮件协议

• MIME
• SMTP

第三方 API

• AWS SES

数据源

• PostgreSQL
• CSV

与 Mailchimp、Sendgrid 和 ConvertKit 的比较

这些数字可能已经过时。请自行进行研究。

以下表格比较了电子邮件提供商每月的价格和每月的电子邮件数量。

以下表格显示了每个提供商每天发送电子邮件的限制。

测试

某些集成测试需要本地运行的 PostgreSQL 数据库

1. 指定以下环境变量
   • DB_HOST
   • DB_PORT
   • DB_USER
   • DB_PASSWORD
   • DB_NAME
2. 设置一个临时的 PostgreSQL 数据库： docker-compose run --rm --service-ports postgres

# Run unit tests and integration tests
cargo test

# Run unit tests
cargo test --lib

# Run integration tests
cargo test --test '*'