password-policy 0.2.0

标题：密码策略库 API 布局：页面

该库提供了密码组合策略的机器可读表示。该库的最终目标是允许网站上传策略描述，然后让密码生成器下载并使用这些描述生成合规密码。

政策说明

使用以下对象PCP、PCPRule、PCPSubsetRequirement和定义策略PCPCharsetRequirement。还有一个SimplePCP用于创建简单策略的实用程序功能。

简单PCP

SimplePCP是用于创建 PCP 对象的快捷功能。与调用相同PCP([PCPRule(*args, **kwargs)])。

五氯苯酚

PCP是所有策略的根类。它包含以下信息。

库提供了两个字符集：

• DEFAULT_CHARSETS——包括小写字母（lower）、大写字母（upper）、数字（digits）和符号（symbols）。这使用 pythonstring包中定义的字符集。符号包括标点符号和空格。
• ALPHABET_CHARSETS— 相同，DEFAULT_CHARSETS只是小写和大写合并为一个字符集（字母表）。

该类PCP还提供了几个实用方法：

• validate()->None— 验证策略是自洽的。例如，检查它不需要比它允许的更多的字符。如果它们与策略有问题，则引发异常。
• dumps(**kwargs) -> str— 将策略转储到 JSON。尝试创建最简洁的表示。传递**kwargs给json.dumps，允许格式化输出。
• @staticmethod loads(s: str) -> PCP— 从提供的 JSON 加载 PCP 对象。

PCPR规则

PCPRule指定密码必须满足的一项或多项要求才能满足规则。必须满足所有要求才能满足规则。可能的要求是，

PCP子集要求

描述子集需求。

PCPCharset 要求

特定于映射字符集的要求。

默认字符集

DEFAULT_CHARSETS包含四个字符集：

• lower— 小写字母 (a–z)。
• upper— 大写字母 (A–Z)。
• digits— 数字 (0–9)。
• symbols— 所有 ASCII 符号，包括空格。

ALPHABET_CHARSETS包含三个字符集：

• alphabet— 小写字母 (a–z) 和大写字母 (A–Z)。
• digits— 数字 (0–9)。
• symbols— 所有 ASCII 符号，包括空格。

检查密码

该check_password(password: str, pcp: PCP) -> bool方法可用于根据策略检查密码。True如果密码与策略中的至少一个规则匹配，它将返回，False否则返回。

衡量政策强度

该库提供了两种方法来估计使用给定策略创建的密码强度：

• check_machine_strength(pcp: PCP) -> int- 估计密码生成器可以使用给定策略生成的密码数量，假设它生成的密码等于所需的最小密码min_length。
• check_human_strength(pcp: PCP, preferences: list[str]) -> int— 估计人类使用给定策略创建的密码强度。此方法假定人类将生成与所需的最小密码相等的密码min_length。此外，它假定用户将根据提供的首选项选择字符集（只要策略允许）。如果未设置，首选项默认为['lower', 'upper', 'digits', 'symbols'].

对于这两种方法，返回值都是估计可以生成的密码数量的一半。这样做是因为平均而言，生成的密码会在搜索一半的搜索空间后被猜到。