copy_tuner_client 2.1.1 → 2.2.0

data/lib/copy_tuner_client/copyray_middleware.rb

@@ -3,6 +3,7 @@
 require 'copy_tuner_client/copyray/rewriter'
 
 module CopyTunerClient
+  # レスポンス HTML を Rewriter に通し、マーカートークンを data-copyray-key 属性へ変換する Rack middleware
   class CopyrayMiddleware
     def initialize(app)
       @app = app
@@ -11,22 +12,8 @@ module CopyTunerClient
     def call(env)
       CopyTunerClient::TranslationLog.clear
       status, headers, response = @app.call(env)
-      if html_headers?(status, headers) && body = response_body(response)
-        csp_nonce = env['action_dispatch.content_security_policy_nonce'] || env['secure_headers_content_security_policy_nonce']
-        # NOTE: CSS/JS 挿入の前に Rewriter を通す。serialize 後も </body> は必ず出力されるので
-        # append_to_html_body の rindex は機能し、CSS/JS タグはトークン非含有なので二重処理も起きない。
-        # NOTE: skipped は data-copyray-key を付与できなかったこと（巨大DOM/Nokogiri例外）を表す。
-        # JS にこれを伝え、オーバーレイ非対応である旨をツールバーで案内させる。
-        body, skipped = CopyTunerClient::Copyray::Rewriter.rewrite(body)
-        body = append_js(body, csp_nonce, skipped: skipped)
-        content_length = body.bytesize.to_s
-        headers['Content-Length'] = content_length
-        # maintains compatibility with other middlewares
-        if defined?(ActionDispatch::Response::RackBody) && ActionDispatch::Response::RackBody === response
-          ActionDispatch::Response.new(status, headers, [body]).to_a
-        else
-          [status, headers, [body]]
-        end
+      if rewritable?(status, headers) && (body = response_body(response))
+        rewrite_response(env, status, headers, body, response)
       else
         [status, headers, response]
       end
@@ -34,6 +21,30 @@ module CopyTunerClient
 
     private
 
+    def rewrite_response(env, status, headers, body, response)
+      csp_nonce =
+        env.fetch('action_dispatch.content_security_policy_nonce') do
+          env['secure_headers_content_security_policy_nonce']
+        end
+      # NOTE: CSS/JS 挿入の前に Rewriter を通す。serialize 後も </body> は必ず出力されるので
+      # append_to_html_body の rindex は機能し、CSS/JS タグはトークン非含有なので二重処理も起きない。
+      # NOTE: skipped は data-copyray-key を付与できなかったこと（巨大DOM/Nokogiri例外）を表す。
+      # JS にこれを伝え、オーバーレイ非対応である旨をツールバーで案内させる。
+      # NOTE: turbo stream はページ断片なので fragment パーサで走査する（html/body ラッパを付けない）。
+      turbo_stream = turbo_stream?(headers)
+      body, skipped = CopyTunerClient::Copyray::Rewriter.rewrite(body, fragment: turbo_stream)
+      # NOTE: ブートストラップ JS はフルページ読み込み時に一度だけ挿入すればよい。turbo stream 断片には
+      # 挿入先の </body> も無く、既に初期化済みのページへマージされるだけなので挿入しない。
+      body = append_js(body, csp_nonce, skipped:) unless turbo_stream
+      headers['Content-Length'] = body.bytesize.to_s
+      # maintains compatibility with other middlewares
+      if defined?(ActionDispatch::Response::RackBody) && response.is_a?(ActionDispatch::Response::RackBody)
+        ActionDispatch::Response.new(status, headers, [body]).to_a
+      else
+        [status, headers, [body]]
+      end
+    end
+
     def helpers
       ActionController::Base.helpers
     end
@@ -53,7 +64,8 @@ module CopyTunerClient
           keysSkipped: #{skipped},
         }
       SCRIPT
