lokalise_manager 7.0.0 → 8.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2f26d5ce781a9d86514c586bfed53b81bda6b5c9016f4277933b02fc74f6ccac
-  data.tar.gz: 9f41116d698fc3c5bda485f414488d6e2ff89820d560204322e2e5349b69eb03
+  metadata.gz: 47771de487435a3744c042598ce442ecd0e7f1c52080cd2f089974efd6176350
+  data.tar.gz: f774cae469107a4816ec6267ec1f4a9201e40ec9f74b26396d8e09c0c4dcbd78
 SHA512:
-  metadata.gz: 7366a212d37275abcb38970ddc20dcd913ba482acdcd07cb6b5e7aa1f40e4082f3ddbead4ec4cf9dbd663aa88e9f6daa78132dad00e4c2e7f35681091179439c
-  data.tar.gz: 8e9e04bbe474d0407a41f07580f8405c1ead322c2bf948df2c6cd3db1661eb4e9875b8ca372e051134c32d944c749fb90f91bb93d66d2d19ae83f1197f4e90b0
+  metadata.gz: 6a27dd2250f829fc5accad0798504ed18900937bdfec79a1afe046582a381b0c703a6027fb548d98210ef2292096a31beba742e3db814607e9abf935baef31b8
+  data.tar.gz: 8f812892db1740c61486f2e16e2579394a51b3f804753aeffecdf6f13a80110de5d8d58a4c7e7730203f0ce02b9f0fd8096a566ceb7cda89344bba7743a8d6fb

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 8.0.0 (26-Feb-2026)
+
+* **Require Ruby 3.2+**
+* Various code updates and enhancements
+
 ## 7.0.0 (26-Feb-2026)
 
 * Strengthen config options

data/README.md

@@ -192,7 +192,7 @@ c.export_preprocessor = ->(raw_data, _path) { raw_data.upcase }
 c.export_filename_generator = ->(_full_path, relative_path) { relative_path.to_s.upcase }
 ```
 
-* `max_retries_export` (`integer`) — this option is introduced to properly handle Lokalise API rate limiting. If the HTTP status code 429 (too many requests) has been received, LokaliseManager will apply an exponential backoff mechanism with a very simple formula: `2 ** retries` (initially `retries` is `0`). If the maximum number of retries has been reached, a `RubyLokaliseApi::Error::TooManyRequests` exception will be raised and the export operation will be halted. By default, LokaliseManager will make up to `5` retries which potentially means `1 + 2 + 4 + 8 + 16 + 32 = 63` seconds of waiting time. If the `max_retries_export` is less than `1`, LokaliseManager will not perform any retries and give up immediately after receiving error 429.
+* `max_retries_export` (`integer`) — controls how many times LokaliseManager retries an export when the Lokalise API returns HTTP status `429` (Too Many Requests) or when a temporary response parsing error occurs. Retries use exponential backoff based on `2 ** retries`, with a small random jitter added to each delay. If the maximum number of retries is reached, the original exception is raised and the export operation is halted. By default, LokaliseManager performs up to `5` retries, resulting in base delays of `1 + 2 + 4 + 8 + 16 = 31` seconds in total, plus up to approximately `5` seconds of additional jitter. If `max_retries_export` is less than `1`, LokaliseManager does not retry and gives up immediately after the first failure.
 * `raise_on_export_fail` (`boolean`) — default is `true`. When this option is enabled, LokaliseManager will re-raise any exceptions that happened during the file uploading. In other words, if any uploading thread raised an exception, your exporting process will exit with an exception. Suppose, you are uploading 12 translation files; these files will be split in 2 groups with 6 files each, and each group will be uploaded in parallel (using threads). However, suppose some exception happens when uploading the first group. By default this exception will be re-raised for the whole process and the script will never try to upload the second group. If you would like to continue uploading even if an exception happened, set the `raise_on_export_fail` to `false`. In this case the `export!` method will return an array with scheduled processes and with information about processes that were not successfully scheduled. This information is represented as an object with three methods: `path` (contains an instance of the `Pathname` class which says which file could not be uploaded), `error` (the actual exception), and `success` (returns `false`). So, you can use the following snippet to check your processes:
 
 ```ruby

