modpack_localizer 0.3.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7f13f2c6fd8dc427ef0ded277221af4bb2a7a8164fe6c6806b201191019895da
-  data.tar.gz: ef0bf6ac23c510d803cf475bbd182fc363d7ff0b5f0ad61a6751a404e1984cf2
+  metadata.gz: e9147b02f5b6012f60cce0708bd2431b16983e857b1b1e91dcde22bb0d83734b
+  data.tar.gz: fd66110285400a00d87421ba9ad2927b6fb5a036037ab56cda2354963bf44407
 SHA512:
-  metadata.gz: 1b50f988c2ae70627ba364af939f5f1449dbd6e08da679f27d7d0de4b347938f616ebe624ac22056f3ae9789576aa50bff145fb375f01d63f81e8306e3012090
-  data.tar.gz: e7081706ed393f3ce188b89dd5b2f0f6a2f2c2d02f0484665b4ef59e771dfc5722bb832851a7f4baf3e0a650e84b061bc7e86b2c8ec8f8310af01e0b95743d32
+  metadata.gz: '07348b4470777efd7ede2f88b1ed6eb0d18b4fed4b982eff8a87d1edde93b4860a45fbaea50570e9b0603e98822b77d523b3e0de507c13f7967e9f54989962ab'
+  data.tar.gz: e0afb02710d8da14e886d9dd9e69f8909b32a408424d734a26e41a24a1176f29a47260a66486f515733225fe253bc2e71f405d5333ef1ad90b7b6b98112c5567

data/CHANGELOG.md

@@ -84,3 +84,19 @@
 
 - gem更新
   - TranslationAPIの扱いが変わったのに伴い、コードを修正
+
+## [0.4.0] - 2025-11/20
+
+- 翻訳APIの呼び出しが失敗した場合にリトライする機能を強化
+  - 指数関数バックオフを導入
+  - 最大リトライ回数を増加
+  - IO::TimeoutError以外の例外もリトライ対象に追加
+    - 翻訳APIの独自エラーとかに対応するため
+- いくつかのライブラリを最新化
+
+## [0.5.0] - 2025-11-23
+
+- プロバイダーを選べるようにdotenvを追加
+- TranslationAPIの設定にカスタムプロンプトを追加できるようにした
+  - プロンプトに「プロパティアクセスは翻訳しないでください。例: obj.property.child」を追加するように変更
+  - これにより、ftbquestのプロパティアクセスが翻訳されてしまう問題を軽減

data/README.md