-      append_to_html_body(html, helpers.javascript_include_tag('copytuner', type: 'module', crossorigin: 'anonymous', nonce: csp_nonce))
+      tag = helpers.javascript_include_tag('copytuner', type: 'module', crossorigin: 'anonymous', nonce: csp_nonce)
+      append_to_html_body(html, tag)
     end
 
     def append_to_html_body(html, content)
@@ -61,18 +73,22 @@ module CopyTunerClient
       return html unless html.include?('</body>')
 
       position = html.rindex('</body>')
-      html.insert(position, content + "\n")
+      html.insert(position, "#{content}\n")
     end
 
     def file?(headers)
-      headers["Content-Transfer-Encoding"] == 'binary'
+      headers['Content-Transfer-Encoding'] == 'binary'
     end
 
-    def html_headers?(status, headers)
+    def rewritable?(status, headers)
       [200, 422].include?(status) &&
-      headers['Content-Type'] &&
-      headers['Content-Type'].include?('text/html') &&
-      !file?(headers)
+        headers['Content-Type'] &&
+        (headers['Content-Type'].include?('text/html') || turbo_stream?(headers)) &&
+        !file?(headers)
+    end
+
+    def turbo_stream?(headers)
+      headers['Content-Type']&.include?('text/vnd.turbo-stream.html')
     end
 
     def response_body(response)

data/lib/copy_tuner_client/dotted_hash.rb

@@ -1,4 +1,5 @@
 module CopyTunerClient
+  # `a.b.c` 形式のドット区切りキーを持つ Hash とネストした Hash を相互変換する
   module DottedHash
     def to_h(dotted_hash)
       hash = {}
@@ -15,18 +16,17 @@ module CopyTunerClient
 
       all_keys.each_with_index do |key, index|
         prefix = "#{key}."
-        conflict_keys = ((index + 1)..Float::INFINITY)
-                        .take_while { |i| all_keys[i]&.start_with?(prefix) }
-                        .map { |i| all_keys[i] }
+        conflict_keys =
+          ((index + 1)..Float::INFINITY)
+          .take_while { |i| all_keys[i]&.start_with?(prefix) }
+          .map { |i| all_keys[i] }
 
-        if conflict_keys.present?
-          results[key] = conflict_keys
-        end
+        results[key] = conflict_keys if conflict_keys.present?
       end
 
       results
     end
 
-    module_function :to_h, :conflict_keys # rubocop:disable Style/AccessModifierDeclarations
+    module_function :to_h, :conflict_keys
   end
 end

data/lib/copy_tuner_client/engine.rb

@@ -5,11 +5,11 @@ require 'copy_tuner_client/helper_extension'
 module CopyTunerClient
   # Connects to integration points for Rails 3 applications
   class Engine < ::Rails::Engine
-    initializer :initialize_copy_tuner_rails, :before => :load_config_initializers do |app|
+    initializer :initialize_copy_tuner_rails, before: :load_config_initializers do |_app|
       CopyTunerClient::Rails.initialize
     end
 
-    initializer :initialize_copy_tuner_hook_methods, :after => :load_config_initializers do |app|
+    initializer :initialize_copy_tuner_hook_methods, after: :load_config_initializers do |_app|
       ActiveSupport.on_load(:action_view) do
         CopyTunerClient::HelperExtension.hook_translation_helper(
           ActionView::Helpers::TranslationHelper,
@@ -17,14 +17,12 @@ module CopyTunerClient
         )
       end
 
-      if CopyTunerClient.configuration.enable_middleware?
-        CopyTunerClient::TranslationLog.install_hook
-      end
+      CopyTunerClient::TranslationLog.install_hook if CopyTunerClient.configuration.enable_middleware?
 
       require 'copy_tuner_client/simple_form_extention'
     end
 
-    initializer "copy_tuner.assets.precompile", group: :all do |app|
+    initializer 'copy_tuner.assets.precompile', group: :all do |app|
       app.config.assets.precompile += ['copytuner.js']
     end
   end

