Source code for watson_developer_cloud.document_conversion_v1

# Copyright 2016 IBM All Rights Reserved.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#      http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

"""
The v1 Document Conversion service
(https://www.ibm.com/watson/developercloud/document-conversion.html)
"""
from .watson_service import WatsonService
import os
import json


class DocumentConversionV1(WatsonService):
    DEFAULT_URL = 'https://gateway.watsonplatform.net/document-conversion/api'
    ANSWER_UNITS = 'answer_units'
    NORMALIZED_HTML = 'normalized_html'
    NORMALIZED_TEXT = 'normalized_text'
    latest_version = '2016-02-10'

    def __init__(self, version, url=DEFAULT_URL, **kwargs):
        WatsonService.__init__(self, 'document_conversion', url, **kwargs)
        self.version = version

    def convert_document(self, document, config, media_type=None):
        params = {'version': self.version}
        filename = os.path.basename(document.name)
        file_tuple = (filename, document, media_type)\
            if media_type else (filename, document)
        files = [('file', file_tuple),
                 ('config',
                  ('config.json', json.dumps(config), 'application/json'))]
        accept_json = config['conversion_target'] == DocumentConversionV1.\
            ANSWER_UNITS
        return self.request(method='POST', url='/v1/convert_document',
                            files=files, params=params,
                            accept_json=accept_json)

    def index_document(self, config, document=None, metadata=None,
                       media_type=None):
        if document is None and metadata is None:
            raise AssertionError(
                'Missing required parameters: document or metadata. At least '
                'one of those is'
                'required.')
        params = {'version': self.version}
        files = [('config', ('config.json', json.dumps(config),
                             'application/json'))]
        if document is not None:
            filename = os.path.basename(document.name)
            file_tuple = (filename, document, media_type)\
                if media_type else (filename, document)
            files.append(('file', file_tuple))
        if metadata is not None:
            files.append(('metadata',
                          ('metadata.json', json.dumps(metadata),
                           'application/json')))
        return self.request(method='POST', url='/v1/index_document',
                            files=files, params=params, accept_json=True)