precis-i18n 1.0.1

用法

使用get_profile函数获取配置文件对象，然后使用 它的enforce方法。enforce方法返回Unicode字符串。

>>> from precis_i18n import get_profile
>>> username = get_profile('UsernameCaseMapped')
>>> username.enforce('Kevin')
'kevin'
>>> username.enforce('\u212Aevin')
'kevin'
>>> username.enforce('\uFF2Bevin')
'kevin'
>>> username.enforce('\U0001F17Aevin')
Traceback (most recent call last):
    ...
UnicodeEncodeError: 'UsernameCaseMapped' codec can't encode character '\U0001f17a' in position 0: DISALLOWED/symbols

或者，可以使用pythonstr.encodeapi。导入 precis_i18n.codec注册precis编解码器名称的模块。现在你 可以对任何unicode字符串使用str.encode方法。结果 如果 不允许使用字符串。

>>> import precis_i18n.codec
>>> 'Kevin'.encode('UsernameCasePreserved')
b'Kevin'
>>> '\u212Aevin'.encode('UsernameCasePreserved')
b'Kevin'
>>> '\uFF2Bevin'.encode('UsernameCasePreserved')
b'Kevin'
>>> '\u212Aevin'.encode('UsernameCaseMapped')
b'kevin'
>>> '\uFF2Bevin'.encode('OpaqueString')
b'\xef\xbc\xabevin'
>>> '\U0001F17Aevin'.encode('UsernameCasePreserved')
Traceback (most recent call last):
    ...
UnicodeEncodeError: 'UsernameCasePreserved' codec can't encode character '\U0001f17a' in position 0: DISALLOWED/symbols

支持的配置文件和编解码器

每个precis配置文件都有相应的编解码器名称。那CaseMapped variant将字符串转换为小写以实现 不区分大小写的比较。

• 保留用户名案例
• usernamecasemapped
• 不透明字符串
• 保留昵称case
• 昵称casemapped

CaseMapped配置文件根据最新的rfc使用unicodeToLower。上一个 这个包的版本使用Unicode默认大小写折叠。有casemapped变体 对于不同的情况转换。这些配置文件名称已弃用：

• usernamecasemapped:tolower
• 用户名casemapped:casefold
• 昵称casemapped:tolower
• 昵称casemapped:casefold

precis基字符串类也可用作编解码器：

• 标识类
• FreeformClass

用户部分和空格分隔的用户名

此实现中的用户名配置文件不允许空格。用户名 配置文件对应于RFC 8265中“用户部件”的定义。如果你想的话 允许应用程序用户名中有空格，必须先拆分字符串。

def enforce_app_username(name):
    profile = precis_i18n.get_profile('UsernameCasePreserved')
    userparts = [profile.enforce(userpart) for userpart in name.split(' ')]
    return ' '.join(userparts)

注意，这样构造的用户名可以在 单独的用户部分。

错误消息

如果字符串 是不允许的。reason字段指定错误的类型。