data/lib/copy_tuner_client/helper_extension.rb

@@ -1,67 +1,71 @@
 module CopyTunerClient
+  # ActionView の translate/t を alias_method で差し替え、Copyray のオーバーレイマーカーを注入する
   module HelperExtension
-    class << self
-      def hook_translation_helper(mod, middleware_enabled:)
-        mod.class_eval do
-          def translate_with_copyray_comment(key, **options)
-            source = translate_without_copyray_comment(key, **options)
+    # NOTE: class_eval ブロック内で def すると、ブロック内メソッドの複雑さが
+    # hook_translation_helper 自体の Metrics/AbcSize としてカウントされてしまうため、
+    # メソッド本体は独立したモジュールに切り出して include する。
+    module CopyrayCommentInjection
+      def translate_with_copyray_comment(key, **options)
+        source = translate_without_copyray_comment(key, **options)
 
-            if controller && CopyTunerClient::Rails.controller_of_rails_engine?(controller)
-              return source
-            end
+        return source if controller && CopyTunerClient::Rails.controller_of_rails_engine?(controller)
 
-            # TODO: test
-            # NOTE: default引数が設定されている場合は、copytunerキャッシュの値をI18n.t呼び出しにより上書きしている
-            # SEE: https://github.com/rails/rails/blob/6c43ebc220428ce9fc9569c2e5df90a38a4fc4e4/actionview/lib/action_view/helpers/translation_helper.rb#L82
-            if options.key?(:default)
-              I18n.t(key.to_s.first == '.' ? scope_key_by_partial(key) : key, **options)
-            end
+        # TODO: test
+        # NOTE: default引数が設定されている場合は、copytunerキャッシュの値をI18n.t呼び出しにより上書きしている
+        # SEE: https://github.com/rails/rails/blob/6c43ebc220428ce9fc9569c2e5df90a38a4fc4e4/actionview/lib/action_view/helpers/translation_helper.rb#L82
+        if options.key?(:default)
+          I18n.t(key.to_s.first == '.' ? scope_key_by_partial(key) : key, **options)
+        end
 
-            # NOTE: マーカーは HTML コメントとしてブラウザに無視されつつ Copyray オーバーレイのキー特定に
-            # 使われる。HTML 以外の経路（メール本文・render :json・CSV/PDF など）ではコメントが文字列として
-            # 出力に混入してしまうため、それらの経路には注入しない。default 引数による初期値登録は維持する
-            # 必要があるため、このガードは初期値登録（上の I18n.t 呼び出し）より後に置く。
-            return source unless copyray_injectable?
+        # NOTE: マーカーは HTML コメントとしてブラウザに無視されつつ Copyray オーバーレイのキー特定に
+        # 使われる。HTML 以外の経路（メール本文・render :json・CSV/PDF など）ではコメントが文字列として
+        # 出力に混入してしまうため、それらの経路には注入しない。default 引数による初期値登録は維持する
+        # 必要があるため、このガードは初期値登録（上の I18n.t 呼び出し）より後に置く。
+        return source unless copyray_injectable?
 
-            if CopyTunerClient.configuration.disable_copyray_comment_injection
-              source
-            else
-              separator = options[:separator] || I18n.default_separator
-              scope = options[:scope]
-              scope_key =
-                if key.to_s.first == '.'
-                  scope_key_by_partial(key)
-                else
-                  # NOTE: locale prefix無しのkeyが必要のためこうしている
-                  I18n.normalize_keys(nil, key, scope, separator).compact.join(separator)
-                end
-              CopyTunerClient::Copyray.augment_template(source, scope_key)
-            end
-          end
+        if CopyTunerClient.configuration.disable_copyray_comment_injection
+          source
+        else
+          CopyTunerClient::Copyray.augment_template(source, copyray_scope_key(key, options))
+        end
+      end
 
