azure-cognitiveservices-search-newssearch 2.0.0

2.0.0 (2020-01-12)

破坏性更改

• NewsSearchAPI主要客户端已重命名为NewsSearchClient

通用破坏性更改

本版本使用下一代代码生成器，可能会因为某些导入而引入破坏性更改。简而言之，一些模块的可见性/导入不正确，并且已经被重命名。这解决了由于使用本不该使用的类而引起的一些问题。无法再从 azure.cognitiveservices.search.newssearch.news_search_api 导入 NewsSearchClient（从 azure.cognitiveservices.search.newssearch 导入仍然像以前一样工作） NewsSearchClientConfiguration 的导入已从 azure.cognitiveservices.search.newssearch.news_search_api 移动到 azure.cognitiveservices.search.newssearch。来自“models”子模块的模型 MyClass 无法再使用 azure.cognitiveservices.search.newssearch.models.my_class 导入（从 azure.cognitiveservices.search.newssearch.models 导入仍然像以前一样工作）来自操作子模块的操作类 MyClassOperations 无法再使用 azure.cognitiveservices.search.newssearch.operations.my_class_operations 导入（从 azure.cognitiveservices.search.newssearch.operations 导入仍然像以前一样工作）最后但并非最不重要的是，HTTP 连接池现在默认启用。您应该始终将客户端用作上下文管理器，或调用 close()，或每个进程不超过一个客户端。

1.0.0 (2018-05-02)

新功能

• 客户端类可以用作上下文管理器以保持底层 HTTP 会话打开以获得性能

通用破坏性更改

本版本使用下一代代码生成器可能会引入破坏性更改。

• 模型签名现在只使用关键字参数语法。所有位置参数都必须重写为关键字参数。为了在大多数情况下保持自动完成，现在为 Python 2 和 Python 3 生成模型。Python 3 使用“*”语法表示关键字仅参数。

• 枚举类型现在使用“str”混入（类 AzureEnum(str, Enum)）来改善遇到未识别枚举值时的行为。尽管这不是破坏性更改，但这些区别很重要，并且在此处进行了记录：https://docs.pythonlang.cn/3/library/enum.html#others 简要说明

  • “is”不应使用。

  • “format”将返回字符串值，其中“%s”字符串格式化将返回NameOfEnum.stringvalue。应优先使用格式语法。

• 新长时间运行的操作

  • 返回类型从 msrestazure.azure_operation.AzureOperationPoller 更改为 msrest.polling.LROPoller。外部 API 与之前相同。

  • 返回类型现在是 始终 一个 msrest.polling.LROPoller，无论使用哪些可选参数。

  • 使用 raw=True 时的行为已更改。现在不是以无轮询的方式返回初始调用结果作为 ClientRawResponse，而是返回一个 LROPoller。轮询后，最终资源将作为 ClientRawResponse 返回。

  • 新增 polling 参数。默认行为是 Polling=True，它将使用 ARM 算法进行轮询。当 Polling=False 时，将返回初始调用的响应而不进行轮询。

  • polling 参数接受 msrest.polling.PollingMethod 子类的实例。

  • add_done_callback 在轮询完成后调用将不再引发异常，而是立即执行回调。

0.1.0 (2018-01-12)

• 初始发布