модуль ActiveJob::TestHelper

# File activejob/lib/active_job/test_helper.rb, line 118
def assert_enqueued_jobs(number, only: nil, except: nil, queue: nil)
  if block_given?
    original_count = enqueued_jobs_size(only: only, except: except, queue: queue)
    yield
    new_count = enqueued_jobs_size(only: only, except: except, queue: queue)
    assert_equal number, new_count - original_count, "#{number} jobs expected, but #{new_count - original_count} were enqueued"
  else
    actual_count = enqueued_jobs_size(only: only, except: except, queue: queue)
    assert_equal number, actual_count, "#{number} jobs expected, but #{actual_count} were enqueued"
  end
end

Утверждает, что количество поставленных в очередь задач соответствует заданному числу.

def test_jobs
  assert_enqueued_jobs 0
  HelloJob.perform_later('david')
  assert_enqueued_jobs 1
  HelloJob.perform_later('abdelkader')
  assert_enqueued_jobs 2
end

Если передать блок, этот блок приведет к поставке в очередь указанного числа задач.

def test_jobs_again
  assert_enqueued_jobs 1 do
    HelloJob.perform_later('cristian')
  end

  assert_enqueued_jobs 2 do
    HelloJob.perform_later('aaron')
    HelloJob.perform_later('rafael')
  end
end

Можно утверждать, сколько раз была поставлена в очередь конкретная задача.

def test_logging_job
  assert_enqueued_jobs 1, only: LoggingJob do
    LoggingJob.perform_later
    HelloJob.perform_later('jeremy')
  end
end

Можно утверждать, сколько раз была поставлена в очередь задача, кроме задач определённого класса.

def test_logging_job
  assert_enqueued_jobs 1, except: HelloJob do
    LoggingJob.perform_later
    HelloJob.perform_later('jeremy')
  end
end

Также можно утверждать, сколько раз задача была поставлена в очередь в определённую очередь.

def test_logging_job
  assert_enqueued_jobs 2, queue: 'default' do
    LoggingJob.perform_later
    HelloJob.perform_later('elfassy')
  end
end

# File activejob/lib/active_job/test_helper.rb, line 300
def assert_enqueued_with(job: nil, args: nil, at: nil, queue: nil)
  original_enqueued_jobs_count = enqueued_jobs.count
  expected = { job: job, args: args, at: at, queue: queue }.compact
  expected_args = prepare_args_for_assertion(expected)
  yield
  in_block_jobs = enqueued_jobs.drop(original_enqueued_jobs_count)
  matching_job = in_block_jobs.find do |in_block_job|
    deserialized_job = deserialize_args_for_assertion(in_block_job)
    expected_args.all? { |key, value| value == deserialized_job[key] }
  end
  assert matching_job, "No enqueued job found with #{expected}"
  instantiate_job(matching_job)
end

Утверждает, что задача, переданная в блоке, была поставлена в очередь с заданными аргументами.

def test_assert_enqueued_with
  assert_enqueued_with(job: MyJob, args: [1,2,3], queue: 'low') do
    MyJob.perform_later(1,2,3)
  end

  assert_enqueued_with(job: MyJob, at: Date.tomorrow.noon) do
    MyJob.set(wait_until: Date.tomorrow.noon).perform_later
  end
end

# File activejob/lib/active_job/test_helper.rb, line 165
def assert_no_enqueued_jobs(only: nil, except: nil, &block)
  assert_enqueued_jobs 0, only: only, except: except, &block
end

Утверждает, что задачи не были поставлены в очередь.

def test_jobs
  assert_no_enqueued_jobs
  HelloJob.perform_later('jeremy')
  assert_enqueued_jobs 1
end

Если передать блок, этот блок не должен поставлять в очередь ни одной задачи.

def test_jobs_again
  assert_no_enqueued_jobs do
    # No job should be enqueued from this block
  end
end

Можно утверждать, что задачи определённого типа не были поставлены в очередь:

