loco_strings 0.1.3 → 0.1.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 567e3981149f49dd55a99138ca51993030011f886c227f3cd8809c5a0c1e48c5
-  data.tar.gz: d9424623eeb635a2798a4f858701be4fa1897714af4181caa5863dbcb8d4bf4d
+  metadata.gz: c2d39a13c5afee6bd306c83aee1793452203d521b426645f1fa885b4b3da1e29
+  data.tar.gz: bd6c23d23e3fb41c39d213f5f33b4f787cf4bea2e323a46b018382a402ca98ec
 SHA512:
-  metadata.gz: 50404d9b25812983c3b6f537d4220572f7df87c837b19411fd22293cc6c1abae4550ec3e630bc359853b8092802cf8324a2b4db8b753ba830d20e0d42bae82c3
-  data.tar.gz: f650a177e645204d68e6cd65fa87214976b5c258c266d90bcdf61a1061bd49466a442dd74d3bac22b1fe7a86b13ecacedb90a32bff5fbf0db3e4c70fc4dd63e4
+  metadata.gz: 90f78c9ba808022d66e4495906c67699023cf224b552ad67b28db15ef040d1da3afabb7b72423630af5d46d17f857fa77cae032881669b222e6d17cb812d8aea
+  data.tar.gz: 65d4ee5ce0b91ba6e084e0ad84942e88a499476d334d5b8990e097312983b5a0ecd4a153275ff953fe9704f72df69a83320fe02694ac8357e7b3b3130ba39aab

data/.rubocop.yml

@@ -1,5 +1,6 @@
 AllCops:
   TargetRubyVersion: 2.6
+  NewCops: enable
 
 Style/StringLiterals:
   Enabled: true

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    loco_strings (0.1.3)
+    loco_strings (0.1.4.1)
       nokogiri (~> 1.13, >= 1.13.8)
 
 GEM

data/lib/loco_strings/decoders/xcstrings_decoder.rb

@@ -0,0 +1,107 @@
+# frozen_string_literal: true
+
+require "json"
+
+module LocoStrings
+  # The XCStringsDecoder class is responsible for decoding the XCStrings file format.
+  class XCStringsDecoder
+    attr_reader :language, :strings, :translations, :languages
+
+    def initialize(file_path)
+      @file_path = file_path
+      @strings = {}
+      @translations = {}
+      @languages = []
+      @language = nil
+    end
+
+    def decode
+      return @strings unless File.exist?(@file_path)
+
+      file = File.read(@file_path)
+      json = JSON.parse(file)
+      extract_languages(json)
+      @language = json["sourceLanguage"]
+      decode_strings(json)
+      @strings
+    end
+
+    private
+
+    def extract_languages(json)
+      @languages = []
+      json["strings"].each do |_key, value|
+        next unless value.key?("localizations")
+
+        value["localizations"].each do |lang, _loc|
+          @languages << lang
+        end
+      end
+      @languages.uniq!
+    end
+
+    def decode_strings(json)
+      strings = json["strings"]
+      strings.each do |key, value|
+        val = decode_string(key, value, @language)
+        @strings[key] = val if val
+        @strings[key] = LocoString.new(key, key, value["comment"], "new") if val.nil?
+
+        decode_translations(key, value)
+      end
+    end
+
+    def decode_string(key, value, language)
+      return unless value.key?("localizations")
+
+      loc = value.dig("localizations", language)
+      return if loc.nil?
+
+      if loc.key?("stringUnit")
+        decode_string_unit(key, loc, value["comment"])
+      elsif loc.key?("variations")
+        decode_variations(key, loc, value["comment"])
+      end
+    end
+
+    def decode_string_unit(key, value, comment)
+      return nil unless value.key?("stringUnit")
+
+      unit = value["stringUnit"]
+      translation = unit["value"]
+      LocoString.new(key, translation, comment, unit["state"]) unless translation.nil?
+    end
+
+    def decode_variations(key, value, comment)
+      variations = value["variations"]
+      plural = decode_plural(variations, comment)
+      return nil if plural.empty?
+
+      variation = LocoVariantions.new(key, comment)
+      plural.each do |unit|
+        variation.append_string(unit)
+      end
+      variation
+    end
+
+    def decode_plural(variation, comment)
+      plural = variation["plural"]
+      return [] if plural.nil?
+
+      result = []
+      plural.each do |key, value|
+        unit = decode_string_unit(key, value, comment)
+        result << unit unless unit.nil?
+      end
+      result
+    end
+
+    def decode_translations(key, value)
+      @languages.each do |language|
+        string = decode_string(key, value, language)
+        @translations[language] ||= {}
+        @translations[language][key] = string
+      end
+    end
+  end
+end

