web_translate_it 3.1.2 → 3.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d4db3eb8623580c53dff0ca3d6e4dea860781436b20c9ff4580bf53e5a7661d0
-  data.tar.gz: f68c3e3ef4b7ed934a6df20da1c4eb13afaa7c115468595f241efc4bc3f5dea5
+  metadata.gz: d9a027a46383d8932b3776d7c614592e3bb186bed328954f0a39bd2e168f2ba3
+  data.tar.gz: 75bd8ab7c9129e6fb4f6c3c982fee30b1793a01ce2ba8219aa4e2480cb491246
 SHA512:
-  metadata.gz: 2faab2844f1ed735004291f6dc7def7cdb630837c18e4e526ca90dc83cb537379090f825403a5cfb2b758fa7213945419fd47eb45e849b154b20af1cbf54d3a5
-  data.tar.gz: b1ae273de1459eabe8ad461d0eee5261e2428aff6ad69230ee7af9a1806302efb09fcea4af7f864c0f6fde697ef7558339777717d583a6cdac95e92a5e9c70ae
+  metadata.gz: 20ce007c03f2a00b5eb2c4ba019f37b814ad5184792a1d14a6231351402f0c5988d470a6f64e1b732a2409c74a8f9696b542b3b12aa7ab9c267f0f1c94c5f3ef
+  data.tar.gz: 6aafb08ddff729b498093150eddafd55410f45a1f8d0239d7a11a5c1a2a06ccff802bd53996d442ef89da955ba38b290b25aad6e0f8bb7182e15527faec2d418

data/bin/wti

@@ -13,6 +13,7 @@ show_commands = <<~COMMANDS
      pull        Pull target language file(s)
      push        Push master language file(s)
      match       Display matching of local files with File Manager
+     diff        Display a diff between local and remote files
      add         Create and push a new master language file
      rm          Delete a master language file from a project
      mv          Moves a file both locally and from a project
@@ -26,7 +27,7 @@ show_commands = <<~COMMANDS
   [options] are:
 COMMANDS
 
-SUB_COMMANDS = %w[pull push match add rm mv addlocale rmlocale status st init].freeze
+SUB_COMMANDS = %w[pull push match diff add rm mv addlocale rmlocale status st init].freeze
 global_options = Optimist.options do
   stop_on SUB_COMMANDS
   banner show_commands
@@ -65,6 +66,15 @@ when 'push'
     opt :all,    'DEPRECATED -- See `wti push --target` instead'
     opt :debug,  'Display debug information'
   end
+when 'diff'
+  Optimist.options do
+    banner <<~BANNER
+      wti diff [filename] - Display a diff between local and remote files
+      [options] are:
+    BANNER
+    opt :config, 'Path to a configuration file', short: '-c', default: '.wti'
+    opt :debug,  'Display debug information'
+  end
 when 'add'
   Optimist.options do
     banner 'wti add filename - Create and push a new master language file'

data/history.md

@@ -1,3 +1,12 @@
+## Version 3.2.1 / 2026-03-02
+
+* Refactor `Connection` class to eliminate class variables. #254
+* Fix `find_all` to guard against non-2xx API responses. #355
+
+## Version 3.2.0 / 2026-01-14
+
+* Add `wti diff` command.
+
 ## Version 3.1.2 / 2025-06-06
 
 * Fix `wti mv` command. #366

data/lib/web_translate_it/command_line.rb

@@ -1,12 +1,14 @@
 # frozen_string_literal: true
 
+require 'tempfile'
+
 module WebTranslateIt
 
   class CommandLine # rubocop:todo Metrics/ClassLength
 
     attr_accessor :configuration, :global_options, :command_options, :parameters
 
-    def initialize(command, command_options, _global_options, parameters, project_path) # rubocop:todo Metrics/CyclomaticComplexity, Metrics/MethodLength
+    def initialize(command, command_options, _global_options, parameters, project_path) # rubocop:todo Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/AbcSize
       self.command_options = command_options
       self.parameters = parameters
       unless command == 'init'
@@ -15,6 +17,8 @@ module WebTranslateIt
           'Pulling files'
         when 'push'
           'Pushing files'
+        when 'diff'
+          'Diffing files'
         when 'add'
           'Creating master files'
         when 'rm'
@@ -64,9 +68,9 @@ module WebTranslateIt
           next if file_array.empty?
 
           threads << Thread.new(file_array) do |f_array|
-            WebTranslateIt::Connection.new(configuration.api_key) do |http|
+            WebTranslateIt::Connection.new(configuration.api_key) do |conn|
               f_array.each do |file|
-                success = file.fetch(http, command_options.force)
+                success = file.fetch(conn.http_connection, command_options.force)
                 complete_success = false unless success
               end
             end
@@ -107,7 +111,7 @@ module WebTranslateIt
       complete_success = true
       $stdout.sync = true
       before_push_hook
-      WebTranslateIt::Connection.new(configuration.api_key) do |http|
+      WebTranslateIt::Connection.new(configuration.api_key) do |conn|
         fetch_locales_to_push(configuration).each do |locale|
           files = if parameters.any?
             configuration.files.find_all { |file| parameters.include?(file.file_path) }.sort { |a, b| a.file_path <=> b.file_path }
