Metadata-Version: 2.1
Name: REDCapLLT
Version: 3.0.0
Summary: A package to translate REDCap language libraries
Home-page: https://github.com/gourgiotisw/REDCapLLT
Author: William Gourgiotis
Author-email: william.gourgiotis@umassmed.edu
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: googletrans ==4.0.0-rc1

# REDCap Language Library Translator

## Overview

The REDCap Language Library Translator is a Python script designed to translate the "default" values in a REDCap JSON file  into a user-defined language using the Google Translate API. The script handles large text translations by breaking them into manageable chunks and also manages translation errors by logging them into a separate file.

## Features

- **Language Support:** Translates "default" values into a wide range of languages.
- **Chunk Processing:** Handles large texts by breaking them into smaller chunks.
- **Error Handling:** Logs any translation errors into a separate file.
- **JSON Key Updates:** Updates the `display` and `key` fields in the JSON file to reflect the new language.

## Supported Languages

| Supported Languages        |      |       |
|----------------------------|----------------------------|----------------------------|
| Afrikaans                  | Haitian Creole             | Pashto                     |
| Amharic                    | Hebrew                     | Persian (Farsi)            |
| Arabic                     | Hindi                      | Polish                     |
| Azerbaijani                | Hungarian                  | Portuguese                 |
| Bashkir                    | Icelandic                  | Punjabi                    |
| Belarusian                 | Indonesian                 | Queretaro Otomi            |
| Bengali                    | Irish                      | Romanian                   |
| Bosnian                    | Italian                    | Russian                    |
| Bulgarian                  | Japanese                   | Samoan                     |
| Catalan                    | Kannada                    | Scots Gaelic               |
| Cebuano                    | Kazakh                     | Serbian                    |
| Chinese (Simplified)       | Khmer                      | Slovak                     |
| Chinese (Traditional)      | Klingon (TlhIngan Hol)     | Slovenian                  |
| Chuvash                    | Korean                     | Spanish                    |
| Croatian                   | Kurdish                    | Swahili                    |
| Czech                      | Kyrgyz                     | Swedish                    |
| Danish                     | Lao                        | Tajik                      |
| Dutch                      | Latvian                    | Tamil                      |
| English                    | Lithuanian                 | Telugu                     |
| Esperanto                  | Luxembourgish              | Thai                       |
| Estonian                   | Macedonian                 | Tongan                     |
| Fijian                     | Malagasy                   | Turkish                    |
| Filipino                   | Malay                      | Turkmen                    |
| Finnish                    | Maltese                    | Ukrainian                  |
| French                     | Mongolian                  | Urdu                       |
| Georgian                   | Nepali                     | Uyghur                     |
| German                     | Norwegian                  | Uzbek                      |
| Greek                      | Odia                       | Vietnamese                 |
| Gujarati                   | Yiddish                    | Welsh                      |
| Xhosa                      | Yoruba                     | Zulu                       |




# REDCap Language Library Translator

## How It Works

### User Input:
- The script prompts the user to select the JSON file using a graphical file dialog.
- The user specifies the target language for translation.

### Extract Default Values:
- The script extracts all "default" and "translation" values from the JSON file.

### Create Subfolder:
- A subfolder is created based on the version of the JSON file and the target language.

### Save Extracted Data:
- The extracted data is saved into a new JSON file within the subfolder.

### Translate Values:
- The script translates the "default" values in the new JSON file.
- If any translation errors occur, the corresponding key-value pairs are logged into a separate "errors" file.

### Update Original JSON:
- The script updates the original JSON file with the new translated values.
- The display and key fields are updated to reflect the new language.

### Cleanup:
- The temporary translation file is deleted.


### Error Handling
If any errors occur during the translation process, the script logs the corresponding key-value pairs into a separate file named {language}_Error.log within the subfolder. This allows users to review and address translation issues separately.

### Contributions
Contributions are welcome! If you have any suggestions or improvements, please submit a pull request or open an issue on GitHub.

### License
This project is licensed under the MIT License. See the LICENSE file for more details.

### Acknowledgments
The googletrans package for providing translation capabilities.
The REDCap community for their support and resources.
