mindee-lite 5.3.1 → 5.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e7845fa564cb9009f33f574fe8b74b7c288e8943d07b881f44f9a028d0eb13df
-  data.tar.gz: 9a52c3245b07e7c7ca56f1b9c6f88b8df2c5f84c8b68b2117ec31cb193dee31f
+  metadata.gz: 5847f9a9f62853290ae96d8a311c66af32cbf5e1f74da6f0e7d0b455a76ae931
+  data.tar.gz: 5fbbd21a967ff60ddc059fa9ed9d5f3fd7422890e3f3675d38347f82a5463da8
 SHA512:
-  metadata.gz: 8253351df7c79cc82245ccbdf80497104921883f373901cabe02bac65a7da9a40f4bd09fc6ae835c8051e24a2153703dceb45f88b10401f21c5cf30ec084bded
-  data.tar.gz: f898b808b8a94074877191673cc8903b846850d1dcc42f91516709ad486fb295ff166683343f759382ae42d06fde5e42ec645d54985007f0ae9d47799b540596
+  metadata.gz: a238ed199069908c8fe5488de1af41436650f77288685297f5da4d5b1cec5c617dfa76c843b6b02efd63fa617b8dc7f80872593d63f1f7b854fce886aa6bd327
+  data.tar.gz: c2845fc9b049a1b123b15678e4effdfb55f382650cb9eecc90244ec553a78679dd1523226e8826a5e3abfbcc95bff85c790aeabcde10d36696cffa977594e3c4

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Mindee Ruby API Library Changelog
 
+## v5.4.0 - 2026-07-21
+### Changes
+* :sparkles: add field confidence comparators
+* :sparkles: add support for cancellation token
+
+
 ## v5.3.1 - 2026-07-15
 ### Fixes
 * :bug: fix file alias being sent as an invalid parameter

data/lib/mindee/http/cancellation_token.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Mindee
+  module HTTP
+    # Custom cancellation token class for polling.
+    class CancellationToken
+      private attr_reader :is_canceled
+
+      def initialize
+        @is_cancelled = false
+      end
+
+      # Cancel the token.
+      def cancel
+        @is_cancelled = true
+      end
+
+      # Check if the token is canceled.
+      def canceled?
+        @is_cancelled
+      end
+    end
+  end
+end

data/lib/mindee/http.rb

@@ -1,3 +1,4 @@
 # frozen_string_literal: true
 
+require_relative 'http/cancellation_token'
 require_relative 'http/http_error_handler'

data/lib/mindee/v1/client.rb

@@ -219,6 +219,7 @@ module Mindee
         Mindee::V1::Parsing::Common::ApiResponse.new(product_class, prediction, raw_http)
       end
 
+      # rubocop:disable Metrics/CyclomaticComplexity
       # Enqueue a document for async parsing and automatically try to retrieve it
       #
       # @param input_source [Mindee::Input::Source::LocalInputSource, Mindee::Input::Source::URLInputSource]
@@ -247,13 +248,23 @@ module Mindee
       #   * `:delay_sec` [Numeric] Delay between polling attempts. Defaults to 1.5.
       #   * `:max_retries` [Integer] Maximum number of retries. Defaults to 80.
       # @param endpoint [Mindee::V1::HTTP::Endpoint] Endpoint of the API.
+      # @param cancellation_token [Mindee::HTTP::CancellationToken, nil] Token for cancellation.
       # @return [Mindee::V1::Parsing::Common::ApiResponse]
-      def enqueue_and_parse(input_source, product_class, endpoint, options)
+      # rubocop:disable Metrics/PerceivedComplexity
+      def enqueue_and_parse(
+        input_source,
+        product_class,
+        endpoint,
+        options,
+        cancellation_token = nil
+      )
         validate_async_params(options.initial_delay_sec, options.delay_sec, options.max_retries)
         enqueue_res = enqueue(input_source, product_class, endpoint: endpoint, options: options)
         job = enqueue_res.job or raise Error::MindeeAPIError, 'Expected job to be present'
         job_id = job.id
 