@@ -118,7 +122,7 @@ module WebTranslateIt
             puts "Couldn't find any local files registered on WebTranslateIt to push."
           else
             files.each do |file|
-              success = file.upload(http, command_options[:merge], command_options.ignore_missing, command_options.label, command_options[:minor], command_options.force)
+              success = file.upload(conn.http_connection, command_options[:merge], command_options.ignore_missing, command_options.label, command_options[:minor], command_options.force)
               complete_success = false unless success
             end
           end
@@ -150,6 +154,42 @@ module WebTranslateIt
       end
     end
 
+    def diff # rubocop:todo Metrics/AbcSize, Metrics/MethodLength, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
+      complete_success = true
+      $stdout.sync = true
+      WebTranslateIt::Connection.new(configuration.api_key) do |conn| # rubocop:todo Metrics/BlockLength
+        files = if parameters.any?
+          configuration.files.find_all { |file| parameters.include?(file.file_path) }.sort { |a, b| a.file_path <=> b.file_path }
+        else
+          configuration.files.find_all { |file| file.locale == configuration.source_locale }.sort { |a, b| a.file_path <=> b.file_path }
+        end
+        if files.empty?
+          puts "Couldn't find any local files registered on WebTranslateIt to diff."
+        else
+          files.each do |file|
+            if File.exist?(file.file_path)
+              remote_content = file.fetch_remote_content(conn.http_connection)
+              if remote_content
+                temp_file = Tempfile.new('wti')
+                temp_file.write(remote_content)
+                temp_file.close
+                puts "Diff for #{file.file_path}:"
+                system "diff #{temp_file.path} #{file.file_path}"
+                temp_file.unlink
+              else
+                puts StringUtil.failure("Couldn't fetch remote file #{file.file_path}")
+                complete_success = false
+              end
+            else
+              puts StringUtil.failure("Can't diff #{file.file_path}. File doesn't exist locally.")
+              complete_success = false
+            end
+          end
+        end
+      end
+      complete_success
+    end
+
     def add # rubocop:todo Metrics/AbcSize, Metrics/MethodLength
       complete_success = true
       $stdout.sync = true
@@ -158,13 +198,13 @@ module WebTranslateIt
         puts 'Usage: wti add path/to/master_file_1 path/to/master_file_2 ...'
         exit
       end
-      WebTranslateIt::Connection.new(configuration.api_key) do |http|
+      WebTranslateIt::Connection.new(configuration.api_key) do |conn|
         added = configuration.files.find_all { |file| file.locale == configuration.source_locale }.to_set { |file| File.expand_path(file.file_path) }
         to_add = parameters.reject { |param| added.include?(File.expand_path(param)) }
         if to_add.any?
           to_add.each do |param|
             file = TranslationFile.new(nil, param.gsub(/ /, '\\ '), nil, configuration.api_key)
-            success = file.create(http)
+            success = file.create(conn.http_connection)
             complete_success = false unless success
           end
         else
@@ -182,14 +222,14 @@ module WebTranslateIt
         puts 'Usage: wti rm path/to/master_file_1 path/to/master_file_2 ...'
         exit
       end
-      WebTranslateIt::Connection.new(configuration.api_key) do |http| # rubocop:todo Metrics/BlockLength
+      WebTranslateIt::Connection.new(configuration.api_key) do |conn| # rubocop:todo Metrics/BlockLength
         parameters.each do |param|
           next unless Util.ask_yes_no("Are you sure you want to delete the master file #{param}?\nThis will also delete its target files and translations.", false)
 
           files = configuration.files.find_all { |file| file.file_path == param }
           if files.any?
             files.each do |master_file|
-              master_file.delete(http)
+              master_file.delete(conn.http_connection)
               # delete files
               if File.exist?(master_file.file_path)
                 success = File.delete(master_file.file_path)
@@ -225,10 +265,10 @@ module WebTranslateIt
       end
       source = parameters[0]
       destination = parameters[1]
-      WebTranslateIt::Connection.new(configuration.api_key) do |http|
+      WebTranslateIt::Connection.new(configuration.api_key) do |conn|
         if Util.ask_yes_no("Are you sure you want to move the master file #{source} and its target files?", true)
           configuration.files.find_all { |file| file.file_path == source }.each do |master_file|
-            master_file.upload(http, false, false, nil, false, true, true, destination)
+            master_file.upload(conn.http_connection, false, false, nil, false, true, true, destination)
             # move master file
             if File.exist?(source)
               success = File.rename(source, destination) if File.exist?(source)
@@ -243,7 +283,7 @@ module WebTranslateIt
             end
             configuration.reload
             configuration.files.find_all { |file| file.master_id == master_file.id }.each do |target_file|
-              success = target_file.fetch(http)
+              success = target_file.fetch(conn.http_connection)
               complete_success = false unless success
             end
             puts StringUtil.success('All done.') if complete_success
@@ -262,8 +302,8 @@ module WebTranslateIt
       end
       parameters.each do |param|
         print StringUtil.success("Adding locale #{param.upcase}... ")
-        WebTranslateIt::Connection.new(configuration.api_key) do
-          WebTranslateIt::Project.create_locale(param)
+        WebTranslateIt::Connection.new(configuration.api_key) do |conn|
+          WebTranslateIt::Project.create_locale(conn, param)
         end
         puts 'Done.'
       end
