modpack_localizer 0.5.1 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 432e408e2125a8379f22bafaac9978bd66a49d8b1a5f28b67ceeffa798072b19
-  data.tar.gz: 7246397c776845ef002ef257e622378062383976a27389d50b202cc1b8292a35
+  metadata.gz: d6f6f78477a00a2dccb3a91ac06b4ae16eef6a6e9183e7c439ed20c6d3756311
+  data.tar.gz: 6eaf4b967aa2b9203b05f52d963054f86df9a3549dee9cc4ec9a8db8f4a4e54a
 SHA512:
-  metadata.gz: 0a86d37bdaa62557cf9d3334c8ff38fc6d22b70ac2d24eda086585bf8ac6cf0ef8158bdbfeb8166b73b4d14b1e0841203cec2f093e565fe73a50499c9f59c7fd
-  data.tar.gz: 60b55d5f89a29403d3a269bd96d11132a39916b183b197123292256348496e0edcbbdf5cfc233a57ac9307b9b80fe224d59ab8fca53e095529b531aec1a10105
+  metadata.gz: ff6c2808e247f65516ffa0e18751715562950c347683114979411ad32aaa5ff459d48684e2d0d2110f50210a4a8d13651414ff5c06e4fd61c4f9593285586ca3
+  data.tar.gz: 75be66f8d7d0b074c355921072cfbede46a2f687893d6c4d4e7ec79e2b75f799e1d5edc458f5023ec8f532e73f8943912f999f0e17c4eafde00b41e0f44c345d

data/CHANGELOG.md

@@ -104,3 +104,8 @@
 ## [0.5.1] - 2025-11-23
 
 - snbtの上書きをするとき、取得するテキストのプロパティ名が間違っていたのを修正
+
+## [0.6.0] - 2025-11-24
+
+- quest giverの翻訳機能を追加
+  - DawnCraftなどのmodpackに対応

data/Rakefile

@@ -1,39 +1,3 @@
 # frozen_string_literal: true
 
-require "bundler/gem_tasks"
-require "rspec/core/rake_task"
-require "rubocop/rake_task"
-require "yard"
-require_relative "rake_helper"
-
-desc "analysis"
-task :analysis do
-  sh "bundle install"
-
-  RakeHelper.init_rake_tasks
-
-  puts "--- rspec ---"
-  Rake::Task[:spec].invoke
-
-  puts "--- rubocop ---"
-  Rake::Task[:rubocop].invoke
-
-  puts "--- yard ---"
-  Rake::Task[:yard].invoke
-end
-
-desc "push to github packages and rubygems"
-task :push do
-  sh "bundle install"
-
-  puts "--- build ---"
-  RakeHelper.build_gem
-
-  puts "--- push to github packages ---"
-  RakeHelper.push_to_github_packages
-
-  puts "--- push to rubygems ---"
-  RakeHelper.push_to_rubygems
-end
-
-task default: :analysis
+require "push_gem"

data/how_to_publish.txt

@@ -2,9 +2,9 @@ some code change
 version.rb change
 changelog.md change
 
-$rake analysis
+$rake gem:check
 
 $git commit
 $git push
 
-$rake push
+$rake gem:push

data/lib/modpack_localizer/quest_giver/performer.rb