data/lib/loco_strings/encoders/xcstrings_encoder.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+require "json"
+
+module LocoStrings
+  # The XCStringsEncoder class is responsible for encoding the LocoStrings data to the XCStrings format.
+  class XCStringsEncoder
+    attr_reader :language, :strings, :translations, :languages
+
+    def initialize(strings, translations, languages, language)
+      @strings = strings
+      @translations = translations
+      @languages = languages
+      @language = language
+    end
+
+    def encode
+      raise Error, "The base language is not defined" if @language.nil?
+
+      json = {
+        "sourceLanguage" => @language,
+        "strings" => {},
+        "version" => "1.0"
+      }
+      generate_keys.each do |key|
+        json["strings"][key] = encode_key(key)
+      end
+      JSON.pretty_generate(json, { space_before: " " })
+    end
+
+    private
+
+    def generate_keys
+      keys = []
+      @translations.each do |_, translation|
+        keys += translation.keys
+      end
+      keys.uniq
+    end
+
+    def encode_key(key)
+      row = {}
+      @translations.each do |language, translation|
+        next unless translation.key?(key)
+
+        value = translation[key]
+        next if value.nil?
+
+        row["comment"] = value.comment unless row.key?("comment") || value.comment.nil?
+        row["localizations"] ||= {}
+        row["localizations"][language] = encode_value(value)
+      end
+      row
+    end
+
+    def encode_value(value)
+      if value.is_a?(LocoVariantions)
+        encode_variations(value)
+      else
+        encode_string_unit(value)
+      end
+    end
+
+    def encode_string_unit(unit)
+      res = { "stringUnit" => {} }
+      res["stringUnit"]["state"] = if unit.state.nil?
+                                     "new"
+                                   else
+                                     unit.state
+                                   end
+      res["stringUnit"]["value"] = unit.value
+      res
+    end
+
+    def encode_variations(variations)
+      plural = {}
+      variations.strings.each do |key, string|
+        plural[key] = encode_string_unit(string) unless string.nil?
+      end
+      {
+        "variations" => {
+          "plural" => plural
+        }
+      }
+    end
+  end
+end

data/lib/loco_strings/parsers/android_file.rb

@@ -29,7 +29,7 @@ module LocoStrings
           end
         end
       end
-      File.open(@file_path, "w") { |file| file.write(builder.to_xml) }
+      File.write(@file_path, builder.to_xml)
     end
 
     private

data/lib/loco_strings/parsers/ios_file.rb

@@ -25,7 +25,7 @@ module LocoStrings
         output += "/* #{value.comment} */\n" if value.comment
         output += "\"#{key}\" = \"#{value.value}\";\n"
       end
-      File.open(@file_path, "w") { |file| file.write(output) }
+      File.write(@file_path, output)
     end
 
     private

data/lib/loco_strings/parsers/loco_file.rb

@@ -23,7 +23,7 @@ module LocoStrings
     end
 
     def update(key, value, comment = nil)
-      comment = @strings[key].comment if comment.nil? && @strings.has_key?(key)
+      comment = @strings[key].comment if comment.nil? && @strings.key?(key)
       @strings[key] = LocoString.new key, value, comment
     end
 

