Merge pull request #954 from watson-developer-cloud/release-2.0

SDK Major Release 2.0
watson-developer-cloud · Mar 28, 2019 · 37e256d · 37e256d
2 parents 2656fb2 + 9194604
commit 37e256d
Show file tree

Hide file tree

Showing 513 changed files with 6,027 additions and 3,862 deletions.
diff --git a/.gitignore b/.gitignore
@@ -41,3 +41,5 @@ Carthage/
 # swagger-codegen
 .swagger-codegen-ignore
 .swagger-codegen/
+.openapi-generator-ignore
+.openapi-generator/
diff --git a/.releaserc b/.releaserc
@@ -3,10 +3,6 @@
   "verifyConditions": [],
   "tagFormat": "${version}",
   "prepare": [
-    {
-      "path": "@semantic-release/changelog",
-      "changelogFile": "CHANGELOG.md",
-    },
     "@semantic-release/git",
     {
       "path": "@semantic-release/exec",

diff --git a/.swift-version b/.swift-version
diff --git a/.travis.yml b/.travis.yml
@@ -1,8 +1,4 @@
 osx_image: xcode10.1
-branches:
-  only:
-    - master
-    - develop
 jobs:
   include:
     - stage: test Linux

diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,3 +1,22 @@
+
+# [2.0.0](https://github.com/watson-developer-cloud/swift-sdk/compare/1.4.0...2.0.0) (2019-03-28)
+
+
+### Features
+
+* **All:**
+  * Version moved to first parameter of init methods for basic authentication
+  * Credentials file support in the intializer dropped for iOS. Only supported in Linux
+  * Error response handling reworked for consistency across services and languages
+  * Ordering of parameters in some methods has changed due to migration of the API docs and generator to OpenAPI 3.0
+  * File-type parameters are now defined as `Data` rather than `URL`
+* **AssistantV1:**
+  * Some model classes have been merged / simplified
+  * The `InputData` class has been renamed to `MessageInput`
+* **SpeechToTextV1:** 
+  * The `recognizeWithWebsockets` method has been revised to accept a `RecognizeCallback` object with `onResults` and `onError` callback properties
+
+
 # [1.4.0](https://github.com/watson-developer-cloud/swift-sdk/compare/1.3.1...1.4.0) (2019-02-12)
 
 

diff --git a/Cartfile b/Cartfile
@@ -1,2 +1,2 @@
 github "daltoniam/Starscream" == 3.0.5
-github "watson-developer-cloud/restkit" ~> 2.0.0
+github "watson-developer-cloud/restkit" ~> 3.0
diff --git a/Cartfile.resolved b/Cartfile.resolved
@@ -1,2 +1,2 @@
 github "daltoniam/Starscream" "3.0.5"
-github "watson-developer-cloud/restkit" "2.0.0"
+github "watson-developer-cloud/restkit" "3.0.0"
diff --git a/IBMWatsonAssistantV1.podspec b/IBMWatsonAssistantV1.podspec
@@ -4,7 +4,7 @@ Pod::Spec.new do |s|
   s.version               = '1.4.0'
   s.summary               = 'Client framework for the IBM Watson Assistant service'
   s.description           = <<-DESC
-With the IBM Watson™ Assistant service, you can build a solution that understands 
+With the IBM Watson™ Assistant service, you can build a solution that understands
 natural-language input and uses machine learning to respond to customers in a way that simulates a conversation between humans.
                             DESC
   s.homepage              = 'https://www.ibm.com/watson/ai-assistant/'
@@ -15,11 +15,12 @@ natural-language input and uses machine learning to respond to customers in a wa
   s.module_name           = 'Assistant'
   s.ios.deployment_target = '10.0'
   s.source                = { :git => 'https://github.com/watson-developer-cloud/swift-sdk.git', :tag => s.version.to_s }
-  
+
   s.source_files          = 'Source/AssistantV1/**/*.swift',
                             'Source/SupportingFiles/Shared.swift'
   s.exclude_files         = 'Source/AssistantV1/Shared.swift'
 
-  s.dependency              'IBMWatsonRestKit', '~> 2.0.0'
-
+  s.swift_version         = '4.2'
+  s.dependency              'IBMWatsonRestKit', '~> 3.0.0'
+
 end
diff --git a/IBMWatsonAssistantV2.podspec b/IBMWatsonAssistantV2.podspec
@@ -4,7 +4,7 @@ Pod::Spec.new do |s|
   s.version               = '1.4.0'
   s.summary               = 'Client framework for the IBM Watson Assistant service'
   s.description           = <<-DESC
-With the IBM Watson™ Assistant service, you can build a solution that understands 
+With the IBM Watson™ Assistant service, you can build a solution that understands
 natural-language input and uses machine learning to respond to customers in a way that simulates a conversation between humans.
                             DESC
   s.homepage              = 'https://www.ibm.com/watson/ai-assistant/'
@@ -15,11 +15,12 @@ natural-language input and uses machine learning to respond to customers in a wa
   s.module_name           = 'Assistant'
   s.ios.deployment_target = '10.0'
   s.source                = { :git => 'https://github.com/watson-developer-cloud/swift-sdk.git', :tag => s.version.to_s }
-  
+
   s.source_files          = 'Source/AssistantV2/**/*.swift',
                             'Source/SupportingFiles/Shared.swift'
   s.exclude_files         = 'Source/AssistantV2/Shared.swift'
 
-  s.dependency              'IBMWatsonRestKit', '~> 2.0.0'
-
+  s.swift_version         = '4.2'
+  s.dependency              'IBMWatsonRestKit', '~> 3.0.0'
+
 end
diff --git a/IBMWatsonCompareComplyV1.podspec b/IBMWatsonCompareComplyV1.podspec
@@ -13,11 +13,12 @@ IBM Watson™ Compare and Comply analyzes governing documents to provide details
   s.module_name           = 'CompareComply'
   s.ios.deployment_target = '10.0'
   s.source                = { :git => 'https://github.com/watson-developer-cloud/swift-sdk.git', :tag => s.version.to_s }
-  
+
   s.source_files          = 'Source/CompareComplyV1/**/*.swift',
                             'Source/SupportingFiles/Shared.swift'
   s.exclude_files         = 'Source/CompareComplyV1/Shared.swift'
 
-  s.dependency              'IBMWatsonRestKit', '~> 2.0.0'
-
+  s.swift_version         = '4.2'
+  s.dependency              'IBMWatsonRestKit', '~> 3.0.0'
+
 end
diff --git a/IBMWatsonDiscoveryV1.podspec b/IBMWatsonDiscoveryV1.podspec
@@ -4,8 +4,8 @@ Pod::Spec.new do |s|
   s.version               = '1.4.0'
   s.summary               = 'Client framework for the IBM Watson Discovery service'
   s.description           = <<-DESC
-IBM Watson™ Discovery makes it possible to rapidly build cognitive, cloud-based exploration applications 
-that unlock actionable insights hidden in unstructured data — including your own proprietary data, 
+IBM Watson™ Discovery makes it possible to rapidly build cognitive, cloud-based exploration applications
+that unlock actionable insights hidden in unstructured data — including your own proprietary data,
 as well as public and third-party data.
                             DESC
   s.homepage              = 'https://www.ibm.com/watson/services/discovery/'
@@ -16,11 +16,12 @@ as well as public and third-party data.
   s.module_name           = 'Discovery'
   s.ios.deployment_target = '10.0'
   s.source                = { :git => 'https://github.com/watson-developer-cloud/swift-sdk.git', :tag => s.version.to_s }
-  
+
   s.source_files          = 'Source/DiscoveryV1/**/*.swift',
                             'Source/SupportingFiles/Shared.swift'
   s.exclude_files         = 'Source/DiscoveryV1/Shared.swift'
 
-  s.dependency              'IBMWatsonRestKit', '~> 2.0.0'
-
+  s.swift_version         = '4.2'
+  s.dependency              'IBMWatsonRestKit', '~> 3.0.0'
+
 end
diff --git a/IBMWatsonLanguageTranslatorV3.podspec b/IBMWatsonLanguageTranslatorV3.podspec
@@ -19,6 +19,7 @@ IBM Watson™ Language Translator can identify the language of text and translat
                             'Source/SupportingFiles/Shared.swift'
   s.exclude_files         = 'Source/LanguageTranslatorV3/Shared.swift'
 
-  s.dependency              'IBMWatsonRestKit', '~> 2.0.0'
+  s.swift_version         = '4.2'
+  s.dependency              'IBMWatsonRestKit', '~> 3.0.0'
 
 end
diff --git a/IBMWatsonNaturalLanguageClassifierV1.podspec b/IBMWatsonNaturalLanguageClassifierV1.podspec
@@ -4,8 +4,8 @@ Pod::Spec.new do |s|
   s.version               = '1.4.0'
   s.summary               = 'Client framework for the IBM Watson Natural Language Classifier service'
   s.description           = <<-DESC
-Natural Language Classifier can help your application understand the language of short texts and 
-make predictions about how to handle them. A classifier learns from your example data and then can 
+Natural Language Classifier can help your application understand the language of short texts and
+make predictions about how to handle them. A classifier learns from your example data and then can
 return information for texts that it is not trained on.
                             DESC
   s.homepage              = 'https://www.ibm.com/watson/services/natural-language-classifier/'
@@ -16,11 +16,12 @@ return information for texts that it is not trained on.
   s.module_name           = 'NaturalLanguageClassifier'
   s.ios.deployment_target = '10.0'
   s.source                = { :git => 'https://github.com/watson-developer-cloud/swift-sdk.git', :tag => s.version.to_s }
-  
+
   s.source_files          = 'Source/NaturalLanguageClassifierV1/**/*.swift',
                             'Source/SupportingFiles/Shared.swift'
   s.exclude_files         = 'Source/NaturalLanguageClassifierV1/Shared.swift'
 
-  s.dependency              'IBMWatsonRestKit', '~> 2.0.0'
-
+  s.swift_version         = '4.2'
+  s.dependency              'IBMWatsonRestKit', '~> 3.0.0'
+
 end
diff --git a/IBMWatsonNaturalLanguageUnderstandingV1.podspec b/IBMWatsonNaturalLanguageUnderstandingV1.podspec
@@ -4,7 +4,7 @@ Pod::Spec.new do |s|
   s.version               = '1.4.0'
   s.summary               = 'Client framework for the IBM Watson Natural Language Understanding service'
   s.description           = <<-DESC
-IBM Watson™ Natural Language Understanding can analyze semantic features of text input, 
+IBM Watson™ Natural Language Understanding can analyze semantic features of text input,
 including categories, concepts, emotion, entities, keywords, metadata, relations, semantic roles, and sentiment.
                             DESC
   s.homepage              = 'https://www.ibm.com/watson/services/natural-language-understanding/'
@@ -15,11 +15,12 @@ including categories, concepts, emotion, entities, keywords, metadata, relations
   s.module_name           = 'NaturalLanguageUnderstanding'
   s.ios.deployment_target = '10.0'
   s.source                = { :git => 'https://github.com/watson-developer-cloud/swift-sdk.git', :tag => s.version.to_s }
-  
+
   s.source_files          = 'Source/NaturalLanguageUnderstandingV1/**/*.swift',
                             'Source/SupportingFiles/Shared.swift'
   s.exclude_files         = 'Source/NaturalLanguageUnderstandingV1/Shared.swift'
 
-  s.dependency              'IBMWatsonRestKit', '~> 2.0.0'
-
+  s.swift_version         = '4.2'
+  s.dependency              'IBMWatsonRestKit', '~> 3.0.0'
+
 end
diff --git a/IBMWatsonPersonalityInsightsV3.podspec b/IBMWatsonPersonalityInsightsV3.podspec
@@ -4,7 +4,7 @@ Pod::Spec.new do |s|
   s.version               = '1.4.0'
   s.summary               = 'Client framework for the IBM Watson Personality Insights service'
   s.description           = <<-DESC
-IBM Watson™ Personality Insights uses linguistic analytics to infer individuals' intrinsic personality characteristics 
+IBM Watson™ Personality Insights uses linguistic analytics to infer individuals' intrinsic personality characteristics
 from digital communications such as email, text messages, tweets, and forum posts.
                             DESC
   s.homepage              = 'https://www.ibm.com/watson/services/personality-insights/'
@@ -20,6 +20,7 @@ from digital communications such as email, text messages, tweets, and forum post
                             'Source/SupportingFiles/Shared.swift'
   s.exclude_files         = 'Source/PersonalityInsightsV3/Shared.swift'
 
-  s.dependency              'IBMWatsonRestKit', '~> 2.0.0'
-
+  s.swift_version         = '4.2'
+  s.dependency              'IBMWatsonRestKit', '~> 3.0.0'
+
 end
diff --git a/IBMWatsonSpeechToTextV1.podspec b/IBMWatsonSpeechToTextV1.podspec
@@ -4,8 +4,8 @@ Pod::Spec.new do |s|
   s.version               = '1.4.0'
   s.summary               = 'Client framework for the IBM Watson Speech to Text service'
   s.description           = <<-DESC
-The IBM® Speech to Text leverages machine intelligence to transcribe the human voice accurately. 
-The service combines information about grammar and language structure with knowledge of the composition 
+The IBM® Speech to Text leverages machine intelligence to transcribe the human voice accurately.
+The service combines information about grammar and language structure with knowledge of the composition
 of the audio signal. It continuously returns and retroactively updates a transcription as more speech is heard.
                             DESC
   s.homepage              = 'https://www.ibm.com/watson/services/speech-to-text/'
@@ -16,7 +16,7 @@ of the audio signal. It continuously returns and retroactively updates a transcr
   s.module_name           = 'SpeechToText'
   s.ios.deployment_target = '10.0'
   s.source                = { :git => 'https://github.com/watson-developer-cloud/swift-sdk.git', :tag => s.version.to_s }
-  
+
   s.source_files          = 'Source/SpeechToTextV1/**/*.swift',
                             'Source/SupportingFiles/Shared.swift',
                             'Source/SupportingFiles/Dependencies/Source/**/*'
@@ -25,12 +25,13 @@ of the audio signal. It continuously returns and retroactively updates a transcr
                             '**/opus_header.h',
                             '**/opus_header.c'
 
-  s.dependency              'IBMWatsonRestKit', '~> 2.0.0'
+  s.swift_version         = '4.2'
+  s.dependency              'IBMWatsonRestKit', '~> 3.0.0'
   s.dependency              'Starscream', '3.0.5'
   s.vendored_libraries    = 'Source/SupportingFiles/Dependencies/Libraries/*.a'
 
   # The renaming of libogg.a and libopus.a is done to avoid duplicate library name errors
-  # in case TextToSpeech is being installed in the same app (which also includes libogg and libopus) 
+  # in case TextToSpeech is being installed in the same app (which also includes libogg and libopus)
   # The ogg/ and opus/ files are flattened to the same directory so that all #include statements work
   s.prepare_command = <<-CMD
                         cd Source/SupportingFiles/Dependencies/Libraries

diff --git a/IBMWatsonTextToSpeechV1.podspec b/IBMWatsonTextToSpeechV1.podspec
@@ -4,7 +4,7 @@ Pod::Spec.new do |s|
   s.version               = '1.4.0'
   s.summary               = 'Client framework for the IBM Watson Text to Speech service'
   s.description           = <<-DESC
-IBM® Text to Speech uses IBM's speech-synthesis capabilities to convert written text to natural-sounding speech. 
+IBM® Text to Speech uses IBM's speech-synthesis capabilities to convert written text to natural-sounding speech.
 The service streams the results back to the client with minimal delay.
                             DESC
   s.homepage              = 'https://www.ibm.com/watson/services/text-to-speech/'
@@ -22,11 +22,12 @@ The service streams the results back to the client with minimal delay.
   s.exclude_files         = 'Source/TextToSpeechV1/Shared.swift',
                             '**/config_types.h'
 
-  s.dependency              'IBMWatsonRestKit', '~> 2.0.0'
+  s.swift_version         = '4.2'
+  s.dependency              'IBMWatsonRestKit', '~> 3.0.0'
   s.vendored_libraries    = 'Source/SupportingFiles/Dependencies/Libraries/*.a'
 
   # The renaming of libogg.a and libopus.a is done to avoid duplicate library name errors
-  # in case SpeechToText is being installed in the same app (which also includes libogg and libopus) 
+  # in case SpeechToText is being installed in the same app (which also includes libogg and libopus)
   # The ogg/ and opus/ files are flattened to the same directory so that all #include statements work
   s.prepare_command = <<-CMD
                         cd Source/SupportingFiles/Dependencies/Libraries

diff --git a/IBMWatsonToneAnalyzerV3.podspec b/IBMWatsonToneAnalyzerV3.podspec
@@ -1,10 +1,10 @@
 Pod::Spec.new do |s|
-  
+
   s.name                  = 'IBMWatsonToneAnalyzerV3'
   s.version               = '1.4.0'
   s.summary               = 'Client framework for the IBM Watson Tone Analyzer service'
   s.description           = <<-DESC
-IBM Watson™ Tone Analyzer uses linguistic analysis to detect emotional and language tones in written text. 
+IBM Watson™ Tone Analyzer uses linguistic analysis to detect emotional and language tones in written text.
 The service can analyze tone at both the document and sentence levels.
                             DESC
   s.homepage              = 'https://www.ibm.com/watson/services/tone-analyzer/'
@@ -15,11 +15,12 @@ The service can analyze tone at both the document and sentence levels.
   s.module_name           = 'ToneAnalyzer'
   s.ios.deployment_target = '10.0'
   s.source                = { :git => 'https://github.com/watson-developer-cloud/swift-sdk.git', :tag => s.version.to_s }
-  
+
   s.source_files          = 'Source/ToneAnalyzerV3/**/*.swift',
                             'Source/SupportingFiles/Shared.swift'
   s.exclude_files         = 'Source/ToneAnalyzerV3/Shared.swift'
 
-  s.dependency              'IBMWatsonRestKit', '~> 2.0.0'
+  s.swift_version         = '4.2'
+  s.dependency              'IBMWatsonRestKit', '~> 3.0.0'
 
 end
diff --git a/IBMWatsonVisualRecognitionV3.podspec b/IBMWatsonVisualRecognitionV3.podspec
@@ -4,7 +4,7 @@ Pod::Spec.new do |s|
   s.version               = '1.4.0'
   s.summary               = 'Client framework for the IBM Watson Visual Recognition service'
   s.description           = <<-DESC
-IBM Watson™ Visual Recognition uses deep learning algorithms to analyze images for 
+IBM Watson™ Visual Recognition uses deep learning algorithms to analyze images for
 scenes, objects, faces, and other content. The response includes keywords that provide information about the content.
                             DESC
   s.homepage              = 'https://www.ibm.com/watson/services/visual-recognition/'
@@ -15,11 +15,12 @@ scenes, objects, faces, and other content. The response includes keywords that p
   s.module_name           = 'VisualRecognition'
   s.ios.deployment_target = '10.0'
   s.source                = { :git => 'https://github.com/watson-developer-cloud/swift-sdk.git', :tag => s.version.to_s }
-  
+
   s.source_files          = 'Source/VisualRecognitionV3/**/*.swift',
                             'Source/SupportingFiles/Shared.swift'
   s.exclude_files         = 'Source/VisualRecognitionV3/Shared.swift'
 
-  s.dependency              'IBMWatsonRestKit', '~> 2.0.0'
-
+  s.swift_version         = '4.2'
+  s.dependency              'IBMWatsonRestKit', '~> 3.0.0'
+
 end