@@ -0,0 +1,120 @@
+require "dotenv"
+require "translation_api"
+require_relative "../util/help"
+require_relative "../util/error"
+require_relative "reader"
+require_relative "writer"
+
+module ModpackLocalizer
+  module QuestGiver
+    # Quest GiverのJSONファイルの翻訳を実行するクラス
+    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 言語
+      # @param [Boolean] display_help ヘルプを表示するか
+      # @return [ModpackLocalizer::QuestGiver::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.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
+
+        ModpackLocalizer.help if display_help
+      end
+
+      # Quest GiverのJSONファイルを翻訳して出力する
+      #
+      # @param [String] file_path ファイルのパス
+      # @param [Boolean] loggable 翻訳ログを出力するか
+      # @return [void]
+      def perform(file_path, loggable: true)
+        @loggable = loggable
+        file_path = File.expand_path(file_path)
+        validate_path(file_path)
+
+        @reader = ModpackLocalizer::QuestGiver::Reader.new
+        @writer = ModpackLocalizer::QuestGiver::Writer.new(file_path)
+        results = @reader.extract_all(file_path)
+        init_progress_bar(file_path, results.length) if @loggable
+
+        results.each do |result|
+          result[:text] = retryable_translate(result[:text])
+          @writer.overwrites(result)
+          @progress_bar.increment if @loggable
+        end
+
+        puts "Quest translation completed!"
+      end
+
+      # ディレクトリ内のJSONファイルを翻訳して出力する
+      #
+      # @param [String] dir_path ディレクトリのパス
+      # @param [Boolean] loggable 翻訳ログを出力するか
+      # @return [void]
+      def perform_directory(dir_path: "quest_giver", loggable: true)
+        puts "Performing directory: #{dir_path}" unless loggable
+        dir_path = File.expand_path(dir_path)
+        validate_path(dir_path)
+
+        json_files = Dir.glob("#{dir_path}/**/*.json")
+        if json_files.empty?
+          puts "JSON files not found in: #{dir_path}"
+          return
+        end
+
+        json_files.each { |file_path| perform(file_path, loggable: loggable) }
+      end
+
+      # ファイルの存在性のバリデーション
+      #
+      # @param [String] path ファイルのパス
+      # @return [void]
+      def validate_path(path)
+        path = File.expand_path(path)
+        raise ModpackLocalizer::PathNotFoundError.new(path) unless File.exist?(path)
+      end
+
+      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 ファイルのパス
+      # @param [Integer] length プログレスバーの長さ
+      # @return [void]
+      def init_progress_bar(file_path, length)
+        @progress_bar = ModpackLocalizer.create_progress_bar(file_path, length)
+      end
+    end
+  end
+end

data/lib/modpack_localizer/quest_giver/reader.rb

@@ -0,0 +1,30 @@
+require "json"
+
+module ModpackLocalizer
+  module QuestGiver
+    # Quest GiverのJSONファイルから翻訳対象テキストを抽出するクラス
+    class Reader
+      TRANSLATABLE_PATHS = [
+        %w[start title text],
+        %w[start description text],
+        %w[complete title text],
+        %w[complete description text]
+      ].freeze
+
+      # JSONファイルから翻訳対象テキストを抽出する
+      #
+      # @param [String] file_path ファイルのパス
+      # @return [Array<Hash>] 翻訳対象テキストの配列
+      def extract_all(file_path)
+        json = JSON.parse(File.read(file_path))
+
+        TRANSLATABLE_PATHS.filter_map do |keys|
+          value = json.dig(*keys)
+          next unless value
+
+          { type: :quest_giver, path: keys.join("."), text: value }
+        end
+      end
+    end
+  end
+end

data/lib/modpack_localizer/quest_giver/writer.rb

@@ -0,0 +1,51 @@
+require "json"
+
+module ModpackLocalizer
+  module QuestGiver
+    # Quest GiverのJSONファイルに翻訳済みテキストを書き戻すクラス
+    class Writer
+      # @param [String] file_path ファイルのパス
+      # @return [ModpackLocalizer::QuestGiver::Writer]
+      def initialize(file_path)
+        @input_file_path = file_path
+        @output_file_path = file_path.gsub("quest_giver/", "output/quest_giver/")
+      end
+
+      # 翻訳済みテキストでJSONを上書きする
+      #
+      # @param [Hash] translated_content 翻訳済みの内容
+      # @return [void]
+      def overwrites(translated_content)
+        FileUtils.mkdir_p(File.dirname(@output_file_path))
+
+        json = JSON.parse(File.read(first_overwrite? ? @input_file_path : @output_file_path))
+        keys = translated_content[:path].split(".")
+        dig_and_set(json, keys, translated_content[:text])
+
+        File.open(@output_file_path, "w") do |file|
+          file.puts JSON.pretty_generate(json)
+        end
+      end
+
+      private
+
+      # ネストされたハッシュの指定パスに値をセットする
+      #
+      # @param [Hash] hash 対象のハッシュ
+      # @param [Array<String>] keys パスのキー配列
+      # @param [String] value セットする値
+      # @return [void]
+      def dig_and_set(hash, keys, value)
+        parent = hash.dig(*keys[0..-2])
+        parent[keys.last] = value
+      end
+
+      # 最初の上書きかどうか
+      #
+      # @return [Boolean]
+      def first_overwrite?
+        !File.exist?(@output_file_path)
+      end
+    end
+  end
+end

