[TA] beta updates (Azure#28291)

* rename AbstractSummaryAction.sentence_count -> max_sentence_count to match ext summ

* add bespoke methods for abs and ext summ

* fix docs, remove copy/paste error

* add tests + recordings

* add docstrings to patched resolutions

* fix docstrings

* autoLD design change

* architect feedback

* fix import

* update recordings

* do not expose BooleanResolution, not supported by TA

* update changelog

Author: kristapratico

sdk/textanalytics/azure-ai-textanalytics/CHANGELOG.md

@@ -2,10 +2,22 @@
 
 ## 5.3.0b2 (Unreleased)
 
+This version of the client library defaults to the service API version `2022-10-01-preview`.
+
 ### Features Added
 
+- Added `begin_extract_summary` client method to perform extractive summarization on documents.
+- Added `begin_abstract_summary` client method to perform abstractive summarization on documents.
+
 ### Breaking Changes
 
+- Removed models `BaseResolution` and `BooleanResolution`.
+- Renamed property `date_time_sub_kind` to `datetime_subkind` on `DateTimeResolution`.
+- Renamed keyword argument `sentence_count` to `max_sentence_count` on `AbstractSummaryAction`.
+- Changed automatic language detection, it is now controlled by the boolean keyword argument `auto_detect_language`.
+  Pass `True` to enable automatic language detection for text documents analyzed by long-running operation APIs.
+- Removed keyword argument `autodetect_default_language` - use `language` to provide a default/fallback language.
+
 ### Bugs Fixed
 
 ### Other Changes

sdk/textanalytics/azure-ai-textanalytics/assets.json

@@ -2,5 +2,5 @@
   "AssetsRepo": "Azure/azure-sdk-assets",
   "AssetsRepoPrefixPath": "python",
   "TagPrefix": "python/textanalytics/azure-ai-textanalytics",
-  "Tag": "python/textanalytics/azure-ai-textanalytics_8fc6958f17"
+  "Tag": "python/textanalytics/azure-ai-textanalytics_e6c8127cc8"
 }

sdk/textanalytics/azure-ai-textanalytics/azure/ai/textanalytics/__init__.py

