sopel-youtube

YouTube链接信息插件用于Sopel。

安装

版本托管在PyPI上，因此安装Sopel后，您只需pip

$ pip install sopel-youtube

(确保您使用的是“正确的”pip，即与您安装Sopel的Python环境相对应的pip。)

从sopel-modules.youtube迁移

在安装此软件包之前，您可以简单地pip uninstall sopel-modules.youtube；不需要额外步骤。sopel-youtube继承了旧版本最初定义和使用的配置部分。

最新源代码

如果您想帮助开发或测试插件，您需要从源代码安装。首先克隆存储库，然后

$ pip install -e .

测试更改

要运行测试，请确保您有开发依赖项

$ pip install -r dev-requirements.txt

从存储库根目录运行测试套件

$ pytest -v .

获取您的API密钥

访问 谷歌开发者控制台 并创建一个应用。创建完成后，转到“API”部分，选择“YouTube数据API”并启用它。然后转到“凭证”部分，选择“添加凭证”，选择“API密钥”，然后选择“服务器密钥”。您可以为此密钥命名并限制其可用的IP地址，但这不是必需的。将提供的值复制到配置向导中的提示（见下文），或配置文件[youtube]部分的api_key字段。

配置插件

sopel-youtube支持Sopel的交互式配置向导

sopel-plugins configure youtube

api_key选项的解释自明（见上文）。

如果视频“观看”链接包含播放列表ID，则默认情况下插件将显示播放列表信息和视频信息。要禁用此功能，将playlist_watch设置为False。

对于视频，默认情况下，仅显示视频长度、上传者（频道名称）、观看次数和上传日期。包含的项目及其出现顺序取决于info_items设置，它是一个关键词列表。未识别的关键词将被简单地忽略。支持的info_items有

• comments（评论数）
• date（上传时间/日期）
• length（持续时间）
• likes（数量）
• uploader（频道名称）
• views（观看次数）

0.5.1和0.6.0之间的更改

• 新包名：sopel-youtube替代sopel-modules.youtube（#55，#67）
• Sopel 8.0+现在要求（#57，#65）
• 改进链接处理（#56，#58）
• 改进线程安全性（#63）
• 修复播放列表的日期解析错误（#62）

0.5.0和0.5.1之间的更改

• 修复隐藏加载时导入错误（#52）

0.4.3和0.5.0之间的更改

• 为Sopel 8做准备
  • 需要Sopel 7.1+；Sopel 7.0不再受支持
  • 使用BooleanAttribute设置类型（#41）
  • 从sopel.module切换到sopel.plugin（#42）
• 根据频道的偏好格式化时间，如有必要则回退到机器人设置（#50）
• 允许使用较新的google-api-python-client库版本（#51）

0.4.2和0.4.3之间的更改

• 删除处理不喜欢的功能，因为YouTube已将其从其API中删除（#45）
• 再次使直播处理更健壮（#48）
• 将info_items中的votes和votes_color关键词替换为votes（#49）
  • 旧关键词将作为别名直到至少插件版本0.5.0

0.4.1和0.4.2之间的更改

• 改进错误处理（#44）

0.4.0和0.4.1之间的更改

• 处理“短片”链接（#36）
• 更小心地处理自动播放列表（#38）

0.3.2和0.4.0之间的更改

• 增强直播流支持（#28）
• 添加播放列表处理（#29，#33）
• 防止双向文本（#31）

0.3.1和0.3.2之间的更改

• 清理一些有问题的导入（#25）
• 从YouTube API请求仅必要的数据字段（#27）

0.3.0和0.3.1之间的更改

• 覆盖处理罕见的API错误，以便将其输出到输出（#23）

0.2.1和0.3.0之间的更改

• 允许配置要包含的视频详细信息（#18）
• 删除输出标签“[YouTube]”上的过时、丑陋的颜色（#21）
• 小清理（正则表达式模式、包元数据）

0.2.0和0.2.1之间的更改

• 处理API发送错误格式的时间戳（#20）

0.1.3和0.2.0之间的更改

• 为Sopel 7更新（#15）

0.1.2和0.1.3之间的更改

• 添加API获取的重试机制（#11）
• 修复在重新连接时有时抛出的异常跟踪（#14）
• 更新古老的、已弃用的Sopel内存API的使用（#16）

0.1.1和0.1.2之间的更改

• 修复禁用视频评论时的错误
• 改进持续时间解析器
• 限制google-api-python-client到兼容版本范围
• 修复安装期间版本号导入问题

0.1.0和0.1.1之间的更改

• 输出着色
• 修复配置向导
• pip安装不受pip版本影响