94 votes

Comment faire pour bloquer les commentaires dans Gherkin ?

En syntaxe gherkin (utilisée par Cucumber et SpecFlow), je peux commenter une ligne en la faisant précéder de '#'.

Existe-t-il un moyen de mettre des commentaires en bloc sur plusieurs lignes ?

2 votes

Je ne l'ai pas essayé, mais si la solution d'Artem est correcte, alors la solution acceptée devrait être changée pour celle-là.

0 votes

De nombreux éditeurs permettent de préfixer plusieurs lignes avec des lignes simples en utilisant un raccourci clavier. Dans Atom, c'est CMD + / ;)

0 votes

Ceci n'est pas soutenu par Gherkin. La raison en est que vous êtes déjà en mesure d'introduire des blocs de description à élaborer selon les besoins pour les mots-clés : Feature, Scenario Outline, Scenario et Examples. Un commentaire multiligne pour ceux-ci serait un anti-modèle. Pour les autres mots-clés, vous disposez d'un commentaire d'une seule ligne si nécessaire. L'introduction d'un commentaire multiligne pour ces mots-clés devrait être plutôt rare et peut-être révélatrice d'un manque de clarté.

63voto

Tz_ Points 1990

Il n'est pas supporté par Gherkin, donc vous devez préfixer toutes les lignes avec #.

Si vous utilisez l'extension SpecFlow Visual Studio (v1.9.2), vous pouvez simplement sélectionner les lignes et les basculer en commentaires et inversement. Les raccourcis par défaut sont Ctrl+K,C pour commenter et Ctrl+K,U pour décommenter.

Vous pouvez également "contourner" ce problème dans Visual Studio en utilisant la fonction d'édition multi-lignes. (Voir http://weblogs.asp.net/scottgu/archive/2010/04/26/box-selection-and-multi-line-editing-with-vs-2010.aspx ). Il vous suffit de sélectionner le début des lignes en maintenant la touche ALT enfoncée et en utilisant la souris. En utilisant cette fonction, vous pouvez taper toutes les lignes sélectionnées en même temps. Vous pouvez également les supprimer de la même manière, en sélectionnant tous les caractères # à supprimer.

7 votes

Vous pouvez faire la même chose dans RubyMine en sélectionnant des lignes et en appuyant sur Ctrl+/, et les décommenter de la même manière. Fabuleusement utile :)

0 votes

J'utilise le truc de l'alt tout le temps. C'est très pratique pour les phrases SQL et aussi quand j'ai besoin d'ajouter ' et ', pour les clauses where-in. +1

27voto

Artem Oboturov Points 2292

Si, il y en a un. Cela s'appelle les commentaires de type PyStrings. Voir l'exemple à http://docs.behat.org/guides/1.gherkin.html#pystrings .

Il fonctionnera si vous l'utilisez juste après Feature ou Scenario et quelques autres éléments.

Feature: my feature
  """ some block comment
      still block comment
  """ end of block comment
Scenario: my feature
  """ some block comment
      still block comment
  """ end of block comment

D'un autre côté, cela ne fonctionnera pas si vous voulez commenter certaines étapes.

Je pense que vous pouvez configurer votre IDE pour commenter une ligne sur une combinaison de touches standard. Par exemple, IntelliJ reconnaît les fichiers *.feature et permet de commenter les lignes. Il est possible de faire la même chose avec Notepad++ ou même VS.

0 votes

Venant de Python, il est vraiment bizarre de voir des guillemets triples utilisés de cette façon. Mais c'est une bonne solution si elle fonctionne !

5 votes

Il n'est pas nécessaire d'utiliser des guillemets triples à ces endroits, car tout texte qui s'y trouve sera de toute façon traité comme des commentaires (c'est-à-dire ignoré) par Cucumber. Les guillemets triples sont utilisés pour les textes multilignes donnés/quand/alors à l'intérieur des étapes.

8voto

p91java Points 49

Commentaire sur une seule ligne : #

Commentaire à plusieurs lignes : Commence par """ Se termine par """

7voto

Afshar Points 222

Sur Eclipse Pour commenter une ou plusieurs lignes du contenu du fichier de fonctionnalités Gherkin, nous pouvons également procéder comme suit.

Ajouter une nouvelle association de fichiers
Windows > Preferences > General > Editors> File Associations > File types: > Add...
et ajoutez un nouveau type de fichier comme *.feature

Associer un éditeur pour un nouveau type de fichier
Associated Editors > > Add...
ajouter Properties File Editor (Default) .

Maintenant, rouvrez le fichier s'il est ouvert et il s'ouvrira en Properties File Editor au lieu de Text editor .

Cela me permet de sélectionner n'importe quel nombre de lignes et de les commenter en utilisant le raccourci commun de commentaire Ctrl+Shift+C.

6voto

Anand Dave Points 31

Utilisez CTRL + /

Il fonctionne très bien. Commentaire sur plusieurs lignes

Prograide.com

Prograide est une communauté de développeurs qui cherche à élargir la connaissance de la programmation au-delà de l'anglais.
Pour cela nous avons les plus grands doutes résolus en français et vous pouvez aussi poser vos propres questions ou résoudre celles des autres.

Powered by:

X