diff --git a/watson_developer_cloud/document_conversion_v1.py b/watson_developer_cloud/document_conversion_v1.py index 0e6a92fea..bbf1714e6 100644 --- a/watson_developer_cloud/document_conversion_v1.py +++ b/watson_developer_cloud/document_conversion_v1.py @@ -16,10 +16,11 @@ The v1 Document Conversion service (https://www.ibm.com/watson/developercloud/document-conversion.html) """ +from .utils import deprecated from .watson_service import WatsonService import os import json - +DEPRECATION_MESSAGE = "Since Document Conversion Service was retired in October 2017, we have continued to improve document conversion capabilities within Watson Discovery. If you are a Document Conversion user, get started with Discovery today. Refer to the migration guide: https://console.bluemix.net/docs/services/discovery/migrate-dcs-rr.html" class DocumentConversionV1(WatsonService): DEFAULT_URL = 'https://gateway.watsonplatform.net/document-conversion/api' @@ -28,10 +29,12 @@ class DocumentConversionV1(WatsonService): NORMALIZED_TEXT = 'normalized_text' latest_version = '2016-02-10' + @deprecated(DEPRECATION_MESSAGE) def __init__(self, version, url=DEFAULT_URL, **kwargs): WatsonService.__init__(self, 'document_conversion', url, **kwargs) self.version = version + @deprecated(DEPRECATION_MESSAGE) def convert_document(self, document, config, media_type=None): params = {'version': self.version} filename = os.path.basename(document.name) @@ -45,7 +48,7 @@ def convert_document(self, document, config, media_type=None): return self.request(method='POST', url='/v1/convert_document', files=files, params=params, accept_json=accept_json) - + @deprecated(DEPRECATION_MESSAGE) def index_document(self, config, document=None, metadata=None, media_type=None): if document is None and metadata is None: diff --git a/watson_developer_cloud/utils.py b/watson_developer_cloud/utils.py new file mode 100644 index 000000000..f7abf8d51 --- /dev/null +++ b/watson_developer_cloud/utils.py @@ -0,0 +1,12 @@ +import warnings + +def deprecated(message): + def deprecated_decorator(func): + def deprecated_func(*args, **kwargs): + warnings.warn("{} is a deprecated function. {}".format(func.__name__, message), + category=DeprecationWarning, + stacklevel=2) + warnings.simplefilter('default', DeprecationWarning) + return func(*args, **kwargs) + return deprecated_func + return deprecated_decorator \ No newline at end of file