fix(nlu): remove summarization param

BREAKING CHANGE: change training_data_content_type default to None

Author: apaparazzi0329

ibm_watson/natural_language_understanding_v1.py

@@ -24,15 +24,6 @@
 models](https://cloud.ibm.com/docs/natural-language-understanding?topic=natural-language-understanding-customizing)
 with Watson Knowledge Studio to detect custom entities and relations in Natural Language
 Understanding.
-IBM is sunsetting Watson Natural Language Understanding Custom Sentiment (BETA). From
-**June 3, 2023** onward, you will no longer be able to use the Custom Sentiment
-feature.<br /><br />To ensure we continue providing our clients with robust and powerful
-text classification capabilities, IBM recently announced the general availability of a new
-[single-label text classification
-capability](https://cloud.ibm.com/docs/natural-language-understanding?topic=natural-language-understanding-classifications).
-This new feature includes extended language support and training data customizations
-suited for building a custom sentiment classifier.<br /><br />If you would like more
-information or further guidance, please contact IBM Cloud Support.{: deprecated}
 
 API Version: 1.0
 See: https://cloud.ibm.com/docs/natural-language-understanding
@@ -122,7 +113,6 @@ def analyze(
         - Semantic roles
         - Sentiment
         - Syntax
-        - Summarization (Experimental)
         If a language for the input text is not specified with the `language` parameter,
         the service [automatically detects the
         language](https://cloud.ibm.com/docs/natural-language-understanding?topic=natural-language-understanding-detectable-languages).
@@ -312,7 +302,7 @@ def create_categories_model(
         language: str,
         training_data: BinaryIO,
         *,
-        training_data_content_type: Optional[str] = 'application/json',
+        training_data_content_type: Optional[str] = None,
         name: Optional[str] = None,
         user_metadata: Optional[dict] = None,
         description: Optional[str] = None,
@@ -499,7 +489,7 @@ def update_categories_model(
         language: str,
         training_data: BinaryIO,
         *,
-        training_data_content_type: Optional[str] = 'application/json',
+        training_data_content_type: Optional[str] = None,
         name: Optional[str] = None,
         user_metadata: Optional[dict] = None,
         description: Optional[str] = None,
@@ -653,7 +643,7 @@ def create_classifications_model(
         language: str,
         training_data: BinaryIO,
         *,
-        training_data_content_type: Optional[str] = 'application/json',
+        training_data_content_type: Optional[str] = None,
         name: Optional[str] = None,
         user_metadata: Optional[dict] = None,
         description: Optional[str] = None,
@@ -849,7 +839,7 @@ def update_classifications_model(
         language: str,
         training_data: BinaryIO,
         *,
-        training_data_content_type: Optional[str] = 'application/json',
+        training_data_content_type: Optional[str] = None,
         name: Optional[str] = None,
         user_metadata: Optional[dict] = None,
         description: Optional[str] = None,
@@ -3632,10 +3622,6 @@ class Features:
           `keywords.sentiment`.
            Supported languages: Arabic, English, French, German, Italian, Japanese,
           Korean, Portuguese, Russian, Spanish.
-    :param SummarizationOptions summarization: (optional) (Experimental) Returns a
-          summary of content.
-          Supported languages: English only.
-          Supported regions: Dallas region only.
     :param CategoriesOptions categories: (optional) Returns a hierarchical taxonomy
           of the content. The top three categories are returned by default.
           Supported languages: Arabic, English, French, German, Italian, Japanese, Korean,
@@ -3656,7 +3642,6 @@ def __init__(
         relations: Optional['RelationsOptions'] = None,
         semantic_roles: Optional['SemanticRolesOptions'] = None,
         sentiment: Optional['SentimentOptions'] = None,
-        summarization: Optional['SummarizationOptions'] = None,
         categories: Optional['CategoriesOptions'] = None,
         syntax: Optional['SyntaxOptions'] = None,
     ) -> None:
@@ -3707,10 +3692,6 @@ def __init__(
                and for keywords with `keywords.sentiment`.
                 Supported languages: Arabic, English, French, German, Italian, Japanese,
                Korean, Portuguese, Russian, Spanish.
-        :param SummarizationOptions summarization: (optional) (Experimental)
-               Returns a summary of content.
-               Supported languages: English only.
-               Supported regions: Dallas region only.
         :param CategoriesOptions categories: (optional) Returns a hierarchical
                taxonomy of the content. The top three categories are returned by default.
                Supported languages: Arabic, English, French, German, Italian, Japanese,
@@ -3727,7 +3708,6 @@ def __init__(
         self.relations = relations
         self.semantic_roles = semantic_roles
         self.sentiment = sentiment
-        self.summarization = summarization
         self.categories = categories
         self.syntax = syntax
 
@@ -3755,9 +3735,6 @@ def from_dict(cls, _dict: Dict) -> 'Features':
                 semantic_roles)
         if (sentiment := _dict.get('sentiment')) is not None:
             args['sentiment'] = SentimentOptions.from_dict(sentiment)
-        if (summarization := _dict.get('summarization')) is not None:
-            args['summarization'] = SummarizationOptions.from_dict(
-                summarization)
         if (categories := _dict.get('categories')) is not None:
             args['categories'] = CategoriesOptions.from_dict(categories)
         if (syntax := _dict.get('syntax')) is not None:
@@ -3815,11 +3792,6 @@ def to_dict(self) -> Dict:
                 _dict['sentiment'] = self.sentiment
             else:
                 _dict['sentiment'] = self.sentiment.to_dict()
-        if hasattr(self, 'summarization') and self.summarization is not None:
-            if isinstance(self.summarization, dict):
-                _dict['summarization'] = self.summarization
-            else:
-                _dict['summarization'] = self.summarization.to_dict()
         if hasattr(self, 'categories') and self.categories is not None:
             if isinstance(self.categories, dict):
                 _dict['categories'] = self.categories
@@ -5619,66 +5591,6 @@ def __ne__(self, other: 'SentimentResult') -> bool:
         return not self == other
 
 
-class SummarizationOptions:
-    """
-    (Experimental) Returns a summary of content.
-    Supported languages: English only.
-    Supported regions: Dallas region only.
-
-    :param int limit: (optional) Maximum number of summary sentences to return.
-    """
-
-    def __init__(
-        self,
-        *,
-        limit: Optional[int] = None,
-    ) -> None:
-        """
-        Initialize a SummarizationOptions object.
-
-        :param int limit: (optional) Maximum number of summary sentences to return.
-        """
-        self.limit = limit
-
-    @classmethod
-    def from_dict(cls, _dict: Dict) -> 'SummarizationOptions':
-        """Initialize a SummarizationOptions object from a json dictionary."""
-        args = {}
-        if (limit := _dict.get('limit')) is not None:
-            args['limit'] = limit
-        return cls(**args)
-
-    @classmethod
-    def _from_dict(cls, _dict):
-        """Initialize a SummarizationOptions object from a json dictionary."""
-        return cls.from_dict(_dict)
-
-    def to_dict(self) -> Dict:
-        """Return a json dictionary representing this model."""
-        _dict = {}
-        if hasattr(self, 'limit') and self.limit is not None:
-            _dict['limit'] = self.limit
-        return _dict
-
-    def _to_dict(self):
-        """Return a json dictionary representing this model."""
-        return self.to_dict()
-
-    def __str__(self) -> str:
-        """Return a `str` version of this SummarizationOptions object."""
-        return json.dumps(self.to_dict(), indent=2)
-
-    def __eq__(self, other: 'SummarizationOptions') -> bool:
-        """Return `true` when self and other are equal, false otherwise."""
-        if not isinstance(other, self.__class__):
-            return False
-        return self.__dict__ == other.__dict__
-
-    def __ne__(self, other: 'SummarizationOptions') -> bool:
-        """Return `true` when self and other are not equal, false otherwise."""
-        return not self == other
-
-
 class SyntaxOptions:
     """
     Returns tokens and sentences from the input text.

test/unit/test_natural_language_understanding_v1.py

@@ -136,10 +136,6 @@ def test_analyze_all_params(self):
         sentiment_options_model['document'] = True
         sentiment_options_model['targets'] = ['testString']
 
-        # Construct a dict representation of a SummarizationOptions model
-        summarization_options_model = {}
-        summarization_options_model['limit'] = 3
-
         # Construct a dict representation of a CategoriesOptions model
         categories_options_model = {}
         categories_options_model['explanation'] = False
@@ -167,7 +163,6 @@ def test_analyze_all_params(self):
         features_model['relations'] = relations_options_model
         features_model['semantic_roles'] = semantic_roles_options_model
         features_model['sentiment'] = sentiment_options_model
-        features_model['summarization'] = summarization_options_model
         features_model['categories'] = categories_options_model
         features_model['syntax'] = syntax_options_model
 
@@ -281,10 +276,6 @@ def test_analyze_value_error(self):
         sentiment_options_model['document'] = True
         sentiment_options_model['targets'] = ['testString']
 
-        # Construct a dict representation of a SummarizationOptions model
-        summarization_options_model = {}
-        summarization_options_model['limit'] = 3
-
         # Construct a dict representation of a CategoriesOptions model
         categories_options_model = {}
         categories_options_model['explanation'] = False
@@ -312,7 +303,6 @@ def test_analyze_value_error(self):
         features_model['relations'] = relations_options_model
         features_model['semantic_roles'] = semantic_roles_options_model
         features_model['sentiment'] = sentiment_options_model
-        features_model['summarization'] = summarization_options_model
         features_model['categories'] = categories_options_model
         features_model['syntax'] = syntax_options_model
 
@@ -2787,9 +2777,6 @@ def test_features_serialization(self):
         sentiment_options_model['document'] = True
         sentiment_options_model['targets'] = ['testString']
 
-        summarization_options_model = {}  # SummarizationOptions
-        summarization_options_model['limit'] = 3
-
         categories_options_model = {}  # CategoriesOptions
         categories_options_model['explanation'] = False
         categories_options_model['limit'] = 3
@@ -2814,7 +2801,6 @@ def test_features_serialization(self):
         features_model_json['relations'] = relations_options_model
         features_model_json['semantic_roles'] = semantic_roles_options_model
         features_model_json['sentiment'] = sentiment_options_model
-        features_model_json['summarization'] = summarization_options_model
         features_model_json['categories'] = categories_options_model
         features_model_json['syntax'] = syntax_options_model
 
@@ -3639,36 +3625,6 @@ def test_sentiment_result_serialization(self):
         assert sentiment_result_model_json2 == sentiment_result_model_json
 
 
-class TestModel_SummarizationOptions:
-    """
-    Test Class for SummarizationOptions
-    """
-
-    def test_summarization_options_serialization(self):
-        """
-        Test serialization/deserialization for SummarizationOptions
-        """
-
-        # Construct a json representation of a SummarizationOptions model
-        summarization_options_model_json = {}
-        summarization_options_model_json['limit'] = 3
-
-        # Construct a model instance of SummarizationOptions by calling from_dict on the json representation
-        summarization_options_model = SummarizationOptions.from_dict(summarization_options_model_json)
-        assert summarization_options_model != False
-
-        # Construct a model instance of SummarizationOptions by calling from_dict on the json representation
-        summarization_options_model_dict = SummarizationOptions.from_dict(summarization_options_model_json).__dict__
-        summarization_options_model2 = SummarizationOptions(**summarization_options_model_dict)
-
-        # Verify the model instances are equivalent
-        assert summarization_options_model == summarization_options_model2
-
-        # Convert model instance back to dict and verify no loss of data
-        summarization_options_model_json2 = summarization_options_model.to_dict()
-        assert summarization_options_model_json2 == summarization_options_model_json
-
-
 class TestModel_SyntaxOptions:
     """
     Test Class for SyntaxOptions