cloudtasker 0.15.rc1 → 0.15.rc2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3acbfbd2b8d2ac1c4260b01fc44c4bd43c0061db35eeb84a0bc5f4c1a9358204
-  data.tar.gz: 1a9e2d8048b39eac16dc794671796025a16c1f27e95967adde23ad4361be3610
+  metadata.gz: 42cff7c50d99de1f66e83e04a3946c7cf370ce03004ee47dc7ee3dcbb46564c8
+  data.tar.gz: 26997c5f357a41563a074e2d03ea2724c3824b46a4b034e45b9e5573d4024cbe
 SHA512:
-  metadata.gz: 915fb26b5107680819a63cd55d2097f56675779f160eb284e109aacbbd111af358e71e5afc99194ec1846e022a73797f57d5e7b8be7b3b2684cc3b30f0fdc787
-  data.tar.gz: 3ca5533216e37a51b2393720d60a6a969ca9c887c0151391f9409921bc952062fd6a82855e9c21b0673a35a604ba40fa56f9f72a590e8481397388c70306ff27
+  metadata.gz: 0aa102da9cbc6ba0d108eb5d3be521efd954544bc7f4a47c11830401c61d2e590cbad7d7d540448dd4c41df7d11774c663c519a1b044518dc1a7c9f46c2c5906
+  data.tar.gz: b415391333360f336f0553297206ce725df0d617a14f3dc0a8fe8c8fb81b7ead8b9fbe92f608ba75214af0469161b2abf1aab65c9b400900a7e5b047d6ed4a18

data/.rubocop.yml

@@ -51,6 +51,9 @@ Style/Documentation:
     - "examples/**/*"
     - "spec/**/*"
 
+Style/SafeNavigationChainLength:
+  Enabled: false
+
 Metrics/ParameterLists:
   CountKeywordArgs: false
 

data/CHANGELOG.md

@@ -1,11 +1,13 @@
 # Changelog
 
-## [v0.15.rc1](https://github.com/keypup-io/cloudtasker/tree/v0.15.rc1) (2025-10-30)
+## [v0.15.rc2](https://github.com/keypup-io/cloudtasker/tree/v0.15.rc2) (2025-11-13)
 