def test_no_logging
  assert_no_enqueued_jobs only: LoggingJob do
    HelloJob.perform_later('jeremy')
  end
end

Можно утверждать, что задачи, кроме задач определённого класса, не были поставлены в очередь:

def test_no_logging
  assert_no_enqueued_jobs except: HelloJob do
    HelloJob.perform_later('jeremy')
  end
end

Примечание: Это утверждение просто сокращённый вариант для:

assert_enqueued_jobs 0, &block

# File activejob/lib/active_job/test_helper.rb, line 285
def assert_no_performed_jobs(only: nil, except: nil, &block)
  assert_performed_jobs 0, only: only, except: except, &block
end

Утверждает, что задачи не были выполнены.

def test_jobs
  assert_no_performed_jobs

  perform_enqueued_jobs do
    HelloJob.perform_later('matthew')
    assert_performed_jobs 1
  end
end

Если передать блок, этот блок не должен выполнять ни одной задачи.

def test_jobs_again
  assert_no_performed_jobs do
    # No job should be performed from this block
  end
end

Форма блока поддерживает фильтрацию. Если указан параметр :only, будут выполняться только перечисленные задачи.

def test_no_logging
  assert_no_performed_jobs only: LoggingJob do
    HelloJob.perform_later('jeremy')
  end
end

Также, если указан параметр :except, задачи, кроме задач определённого класса, не будут выполняться.

def test_no_logging
  assert_no_performed_jobs except: HelloJob do
    HelloJob.perform_later('jeremy')
  end
end

Примечание: Это утверждение просто сокращённый вариант для:

assert_performed_jobs 0, &block

# File activejob/lib/active_job/test_helper.rb, line 232
def assert_performed_jobs(number, only: nil, except: nil)
  if block_given?
    original_count = performed_jobs.size
    perform_enqueued_jobs(only: only, except: except) { yield }
    new_count = performed_jobs.size
    assert_equal number, new_count - original_count,
      "#{number} jobs expected, but #{new_count - original_count} were performed"
  else
    performed_jobs_size = performed_jobs.size
    assert_equal number, performed_jobs_size, "#{number} jobs expected, but #{performed_jobs_size} were performed"
  end
end

Утверждает, что количество выполненных задач соответствует заданному числу. Если блок не передан, perform_enqueued_jobs необходимо вызвать вокруг вызова задачи.

def test_jobs
  assert_performed_jobs 0

  perform_enqueued_jobs do
    HelloJob.perform_later('xavier')
  end
  assert_performed_jobs 1

  perform_enqueued_jobs do
    HelloJob.perform_later('yves')
    assert_performed_jobs 2
  end
end

Если передать блок, этот блок должен выполнить указанное количество задач.

def test_jobs_again
  assert_performed_jobs 1 do
    HelloJob.perform_later('robin')
  end

  assert_performed_jobs 2 do
    HelloJob.perform_later('carlos')
    HelloJob.perform_later('sean')
  end
end

Форма блока поддерживает фильтрацию. Если указан параметр :only, будут выполняться только перечисленные задачи.

def test_hello_job
  assert_performed_jobs 1, only: HelloJob do
    HelloJob.perform_later('jeremy')
    LoggingJob.perform_later
  end
end

Также, если указан параметр :except, задачи, кроме задач определённого класса, будут выполняться.

def test_hello_job
  assert_performed_jobs 1, except: LoggingJob do
    HelloJob.perform_later('jeremy')
    LoggingJob.perform_later
  end
end

Также может быть указан массив для тестирования нескольких задач.

def test_hello_and_logging_jobs
  assert_nothing_raised do
    assert_performed_jobs 2, only: [HelloJob, LoggingJob] do
      HelloJob.perform_later('jeremy')
      LoggingJob.perform_later('stewie')
      RescueJob.perform_later('david')
    end
  end
end