-          # NOTE: HTML 以外の経路（メール本文・render :json・CSV/PDF など）ではマーカーが文字列として
-          # 出力に混入するため注入しない。判定には controller.request.format を使い、@current_template.format /
-          # lookup_context.formats のような ActionView の内部実装には依存させない（Rails バージョン間で壊れうるため）。
-          def copyray_injectable?
-            current_controller = controller
-            return false if current_controller.nil?
+      def copyray_scope_key(key, options)
+        return scope_key_by_partial(key) if key.to_s.first == '.'
 
-            # NOTE: mailer は request を持たず request.format で判定できない。かつメール本文への
-            # マーカー混入は実害が大きいため、controller の型で明示除外する。
-            return false if defined?(ActionMailer::Base) && current_controller.is_a?(ActionMailer::Base)
+        separator = options.fetch(:separator, I18n.default_separator)
+        # NOTE: locale prefix無しのkeyが必要のためこうしている
+        I18n.normalize_keys(nil, key, options[:scope], separator).compact.join(separator)
+      end
+      private :copyray_scope_key
 
-            # NOTE: request が無い／format が html でない経路には注入しない。&. と || false で
-            # request 不在時も安全に false を返す。
-            current_controller.request&.format&.html? || false
-          end
-          private :copyray_injectable?
+      # NOTE: HTML 以外の経路（メール本文・render :json・CSV/PDF など）ではマーカーが文字列として
+      # 出力に混入するため注入しない。判定には controller.request.format を使い、@current_template.format /
+      # lookup_context.formats のような ActionView の内部実装には依存させない（Rails バージョン間で壊れうるため）。
+      def copyray_injectable?
+        current_controller = controller
+        return false if current_controller.nil?
 
-          if middleware_enabled
-            alias_method :translate_without_copyray_comment, :translate
-            alias_method :translate, :translate_with_copyray_comment
-            alias :t :translate
-          end
-        end
+        # NOTE: mailer は request を持たず request.format で判定できない。かつメール本文への
+        # マーカー混入は実害が大きいため、controller の型で明示除外する。
+        return false if defined?(ActionMailer::Base) && current_controller.is_a?(ActionMailer::Base)
+
+        # NOTE: request が無い／format が html でない経路には注入しない。&. と || false で
+        # request 不在時も安全に false を返す。
+        current_controller.request&.format&.html? || false
+      end
+      private :copyray_injectable?
+    end
+    private_constant :CopyrayCommentInjection
+
+    def self.hook_translation_helper(mod, middleware_enabled:)
+      return unless middleware_enabled
+
+      mod.include(CopyrayCommentInjection)
+      mod.class_eval do
+        alias_method :translate_without_copyray_comment, :translate
+        alias_method :translate, :translate_with_copyray_comment
+        alias_method :t, :translate
       end
     end
   end

data/lib/copy_tuner_client/i18n_backend.rb

@@ -57,7 +57,7 @@ module CopyTunerClient
 
     private
 
-    def lookup(locale, key, scope = [], options = {}) # rubocop:disable Metrics/CyclomaticComplexity,Metrics/MethodLength
+    def lookup(locale, key, scope = [], options = {})
       return nil if !key.is_a?(String) && !key.is_a?(Symbol)
 
       parts = I18n.normalize_keys(locale, key, scope, options[:separator])
@@ -68,21 +68,14 @@ module CopyTunerClient
       # ローカル config/locales（I18n::Backend::Simple）を優先する。段階的にローカルへ移行するための仕組み。
       # ローカルに無い場合は nil（未訳）のまま返し、copy_tuner へのフォールバックも空キー登録も行わない（完全分離）。
       # ignored_keys より先に評価することで、両方にマッチするキーでも確実にローカルへ委譲する。
-      if local_first_key?(key_without_locale)
-        return super
-      end
+      return super if local_first_key?(key_without_locale)
 