data/lib/lokalise_manager/error.rb

@@ -5,9 +5,5 @@ module LokaliseManager
   # allowing the library to raise specific errors that can be easily identified
   # and handled separately from other StandardError exceptions in Ruby.
   class Error < StandardError
-    # Initializes a new Error object
-    def initialize(message = '')
-      super
-    end
   end
 end

data/lib/lokalise_manager/global_config.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require 'yaml'
+
 module LokaliseManager
   # GlobalConfig provides a central place to manage configuration settings for LokaliseManager.
   # It allows setting various operational parameters such as API tokens, paths, and behavior modifiers.

data/lib/lokalise_manager/task_definitions/base.rb

@@ -31,8 +31,8 @@ module LokaliseManager
         raise_on_export_fail import_async export_preprocessor export_filename_generator
       ].freeze
 
-      BACKOFF_BASE_SECONDS = 1 # base multiplier (1,2,4,8...)
-      BACKOFF_CAP_SECONDS  = 32         # max sleep cap
+      BACKOFF_BASE_SECONDS = 1          # base multiplier (1,2,4,8...)
+      BACKOFF_CAP_SECONDS = 32          # max exponential backoff before jitter
       BACKOFF_JITTER_RANGE = 1.0        # adds rand * range
 
       # Initializes a new task object with merged global and custom configurations.

data/lib/lokalise_manager/task_definitions/exporter.rb

@@ -6,7 +6,7 @@ module LokaliseManager
   module TaskDefinitions
     # Handles exporting translation files from a local project to Lokalise.
     class Exporter < Base
-      # Maximum number of concurrent uploads to avoid exceeding Lokalise API rate limits.
+      # Number of files uploaded concurrently in each batch.
       MAX_THREADS = 6
 
       ProcessResult = Struct.new(:success, :process, :path, :error, keyword_init: true)
@@ -15,7 +15,7 @@ module LokaliseManager
       #
       # - Validates configuration.
       # - Gathers translation files from the project directory.
-      # - Uploads files to Lokalise in parallel, respecting API rate limits.
+      # - Uploads files to Lokalise in parallel and retries rate-limited requests.
       # - Handles errors and ensures failed uploads are reported.
       #
       # @return [Array] An array of process results for each uploaded file.

data/lib/lokalise_manager/task_definitions/importer.rb

@@ -71,7 +71,9 @@ module LokaliseManager
       # @return [QueuedProcess] The process object when completed successfully.
       # @raise [LokaliseManager::Error] If the process fails or takes too long.
       def wait_for_async_download(process_id)
-        (config.max_retries_import + 1).times do |i|
+        max_retries = [config.max_retries_import.to_i, 0].max
+
+        (max_retries + 1).times do |i|
           process = reload_process(process_id)
 
           case process.status
@@ -79,7 +81,7 @@ module LokaliseManager
           when 'finished' then return process
           end
 
-          sleep_with_backoff(i)
+          sleep_with_backoff(i) if i < max_retries
         end
 
         raise LokaliseManager::Error, "Asynchronous download process timed out after #{config.max_retries_import} tries"
@@ -90,7 +92,9 @@ module LokaliseManager
       # @param process_id [String] The process ID to check.
       # @return [QueuedProcess] The process object with updated status.
       def reload_process(process_id)
-        api_client.queued_process project_id_with_branch, process_id
+        fetch_with_retry do
+          api_client.queued_process(project_id_with_branch, process_id)
+        end
       end
 
       # Extracts and processes files from a ZIP archive.
@@ -146,7 +150,7 @@ module LokaliseManager
 
         $stdout.puts "The target directory #{path} is not empty!"
         $stdout.print 'Enter Y to continue: '
