Comment revenir tôt d'une tâche de râteau?

J'ai une tâche de râteau où je fais quelques vérifications au début, si l'une des vérifications échoue, je voudrais revenir tôt de la tâche de râteau, je ne veux pas exécuter le code restant.

Je pensais que la solution serait de placer un retour là où je voulais revenir du code mais j'obtiens l'erreur suivante

unexpected return

Une tâche Rake est essentiellement un bloc. Un bloc, à l'exception de lambdas, ne prend pas en charge le retour, mais vous pouvez passer à l'instruction suivante en utilisant nextce qui dans une tâche de râteau a le même effet que d'utiliser le retour dans une méthode.

task :foo do
  puts "printed"
  next
  puts "never printed"
end

Ou vous pouvez déplacer le code dans une méthode et utiliser return dans la méthode.

task :foo do
  do_something
end

def do_something
  puts "startd"
  return
  puts "end"
end

Je préfère le deuxième choix.

Vous pouvez utiliser abort(message)de l'intérieur de la tâche pour abandonner cette tâche avec un message.

J'ai tendance à utiliser abortce qui est une meilleure alternative dans de telles situations, par exemple:

task :foo do
  something = false
  abort 'Failed to proceed' unless something
end

Retour avec une erreur ❌

Si vous revenez avec une erreur (c'est-à-dire un code de sortie de 1) que vous voudrez utiliser abort, qui prend également un paramètre de chaîne facultatif qui sera sorti à la sortie:

task :check do

  # If any of your checks fail, you can exit early like this.
  abort( "One of the checks has failed!" ) if check_failed?

end

Sur la ligne de commande:

$ rake check && echo "All good"
#=> One of the checks has failed!

Retour avec succès ✅

Si vous revenez sans erreur (c'est-à-dire un code de sortie de 0) que vous voudrez utiliser exit, qui ne prend pas de paramètre de chaîne.

task :check do

  # If any of your checks fail, you can exit early like this.
  exit if check_failed?

end

Sur la ligne de commande:

$ rake check && echo "All good"
#=> All good

Ceci est important si vous l'utilisez dans un travail cron ou quelque chose qui doit faire quelque chose par la suite selon que la tâche de râteau a réussi ou non.

Si vous devez sortir de plusieurs niveaux de bloc, vous pouvez utiliser fail .

Par exemple

task :something do
  [1,2,3].each do |i|
    ...
    fail "some error" if ...
  end
end

(Voir https://stackoverflow.com/a/3753955/11543 .)

Si vous vouliez quitter une tâche de râteau sans provoquer le "râteau abandonné!" message à imprimer, vous pouvez alors utiliser soit "abandonner", soit "quitter". Mais "abandonner", lorsqu'il est utilisé dans un bloc de secours, met fin à la tâche et affiche toute l'erreur (même sans utiliser --trace). Donc, "quitter" est ce que j'utilise.

J'ai utilisé l' nextapproche suggérée par Simone Carletti, car lors du test de la tâche de râteau abort, qui n'est en fait qu'un wrapper exit, ce n'est pas le comportement souhaité.

Exemple:

task auto_invoice: :environment do
  if Application.feature_disabled?(:auto_invoice)
    $stderr.puts 'Feature is disabled, aborting.'
  next
end