data/lib/loco_strings/parsers/xcstrings_file.rb

@@ -1,107 +1,84 @@
+# frozen_string_literal: true
+
 require_relative "loco_file"
+require_relative "../encoders/xcstrings_encoder"
+require_relative "../decoders/xcstrings_decoder"
 require "json"
 
 module LocoStrings
+  # The XCStringsFile class is responsible for reading and writing the XCStrings file format.
   class XCStringsFile < LocoFile
     def read
       clean
       return @strings unless File.exist?(@file_path)
 
-      comment = nil
-      file = File.read(@file_path)
-      json = JSON.parse(file)
-      extract_languages(json)
-      @language = json["sourceLanguage"]
-      @translations = {}
-      strings = json["strings"]
-      strings.each do |key, value|
-        comment = value["comment"]
-        translation = key
-        if value.has_key?("localizations") && value["localizations"].has_key?(@language)
-          loc = value["localizations"][@language]
-        end
-        translation = loc["stringUnit"]["value"] unless loc.nil?
-        @strings[key] = LocoString.new key, translation, comment unless translation.nil?
-        for language in @languages
-          next unless value.has_key?("localizations") && value["localizations"].has_key?(language)
-
-          loc = value["localizations"][language]
-          translation = loc["stringUnit"]["value"] unless loc.nil?
-          @translations[language] = {} unless @translations.has_key?(language)
-          @translations[language][key] = translation unless translation.nil?
-        end
-      end
+      decoder = XCStringsDecoder.new(@file_path)
+      decoder.decode
+
+      @language = decoder.language
+      @strings = decoder.strings
+      @translations = decoder.translations
+      @languages = decoder.languages
       @strings
     end
 
     def write
       raise Error, "The base language is not defined" if @language.nil?
 
-      json = {}
-      json["sourceLanguage"] = @language
-      json["strings"] = {}
-      @strings.each do |key, value|
-        row = {}
-        row["comment"] = value.comment unless value.comment.nil?
-        localizations = {}
-        if value.value != key && !value.value.nil?
-          localizations[@language] = {
-            "stringUnit" => {
-              "state" => "translated",
-              "value" => value.value
-            }
-          }
-        end
-        @languages.each do |language|
-          next if language == @language
-          next unless @translations.has_key?(language) && @translations[language].has_key?(key)
-
-          localizations[language] = {
-            "stringUnit" => {
-              "state" => "translated",
-              "value" => @translations[language][key]
-            }
-          }
-        end
-        row["localizations"] = localizations unless localizations.empty?
-        json["strings"][key] = row
-      end
-      json["version"] = "1.0"
-      File.open(@file_path, "w") { |file| file.write(JSON.pretty_generate(json)) }
+      json = XCStringsEncoder.new(@strings, @translations, @languages, @language).encode
+      File.write(@file_path, json)
     end
 
-    def update(key, value, comment = nil, language = @language)
-      raise Error, "The base language is not defined" if @language.nil?
+    def update(key, value, comment = nil, stage = nil, language = @language)
+      raise Error, "The base language is not defined" if language.nil?
 
-      if @language != language
-        @languages << language unless @languages.include?(language)
-        @translations[language] = {} unless @translations.has_key?(language)
-        @translations[language][key] = value
-        @strings[key] = LocoString.new key, key, comment unless @strings.has_key?(key)
-        return
-      end
-      comment = @strings[key].comment if @strings.has_key?(key) && (comment.nil? && @strings.has_key?(key))
-      @strings[key] = LocoString.new key, value, comment
-    end
+      stage = "translated" if stage.nil?
+      string = make_strings(key, value, comment, stage, language)
+      return if string.nil?
 
-    def value(key, language = nil)
-      return @strings[key] if language.nil? || language == @language
-      return @translations[language][key] if @translations.has_key?(language) && @translations[language].has_key?(key)
+      @translations[language] ||= {}
+      @translations[language][key] = string
+      @strings[key] = string if @language == language
     end
 