@@ -280,8 +320,8 @@ module WebTranslateIt
         next unless Util.ask_yes_no("Are you certain you want to delete the locale #{param.upcase}?\nThis will also delete its files and translations.", false)
 
         print StringUtil.success("Deleting locale #{param.upcase}... ")
-        WebTranslateIt::Connection.new(configuration.api_key) do
-          WebTranslateIt::Project.delete_locale(param)
+        WebTranslateIt::Connection.new(configuration.api_key) do |conn|
+          WebTranslateIt::Project.delete_locale(conn, param)
         end
         puts 'Done.'
       end
@@ -296,7 +336,7 @@ module WebTranslateIt
         api_key = Util.ask(' Project API Key:')
         path = Util.ask(' Path to configuration file:', '.wti')
       end
-      FileUtils.mkpath(path.split('/')[0..path.split('/').size - 2].join('/')) unless path.split('/').size == 1
+      FileUtils.mkpath(path.split('/')[0..(path.split('/').size - 2)].join('/')) unless path.split('/').size == 1
       project = JSON.parse WebTranslateIt::Project.fetch_info(api_key)
       project_info = project['project']
       if File.exist?(path) && !File.writable?(path)

data/lib/web_translate_it/connection.rb

@@ -4,36 +4,36 @@ module WebTranslateIt
 
   class Connection
 
-    @@api_key = nil
-    @@http_connection = nil
-    @@debug = false
+    @debug = false
+
+    class << self
+
+      attr_reader :debug
+
+    end
+
+    attr_reader :api_key, :http_connection
 
     #
     # Initialize and yield a HTTPS Keep-Alive connection to WebTranslateIt.com
     #
     # Usage:
     #
-    # WebTranslateIt::Connection.new(api_key) do
-    #   # do something with Connection.api_key and Connection.http_connection
-    # end
-    #
-    # Or:
-    #
-    # WebTranslateIt::Connection.new(api_key) do |http_connection|
-    #   http_connection.request(request)
+    # WebTranslateIt::Connection.new(api_key) do |connection|
+    #   connection.http_connection.request(request)
     # end
     #
     def initialize(api_key) # rubocop:todo Metrics/AbcSize, Metrics/MethodLength
-      @@api_key = api_key
+      @api_key = api_key
       proxy = ENV['http_proxy'] ? URI.parse(ENV['http_proxy']) : Struct.new(:host, :port, :user, :password).new
       http = Net::HTTP::Proxy(proxy.host, proxy.port, proxy.user, proxy.password).new('webtranslateit.com', 443)
       http.use_ssl      = true
       http.open_timeout = http.read_timeout = 60
-      http.set_debug_output($stderr) if @@debug
+      http.set_debug_output($stderr) if self.class.debug
       begin
         http.verify_mode = OpenSSL::SSL::VERIFY_PEER
-        @@http_connection = http.start
-        yield @@http_connection if block_given?
+        @http_connection = http.start
+        yield self if block_given?
       rescue OpenSSL::SSL::SSLError
         puts 'Error: Unable to verify SSL certificate.'
         exit 1
@@ -43,15 +43,7 @@ module WebTranslateIt
     end
 
     def self.turn_debug_on
-      @@debug = true
-    end
-
-    def self.api_key
-      @@api_key
-    end
-
-    def self.http_connection
-      @@http_connection
+      @debug = true
     end
 
   end

data/lib/web_translate_it/project.rb

@@ -8,10 +8,10 @@ module WebTranslateIt
       success = true
       tries ||= 3
       begin
-        WebTranslateIt::Connection.new(api_key) do |http|
+        WebTranslateIt::Connection.new(api_key) do |conn|
           request = Net::HTTP::Get.new("/api/projects/#{api_key}")
           WebTranslateIt::Util.add_fields(request)
-          response = http.request(request)
+          response = conn.http_connection.request(request)
           return response.body if response.is_a?(Net::HTTPSuccess)
 
           puts 'An error occured while fetching the project information:'
@@ -37,10 +37,10 @@ module WebTranslateIt
       success = true
       tries ||= 3
       begin
-        WebTranslateIt::Connection.new(api_key) do |http|
+        WebTranslateIt::Connection.new(api_key) do |conn|
           request = Net::HTTP::Get.new(url)
           WebTranslateIt::Util.add_fields(request)
-          return Util.handle_response(http.request(request), true)
+          return Util.handle_response(conn.http_connection.request(request), true)
         end
       rescue Timeout::Error
         puts 'Request timeout. Will retry in 5 seconds.'
@@ -54,14 +54,14 @@ module WebTranslateIt
       success
     end
 
-    def self.create_locale(locale_code) # rubocop:todo Metrics/MethodLength
+    def self.create_locale(connection, locale_code) # rubocop:todo Metrics/MethodLength
       success = true
       tries ||= 3
       begin
-        request = Net::HTTP::Post.new("/api/projects/#{Connection.api_key}/locales")
+        request = Net::HTTP::Post.new("/api/projects/#{connection.api_key}/locales")
         WebTranslateIt::Util.add_fields(request)
         request.set_form_data({'id' => locale_code}, ';')
-        Util.handle_response(Connection.http_connection.request(request), true)
+        Util.handle_response(connection.http_connection.request(request), true)
       rescue Timeout::Error
         puts 'Request timeout. Will retry in 5 seconds.'
         if (tries -= 1).positive?