-[Full Changelog](https://github.com/keypup-io/cloudtasker/compare/v0.14.0...v0.15.rc1)
+[Full Changelog](https://github.com/keypup-io/cloudtasker/compare/v0.14.0...v0.15.rc2)
 
 **Improvements:**
+- Queues: support `propagate_queue: true` option on `cloudtasker_options` to make workers enqueued inside a job use the runtime queue instead of the default (class-configured or `default`) queue.
 - Unique Jobs: add `until_completed` strategy to lock jobs until they are completed or have exhausted all retries (thanks @jam-packed).
+- Workers: provide `perform_now` method to perform job inline and align with other job frameworks
 
 **Maintenance:**
 - Supported rubies: drop support for ruby `2.7`. Cloudtasker now requires ruby `3.0` and above.

data/Gemfile

@@ -11,7 +11,7 @@ gem 'bundler', '~> 2.0'
 gem 'rake', '>= 12.3.3'
 gem 'rspec', '~> 3.0'
 gem 'rspec-json_expectations', '~> 2.2'
-gem 'rubocop', '~> 1.64.1'
+gem 'rubocop', '~> 1.75.2'
 gem 'rubocop-rspec', '~> 3.0.1'
 gem 'semantic_logger'
 gem 'timecop'

data/README.md

@@ -120,6 +120,10 @@ Open a Rails console and enqueue some jobs
 
   # Process job in 60 seconds
   DummyWorker.perform_in(60, 'foo')
+
+  # Process job immediately, inline
+  # Supported since: v0.15.rc2
+  DummyWorker.perform_now('foo')
 ```
 
 Your Rails logs should display the following:
@@ -474,6 +478,11 @@ MyWorker.perform_at(3.days.from_now, arg1, arg2)
 MyWorker.schedule(args: [arg1, arg2], time_at: Time.parse('2025-01-01 00:50:00Z'), queue: 'critical')
 # or
 MyWorker.schedule(args: [arg1, arg2], time_in: 5 * 60, queue: 'critical')
+
+# Perform worker immediately, inline. This will not send the job to
+# the processing queue. Middlewares such as Unique Job, Batch Jobs will still be invoked.
+# Supported since: v0.15.rc2
+MyWorker.perform_now(arg1, arg2)
 ```
 
 Cloudtasker also provides a helper for re-enqueuing jobs. Re-enqueued jobs keep the same job id. Some middlewares may rely on this to track the fact that that a job didn't actually complete (e.g. Cloustasker batch). This is optional and you can always fallback to using exception management (raise an error) to retry/re-enqueue jobs.
@@ -545,6 +554,53 @@ Queues can also be assigned at runtime when scheduling a job:
 CriticalWorker.schedule(args: [1], queue: :important)
 ```
 
+### Propagating the queue in child workers
+**Supported since:** `v0.15.rc2`
+
+You can specify `propagate_queue: true` via the `cloudtasker_options` to make workers enqueued inside a job use the runtime queue instead of the default (class-configured or `default`) queue:
+
+```ruby
+# app/workers/child_worker.rb
+
+class ChildWorker
+  include Cloudtasker::Worker
+
+  cloudtasker_options queue: :level2
+
+  def perform(some_arg)
+    logger.info("This is a child job, which is set to run on the level2 queue by default.")
+  end
+end
+```
+
+```ruby
+# app/workers/parent_worker.rb
+
+class ParentWorker
+  include Cloudtasker::Worker
+
+  cloudtasker_options queue: :level1, propagate_queue: true
+
+  def perform(some_arg)
+    logger.info("This is a parent job, which is set to run on the level1 queue by default.")
+
+    # This worker will run on queue 'level1' instead of 'level2' because
+    # the "propagate_queue: true" has been specified on the parent.
+    ChildWorker.perform_async(some_arg)
+
+    # This worker will run on queue 'level3' because the queue has been explicitly
+    # specified on the scheduling options. It overrides the propagate_queue behaviour.
+    ChildWorker.schedule(queue: 'level3', args: [some_arg])
+
+    # This worker will run on queue 'level4' and the first ChildWorker it enqueues
+    # will also run on queue 'level4'. The second ChidlWorker will, however, run
+    # on queue 'level3', as explained above.
+    ParentWorker.schedule(queue: 'level4', args: [some_arg])
+  end
+end
+```
+
+
 ## Extensions
 **Note**: Extensions are not available when using cloudtasker via ActiveJob.
 

data/app/controllers/cloudtasker/worker_controller.rb

@@ -30,7 +30,7 @@ module Cloudtasker
       head :not_found
     rescue StandardError
       # 422: Job will be retried
-      head :unprocessable_entity
+      head 422
     end
 
     private

data/lib/cloudtasker/backend/memory_task.rb

@@ -66,7 +66,7 @@ module Cloudtasker
         payload = payload.merge(schedule_time: payload[:schedule_time].to_i)
 
         # Save task
-        task = new(**payload.merge(id: id))
+        task = new(**payload, id: id)
         queue << task
 
         # Execute task immediately if in testing and inline mode enabled

data/lib/cloudtasker/backend/redis_task.rb

@@ -89,7 +89,7 @@ module Cloudtasker
         # Save job
         redis.write(key(id), payload)
         redis.sadd(key, [id])
-        new(**payload.merge(id: id))
+        new(**payload, id: id)
       end
 
       #
@@ -103,7 +103,7 @@ module Cloudtasker
         gid = key(id)
         return nil unless (payload = redis.fetch(gid))
 
-        new(**payload.merge(id: id))
+        new(**payload, id: id)
       end
 
       #

data/lib/cloudtasker/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Cloudtasker
-  VERSION = '0.15.rc1'
+  VERSION = '0.15.rc2'
 end

data/lib/cloudtasker/worker.rb

@@ -96,7 +96,7 @@ module Cloudtasker
       end
 
       #
-      # Enqueue worker in the backgroundf.
+      # Enqueue worker in the background.
       #
       # @param [Array<any>] *args List of worker arguments
       #
@@ -130,6 +130,20 @@ module Cloudtasker
         schedule(args: args, time_at: time_at)
       end
 
+      #
+      # Perform a worker inline, without sending it to the queue for processing.
+      #
+      # Middlewares (unique job, batch etc.) will still be invoked as if the job
+      # had been scheduled.
+      #
+      # @param [Array<any>] *args List of worker arguments
+      #
+      # @return [Any] The result of the worker perform method.
+      #
+      def perform_now(*args)
+        new(job_args: args).execute
+      end
+
       #
       # Enqueue a worker with explicity options.
       #
@@ -184,7 +198,12 @@ module Cloudtasker
     # @return [String] The name of queue.
     #
     def job_queue
-      (@job_queue ||= self.class.cloudtasker_options_hash[:queue] || Config::DEFAULT_JOB_QUEUE).to_s
+      (
+        @job_queue ||=
+          Thread.current[:cloudtasker_propagated_queue] ||
+          self.class.cloudtasker_options_hash[:queue] ||
+          Config::DEFAULT_JOB_QUEUE
+      ).to_s
     end
 
     #
@@ -215,7 +234,7 @@ module Cloudtasker
     #
     # Execute the worker by calling the `perform` with the args.
     #
-    # @return [Any] The result of the perform.
+    # @return [Any] The result of the worker perform method.
     #
     def execute
       logger.info('Starting job...')
@@ -436,6 +455,10 @@ module Cloudtasker
     def execute_middleware_chain
       self.perform_started_at = Time.now
 
+      # Store the parent worker queue so as to propagate it to the child workers
+      # See: #job_queue
+      Thread.current[:cloudtasker_propagated_queue] = job_queue if self.class.cloudtasker_options_hash[:propagate_queue]
+
       Cloudtasker.config.server_middleware.invoke(self) do
         # Immediately abort the job if it is already dead
         flag_as_dead if job_dead?
@@ -454,6 +477,7 @@ module Cloudtasker
       end
     ensure
       self.perform_ended_at = Time.now
+      Thread.current[:cloudtasker_propagated_queue] = nil
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cloudtasker
 version: !ruby/object:Gem::Version
-  version: 0.15.rc1
+  version: 0.15.rc2
 platform: ruby
 authors:
 - Arnaud Lachaume
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-10-30 00:00:00.000000000 Z
+date: 2025-11-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -237,7 +237,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
+rubygems_version: 3.5.4
 signing_key:
 specification_version: 4
 summary: Background jobs for Ruby using Google Cloud Tasks (beta)