# File activejob/lib/active_job/test_helper.rb, line 325
def assert_performed_with(job: nil, args: nil, at: nil, queue: nil)
  original_performed_jobs_count = performed_jobs.count
  expected = { job: job, args: args, at: at, queue: queue }.compact
  expected_args = prepare_args_for_assertion(expected)
  perform_enqueued_jobs { yield }
  in_block_jobs = performed_jobs.drop(original_performed_jobs_count)
  matching_job = in_block_jobs.find do |in_block_job|
    deserialized_job = deserialize_args_for_assertion(in_block_job)
    expected_args.all? { |key, value| value == deserialized_job[key] }
  end
  assert matching_job, "No performed job found with #{expected}"
  instantiate_job(matching_job)
end

Утверждает, что задача, переданная в блоке, была выполнена с заданными аргументами.

def test_assert_performed_with
  assert_performed_with(job: MyJob, args: [1,2,3], queue: 'high') do
    MyJob.perform_later(1,2,3)
  end

  assert_performed_with(job: MyJob, at: Date.tomorrow.noon) do
    MyJob.set(wait_until: Date.tomorrow.noon).perform_later
  end
end

# File activejob/lib/active_job/test_helper.rb, line 370
def perform_enqueued_jobs(only: nil, except: nil)
  validate_option(only: only, except: except)
  old_perform_enqueued_jobs = queue_adapter.perform_enqueued_jobs
  old_perform_enqueued_at_jobs = queue_adapter.perform_enqueued_at_jobs
  old_filter = queue_adapter.filter
  old_reject = queue_adapter.reject

  begin
    queue_adapter.perform_enqueued_jobs = true
    queue_adapter.perform_enqueued_at_jobs = true
    queue_adapter.filter = only
    queue_adapter.reject = except
    yield
  ensure
    queue_adapter.perform_enqueued_jobs = old_perform_enqueued_jobs
    queue_adapter.perform_enqueued_at_jobs = old_perform_enqueued_at_jobs
    queue_adapter.filter = old_filter
    queue_adapter.reject = old_reject
  end
end

Выполняет все задачи в очереди в течение блока.

def test_perform_enqueued_jobs
  perform_enqueued_jobs do
    MyJob.perform_later(1, 2, 3)
  end
  assert_performed_jobs 1
end

Этот метод также поддерживает фильтрацию. Если указан параметр :only, будут выполняться только перечисленные задачи.

def test_perform_enqueued_jobs_with_only
  perform_enqueued_jobs(only: MyJob) do
    MyJob.perform_later(1, 2, 3) # will be performed
    HelloJob.perform_later(1, 2, 3) # will not be performed
  end
  assert_performed_jobs 1
end

Также, если указан параметр :except, задачи, кроме задач определённого класса, будут выполняться.

def test_perform_enqueued_jobs_with_except
  perform_enqueued_jobs(except: HelloJob) do
    MyJob.perform_later(1, 2, 3) # will be performed
    HelloJob.perform_later(1, 2, 3) # will not be performed
  end
  assert_performed_jobs 1
end

# File activejob/lib/active_job/test_helper.rb, line 396
def queue_adapter
  ActiveJob::Base.queue_adapter
end

Доступ к #queue_adapter, заданному ActiveJob::Base.

def test_assert_job_has_custom_queue_adapter_set
  assert_instance_of CustomQueueAdapter, HelloJob.queue_adapter
end

# File activejob/lib/active_job/test_helper.rb, line 64
def queue_adapter_for_test
  ActiveJob::QueueAdapters::TestAdapter.new
end

Устанавливает адаптер очереди для использования со всеми вспомогательными методами тестирования задач Active Job.

Возвращает экземпляр адаптера очереди и по умолчанию равен ActiveJob::QueueAdapters::TestAdapter.

Примечание: адаптер, предоставленный этим методом, должен предоставлять дополнительные методы, ожидаемые от стандартного ActiveJob::QueueAdapter, для использования с вспомогательными методами тестирования задач Active Job. См. ActiveJob::QueueAdapters::TestAdapter.