@@ -74,13 +74,13 @@ module WebTranslateIt
       success
     end
 
-    def self.delete_locale(locale_code) # rubocop:todo Metrics/MethodLength
+    def self.delete_locale(connection, locale_code) # rubocop:todo Metrics/MethodLength
       success = true
       tries ||= 3
       begin
-        request = Net::HTTP::Delete.new("/api/projects/#{Connection.api_key}/locales/#{locale_code}")
+        request = Net::HTTP::Delete.new("/api/projects/#{connection.api_key}/locales/#{locale_code}")
         WebTranslateIt::Util.add_fields(request)
-        Util.handle_response(Connection.http_connection.request(request), true)
+        Util.handle_response(connection.http_connection.request(request), true)
       rescue Timeout::Error
         puts 'Request timeout. Will retry in 5 seconds.'
         if (tries -= 1).positive?

data/lib/web_translate_it/string.rb

@@ -5,7 +5,7 @@ module WebTranslateIt
   class String # rubocop:todo Metrics/ClassLength
 
     attr_accessor :id, :key, :plural, :type, :dev_comment, :word_count, :status, :category, :labels, :file,
-                  :created_at, :updated_at, :translations, :new_record
+                  :created_at, :updated_at, :translations, :new_record, :connection
 
     # Initialize a new WebTranslateIt::String
     #
@@ -21,8 +21,9 @@ module WebTranslateIt
     #
     # to instantiate a new String with a source and target translation.
 
-    def initialize(params = {}) # rubocop:todo Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/MethodLength, Metrics/PerceivedComplexity
+    def initialize(params = {}, connection: nil) # rubocop:todo Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/MethodLength, Metrics/PerceivedComplexity
       params.stringify_keys!
+      self.connection   = connection
       self.id           = params['id'] || nil
       self.key          = params['key'] || nil
       self.plural       = params['plural'] || nil
@@ -51,11 +52,11 @@ module WebTranslateIt
     #
     # to find and instantiate an array of String which key is like `product_name_123`.
 
-    def self.find_all(params = {}) # rubocop:todo Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/MethodLength, Metrics/PerceivedComplexity
+    def self.find_all(connection, params = {}) # rubocop:todo Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/MethodLength, Metrics/PerceivedComplexity
       success = true
       tries ||= 3
       params.stringify_keys!
-      url = "/api/projects/#{Connection.api_key}/strings"
+      url = "/api/projects/#{connection.api_key}/strings"
       url += "?#{HashUtil.to_params('filters' => params)}" unless params.empty?
 
       request = Net::HTTP::Get.new(url)
@@ -63,9 +64,11 @@ module WebTranslateIt
       begin
         strings = []
         while request
-          response = Connection.http_connection.request(request)
+          response = connection.http_connection.request(request)
+          return [] unless response.code.to_i < 400
+
           JSON.parse(response.body).each do |string_response|
-            string = WebTranslateIt::String.new(string_response)
+            string = WebTranslateIt::String.new(string_response, connection: connection)
             string.new_record = false
             strings.push(string)
           end
@@ -104,16 +107,16 @@ module WebTranslateIt
     # to find and instantiate the String which ID is `1234`.
     #
 
-    def self.find(id) # rubocop:todo Metrics/MethodLength, Metrics/AbcSize
+    def self.find(connection, id) # rubocop:todo Metrics/MethodLength, Metrics/AbcSize
       success = true
       tries ||= 3
-      request = Net::HTTP::Get.new("/api/projects/#{Connection.api_key}/strings/#{id}")
+      request = Net::HTTP::Get.new("/api/projects/#{connection.api_key}/strings/#{id}")
       WebTranslateIt::Util.add_fields(request)
       begin
-        response = Connection.http_connection.request(request)
+        response = connection.http_connection.request(request)
         return nil if response.code.to_i == 404
 
-        string = WebTranslateIt::String.new(JSON.parse(response.body))
+        string = WebTranslateIt::String.new(JSON.parse(response.body), connection: connection)
         string.new_record = false
         return string
       rescue Timeout::Error
@@ -156,10 +159,10 @@ module WebTranslateIt
     def delete # rubocop:todo Metrics/MethodLength
       success = true
       tries ||= 3
-      request = Net::HTTP::Delete.new("/api/projects/#{Connection.api_key}/strings/#{id}")
+      request = Net::HTTP::Delete.new("/api/projects/#{connection.api_key}/strings/#{id}")
       WebTranslateIt::Util.add_fields(request)
       begin
-        Util.handle_response(Connection.http_connection.request(request), true, true)
+        Util.handle_response(connection.http_connection.request(request), true, true)
       rescue Timeout::Error
         puts 'Request timeout. Will retry in 5 seconds.'
         if (tries -= 1).positive?
@@ -189,14 +192,15 @@ module WebTranslateIt
       return translation if translation
       return nil if new_record
 
-      request = Net::HTTP::Get.new("/api/projects/#{Connection.api_key}/strings/#{id}/locales/#{locale}/translations")
+      request = Net::HTTP::Get.new("/api/projects/#{connection.api_key}/strings/#{id}/locales/#{locale}/translations")
       WebTranslateIt::Util.add_fields(request)
       begin
