laurelin-ldap 2.0.4

功能概述

• 完全符合RFC 4510及其子标准，以及几个其他相关标准。

• 针对CPython 2.7，3.4 - 3.7，PyPy和PyPy3进行了测试。

• 简化过滤语法（可选，完全支持标准过滤语法，默认使用）

• Pythonic属性输入和展示。它只是一个字典。

• 极其简单的相对搜索。所有对象都有一系列搜索方法，这些方法会自动将对象的DN作为搜索基准。在许多情况下，您不需要向搜索方法传递任何参数。

• 同样，所有对象都有一系列修改方法，允许您在不重新传递DN的情况下修改已查询对象的属性。

• 您永远不需要输入完整的绝对DN。

• 智能修改不会将现有属性值发送到服务器，也不会请求删除不存在的属性值。这可以防止许多不必要的服务器错误。Laurelin会在修改对象之前为您查询对象，以确保您不会看到无意义的错误（如果需要的话）。

• 完全支持通过配置文件配置Laurelin和连接到服务器

• 自定义验证。您可以定义验证器，在将新对象和修改操作发送到服务器之前检查它们是否正确。由于您控制这段代码，这可以是针对特定属性值的简单正则表达式检查，也可以是复杂的审批队列机制。

• 高度可扩展。新方法可以轻松且安全地绑定到基类。

• 无缝集成控件。一旦定义，这些就只是特定方法的新关键字参数和响应对象的额外属性。

• 包括Python实现的标准模式元素。

依赖信息

Laurelin遵循SemVer。当您将laurelin-ldap添加到您的需求时，我强烈建议使用与您最初使用的major.minor兼容的发布操作符。例如

% pip install laurelin-ldap
...
Successfully installed laurelin-ldap-1.5.0 ...
                                     ^^^

由于安装了1.5.0，请将以下内容添加到您的requirements.txt和/或install_requires列表中

laurelin-ldap~=1.5

但当然，使用您实际安装的任何版本。您也可以使用pip freeze，但是修补和次要版本总是兼容的。修补版本通常会包含重要的修复。如果您确定您不希望出现新功能，只希望修复，您仍然可以使用兼容发布操作符，如下所示（再次替换为您的实际安装版本）

laurelin-ldap~=1.5.0

如有任何问题或疑虑，请随时在GitHub上提交问题。

公共API定义

• laurelin.ldap.__all__中的所有内容 - 尽可能直接从laurelin.ldap导入

• laurelin.ldap.exceptions

• laurelin.ldap.rfc*

• laurelin.ldap.protoutils

• laurelin.ldap.config

在laurelin.extensions中定义的内置扩展在通过其LaurelinExtension、LaurelinLDAPExtension和LaurelinLDAPObjectExtension实例提供的接口方面是稳定的，这些接口控制关键字和响应属性以及模式元素的可用性。不建议直接导入扩展，并且扩展模块中的任何其他对象不应被视为稳定。

任何在laurelin源代码中硬编码的第三方扩展名称的稳定性无法保证，包括在laurelin.ldap.extensible.base.Extensible.AVAILABLE_EXTENSIONS或任何未来的位置。目前没有定义第三方扩展）。为了确保不使用任何第三方扩展，并因此提供完全的稳定性保证，设置LDAP.DEFAULT_BUILT_IN_EXTENSIONS_ONLY = True或将built_in_extensions_only=True传递给您的LDAP()构造函数。

如果用户应该冒险进入声明公共API之上的其他模块，我强烈建议固定您的版本。我也强烈建议永远不要调用私有函数或方法（以下划线前缀）。