+        raise Mindee::Error::MindeeError, 'Enqueueing of the document was canceled.' if cancellation_token&.canceled?
+
         sleep(options.initial_delay_sec)
         polling_attempts = 1
         logger.debug("Successfully enqueued document with job id: '#{job_id}'")
@@ -266,6 +277,8 @@ module Mindee
         # @type var valid_statuses: Array[(:waiting | :processing | :completed | :failed)]
         while valid_statuses.include?(queue_res_job.status) && polling_attempts < options.max_retries
           logger.debug("Polling server for parsing result with job id: '#{job_id}'. Attempt #{polling_attempts}")
+          raise Mindee::Error::MindeeError, 'Enqueueing of the document was canceled.' if cancellation_token&.canceled?
+
           sleep(options.delay_sec)
           queue_res = parse_queued(job_id, product_class, endpoint: endpoint)
           queue_res_job = queue_res.job or raise Error::MindeeAPIError, 'Expected job to be present'
@@ -280,7 +293,9 @@ module Mindee
 
         queue_res
       end
+      # rubocop:enable Metrics/PerceivedComplexity
 
+      # rubocop:enable Metrics/CyclomaticComplexity
       # Sends a document to a workflow.
       #
       # Accepts options either as a Hash or as a WorkflowOptions struct.

data/lib/mindee/v2/client.rb

@@ -58,12 +58,15 @@ module Mindee
       #   The source of the input document (local file or URL).
       # @param params [Hash, Input::BaseParameters] Parameters for the inference.
       # @param polling_options [Hash, PollingOptions, nil] Parameters for polling.
+      # @param cancellation_token [Mindee::HTTP::CancellationToken, nil] Token for cancellation.
       # @return [Parsing::BaseResponse]
+      # rubocop:disable Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
       def enqueue_and_get_result(
         product,
         input_source,
         params,
-        polling_options = nil
+        polling_options = nil,
+        cancellation_token = nil
       )
         enqueue_response = enqueue(product, input_source, params)
         normalized_params = normalize_parameters(product.params_type, params, polling_options: polling_options)
@@ -77,6 +80,8 @@ module Mindee
         job_id = enqueue_response.job.id
         logger.debug("Successfully enqueued document with job id: #{job_id}.")
 
+        raise Mindee::Error::MindeeError, 'Enqueueing of the document was canceled.' if cancellation_token&.canceled?
+
         sleep(normalized_params.polling_options.initial_delay_sec)
         retry_counter = 1
         poll_results = get_job(job_id)
@@ -94,6 +99,8 @@ module Mindee
             "Job status: #{poll_results.job.status}."
           )
 
+          raise Mindee::Error::MindeeError, 'Enqueueing of the document was canceled.' if cancellation_token&.canceled?
+
           sleep(normalized_params.polling_options.delay_sec)
           poll_results = get_job(job_id)
           retry_counter += 1
@@ -110,6 +117,7 @@ module Mindee
         raise Mindee::Error::MindeeError,
               "Asynchronous parsing request timed out after #{sec_count} seconds"
       end
+      # rubocop:enable Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
 
       # Searches for a list of available models for the given API key.
       # @param model_name [String]

data/lib/mindee/v2/parsing/field/field_confidence.rb

@@ -87,8 +87,8 @@ module Mindee
             end
           end
 
-          # less than or equality of two FieldConfidence instances.
-          # # @param other [String, Integer, FieldConfidence] The other confidence to compare.
+          # Less than or equality of two FieldConfidence instances.
+          # @param other [String, Integer, FieldConfidence] The other confidence to compare.
           def <=(other)
             if other.is_a?(FieldConfidence)
               to_i <= val_to_i(other.value)
@@ -101,12 +101,47 @@ module Mindee
             end
           end
 