-        response = Util.handle_response(Connection.http_connection.request(request), true, true)
+        response = Util.handle_response(connection.http_connection.request(request), true, true)
         hash = JSON.parse(response)
         return nil if hash.empty?
 
         translation = WebTranslateIt::Translation.new(hash)
+        translation.connection = connection
         return translation
       rescue Timeout::Error
         puts 'Request timeout. Will retry in 5 seconds.'
@@ -218,17 +222,18 @@ module WebTranslateIt
     def update # rubocop:todo Metrics/AbcSize, Metrics/MethodLength
       success = true
       tries ||= 3
-      request = Net::HTTP::Put.new("/api/projects/#{Connection.api_key}/strings/#{id}")
+      request = Net::HTTP::Put.new("/api/projects/#{connection.api_key}/strings/#{id}")
       WebTranslateIt::Util.add_fields(request)
       request.body = to_json
 
       translations.each do |translation|
         translation.string_id = id
+        translation.connection = connection
         translation.save
       end
 
       begin
-        Util.handle_response(Connection.http_connection.request(request), true, true)
+        Util.handle_response(connection.http_connection.request(request), true, true)
       rescue Timeout::Error
         puts 'Request timeout. Will retry in 5 seconds.'
         if (tries -= 1).positive?
@@ -247,11 +252,11 @@ module WebTranslateIt
     def create # rubocop:todo Metrics/AbcSize, Metrics/MethodLength
       success = true
       tries ||= 3
-      request = Net::HTTP::Post.new("/api/projects/#{Connection.api_key}/strings")
+      request = Net::HTTP::Post.new("/api/projects/#{connection.api_key}/strings")
       WebTranslateIt::Util.add_fields(request)
       request.body = to_json(true)
       begin
-        response = JSON.parse(Util.handle_response(Connection.http_connection.request(request), true, true))
+        response = JSON.parse(Util.handle_response(connection.http_connection.request(request), true, true))
         self.id = response['id']
         self.new_record = false
         return true

data/lib/web_translate_it/term.rb

@@ -4,7 +4,7 @@ module WebTranslateIt
 
   class Term # rubocop:todo Metrics/ClassLength
 
-    attr_accessor :id, :text, :description, :created_at, :updated_at, :translations, :new_record
+    attr_accessor :id, :text, :description, :created_at, :updated_at, :translations, :new_record, :connection
 
     # Initialize a new WebTranslateIt::Term
     #
@@ -20,8 +20,9 @@ module WebTranslateIt
     #
     # to instantiate a new Term with a Term Translations in Spanish and French.
 
-    def initialize(params = {})
+    def initialize(params = {}, connection: nil) # rubocop:todo Metrics/AbcSize
       params.stringify_keys!
+      self.connection   = connection
       self.id           = params['id'] || nil
       self.text         = params['text'] || nil
       self.description  = params['description'] || nil
@@ -41,11 +42,11 @@ module WebTranslateIt
     #
     #  puts terms.inspect #=> An array of WebTranslateIt::Term objects
 
-    def self.find_all(params = {}) # rubocop:todo Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/MethodLength, Metrics/PerceivedComplexity
+    def self.find_all(connection, params = {}) # rubocop:todo Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/MethodLength, Metrics/PerceivedComplexity
       success = true
       tries ||= 3
       params.stringify_keys!
-      url = "/api/projects/#{Connection.api_key}/terms"
+      url = "/api/projects/#{connection.api_key}/terms"
       url += "?#{HashUtil.to_params(params)}" unless params.empty?
 
       request = Net::HTTP::Get.new(url)
@@ -53,9 +54,11 @@ module WebTranslateIt
       begin
         terms = []
         while request
-          response = Connection.http_connection.request(request)
+          response = connection.http_connection.request(request)
+          return [] unless response.code.to_i < 400
+
           JSON.parse(response.body).each do |term_response|
-            term = WebTranslateIt::Term.new(term_response)
+            term = WebTranslateIt::Term.new(term_response, connection: connection)
             term.new_record = false
             terms.push(term)
           end
@@ -94,16 +97,16 @@ module WebTranslateIt
     # to find and instantiate the Term which ID is `1234`.
     #
 
-    def self.find(term_id) # rubocop:todo Metrics/MethodLength, Metrics/AbcSize
+    def self.find(connection, term_id) # rubocop:todo Metrics/MethodLength, Metrics/AbcSize
       success = true
       tries ||= 3
-      request = Net::HTTP::Get.new("/api/projects/#{Connection.api_key}/terms/#{term_id}")
+      request = Net::HTTP::Get.new("/api/projects/#{connection.api_key}/terms/#{term_id}")
       WebTranslateIt::Util.add_fields(request)
       begin
-        response = Connection.http_connection.request(request)
+        response = connection.http_connection.request(request)
         return nil if response.code.to_i == 404
 
-        term = WebTranslateIt::Term.new(JSON.parse(response.body))
+        term = WebTranslateIt::Term.new(JSON.parse(response.body), connection: connection)
         term.new_record = false
         return term
       rescue Timeout::Error
@@ -146,10 +149,10 @@ module WebTranslateIt
     def delete # rubocop:todo Metrics/MethodLength
       success = true
       tries ||= 3