@@ -16,12 +16,11 @@ or if no specific configs required
 
 1. Download [release](https://github.com/milkeclair/modpack_localizer/releases)
 2. Make `.env` file
-3. Add `OPENAI_API_KEY=your_api_key` to `.env`
-4. Optional: Add `OPENAI_MODEL=some_openai_model` to `.env`
-5. Add `some.snbt` or `quests` directory contents to `quests` directory
-6. Add `some.jar` files to `mods` directory
-7. Double click `start.bat` file
-8. Check `output` directory
+3. Add your API keys to `.env` file [see](https://github.com/milkeclair/translation_api)
+4. Add `some.snbt` or `quests` directory contents to `quests` directory
+5. Add `some.jar` files to `mods` directory
+6. Double click `start.bat` file
+7. Check `output` directory
 
 ## Options for omakase method
 

data/dist/example.rb

@@ -1,5 +1,10 @@
 require "modpack_localizer"
 
-ModpackLocalizer.omakase(language: "English")
+# ModpackLocalizer.omakase(language: "English")
 # or
-ModpackLocalizer.omakase(language: "Japanese", country: "Japan", locale_code: nil, threadable: true)
+begin
+  ModpackLocalizer.omakase
+rescue StandardError => e
+  puts e
+  puts e.backtrace
+end

data/lib/modpack_localizer/jar/performer.rb

@@ -1,3 +1,4 @@
+require "dotenv"
 require "translation_api"
 require_relative "../util/help"
 require_relative "../util/error"
@@ -8,6 +9,12 @@ module ModpackLocalizer
   module JAR
     # .jarの翻訳を実行するクラス
     class Performer
+      Dotenv.load
+
+      MAX_RETRIES = 8
+      BASE_DELAY = 5
+      MAX_SLEEP = 256
+
       # locale_codeを指定する場合、countryの指定は不要
       #
       # @param [Boolean] output_logs APIのログを出力するか
@@ -21,12 +28,7 @@ module ModpackLocalizer
         output_logs: true, except_words: [], language: "Japanese",
         country: "Japan", locale_code: nil, display_help: true
       )
-        TranslationAPI.configure do |config|
-          config.output_logs  = output_logs
-          config.language     = language
-          config.except_words = except_words
-          config.provider     = :openai
-        end
+        configure_translation_api(output_logs:, except_words:, language:)
 
         @language, @country_name, @locale_code = language, country, locale_code
         @reader, @writer, @progress_bar, @loggable, @tierdown = nil
@@ -83,6 +85,18 @@ module ModpackLocalizer
 
       private
 
+      def configure_translation_api(
+        output_logs: true, except_words: [], language: "Japanese"
+      )
+        TranslationAPI.configure do |config|
+          config.output_logs   = output_logs
+          config.language      = language.downcase
+          config.except_words  = except_words
+          config.provider      = ENV["PROVIDER"]&.to_sym || :openai
+          config.custom_prompt = "Never translate property access. Example: obj.property.child"
+        end
+      end
+
       # ReaderとWriterを初期化する
       #
       # @params [String] file_path ファイルのパス
@@ -118,12 +132,13 @@ module ModpackLocalizer
           retries = 0
           begin
             lang_data.json[key] = TranslationAPI.translate(value)
-          rescue IO::TimeoutError => e
+          rescue StandardError => e
             retries += 1
-            raise e unless retries <= 3
+            raise e unless retries <= MAX_RETRIES
 
-            puts "Connection failed, retrying... (#{retries}/3)"
-            sleep(2)
+            sleep_time = sleep_time(retries)
+            puts "Translation failed, retrying... (#{retries}/#{MAX_RETRIES}) waiting #{sleep_time.round(2)} seconds"
+            sleep(sleep_time)
             retry
           end
           @progress_bar.increment if @loggable
@@ -153,6 +168,10 @@ module ModpackLocalizer
         "#{camelize(lang_data.mod_name)} already has #{@reader.extract_file_name(lang_data.file_name)} file."
       end
 
+      def sleep_time(retries)
+        [BASE_DELAY * (retries**2), MAX_SLEEP].min
+      end
+
       def camelize(str)
         str.split("_").map(&:capitalize).join
       end

data/lib/modpack_localizer/snbt/performer.rb

@@ -1,3 +1,4 @@
+require "dotenv"
 require "translation_api"
 require_relative "../util/help"
 require_relative "../util/error"
@@ -8,6 +9,12 @@ module ModpackLocalizer
   module SNBT
     # .snbtの翻訳を実行するクラス
     class Performer
+      Dotenv.load
+
+      MAX_RETRIES = 8
+      BASE_DELAY = 5
+      MAX_SLEEP = 256
+
       # @param [Boolean] output_logs APIのログを出力するか
       # @param [Array<String>] except_words 翻訳しない単語
       # @param [String] language 言語
@@ -15,10 +22,11 @@ module ModpackLocalizer
       # @return [ModpackLocalizer::SNBT::Performer]
       def initialize(output_logs: true, except_words: [], language: "Japanese", display_help: true)
         TranslationAPI.configure do |config|
-          config.output_logs  = output_logs
-          config.language     = language
-          config.except_words = except_words
-          config.provider     = :openai
+          config.output_logs   = output_logs
+          config.language      = language.downcase
+          config.except_words  = except_words
+          config.provider      = ENV["PROVIDER"]&.to_sym || :openai
+          config.custom_prompt = "Never translate property access. Example: obj.property.child"
         end
 
         @reader, @writer, @progress_bar, @loggable = nil
@@ -41,7 +49,7 @@ module ModpackLocalizer
         init_progress_bar(file_path, results.length) if @loggable
 
         results.each do |result|
-          result[:text] = TranslationAPI.translate(result[:text])
+          result[:snbt] = retryable_translate(result[:text])
           @writer.overwrites(result)
           @progress_bar.increment if @loggable
         end
@@ -80,6 +88,25 @@ module ModpackLocalizer
 
       private
 
+      def retryable_translate(text)
+        retries = 0
+        begin
+          TranslationAPI.translate(text)
+        rescue StandardError => e
+          retries += 1
+          raise e unless retries <= MAX_RETRIES
+
+          sleep_time = sleep_time(retries)
+          puts "Translation failed, retrying... (#{retries}/#{MAX_RETRIES}) waiting #{sleep_time.round(2)} seconds"
+          sleep(sleep_time)
+          retry
+        end
+      end
+
+      def sleep_time(retries)
+        [BASE_DELAY * (retries**2), MAX_SLEEP].min
+      end
+
       # プログレスバーを初期化する
       #
       # @param [String] file_path ファイルのパス

data/lib/modpack_localizer/util/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ModpackLocalizer
-  VERSION = "0.3.0"
+  VERSION = "0.5.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: modpack_localizer
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.5.0
 platform: ruby
 authors:
 - milkeclair
@@ -23,6 +23,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: dotenv
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: iso-639
   requirement: !ruby/object:Gem::Requirement