+          # Greater than comparison of two FieldConfidence instances.
+          # @param other [String, Integer, FieldConfidence] The other confidence to compare.
+          def >(other)
+            if other.is_a?(FieldConfidence)
+              to_i > val_to_i(other.value)
+            elsif other.is_a?(String)
+              to_i > val_to_i(other)
+            elsif other.is_a?(Integer)
+              to_i > other
+            else
+              raise ArgumentError, "Invalid type: #{other.class}"
+            end
+          end
+
+          # Less than comparison of two FieldConfidence instances.
+          # @param other [String, Integer, FieldConfidence] The other confidence to compare.
+          def <(other)
+            if other.is_a?(FieldConfidence)
+              to_i < val_to_i(other.value)
+            elsif other.is_a?(String)
+              to_i < val_to_i(other)
+            elsif other.is_a?(Integer)
+              to_i < other
+            else
+              raise ArgumentError, "Invalid type: #{other.class}"
+            end
+          end
+
           # rubocop:enable Style/CaseLikeIf
 
           # Aliases for the comparison operators.
           alias eql? ==
+          alias equal? ==
           alias gteql? >=
+          alias greater_than_or_equal? >=
           alias lteql? <=
+          alias less_than_or_equal? <=
+          alias gt? >
+          alias greater_than? >
+          alias lt? <
+          alias less_than? <
 
           protected
 

data/lib/mindee/version.rb

@@ -3,7 +3,7 @@
 # Mindee
 module Mindee
   # Current version.
-  VERSION = '5.3.1'
+  VERSION = '5.4.0'
 
   # Finds and return the current platform.
   # @return [Symbol, Hash[String | Symbol, Regexp], Nil?]

data/sig/mindee/http/cancellation_token.rbs

@@ -0,0 +1,15 @@
+# lib/http/cancellation_token.rb
+
+module Mindee
+  module HTTP
+    class CancellationToken
+      @is_cancelled: bool
+
+      attr_reader is_canceled: bool
+
+      def canceled?: -> bool
+      def initialize: -> void
+      def cancel: -> void
+    end
+  end
+end

data/sig/mindee/v2/parsing/field/field_confidence.rbs

@@ -20,6 +20,15 @@ module Mindee
           def lteql? : (String | Integer | FieldConfidence) -> bool
           def >=: (String | Integer | FieldConfidence) -> bool
           def gteql?: (String | Integer | FieldConfidence) -> bool
+          def greater_than_or_equal?: (String | Integer | FieldConfidence) -> bool
+          def >: (String | Integer | FieldConfidence) -> bool
+          def gt?: (String | Integer | FieldConfidence) -> bool
+          def greater_than?: (String | Integer | FieldConfidence) -> bool
+          def <: (String | Integer | FieldConfidence) -> bool
+          def lt?: (String | Integer | FieldConfidence) -> bool
+          def less_than?: (String | Integer | FieldConfidence) -> bool
+          def less_than_or_equal?: (String | Integer | FieldConfidence) -> bool
+          def equal?: (String | Integer | FieldConfidence) -> bool
           def inspect: -> String
 
           def val_to_i: (String) -> Integer

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mindee-lite
 version: !ruby/object:Gem::Version
-  version: 5.3.1
+  version: 5.4.0
 platform: ruby
 authors:
 - Mindee, SA
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-15 00:00:00.000000000 Z
+date: 2026-07-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -130,6 +130,7 @@ files:
 - lib/mindee/geometry/utils.rb
 - lib/mindee/http.rb
 - lib/mindee/http/.rubocop.yml
+- lib/mindee/http/cancellation_token.rb
 - lib/mindee/http/http_error_handler.rb
 - lib/mindee/http/response_validation.rb
 - lib/mindee/image.rb
@@ -374,6 +375,7 @@ files:
 - sig/mindee/geometry/polygon.rbs
 - sig/mindee/geometry/quadrilateral.rbs
 - sig/mindee/geometry/utils.rbs
+- sig/mindee/http/cancellation_token.rbs
 - sig/mindee/http/http_error_handler.rbs
 - sig/mindee/http/response_validation.rbs
 - sig/mindee/image/extracted_image.rbs