OpenAI support, Overwrite option

README.md

@@ -138,6 +138,7 @@ As of this release, json-autotranslate offers five services:
   to translate strings)
 - **amazon-translate** (uses
   [Amazon Translate](https://aws.amazon.com/translate/) to translate strings)
+- **OpenAI** (uses gpt-4o and can take a context file path from the context option)
 - **manual** (allows you to translate strings manually by entering them into the
   CLI)
 - **dry-run** (outputs a list of strings that will be translated without
@@ -307,7 +308,7 @@ Options:
   -s, --service <service>                        selects the service to be used for translation (default: "google-translate")
   -g, --glossaries [glossariesDir]               set the glossaries folder to be used by DeepL. Keep empty for automatic determination of matching glossary
   -a, --appName <appName>                        specify the name of your app to distinguish DeepL glossaries (if sharing an API key between multiple projects) (default: "json-autotranslate")
-  --context <context>                            set the context that is used by DeepL for translations
+  --context <context>                            set the context that is used by DeepL for translations, for OpenAI it is the path to the json file containing the context for each key
   --list-services                                outputs a list of available services
   -m, --matcher <matcher>                        selects the matcher to be used for interpolations (default: "icu")
   --list-matchers                                outputs a list of available matchers
@@ -316,6 +317,7 @@ Options:
   -d, --delete-unused-strings                    deletes strings in translation files that don't exist in the template
   --directory-structure <default|ngx-translate>  the locale directory structure
   --decode-escapes                               decodes escaped HTML entities like &#39; into normal UTF-8 characters
+  -o, --overwrite                                overwrite already present translations
   -h, --help                                     display help for command
 ```
 

src/index.ts

@@ -65,7 +65,7 @@ commander
   )
   .option(
     '--context <context>',
-    `set the context that is used by DeepL for translations`,
+    `set the context that is used by DeepL for translations, for OpenAI it's the path to a JSON file`,
   )
   .option('--list-services', `outputs a list of available services`)
   .option(
@@ -94,6 +94,10 @@ commander
     '--decode-escapes',
     'decodes escaped HTML entities like &#39; into normal UTF-8 characters',
   )
+  .option(
+    '-o, --overwrite',
+    'overwrite existing translations instead of skipping them',
+  )
   .parse(process.argv);
 
 const translate = async (
@@ -112,6 +116,7 @@ const translate = async (
   glossariesDir?: string | boolean,
   appName?: string,
   context?: string,
+  overwrite: boolean = false,
 ) => {
   const workingDir = path.resolve(process.cwd(), inputDir);
   const resolvedCacheDir = path.resolve(process.cwd(), cacheDir);
@@ -297,6 +302,7 @@ const translate = async (
       dirStructure,
       deleteUnusedStrings,
       withArrays,
+      overwrite,
     );
 
     switch (dirStructure) {
@@ -426,6 +432,7 @@ translate(
   commander.glossaries,
   commander.appName,
   commander.context,
+  commander.overwrite,
 ).catch((e: Error) => {
   console.log();
   console.log(chalk.bgRed('An error has occurred:'));
@@ -445,6 +452,7 @@ function createTranslator(
   dirStructure: DirectoryStructure,
   deleteUnusedStrings: boolean,
   withArrays: boolean,
+  overwrite, 
 ) {
   return async (
     sourceFile: TranslatableFile,
@@ -472,7 +480,7 @@ function createTranslator(
       : [];
     const templateStrings = Object.keys(sourceFile.content);
     const stringsToTranslate = templateStrings
-      .filter((key) => !existingKeys.includes(key) || cacheDiff.includes(key))
+      .filter((key) => overwrite || !existingKeys.includes(key) || cacheDiff.includes(key))
       .map((key) => ({
         key,
         value: sourceFile.type === 'key-based' ? sourceFile.content[key] : key,

src/services/index.ts

@@ -5,6 +5,7 @@ import { AzureTranslator } from './azure-translator';
 import { ManualTranslation } from './manual';
 import { Matcher } from '../matchers';
 import { AmazonTranslate } from './amazon-translate';
+import { OpenAITranslator } from './openai';
 
 export interface TranslationResult {
   key: string;
@@ -44,6 +45,7 @@ export const serviceMap: {
   azure: new AzureTranslator(),
   manual: new ManualTranslation(),
   'amazon-translate': new AmazonTranslate(),
+  'openai': new OpenAITranslator(),
 };
 
 export interface DeepLGlossary {