-        $stdin.gets.strip.upcase == 'Y'
+        $stdin.gets&.strip&.upcase == 'Y'
       end
 
       # Opens a local file or downloads a remote file.
@@ -170,16 +174,8 @@ module LokaliseManager
       #
       # @yield The operation to retry.
       # @return [Object] The result of the successful operation.
-      def fetch_with_retry(&block)
-        with_exp_backoff(config.max_retries_import, &block)
-      end
-
-      # Extracts the subdirectory and filename from a given path.
-      #
-      # @param entry [String] The file path.
-      # @return [Array<Pathname, Pathname>] An array containing the subdirectory and filename.
-      def subdir_and_filename_for(entry)
-        Pathname.new(entry).split
+      def fetch_with_retry(&)
+        with_exp_backoff(config.max_retries_import, &)
       end
     end
   end

data/lib/lokalise_manager/utils/hash_utils.rb

@@ -6,7 +6,7 @@ module LokaliseManager
     module HashUtils
       refine Hash do
         # Deeply merges two hashes
-        # Taken from https://github.com/rails/rails/blob/83217025a171593547d1268651b446d3533e2019/activesupport/lib/active_support/core_ext/hash/deep_merge.rb
+        # Taken from https://api.rubyonrails.org/files/activesupport/lib/active_support/core_ext/hash/deep_merge_rb.html
         def deep_merge(other_hash, &block)
           dup.deep_merge!(other_hash, &block)
         end

data/lib/lokalise_manager/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module LokaliseManager
-  VERSION = '7.0.0'
+  VERSION = '8.0.0'
 end

data/lokalise_manager.gemspec

@@ -13,7 +13,7 @@ Gem::Specification.new do |spec|
   spec.homepage              = 'https://github.com/bodrovis/lokalise_manager'
   spec.license               = 'MIT'
   spec.platform              = Gem::Platform::RUBY
-  spec.required_ruby_version = '>= 3.0'
+  spec.required_ruby_version = '>= 3.2'
 
   spec.files = Dir['README.md', 'LICENSE',
                    'CHANGELOG.md', 'lib/**/*.rb',
@@ -22,7 +22,7 @@ Gem::Specification.new do |spec|
   spec.require_paths    = ['lib']
 
   spec.add_dependency 'base64', '~> 0.3.0'
-  spec.add_dependency 'ruby-lokalise-api', '~> 9.3'
+  spec.add_dependency 'ruby-lokalise-api', '~> 10.0'
   spec.add_dependency 'rubyzip', '>= 2.3', '< 4.0'
   spec.add_dependency 'zeitwerk', '~> 2.4'
 
@@ -33,7 +33,7 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'rubocop-performance', '~> 1.5'
   spec.add_development_dependency 'rubocop-rake', '~> 0.7'
   spec.add_development_dependency 'rubocop-rspec', '~> 3.0'
-  spec.add_development_dependency 'simplecov', '~> 0.22'
+  spec.add_development_dependency 'simplecov', '~> 1.0'
   spec.add_development_dependency 'webmock', '~> 3.18'
   spec.metadata = {
     'rubygems_mfa_required' => 'true',

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lokalise_manager
 version: !ruby/object:Gem::Version
-  version: 7.0.0
+  version: 8.0.0
 platform: ruby
 authors:
 - Ilya Krukowski
@@ -29,14 +29,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '9.3'
+        version: '10.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '9.3'
+        version: '10.0'
 - !ruby/object:Gem::Dependency
   name: rubyzip
   requirement: !ruby/object:Gem::Requirement
@@ -175,14 +175,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.22'
+        version: '1.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.22'
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: webmock
   requirement: !ruby/object:Gem::Requirement
@@ -234,14 +234,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.0'
+      version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.6
+rubygems_version: 4.0.19
 specification_version: 4
 summary: Lokalise integration for Ruby
 test_files: []