-      request = Net::HTTP::Delete.new("/api/projects/#{Connection.api_key}/terms/#{id}")
+      request = Net::HTTP::Delete.new("/api/projects/#{connection.api_key}/terms/#{id}")
       WebTranslateIt::Util.add_fields(request)
       begin
-        Util.handle_response(Connection.http_connection.request(request), true, true)
+        Util.handle_response(connection.http_connection.request(request), true, true)
       rescue Timeout::Error
         puts 'Request timeout. Will retry in 5 seconds.'
         if (tries -= 1).positive?
@@ -179,10 +182,10 @@ module WebTranslateIt
       return translation if translation
       return nil if new_record
 
-      request = Net::HTTP::Get.new("/api/projects/#{Connection.api_key}/terms/#{id}/locales/#{locale}/translations")
+      request = Net::HTTP::Get.new("/api/projects/#{connection.api_key}/terms/#{id}/locales/#{locale}/translations")
       WebTranslateIt::Util.add_fields(request)
       begin
-        response = Util.handle_response(Connection.http_connection.request(request), true, true)
+        response = Util.handle_response(connection.http_connection.request(request), true, true)
         array = JSON.parse(response)
         return nil if array.empty?
 
@@ -209,17 +212,18 @@ module WebTranslateIt
     def update # rubocop:todo Metrics/AbcSize, Metrics/MethodLength
       success = true
       tries ||= 3
-      request = Net::HTTP::Put.new("/api/projects/#{Connection.api_key}/terms/#{id}")
+      request = Net::HTTP::Put.new("/api/projects/#{connection.api_key}/terms/#{id}")
       WebTranslateIt::Util.add_fields(request)
       request.body = to_json
 
       translations.each do |translation|
         translation.term_id = id
+        translation.connection = connection
         translation.save
       end
 
       begin
-        Util.handle_response(Connection.http_connection.request(request), true, true)
+        Util.handle_response(connection.http_connection.request(request), true, true)
       rescue Timeout::Error
         puts 'Request timeout. Will retry in 5 seconds.'
         if (tries -= 1).positive?
@@ -235,12 +239,12 @@ module WebTranslateIt
     def create # rubocop:todo Metrics/AbcSize, Metrics/MethodLength
       success = true
       tries ||= 3
-      request = Net::HTTP::Post.new("/api/projects/#{Connection.api_key}/terms")
+      request = Net::HTTP::Post.new("/api/projects/#{connection.api_key}/terms")
       WebTranslateIt::Util.add_fields(request)
       request.body = to_json(true)
 
       begin
-        response = JSON.parse(Util.handle_response(Connection.http_connection.request(request), true, true))
+        response = JSON.parse(Util.handle_response(connection.http_connection.request(request), true, true))
         self.id = response['id']
         self.new_record = false
         return true

data/lib/web_translate_it/term_translation.rb

@@ -4,7 +4,7 @@ module WebTranslateIt
 
   class TermTranslation
 
-    attr_accessor :id, :locale, :text, :description, :status, :new_record, :term_id
+    attr_accessor :id, :locale, :text, :description, :status, :new_record, :term_id, :connection
 
     # Initialize a new WebTranslateIt::TermTranslation
     #
@@ -59,12 +59,12 @@ module WebTranslateIt
     def create # rubocop:todo Metrics/AbcSize, Metrics/MethodLength
       success = true
       tries ||= 3
-      request = Net::HTTP::Post.new("/api/projects/#{Connection.api_key}/terms/#{term_id}/locales/#{locale}/translations")
+      request = Net::HTTP::Post.new("/api/projects/#{connection.api_key}/terms/#{term_id}/locales/#{locale}/translations")
       WebTranslateIt::Util.add_fields(request)
       request.body = to_json
 
       begin
-        response = JSON.parse(Util.handle_response(Connection.http_connection.request(request), true, true))
+        response = JSON.parse(Util.handle_response(connection.http_connection.request(request), true, true))
         self.id = response['id']
         self.new_record = false
         return true
@@ -80,14 +80,14 @@ module WebTranslateIt
       success
     end
 
-    def update # rubocop:todo Metrics/MethodLength
+    def update # rubocop:todo Metrics/AbcSize, Metrics/MethodLength
       success = true
       tries ||= 3
-      request = Net::HTTP::Put.new("/api/projects/#{Connection.api_key}/terms/#{id}/locales/#{locale}/translations/#{id}")
+      request = Net::HTTP::Put.new("/api/projects/#{connection.api_key}/terms/#{id}/locales/#{locale}/translations/#{id}")
       WebTranslateIt::Util.add_fields(request)
       request.body = to_json
       begin
-        Util.handle_response(Connection.http_connection.request(request), true, true)
+        Util.handle_response(connection.http_connection.request(request), true, true)
       rescue Timeout::Error
         puts 'Request timeout. Will retry in 5 seconds.'
         if (tries -= 1).positive?

data/lib/web_translate_it/translation.rb

@@ -4,7 +4,7 @@ module WebTranslateIt
 
   class Translation
 
-    attr_accessor :id, :locale, :text, :status, :created_at, :updated_at, :version, :string_id
+    attr_accessor :id, :locale, :text, :status, :created_at, :updated_at, :version, :string_id, :connection
 
     # Initialize a new WebTranslateIt::Translation
     #