-    def clean
-      @strings = {}
-      @translations = {}
-      @languages = []
-      @language = nil
+    def update_variation(key, variant, strings, comment = nil, state = nil, language = @language) # rubocop:disable Metrics/ParameterLists
+      raise Error, "The base language is not defined" if language.nil?
+
+      variations = make_variations(key, variant, strings, comment, state, language)
+      return if variations.nil?
+
+      @translations[language] ||= {}
+      @translations[language][key] = variations
+      @strings[key] = variations if @language == language
     end
 
-    def set_language(language)
+    def select_language(language)
       raise Error, "The base language is aready defined" unless @language.nil?
 
       @language = language
     end
 
+    def value(key)
+      raise Error, "The base language is not defined" if @language.nil?
+
+      value_by_language(key, @language)
+    end
+
+    def value_by_language(key, language)
+      str = @translations.dig(language, key)
+      return nil if str.nil?
+
+      if str.is_a?(LocoString)
+        str.value
+      elsif str.is_a?(LocoVariantions)
+        str.strings.map { |_, v| v.value }
+      end
+    end
+
+    def unit(key, language = @language)
+      @translations.dig(language, key)
+    end
+
     def to_s
       result = ""
       result += "Base language: #{@language}\n" unless @language.nil?
@@ -113,18 +90,39 @@ module LocoStrings
       result
     end
 
+    def clean
+      @strings = {}
+      @translations = {}
+      @languages = []
+      @language = nil
+    end
+
     private
 
-    def extract_languages(json)
-      @languages = []
-      json["strings"].each do |_key, value|
-        next unless value.has_key?("localizations")
+    def make_strings(key, value, comment = nil, state = nil, language = @language)
+      unit = @translations.dig(language, key)
+      return LocoString.new(key, value, comment, state) if unit.nil?
+
+      if unit.is_a?(LocoVariantions)
+        puts "Variations not supported through this method"
+        return nil
+      end
+      unit.update(value, comment, state)
+      unit
+    end
+
+    def make_variations(key, variant, value, comment = nil, state = nil, language = @language) # rubocop:disable Metrics/ParameterLists
+      variants = @translations.dig(language, key)
 
-        value["localizations"].each do |lang, _loc|
-          @languages << lang
-        end
+      return make_strings(key, value, comment, state, language) if variants.is_a?(LocoString)
+
+      if variants.nil?
+        state = "new" if state.nil?
+        return LocoVariantions.new(key, { variant => LocoString.new(variant, value, comment, state) })
       end
-      @languages.uniq!
+
+      variants.update_variant(variant, value, comment, state)
+      variants
     end
   end
 end

data/lib/loco_strings/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module LocoStrings
-  VERSION = "0.1.3"
+  VERSION = "0.1.4.1"
 end

data/lib/loco_strings.rb

@@ -9,17 +9,46 @@ require_relative "loco_strings/parsers/xcstrings_file"
 module LocoStrings
   class Error < StandardError; end
 
-  LocoString = Struct.new(:key, :value, :comment) do
-    def initialize(key, value, comment = nil)
+  LocoString = Struct.new(:key, :value, :comment, :state) do
+    def initialize(key, value, comment = nil, state = nil)
       super
     end
 
+    def update(value, comment = nil, state = nil)
+      self.value = value
+      self.comment = comment unless comment.nil?
+      self.state = state
+    end
+
+    def to_s
+      "Key: #{key}, Value: #{value}, Comment: #{comment || "None"}, State: #{state || "None"}"
+    end
+  end
+
+  LocoVariantions = Struct.new(:key, :strings, :comment) do
+    def initialize(key, strings = nil, comment = nil)
+      super
+      self.strings = strings || {}
+    end
+
+    def append_string(string)
+      strings[string.key] = string
+    end
+
+    def update_variant(key, value, comment = nil, state = nil)
+      if strings.key? key
+        strings[key].update(value, comment, state)
+      else
+        strings[key] = LocoString.new(key, value, comment, state)
+      end
+    end
+
     def to_s
