[AutoPR] cognitiveservices/data-plane/ComputerVision

azure-cognitiveservices-vision-computervision/HISTORY.rst

@@ -3,6 +3,48 @@
 Release History
 ===============
 
+0.2.0 (2018-06-22)
+++++++++++++++++++
+
+**Features**
+
+- analyze_image now support 'en', 'es', 'ja', 'pt', 'zh' (including "in_stream" version of these operations)
+- describe_image/tag_image/analyze_image_by_domain now support the language parameter (including "in_stream" version of these operations)
+- Client class can be used as a context manager to keep the underlying HTTP session open for performance
+
+**Bug fixes**
+
+- Fix several invalid JSON description, that was raising unexpected exceptions (including OCRResult from bug #2614)
+
+**Breaking changes**
+
+- recognize_text "detect_handwriting" boolean is now a "mode" str between 'Handwritten' and 'Printed'
+
+**General Breaking changes**
+
+This version uses a next-generation code generator that *might* introduce breaking changes.
+
+- Model signatures now use only keyword-argument syntax. All positional arguments must be re-written as keyword-arguments.
+  To keep auto-completion in most cases, models are now generated for Python 2 and Python 3. Python 3 uses the "*" syntax for keyword-only arguments.
+- Enum types now use the "str" mixin (class AzureEnum(str, Enum)) to improve the behavior when unrecognized enum values are encountered.
+  While this is not a breaking change, the distinctions are important, and are documented here:
+  https://docs.python.org/3/library/enum.html#others
+  At a glance:
+
+  - "is" should not be used at all.
+  - "format" will return the string value, where "%s" string formatting will return `NameOfEnum.stringvalue`. Format syntax should be prefered.
+
+- New Long Running Operation:
+
+  - Return type changes from `msrestazure.azure_operation.AzureOperationPoller` to `msrest.polling.LROPoller`. External API is the same.
+  - Return type is now **always** a `msrest.polling.LROPoller`, regardless of the optional parameters used.
+  - The behavior has changed when using `raw=True`. Instead of returning the initial call result as `ClientRawResponse`, 
+    without polling, now this returns an LROPoller. After polling, the final resource will be returned as a `ClientRawResponse`.
+  - New `polling` parameter. The default behavior is `Polling=True` which will poll using ARM algorithm. When `Polling=False`,
+    the response of the initial call will be returned without polling.
+  - `polling` parameter accepts instances of subclasses of `msrest.polling.PollingMethod`.
+  - `add_done_callback` will no longer raise if called after polling is finished, but will instead execute the callback right away.
+
 0.1.0 (2018-01-23)
 ++++++++++++++++++
 

azure-cognitiveservices-vision-computervision/README.rst

@@ -3,13 +3,7 @@ Microsoft Azure SDK for Python
 
 This is the Microsoft Azure Cognitive Services Computer Vision Client Library.
 
-Azure Resource Manager (ARM) is the next generation of management APIs that
-replace the old Azure Service Management (ASM).
-
-This package has been tested with Python 2.7, 3.3, 3.4, 3.5 and 3.6.
-
-For the older Azure Service Management (ASM) libraries, see
-`azure-servicemanagement-legacy <https://pypi.python.org/pypi/azure-servicemanagement-legacy>`__ library.
+This package has been tested with Python 2.7, 3.4, 3.5 and 3.6.
 
 For a more complete set of Azure libraries, see the `azure <https://pypi.python.org/pypi/azure>`__ bundle package.
 
@@ -33,6 +27,14 @@ If you see azure==0.11.0 (or any version below 1.0), uninstall it first:
     pip uninstall azure
 
 
+Usage
+=====
+
+For code examples, see `Cognitive Services Computer Vision
+<https://docs.microsoft.com/python/api/overview/azure/cognitive-services>`__
+on docs.microsoft.com.
+
+
 Provide Feedback
 ================