-      config = CopyTunerClient.configuration
-      if config.ignored_keys.include?(key_without_locale)
-        config.ignored_key_handler.call(IgnoredKey.new("Ignored key: #{key_without_locale}"))
-      end
+      handle_ignored_key(key_without_locale)
 
       # NOTE: ハッシュ化した場合に削除されるキーに対応するため、最初に完全一致をチェック（旧クライアントの動作を維持）
       # 例: `en.test.key` が `en.test.key.conflict` のように別のキーで上書きされている場合の対応
       exact_match = cache[key_with_locale]
-      if exact_match
-        return exact_match
-      end
+      return exact_match if exact_match
 
       ensure_tree_cache_current
       tree_result = lookup_in_tree_cache(parts)
@@ -90,13 +83,18 @@ module CopyTunerClient
 
       content = super
 
-      if content.nil?
-        cache[key_with_locale] = nil
-      end
+      cache[key_with_locale] = nil if content.nil?
 
       content
     end
 
+    def handle_ignored_key(key_without_locale)
+      config = CopyTunerClient.configuration
+      return unless config.ignored_keys.include?(key_without_locale)
+
+      config.ignored_key_handler.call(IgnoredKey.new("Ignored key: #{key_without_locale}"))
+    end
+
     def ensure_tree_cache_current
       current_version = cache.version
       # ETag が nil の場合（初回ダウンロード前）や変更があった場合のみ更新

data/lib/copy_tuner_client/i18n_compat.rb

@@ -1,10 +1,11 @@
 require 'nokogiri'
 
 module CopyTunerClient
+  # `_html` サフィックス無しに HTML タグを含む訳文（i18n の HTML 安全規約違反）を検出する
   module I18nCompat
     def select_html_incompatible_blurbs(blurbs)
       non_html_key_blurbs = blurbs.reject { |key| key.ends_with?('.html') || key.ends_with?('_html') }
-      html_blurbs = non_html_key_blurbs.select do |key, content|
+      non_html_key_blurbs.select do |_key, content|
         Nokogiri::HTML.fragment(content).children.any? { |node| node.name != 'text' }
       end
     end

data/lib/copy_tuner_client/poller.rb

@@ -1,4 +1,3 @@
-require 'thread'
 require 'copy_tuner_client/cache'
 require 'copy_tuner_client/queue_with_timeout'
 
@@ -30,7 +29,7 @@ module CopyTunerClient
     def stop
       @mutex.synchronize do
         @command_queue.uniq_push(:stop)
-        @thread.join if @thread
+        @thread&.join
         @thread = nil
       end
     end
@@ -59,8 +58,8 @@ module CopyTunerClient
         end
       end
       @logger.info 'stop poller thread'
-    rescue InvalidApiKey => error
-      logger.error(error.message)
+    rescue InvalidApiKey => e
+      logger.error(e.message)
     end
   end
 end

data/lib/copy_tuner_client/prefixed_logger.rb

@@ -1,4 +1,5 @@
 module CopyTunerClient
+  # ログ出力にプレフィックスとプロセス/スレッド情報を付加する Logger ラッパー
   class PrefixedLogger
     attr_reader :prefix, :original_logger
 
@@ -7,24 +8,24 @@ module CopyTunerClient
       @original_logger = logger
     end
 
-    def info(message = nil, &block)
-      log(:info, message, &block)
+    def info(message = nil, &)
+      log(:info, message, &)
     end
 
-    def debug(message = nil, &block)
-      log(:debug, message, &block)
+    def debug(message = nil, &)
+      log(:debug, message, &)
     end
 
-    def warn(message = nil, &block)
-      log(:warn, message, &block)
+    def warn(message = nil, &)
+      log(:warn, message, &)
     end
 
-    def error(message = nil, &block)
-      log(:error, message, &block)
+    def error(message = nil, &)
+      log(:error, message, &)
     end
 
-    def fatal(message = nil, &block)
-      log(:fatal, message, &block)
+    def fatal(message = nil, &)
+      log(:fatal, message, &)
     end
 
     def flush
@@ -33,9 +34,9 @@ module CopyTunerClient
 
     private
 
