pry byebug

pry-byebug

Ajoute des capacités de débogage étape par étape et de la navigation de pile pour faire un prix à l'aide de byebug.

Pour utiliser, invoquez Pry normalement. Pas besoin de démarrer votre script ou votre application différemment. L'exécution s'arrêtera dans la première instruction après votre binding.pry .

 def some_method
  puts 'Hello World' # Run 'step' in the console to move here
end

binding . pry
some_method          # Execution will stop here.
puts 'Goodbye World' # Run 'next' in the console to move here. 

Exigences

IRM 2.4.0 ou plus.

Installation

Ajouter

 gem 'pry-byebug'

à votre gemfile et courez

 bundle install

Assurez-vous d'inclure la gemme à l'échelle mondiale ou à l'intérieur du groupe :test si vous prévoyez de l'utiliser pour déboguer vos tests!

Commandes

Débogage étape par étape

Break: Gérez les points d'arrêt.

ÉTAPE: ÉTAPE EXÉCUTION dans la ligne ou la méthode suivante. Prend un argument numérique facultatif pour marcher plusieurs fois.

Suivant: passez à la ligne suivante dans la même trame. Prend également un argument numérique en option pour démarrer plusieurs lignes.

Terminez: exécutez jusqu'à ce que la trame de pile actuelle revienne.

Continuez: Continuez l'exécution du programme et terminez la session PRY.

Navigation CallStack

Backtrace: montre la pile actuelle. Vous pouvez utiliser les numéros sur le côté gauche avec la commande frame pour naviguer dans la pile.

UP: déplace le cadre de pile vers le haut. Prend un argument numérique facultatif pour déplacer plusieurs images.

En bas: déplace le cadre de pile vers le bas. Prend un argument numérique facultatif pour déplacer plusieurs images.

Cadre: se déplace vers un cadre spécifique. Appelé sans arguments affichera le cadre actuel.

Comportement de byebug correspondant

Si vous venez de Byebug ou des versions Pry-Byebug avant 3,0, vous manquez peut-être des alias «n», «s», «C» et «F» pour les commandes de Stepping. Ces alias ont été supprimés par défaut car ils entrent généralement en conflit avec les noms de variables de grattage. Mais il est très facile de les réactiver si vous les voulez toujours, ajoutez simplement les raccourcis suivants à votre fichier ~/.pryrc :

 if defined? ( PryByebug )
  Pry . commands . alias_command 'c' , 'continue'
  Pry . commands . alias_command 's' , 'step'
  Pry . commands . alias_command 'n' , 'next'
  Pry . commands . alias_command 'f' , 'finish'
end

En outre, vous pourriez également trouver utile la dernière commande en appuyant simplement sur la touche Enter (par exemple, avec step ou next ). Pour y parvenir, ajoutez ceci à votre fichier ~/.pryrc :

 # Hit Enter to repeat last command
Pry :: Commands . command /^$/ , "repeat last command" do
  pry_instance . run_command Pry . history . to_a . last
end 

Points d'arrêt

Vous pouvez définir et ajuster les points d'arrêt directement à partir d'une session Pry à l'aide de la commande break :

Break: définissez un nouveau point d'arrêt par rapport à un numéro de ligne dans le fichier actuel, un fichier et un numéro de ligne ou une méthode. Passez une expression facultative pour créer un point d'arrêt conditionnel. Modifiez les points d'arrêt existants via divers drapeaux.

Exemples:

 break SomeClass #run            # Break at the start of `SomeClass#run`.
break Foo #bar if baz?          # Break at `Foo#bar` only if `baz?`.
break app / models / user . rb : 15    # Break at line 15 in user.rb.
break 14                       # Break at line 14 in the current file.

break -- condition 4 x > 2      # Change condition on breakpoint #4 to 'x > 2'.
break -- condition 3            # Remove the condition on breakpoint #3.

break -- delete 5               # Delete breakpoint #5.
break -- disable - all            # Disable all breakpoints.

break                          # List all breakpoints.
break -- show 2                 # Show details about breakpoint #2.

Type break --help d'une session PRY pour voir toutes les options disponibles.

Alternatives

Notez que toutes les alternatives ici sont incompatibles avec Pry-Byebug. Si votre plateforme est prise en charge par Pry-Byebug, vous devez supprimer l'un des gemmes mentionnés ici s'ils sont présents dans votre gemfile.

• Pry-Debugger: fournit un débogage étape par étape pour l'IRM 1.9.3 ou des rubis plus anciens. Si vous les utilisez toujours et que vous avez besoin d'un débogueur étape par étape pour aider à la mise à niveau, Pry-Debugger peut être pratique.

• Pry-stack_explorer: fournit des capacités de navigation de pile pour l'IRM 1.9.3 ou des rubis plus anciens. Si vous les utilisez toujours et que vous devez naviguer dans votre pile pour vous aider avec la mise à niveau, Pry-stack_explorer peut être pratique.

• Pry-Nav: fournit un débogage étape par étape pour JRuby.

Contribuer

Voir commencer avec le développement.

Financement

Abonnez-vous à Tidelift pour vous assurer que Pry-Byebug reste activement maintenu et en même temps obtenir des assurances de licence et des notifications de sécurité en temps opportun pour vos dépendances open source.

Vous pouvez également aider pry-byebug en laissant une petite (ou grande) astuce à travers Liberapay.

Coordonnées de sécurité

Veuillez utiliser le contact de sécurité Tidelift pour signaler une vulnérabilité de sécurité. Tidelift coordonnera le correctif et la divulgation.

Crédits

• Gopal Patel (@nixme), créateur de Pry-Debugger, et tous ceux qui y ont contribué. Pry-Byebug est une fourche de pry-débugger, donc il n'existerait pas comme il est sans ces contributions.
• John Mair (@banister), créateur de Pry.

Les correctifs et les rapports de bogues sont les bienvenus.