Metadata-Version: 2.1
Name: magictranslator
Version: 0.1.0
Summary: Wrapper library for multiple translation APIs
Home-page: https://github.com/c-rainbow/magictranslator
Author: c_rainbow
Author-email: c.rainbow.678@example.com
License: UNKNOWN
Description: # Magic Translator
        
        Magic translator is a wrapper library of multiple translation APIs.
        For different source languages, you can configure which translation API to use and/or which destination language to translate to.
        
        
        ## Installation
        
        The library is developed and tested in Python 3.7
        
        ```python
        pip install magictranslator
        ```
        
        ## Usage
        
        ```python
        from magictranslator import translator
        
        t = translator.FromJSONConfigFile('config.json')  
        res = t.Translate('hola amigo buenas noches')
        print(res.translated_text)
        ```
        
        
        ## Config JSON file structure
        
        MagicTranslator accepts JSON-like data config as input. The config JSON data (example can be found in config.json) has the following structure. All language codes are valid two-character ISO-639-1 codes, such as 'en', 'ar', 'ko'
        
        ### translators
        
        List of translators to use. Each object in the list has the following items
        
        - name (required): Name of translator. Currently supported names are: googletrans, google, aws, yandex
        - optional data specific to each translator
            - googletrans: no additional data is needed
            - google: "service_account" is required with path to the service account JSON file
            - aws: "region" is required for the AWS Translate API region name
            - yandex: "api_key" is required
        
        ### default_translator
        
        Name of the default translator. Should be one of the translators in "translators" section
        
        ### default_dest
        
        Default destination language code to translate to
        
        ### no_translates
        
        List of language codes not to translate
        
        ### src_langs
        
        List of source languages to configure specifically. All other languages not in this list will be translated to default_dest by default_translator.
        
        Each object in the list has three fields
        - src (required): Source language code
        - dest (optional): Destination language code, if different from default_dest
        - translator (optional): Name of translator to use, if different from default_translator
        
        
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