-    def log(severity, message, &block)
+    def log(severity, message, &)
       prefixed_message = "#{prefix} #{thread_info} #{message}"
-      original_logger.send(severity, prefixed_message, &block)
+      original_logger.public_send(severity, prefixed_message, &)
     end
 
     def thread_info

data/lib/copy_tuner_client/process_guard.rb

@@ -3,7 +3,7 @@ module CopyTunerClient
   # process (such as in Unicorn or Passenger). Also registers hooks for exiting
   # processes and completing background jobs. Applications using the client
   # will not need to interact with this class directly.
-  class ProcessGuard
+  class ProcessGuard # rubocop:disable Metrics/ClassLength
     # @param options [Hash]
     # @option options [Logger] :logger where errors should be logged
     def initialize(cache, poller, options)
@@ -33,15 +33,16 @@ module CopyTunerClient
     end
 
     def passenger_spawner?
-      defined?(PhusionPassenger) && ($0.include?("Passenger AppPreloader") || $0.include?("ApplicationSpawner") || $0.include?("rack-preloader"))
+      defined?(PhusionPassenger) &&
+        ['Passenger AppPreloader', 'ApplicationSpawner', 'rack-preloader'].any? { |name| $PROGRAM_NAME.include?(name) }
     end
 
     def unicorn_spawner?
-      defined?(Unicorn::HttpServer) && ($0.include?("unicorn") && !caller.any? { |line| line.include?("worker_loop") })
+      defined?(Unicorn::HttpServer) && $PROGRAM_NAME.include?('unicorn') && caller.none? { |line| line.include?('worker_loop') }
     end
 
     def puma_spawner?
-      defined?(Puma::Runner) && $0.include?('puma')
+      defined?(Puma::Runner) && $PROGRAM_NAME.include?('puma')
     end
 
     def delayed_job_spawner?
@@ -49,11 +50,11 @@ module CopyTunerClient
       # - bin/delayed_job start
       # - bin/rake jobs:work
       # 前者の呼び出しでのみジョブ処理用の子プロセスが作られるため、　poller を作るフックを仕込む必要がある。
-      defined?(Delayed::Worker) && $0.include?('delayed_job')
+      defined?(Delayed::Worker) && $PROGRAM_NAME.include?('delayed_job')
     end
 
     def good_job_spawner?
-      $0.include?('good_job') && defined?(GoodJob) && ARGV.include?('--daemonize')
+      $PROGRAM_NAME.include?('good_job') && defined?(GoodJob) && ARGV.include?('--daemonize')
     end
 
     def register_spawn_hooks
@@ -71,17 +72,17 @@ module CopyTunerClient
     end
 
     def register_passenger_hook
-      @logger.info("Registered Phusion Passenger fork hook")
-      PhusionPassenger.on_event(:starting_worker_process) do |forked|
+      @logger.info('Registered Phusion Passenger fork hook')
+      PhusionPassenger.on_event(:starting_worker_process) do |_forked|
         start_polling
       end
     end
 
     def register_unicorn_hook
-      @logger.info("Registered Unicorn fork hook")
+      @logger.info('Registered Unicorn fork hook')
       poller = @poller
       Unicorn::HttpServer.class_eval do
-        alias_method :worker_loop_without_copy_tuner, :worker_loop
+        alias_method(:worker_loop_without_copy_tuner, :worker_loop)
         define_method :worker_loop do |worker|
           poller.start
           worker_loop_without_copy_tuner(worker)
@@ -90,10 +91,10 @@ module CopyTunerClient
     end
 
     def register_delayed_hook
-      @logger.info("Registered Delayed::Job start hook")
+      @logger.info('Registered Delayed::Job start hook')
       poller = @poller
       Delayed::Worker.class_eval do
-        alias_method :start_without_copy_tuner, :start
+        alias_method(:start_without_copy_tuner, :start)
         define_method :start do
           poller.start
           start_without_copy_tuner