-      "Key: #{key}, Value: #{value}, Comment: #{comment || "None"}"
+      "Key: #{key}, Strings: #{strings}, Comment: #{comment || "None"}"
     end
   end
 
-  def self.load(file_path)
+  def self.load(file_path) # rubocop:disable Metrics/MethodLength
     ext = File.extname(file_path)
     raise Error, "Unsupported file format: #{ext}" unless [".strings", ".xml", ".xcstrings"].include? ext
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: loco_strings
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.4.1
 platform: ruby
 authors:
 - Aleksei Cherepanov
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-11-16 00:00:00.000000000 Z
+date: 2024-02-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri
@@ -53,12 +53,13 @@ files:
 - README.md
 - Rakefile
 - lib/loco_strings.rb
+- lib/loco_strings/decoders/xcstrings_decoder.rb
+- lib/loco_strings/encoders/xcstrings_encoder.rb
 - lib/loco_strings/parsers/android_file.rb
 - lib/loco_strings/parsers/ios_file.rb
 - lib/loco_strings/parsers/loco_file.rb
 - lib/loco_strings/parsers/xcstrings_file.rb
 - lib/loco_strings/version.rb
-- loco_strings.gemspec
 - sig/loco_strings.rbs
 homepage: https://github.com/ftp27/loco_strings
 licenses:
@@ -66,6 +67,7 @@ licenses:
 metadata:
   homepage_uri: https://github.com/ftp27/loco_strings
   source_code_uri: https://github.com/ftp27/loco_strings
+  rubygems_mfa_required: 'true'
 post_install_message:
 rdoc_options: []
 require_paths:

data/loco_strings.gemspec

@@ -1,40 +0,0 @@
-# frozen_string_literal: true
-
-# rubocop:disable Layout/LineLength
-
-require_relative "lib/loco_strings/version"
-
-Gem::Specification.new do |spec|
-  spec.name = "loco_strings"
-  spec.version = LocoStrings::VERSION
-  spec.authors = ["Aleksei Cherepanov"]
-  spec.email = ["ftp27host@gmail.com"]
-
-  spec.summary = "LocoStrings is a Ruby gem for working with iOS and Android localization strings."
-  spec.description = "LocoStrings is a powerful and easy-to-use Ruby gem that simplifies the process of managing localization strings for iOS and Android apps. With LocoStrings, you can easily extract, organize, and update your app's localized strings in one place, making it easy to maintain consistency across all of your app's translations. LocoStrings supports multiple file formats, including XLIFF and CSV, and provides a simple and intuitive API for working with your app's strings in code. Whether you're a solo developer or part of a team, LocoStrings makes managing your app's localization a breeze."
-  spec.homepage = "https://github.com/ftp27/loco_strings"
-  spec.license = "MIT"
-  spec.required_ruby_version = ">= 2.6.0"
-
-  spec.metadata["homepage_uri"] = spec.homepage
-  spec.metadata["source_code_uri"] = spec.homepage
-
-  # Specify which files should be added to the gem when it is released.
-  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
-  spec.files = Dir.chdir(__dir__) do
-    `git ls-files -z`.split("\x0").reject do |f|
-      (File.expand_path(f) == __FILE__) || f.start_with?(*%w[bin/ test/ spec/ features/ .git .circleci appveyor])
-    end
-  end
-  spec.bindir = "exe"
-  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
-  spec.require_paths = ["lib"]
-
-  # Uncomment to register a new dependency of your gem
-  spec.add_dependency "nokogiri", "~> 1.13", ">= 1.13.8"
-
-  # For more information and examples about making a new gem, check out our
-  # guide at: https://bundler.io/guides/creating_gem.html
-end
-
-# rubocop:enable Layout/LineLength