data/lib/modpack_localizer/util/version.rb

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

data/lib/modpack_localizer.rb

@@ -5,6 +5,7 @@ require_relative "modpack_localizer/util/version"
 require_relative "modpack_localizer/util/help"
 require_relative "modpack_localizer/snbt/performer"
 require_relative "modpack_localizer/jar/performer"
+require_relative "modpack_localizer/quest_giver/performer"
 
 # SNBT形式のファイルを翻訳する
 # 翻訳できるプロパティ
@@ -25,6 +26,7 @@ module ModpackLocalizer
     performers << ModpackLocalizer::JAR::Performer.new(
       language:, country:, locale_code:, display_help: false
     )
+    performers << ModpackLocalizer::QuestGiver::Performer.new(language:, display_help: false)
 
     if threadable
       threads = performers.map { Thread.new { it.perform_directory(loggable: false) } }

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: modpack_localizer
 version: !ruby/object:Gem::Version
-  version: 0.5.1
+  version: 0.6.0
 platform: ruby
 authors:
 - milkeclair
@@ -144,6 +144,9 @@ files:
 - lib/modpack_localizer/jar/performer.rb
 - lib/modpack_localizer/jar/reader.rb
 - lib/modpack_localizer/jar/writer.rb
+- lib/modpack_localizer/quest_giver/performer.rb
+- lib/modpack_localizer/quest_giver/reader.rb
+- lib/modpack_localizer/quest_giver/writer.rb
 - lib/modpack_localizer/snbt/description_extractor.rb
 - lib/modpack_localizer/snbt/formatter.rb
 - lib/modpack_localizer/snbt/performer.rb
@@ -155,7 +158,6 @@ files:
 - lib/modpack_localizer/util/help.rb
 - lib/modpack_localizer/util/indent_helper.rb
 - lib/modpack_localizer/util/version.rb
-- rake_helper.rb
 - sig/jp_quest.rbs
 homepage: https://github.com/milkeclair/modpack_localizer
 licenses:

data/rake_helper.rb

@@ -1,29 +0,0 @@
-# frozen_string_literal: true
-
-class RakeHelper
-  GITHUB_PACKAGES_PUSH_COMMAND =
-    "gem push --key github --host https://rubygems.pkg.github.com/milkeclair " \
-    "pkg/modpack_localizer-#{ModpackLocalizer::VERSION}.gem".freeze
-
-  RUBYGEMS_PUSH_COMMAND =
-    "gem push --host https://rubygems.org " \
-    "pkg/modpack_localizer-#{ModpackLocalizer::VERSION}.gem".freeze
-
-  def self.init_rake_tasks
-    RSpec::Core::RakeTask.new(:spec) { |task| task.verbose = false }
-    RuboCop::RakeTask.new
-    YARD::Rake::YardocTask.new
-  end
-
-  def self.build_gem
-    abort("gemのビルドに失敗しました") unless system("rake build")
-  end
-
-  def self.push_to_github_packages
-    abort("githubへのgemのpushに失敗しました") unless system(GITHUB_PACKAGES_PUSH_COMMAND)
-  end
-
-  def self.push_to_rubygems
-    abort("rubygemsへのgemのpushに失敗しました") unless system(RUBYGEMS_PUSH_COMMAND)
-  end
-end