@@ -102,21 +103,22 @@ module CopyTunerClient
     end
 
     def register_good_job_hook
-      @logger.info("Registered good_job start hook")
+      @logger.info('Registered good_job start hook')
       poller = @poller
-      hook_module = Module.new do
-        define_method :daemon do
-          super() # NOTE: define_method 内で super を呼ぶ場合は引数を明示的に指定する必要があるので注意
-          poller.start
+      hook_module =
+        Module.new do
+          define_method :daemon do
+            super() # NOTE: define_method 内で super を呼ぶ場合は引数を明示的に指定する必要があるので注意
+            poller.start
+          end
         end
-      end
-      ::Process.singleton_class.prepend hook_module
+      ::Process.singleton_class.prepend(hook_module)
     end
 
     def register_puma_hook
       # If Puma is clustered mode without preload_app, this method is called on worker process.
       # Just start poller and return.
-      if $0.include?('cluster worker')
+      if $PROGRAM_NAME.include?('cluster worker')
         @logger.info('Puma would be clustered mode without preload_app')
         @poller.start
         return
@@ -126,13 +128,14 @@ module CopyTunerClient
       # If Puma is clustered mode with preload_app, this method is called before fork.
       # Delay poller start until Puma::Runner#start_server which is called on worker process.
       poller = @poller
-      hook_module = Module.new do
-        define_method :start_server do
-          poller.start
-          super() # NOTE: define_method 内で super を呼ぶ場合は引数を明示的に指定する必要があるので注意
+      hook_module =
+        Module.new do
+          define_method :start_server do
+            poller.start
+            super() # NOTE: define_method 内で super を呼ぶ場合は引数を明示的に指定する必要があるので注意
+          end
         end
-      end
-      Puma::Runner.prepend hook_module
+      Puma::Runner.prepend(hook_module)
     end
 
     def register_exit_hooks

data/lib/copy_tuner_client/queue_with_timeout.rb

@@ -7,17 +7,17 @@ module CopyTunerClient
       @received = ConditionVariable.new
     end
 
-    def <<(x)
+    def <<(item)
       @mutex.synchronize do
-        @queue << x
+        @queue << item
         @received.signal
       end
     end
 
-    def uniq_push(x)
+    def uniq_push(item)
       @mutex.synchronize do
-        unless @queue.member?(x)
-          @queue << x
+        unless @queue.member?(item)
+          @queue << item
           @received.signal
         end
       end
@@ -29,22 +29,32 @@ module CopyTunerClient
 
     def pop_with_timeout(timeout = nil)
       @mutex.synchronize do
-        if timeout.nil?
-          # wait indefinitely until there is an element in the queue
-          while @queue.empty?
-            @received.wait(@mutex)
-          end
-        elsif @queue.empty? && timeout != 0
-          # wait for element or timeout
-          timeout_time = timeout + Time.now.to_f
-          while @queue.empty? && (remaining_time = timeout_time - Time.now.to_f) > 0
-            @received.wait(@mutex, remaining_time)
-          end
-        end
-        #if we're still empty after the timeout, raise exception
-        raise ThreadError, "queue empty" if @queue.empty?
+        wait_for_item(timeout)
+
+        # if we're still empty after the timeout, raise exception
+        raise ThreadError, 'queue empty' if @queue.empty?
+
         @queue.shift
       end
     end
+
+    private
+
+    def wait_for_item(timeout)
+      if timeout.nil?
+        # wait indefinitely until there is an element in the queue
+        @received.wait(@mutex) while @queue.empty?
+      elsif @queue.empty? && timeout != 0
+        wait_with_timeout(timeout)
+      end
+    end
+
+    def wait_with_timeout(timeout)
+      # wait for element or timeout
+      timeout_time = timeout + Time.now.to_f
+      while @queue.empty? && (remaining_time = timeout_time - Time.now.to_f).positive?
+        @received.wait(@mutex, remaining_time)
+      end
+    end
   end
 end