蒸汽记者

steam-reporter是一个命令行工具，用于解析 Steam 营销电子邮件收据并将交易信息存储在本地 SQLite 数据库中。它目前仅针对美国用户进行测试和配置。

安装

pip install steam_reporter

设置

配置文件

将 repos默认配置文件复制到您选择的目录，例如~/path_to_config/config.ini. 根据您的用例完成database、address和部分。server有关配置文件中每个部分的概述，请参见下文。如果您有多个电子邮件帐户需要从中获取交易，请为每个电子邮件地址创建一个 config.ini 文件，并steam-reporter为每个配置文件运行。如果需要，它们可以指向同一个数据库文件。

钥匙圈

steam-reporter使用 python 密钥环库安全地处理电子邮件帐户凭据。必须在使用前添加凭据。steam-reporter可以用作通过-p标志设置密钥环凭据的前端。例如，steam_reporter -p config_file_path/config.ini。然后将提示您输入用户名和密码。如果您想手动设置凭据，请使用服务名称steam-reporter。

用法

这很简单

$ steam_reporter /config_file_path/config.ini

句法

steam_reporter [-h] [--quiet] [--password] [--update] [--mark_seen] config

位置参数

config- 预期配置文件的位置，例如~/path_to_config/config.ini

选项

-h, --help- 显示帮助。
-q, --quiet- 防止打印到控制台。
-p, --password- 在本地密钥环中设置用户名和密码。
-u, --update- 仅在数据库中最后一个日期交易之后和之后添加交易。
-m, --mark_seen- 将提取的电子邮件标记为已查看。

配置文件选项

线程

Threads = 1

这是要使用的进程数。除非您正在处理大量本地文件，否则它不太可能产生太大影响。steam-reporter 已移至多处理，但Threads仍保持与现有配置的人的兼容性

Emails_Per_Transaction

Emails_Per_Transaction = 1000

Rows_Per_Transaction ：一次处理的文件/电子邮件数。由于每封电子邮件中可能包含多个事务，实际提交的事务数可能更多。对电子邮件影响最大，而不是本地文件。较大的数字会增加内存使用量。注意 :::: 提供给 IMAP 提取命令的字符数似乎有限制。如果发生这种情况（FETCH 命令错误或未终止的行），请减少此数字。随着 id 长度的增加（即 200 vs 2000 vs 20000），这个数字可能必须减少。

数据库

Database = /home/user/example/database.db

要使用的数据库的位置。如果不存在，将创建一个新数据库。

本地文件夹

Local_Folder = /home/user/example/downloaded_emails/

取消注释此行以使用本地 eml 文件而不是从服务器获取。

# Local_Folder =

地址

Address = example@email.com

从中获取电子邮件的电子邮件地址。

服务器

Server = imap.email.com

地址的电子邮件服务器。

文件夹

Folder = Steam_Emails_Location

取消注释此行以搜索特定的收件箱文件夹。如果您的 Steam 市场交易电子邮件不在您的主收件箱文件夹中，请使用此选项。

# Folder =

故障排除

无法登录/应用特定密码

一些电子邮件提供商（例如 hotmail）现在需要应用程序特定密码才能让第三方应用程序登录。如果 steam-reporter 无法连接到您的电子邮件帐户，这可能就是原因。您的电子邮件帐户设置中应该有一个选项来生成应用程序专用密码。使用它代替您的常规密码

提取错误

从服务器获取电子邮件时，fetch 命令可以采用一系列 id - 例如1:4、1,2,3,4或1,3:5. 可以发送的命令的长度似乎有限制。如果您收到有关 FETCH 命令错误的错误，您可能需要减少配置文件中每个事务的电子邮件。