@@ -39,11 +39,11 @@ module WebTranslateIt
 
     def save # rubocop:todo Metrics/MethodLength
       tries ||= 3
-      request = Net::HTTP::Post.new("/api/projects/#{Connection.api_key}/strings/#{string_id}/locales/#{locale}/translations")
+      request = Net::HTTP::Post.new("/api/projects/#{connection.api_key}/strings/#{string_id}/locales/#{locale}/translations")
       WebTranslateIt::Util.add_fields(request)
       request.body = to_json
       begin
-        Util.handle_response(Connection.http_connection.request(request), true, true)
+        Util.handle_response(connection.http_connection.request(request), true, true)
       rescue Timeout::Error
         puts 'Request timeout. Will retry in 5 seconds.'
         if (tries -= 1).positive?

data/lib/web_translate_it/translation_file.rb

@@ -46,27 +46,27 @@ module WebTranslateIt
       end
       display.push "#{StringUtil.checksumify(local_checksum.to_s)}..#{StringUtil.checksumify(remote_checksum.to_s)}"
       if !File.exist?(file_path) || force || (remote_checksum != local_checksum)
+
+        request = Net::HTTP::Get.new(api_url)
+        WebTranslateIt::Util.add_fields(request)
+        FileUtils.mkpath(file_path.split('/')[0..-2].join('/')) unless File.exist?(file_path) || (file_path.split('/')[0..-2].join('/') == '')
         begin
-          request = Net::HTTP::Get.new(api_url)
-          WebTranslateIt::Util.add_fields(request)
-          FileUtils.mkpath(file_path.split('/')[0..-2].join('/')) unless File.exist?(file_path) || (file_path.split('/')[0..-2].join('/') == '')
-          begin
-            response = http_connection.request(request)
-            File.open(file_path, 'wb') { |file| file << response.body } if response.code.to_i == 200
-            display.push Util.handle_response(response)
-          rescue Timeout::Error
-            puts StringUtil.failure('Request timeout. Will retry in 5 seconds.')
-            if (tries -= 1).positive?
-              sleep(5)
-              retry
-            else
-              success = false
-            end
-          rescue StandardError
-            display.push StringUtil.failure("An error occured: #{$ERROR_INFO}")
+          response = http_connection.request(request)
+          File.open(file_path, 'wb') { |file| file << response.body } if response.code.to_i == 200
+          display.push Util.handle_response(response)
+        rescue Timeout::Error
+          puts StringUtil.failure('Request timeout. Will retry in 5 seconds.')
+          if (tries -= 1).positive?
+            sleep(5)
+            retry
+          else
             success = false
           end
+        rescue StandardError
+          display.push StringUtil.failure("An error occured: #{$ERROR_INFO}")
+          success = false
         end
+
       else
         display.push StringUtil.success('Skipped')
       end
@@ -74,6 +74,13 @@ module WebTranslateIt
       success
     end
 
+    def fetch_remote_content(http_connection)
+      request = Net::HTTP::Get.new(api_url)
+      WebTranslateIt::Util.add_fields(request)
+      response = http_connection.request(request)
+      response.body if response.code.to_i == 200
+    end
+
     # Update a language file to Web Translate It by performing a PUT Request.
     #
     # Example of implementation:

data/lib/web_translate_it/util/hash_extensions.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+class Hash
+
+  # Destructively convert all keys to strings.
+  def stringify_keys!
+    keys.each do |key|
+      self[key.to_s] = delete(key)
+    end
+    self
+  end
+
+end

data/lib/web_translate_it/util/hash_util.rb

@@ -3,7 +3,7 @@
 class HashUtil
 
   def self.to_params(hash) # rubocop:todo Metrics/MethodLength
-    params = ''
+    params = +''
     stack = []
 
     hash.each do |k, v|
@@ -30,14 +30,4 @@ class HashUtil
 
 end
 
-class Hash
-
-  # Destructively convert all keys to strings.
-  def stringify_keys!
-    keys.each do |key|
-      self[key.to_s] = delete(key)
-    end
-    self
-  end
-
-end
+require_relative 'hash_extensions'

data/lib/web_translate_it/util/string_util.rb

@@ -3,7 +3,7 @@
 class StringUtil
 
   def self.backward_truncate(str)
-    return "...#{str[str.length - 50 + 3..str.length]}" if str.length > 50
+    return "...#{str[(str.length - 50 + 3)..str.length]}" if str.length > 50
 
     spaces = ''
     (50 - str.length).times { spaces += ' ' }

data/lib/web_translate_it.rb

@@ -34,9 +34,9 @@ module WebTranslateIt
     return if config.ignore_locales.include?(locale)
 
     config.logger&.debug { "   Fetching #{locale} language file(s) from WebTranslateIt" }
-    WebTranslateIt::Connection.new(config.api_key) do |http|
+    WebTranslateIt::Connection.new(config.api_key) do |conn|
       config.files.find_all { |file| file.locale.in?([locale, I18n.locale]) }.each do |file|
-        file.fetch(http)
+        file.fetch(conn.http_connection)
       end
     end
   end

data/man/wti.1

@@ -15,6 +15,9 @@
 .P
 \fBwti pull\fR [\fB\-l\fR] \fIOPTIONS\fR
 .
