listparser 0.20

listparser

在Python中解析OPML订阅列表。

如果您正在构建一个聚合阅读器并且需要解析OPML订阅列表，您就来到了正确的位置！

listparser使得轻松解析和使用多种格式的订阅列表变得简单。它支持OPML、RDF+FOAF以及iGoogle导出的设置格式，并且可在Python 3.8+和PyPy 3.8上运行。

使用方法

>>> import listparser
>>> result = listparser.parse(open("feeds.opml").read())

将返回一个包含几个键的字典

• meta：订阅列表信息的字典

• feeds：一系列的源

• lists：一系列的订阅列表

• version：格式标识符，如“opml2”

• bozo：如果列表存在问题，则为True，否则为False

• bozo_exception：（如果< span class="docutils literal">bozo 为1）问题描述

为了方便，结果字典支持对其键的属性访问。

继续示例

>>> result.meta.title
'listparser project feeds'
>>> len(result.feeds)
2
>>> result.feeds[0].title, result.feeds[0].url
('listparser blog', 'https://kurtmckee.org/tag/listparser')

更详细的文档可以在docs/目录中找到，也可以在线查看。

错误

难免会有错误。处理它们最好的方法是隔离出最简单的可能文档来找出错误，将该文档作为测试用例添加，然后找到并修复问题。

…你还可以只是报告错误，让其他人来解决问题，但这对你来说可能不会那么有趣！

错误可以在GitHub上报告.

Git工作流程

listparser基本上遵循git-flow方法

• 功能和更改在main分支的分支上开发。它们合并回main分支。

• 特性版本分支从main分支分离。项目元数据（如版本和版权年份）更新后，发布分支合并到releases分支。然后对releases分支进行标记，并将其合并回main。

• 热修复分支从releases分支分离。与特性版本一样，项目元数据更新，热修复分支合并回releases分支，然后对其进行标记并合并回main。

开发

要设置开发环境，请在命令行中按照以下步骤操作

# Set up a virtual environment.
python -m venv .venv

# Activate the virtual environment in Linux:
. .venv/bin/activate

# ...or in Windows Powershell:
& .venv/Scripts/Activate.ps1

# Install dependencies.
python -m pip install -U pip setuptools wheel
python -m pip install poetry pre-commit tox scriv
poetry install --all-extras

# Enable pre-commit.
pre-commit install

# Run the unit tests.
tox

提交PR时，务必创建和编辑变更日志片段。

scriv create

变更日志片段将创建在changelog.d/目录中。编辑文件以描述你所做的更改。