This gem use callbacks from ActiveJob to set job status and save them in ActiveRecord. It supports different states of job including pending, running, finished and failed. It also allows setting job progress and job result.
The table name is ae_active_job_state_job_states
. It uses native JSON data type in SQL so make sure your SQL database supports that. For MySQL that means version 5.7 and later.
Add this line to your application's Gemfile:
gem 'ae_active_job_state'
And then execute:
$ bundle install
Or install it yourself as:
$ gem install ae_active_job_state
Then you need to copy the migration over
$ rails generate ae_active_job_state
Occasionally, additional migrations may be required when updating this gem. The migration generator takes a
since_version
flag that will take the version you are upgrading from and add any required migrations since that
version.
$ rails generate ae_active_job_state --since_version 0.1.0
class AlwaysPassJob < ActiveJob::Base
include AeActiveJobState::HasJobState
def perform(_params)
1
end
end
If you want to apply this on all job classes, you can even include it in ApplicationJob
class ApplicationJob < ActiveJob::Base
include AeActiveJobState::HasJobState
end
class AlwaysPassJob < ApplicationJob
def perform(_params)
1
end
end
job = AlwaysPassJob.perform_later(1)
job.job_state.id
class HasProgressJob < ApplicationJob
def perform(_params)
set_job_progress!('percent' => 20)
end
end
job = HasProgressJob.perform_later(1)
# wait for job to execute
job.job_state.progress == { 'percent' => 20 }
class HasResultJob < ApplicationJob
def perform(_params)
set_job_result!('value' => 20)
end
end
job = HasResultJob.perform_later(1)
# wait for job to finish
job.job_state.result == { 'value' => 20 }
This gem assumes MySQL running at port 3307 on IP address 127.0.0.1. The quickest way to set this up is to use docker:
docker run -d -v /tmp/mysql_data:/var/lib/mysql --name mysql5.7 -e MYSQL_ALLOW_EMPTY_PASSWORD=true -p 3307:3306 mysql:5.7
Then you can run rpsec bundle exec rspec
bundle exec rubocop
The gem is available as open source under the terms of the MIT License.