+.P
+\fBwti diff\fR \fIOPTIONS\fR
+.
 .SH "DESCRIPTION"
 \fBwti\fR is an utility to help you sync language files between the WebTranslateIt\.com service and your computer/server\.
 .
@@ -25,6 +28,9 @@
 \fBwti pull\fR will pull the target language files from Web Translate It\. It will download and update your file with the latest translations from Web Translate It\.
 .
 .P
+\fBwti diff\fR will show a difference between your local file and the file hosted at Web Translate It\.
+.
+.P
 \fBwti status\fR fetch and display translation statistics from Web Translate It\.
 .
 .SH "OPTIONS"

data/man/wti.1.html

@@ -93,6 +93,8 @@ update the strings hosted at Web Translate It by the strings from the file you p
 <p><code>wti pull</code> will pull the target language files from Web Translate It. It will download
 and update your file with the latest translations from Web Translate It.</p>
 
+<p><code>wti diff</code> will display a diff between local and remote language files.</p>
+
 <p><code>wti status</code> fetch and display translation statistics from Web Translate It.</p>
 
 <h2 id="OPTIONS">OPTIONS</h2>

data/man/wti.1.ron

@@ -9,6 +9,8 @@ wti(1) -- WebTranslateIt.com from the command line
 
 `wti pull` [`-l`] <OPTIONS>
 
+`wti diff` <OPTIONS>
+
 ## DESCRIPTION
  
 `wti` is an utility to help you sync language files between the
@@ -20,6 +22,8 @@ update the strings hosted at Web Translate It by the strings from the file you p
 `wti pull` will pull the target language files from Web Translate It. It will download
 and update your file with the latest translations from Web Translate It.
 
+`wti diff` will show a difference between your local file and the file hosted at Web Translate It.
+
 `wti status` fetch and display translation statistics from Web Translate It.
 
 ## OPTIONS

data/readme.md

@@ -12,7 +12,7 @@ wti lets you easily sync your language files with [WebTranslateIt.com](https://w
 
 ### wti...
 
-* wti is a **command-line tool**. It works on all operating systems: Windows, Linux, MacOS X, ... It is also available as a [Docker package](https://github.com/webtranslateit/wti-docker/pkgs/container/wti-docker).
+* wti is a **command-line tool**. It works on all operating systems: Windows, Linux, macOS, ... It is also available as a [Docker package](https://github.com/webtranslateit/wti-docker/pkgs/container/wti-docker).
 * wti is really easy to use. It was inspired by git. Use `wti push` and `wti pull` to sync your language files with WebTranslateIt.com.
 
 ### Optionally, wti does...
@@ -29,8 +29,8 @@ You will also need ruby to run `wti`. We require ruby version 3.0 or newer. On L
 
 ``` bash
 $ gem install web_translate_it
-Fetching: web_translate_it-3.0.2.gem (100%)
-Successfully installed web_translate_it-3.0.2
+Fetching: web_translate_it-3.2.0.gem (100%)
+Successfully installed web_translate_it-3.2.0
 1 gem installed
 ```
 
@@ -38,7 +38,7 @@ At this point you should have the `wti` executable working:
 
 ``` bash
 $ wti -v
-wti version 3.0.2
+wti version 3.2.0
 ```
 
 We also provide `wti` as a Docker packages. [See our packages and instructions to install](https://github.com/webtranslateit/wti-docker/pkgs/container/wti-docker).
@@ -78,6 +78,7 @@ Execute `wti --help` to see the usage:
       pull        Pull target language file(s)
       push        Push master language file(s)
       match       Display matching of local files with File Manager
+      diff        Display a diff between local and remote files
       add         Create and push a new master language file
       addlocale   Add a new locale to the project
       server      Start a synchronisation server
@@ -196,6 +197,10 @@ Append `--help` for each command for more information. For instance:
     <td>wti match</td>
     <td>Show matching between files on local computer and the ones in WebTranslateIt’s File Manager</td>
   </tr>
+  <tr>
+    <td>wti diff config/locales/app/en.yml</td>
+    <td>View diff between local and remote file config/locales/app/en.yml</td>
+  </tr>
 </table>
 
 ## Hooks
@@ -272,4 +277,4 @@ fr: 100% translated, 100% completed.
 
 # License
 
-Copyright (c) 2009-2024 [WebTranslateIt Software S.L](https://webtranslateit.com), released under the MIT License.
+Copyright (c) 2009-2026 [WebTranslateIt Software S.L](https://webtranslateit.com), released under the MIT License.

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: web_translate_it
 version: !ruby/object:Gem::Version
-  version: 3.1.2
+  version: 3.2.1
 platform: ruby
 authors:
 - Edouard Briere
 bindir: bin
 cert_chain: []
-date: 2025-06-06 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: multi_json
@@ -61,6 +61,7 @@ files:
 - lib/web_translate_it/translation.rb
 - lib/web_translate_it/translation_file.rb
 - lib/web_translate_it/util.rb
+- lib/web_translate_it/util/hash_extensions.rb
 - lib/web_translate_it/util/hash_util.rb
 - lib/web_translate_it/util/string_util.rb
 - license
@@ -95,7 +96,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 3.6.9
 specification_version: 4
 summary: A CLI tool to sync locale files with WebTranslateIt.com.
 test_files: []