@@ -68,11 +68,9 @@
 )
 from ._generated.models import (
     HealthcareDocumentType,
-    BaseResolution,
     ResolutionKind,
     AgeResolution,
     AreaResolution,
-    BooleanResolution,
     CurrencyResolution,
     DateTimeResolution,
     InformationResolution,
@@ -162,11 +160,9 @@
     "ExtractSummaryResult",
     "SummarySentence",
     "HealthcareDocumentType",
-    "BaseResolution",
     "ResolutionKind",
     "AgeResolution",
     "AreaResolution",
-    "BooleanResolution",
     "CurrencyResolution",
     "DateTimeResolution",
     "InformationResolution",

sdk/textanalytics/azure-ai-textanalytics/azure/ai/textanalytics/_dict_mixin.py

@@ -3,7 +3,7 @@
 # Licensed under the MIT License.
 # ------------------------------------
 
-from typing import Any, List, Tuple, Optional, Iterable
+from typing import Any, Tuple, Optional, Iterable
 
 
 class DictMixin:
@@ -17,7 +17,7 @@ def __repr__(self) -> str:
         return str(self)
 
     def __len__(self) -> int:
-        return len(self.keys())
+        return len(self.keys())  # type: ignore
 
     def __delitem__(self, key: str) -> None:
         self.__dict__[key] = None
@@ -42,10 +42,10 @@ def has_key(self, k: str) -> bool:
     def update(self, *args: Any, **kwargs: Any) -> None:
         self.__dict__.update(*args, **kwargs)
 
-    def keys(self) -> List[str]:
+    def keys(self) -> Iterable[str]:
         return [k for k in self.__dict__ if not k.startswith("_")]
 
-    def values(self) -> List[Any]:
+    def values(self) -> Iterable[Any]:
         return [v for k, v in self.__dict__.items() if not k.startswith("_")]
 
     def items(self) -> Iterable[Tuple[str, Any]]:

sdk/textanalytics/azure-ai-textanalytics/azure/ai/textanalytics/_generated/v2022_10_01_preview/models/__init__.py

@@ -15,7 +15,7 @@
 from ._models_py3 import AbstractiveSummary
 from ._models_py3 import AbstractiveSummaryDocumentResult
 from ._models_py3 import AbstractiveSummaryDocumentResultWithDetectedLanguage
-from ._models_py3 import AgeResolution
+from ._patch import AgeResolution
 from ._models_py3 import AnalyzeTextDynamicClassificationInput
 from ._models_py3 import AnalyzeTextEntityLinkingInput
 from ._models_py3 import AnalyzeTextEntityRecognitionInput
@@ -30,12 +30,12 @@
 from ._models_py3 import AnalyzeTextSentimentAnalysisInput
 from ._models_py3 import AnalyzeTextTask
 from ._models_py3 import AnalyzeTextTaskResult
-from ._models_py3 import AreaResolution
+from ._patch import AreaResolution
 from ._models_py3 import BaseResolution
 from ._models_py3 import BooleanResolution
 from ._models_py3 import ClassificationDocumentResult
 from ._models_py3 import ClassificationResult
-from ._models_py3 import CurrencyResolution
+from ._patch import CurrencyResolution
 from ._models_py3 import CustomEntitiesLROTask
 from ._models_py3 import CustomEntitiesResult
 from ._models_py3 import CustomEntitiesResultDocumentsItem
@@ -51,7 +51,7 @@
 from ._models_py3 import CustomSingleLabelClassificationLROTask
 from ._models_py3 import CustomSingleLabelClassificationTaskParameters
 from ._models_py3 import CustomTaskParameters
-from ._models_py3 import DateTimeResolution
+from ._patch import DateTimeResolution
 from ._models_py3 import DetectedLanguage
 from ._models_py3 import DocumentDetectedLanguage
 from ._models_py3 import DocumentDetectedLanguageString
@@ -100,7 +100,7 @@
 from ._models_py3 import HealthcareRelationEntity
 from ._models_py3 import HealthcareResult
 from ._models_py3 import HealthcareTaskParameters
-from ._models_py3 import InformationResolution
+from ._patch import InformationResolution
 from ._models_py3 import InnerErrorModel
 from ._models_py3 import InputError
 from ._models_py3 import JobState
@@ -117,15 +117,15 @@
 from ._models_py3 import LanguageDetectionTaskParameters
 from ._models_py3 import LanguageDetectionTaskResult
 from ._models_py3 import LanguageInput
-from ._models_py3 import LengthResolution
+from ._patch import LengthResolution
 from ._models_py3 import LinkedEntitiesDocumentResult
 from ._models_py3 import LinkedEntity
 from ._models_py3 import Match
 from ._models_py3 import MultiLanguageAnalysisInput
 from ._models_py3 import MultiLanguageInput
-from ._models_py3 import NumberResolution
-from ._models_py3 import NumericRangeResolution
-from ._models_py3 import OrdinalResolution
+from ._patch import NumberResolution
+from ._patch import NumericRangeResolution
+from ._patch import OrdinalResolution
 from ._models_py3 import PIIResultWithDetectedLanguage
 from ._models_py3 import Pagination
 from ._models_py3 import PiiEntitiesDocumentResult
@@ -149,7 +149,7 @@
 from ._models_py3 import SentimentResponse
 from ._models_py3 import SentimentResponseDocumentsItem
 from ._models_py3 import SentimentTaskResult
-from ._models_py3 import SpeedResolution
+from ._patch import SpeedResolution
 from ._models_py3 import SummaryContext
 from ._models_py3 import TargetConfidenceScoreLabel
 from ._models_py3 import TargetRelation
@@ -158,10 +158,10 @@
 from ._models_py3 import TaskState
 from ._models_py3 import TasksState
 from ._models_py3 import TasksStateTasks
-from ._models_py3 import TemperatureResolution
-from ._models_py3 import TemporalSpanResolution
-from ._models_py3 import VolumeResolution
-from ._models_py3 import WeightResolution
+from ._patch import TemperatureResolution
+from ._patch import TemporalSpanResolution
+from ._patch import VolumeResolution
+from ._patch import WeightResolution
 
 
 from ._text_analytics_client_enums import AgeUnit

sdk/textanalytics/azure-ai-textanalytics/azure/ai/textanalytics/_generated/v2022_10_01_preview/models/_models_py3.py

@@ -2870,9 +2870,9 @@ class DateTimeResolution(BaseResolution):
      (https://github.com/Microsoft/Recognizers-Text/blob/master/Patterns/English/English-DateTime.yaml).
      Required.
     :vartype timex: str
-    :ivar date_time_sub_kind: The DateTime SubKind. Required. Known values are: "Time", "Date",
+    :ivar datetime_subkind: The DateTime SubKind. Required. Known values are: "Time", "Date",
      "DateTime", "Duration", and "Set".
-    :vartype date_time_sub_kind: str or
+    :vartype datetime_subkind: str or
      ~azure.ai.textanalytics.v2022_10_01_preview.models.DateTimeSubKind
     :ivar value: The actual time that the extracted text denote. Required.
     :vartype value: str
@@ -2886,14 +2886,14 @@ class DateTimeResolution(BaseResolution):
     _validation = {
         'resolution_kind': {'required': True},
         'timex': {'required': True},
-        'date_time_sub_kind': {'required': True},
+        'datetime_subkind': {'required': True},
         'value': {'required': True},
     }
 
     _attribute_map = {
         "resolution_kind": {"key": "resolutionKind", "type": "str"},
         "timex": {"key": "timex", "type": "str"},
-        "date_time_sub_kind": {"key": "dateTimeSubKind", "type": "str"},
+        "datetime_subkind": {"key": "dateTimeSubKind", "type": "str"},
         "value": {"key": "value", "type": "str"},
         "modifier": {"key": "modifier", "type": "str"},
     }
@@ -2902,7 +2902,7 @@ def __init__(
         self,
         *,
         timex: str,
-        date_time_sub_kind: Union[str, "_models.DateTimeSubKind"],
+        datetime_subkind: Union[str, "_models.DateTimeSubKind"],
         value: str,
         modifier: Optional[Union[str, "_models.TemporalModifier"]] = None,
         **kwargs
@@ -2912,9 +2912,9 @@ def __init__(
          (https://github.com/Microsoft/Recognizers-Text/blob/master/Patterns/English/English-DateTime.yaml).
          Required.
         :paramtype timex: str
-        :keyword date_time_sub_kind: The DateTime SubKind. Required. Known values are: "Time", "Date",
+        :keyword datetime_subkind: The DateTime SubKind. Required. Known values are: "Time", "Date",
          "DateTime", "Duration", and "Set".
-        :paramtype date_time_sub_kind: str or
+        :paramtype datetime_subkind: str or
          ~azure.ai.textanalytics.v2022_10_01_preview.models.DateTimeSubKind
         :keyword value: The actual time that the extracted text denote. Required.
         :paramtype value: str
@@ -2927,7 +2927,7 @@ def __init__(
         super().__init__(**kwargs)
         self.resolution_kind = 'DateTimeResolution'  # type: str
         self.timex = timex
-        self.date_time_sub_kind = date_time_sub_kind
+        self.datetime_subkind = datetime_subkind
         self.value = value
         self.modifier = modifier