Launchpad doctests的样式检查器。
项目描述
lp-lint-doctest 是一个用于存储在文本文件中(与存储在docstrings中的doctests相对)的 Python doctests 的样式检查器,优化用于 Launchpad开发。它执行以下检查
注释应位于doctest的叙述部分(即未缩进的文本)而不是Python示例中。
叙述文本行限制为79个字符。
示例中的源行(以>>> 或 ... 开头)限制为71个字符。
示例中的预期输出行限制为75个字符。
源和预期输出行应缩进四个空格。
不应有尾随空格。
应使用reStructuredText风格的标题,而不是MoinMoin风格。
在示例中的任何源行中添加 # noqa 注释可以抑制该示例中所有行的注释、行长度、缩进和尾随空格检查。
此外,lp-lint-doctest 对每个 doctest 文件的累积源代码运行 pyflakes。
本项目是从 Curtis Hovey 的 pocket-lint 项目中拆分出来的。自那时以来,许多其他优秀的 linters 已经出现,支持 pocket-lint 支持的大多数其他源类型,但似乎没有其他可行的替代品来替代其 doctest 检查。
lp-lint-doctest 支持 pre-commit。要使用它,请将以下内容添加到您的 .pre-commit-config.yaml 文件的 repos 部分
- repo: https://git.launchpad.net/lp-lint-doctest rev: '' # pick a git tag to point to hooks: - id: lp-lint-doctest
如果您需要添加自定义 doctest 选项标志,请添加 args: [--allow-option-flag, MY_CUSTOM_FLAG_NAME]。
lp-lint-doctest 的 NEWS
0.5 (2022-09-09)
将行长度限制提高到 79 个字符,这与 Launchpad 的 black 配置更匹配。
0.4 (2021-10-27)
默认情况下在 types: [rst] 上运行。这对于除 Launchpad 本身之外的其他存储库的使用是一个更好的默认设置(可以覆盖此设置)。
宣布支持 Python 3.10。
0.3 (2021-07-27)
允许 # noqa 注释同时抑制注释检查。
0.2 (2021-07-25)
添加 --allow-option-flag 命令行选项以注册自定义 doctest 选项标志。
如果示例中的源行包含 doctest 指令,则允许在源行中包含注释。
通过在示例的任何源行中添加 # noqa 注释来抑制示例的检查。
0.1 (2021-07-24)
初始发布,从 pocket-lint 中拆分出来。
项目详情
下载文件
下载适合您平台的文件。如果您不确定选择哪个,请了解更多关于 安装软件包 的信息。
源分布
构建分布
lp-lint-doctest-0.5.tar.gz 的哈希值
算法 | 哈希摘要 | |
---|---|---|
SHA256 | 98c7abddabe367093f54630f3dbaa159158e41d3d1e468aef7afb2c869b995fa |
|
MD5 | e30a7b9486c549970dc45f560740f023 |
|
BLAKE2b-256 | d6e27d366a09b3577eb6e5fa5513913bf7cd29fbb8ae2ce3b20bfcd5cec9f9fc |
lp_lint_doctest-0.5-py3-none-any.whl 的哈希值
算法 | 哈希摘要 | |
---|---|---|
SHA256 | 9552a7ee5151f1d2fe279a756f25a06018d9befc44817ae7dd7702e8149ea952 |
|
MD5 | 4156a515cea947752ea08848738573bd |
|
BLAKE2b-256 | 54df7c1ce5c2e4f58839a5316c6b9926d08c97b9158a4b917e966680227dea5c |