Daniel Zanzini

Le développement piloté par les spécifications est un processus de développement logiciel qui utilise la spécification API comme guide de mise en œuvre. Les entrées et sorties sont transformées en cas de test pour garantir que l'API fait tout ce qu'elle promet.

Il n'y a qu'une seule exigence pour utiliser cette approche: Écrivez d'abord la documentation de l'API. Le mieux que nous puissions faire d'avance est le mieux, mais nous n'allons pas ici en cascade. Nous pouvons également utiliser les avantages des méthodologies agiles pour incrémenter la documentation en cycles, comme nous le faisons lors du codage.

La rédaction de la documentation présente d'abord certains avantages:

  1. Parallélisez le processus de développement. Avec la documentation en main, le serveur et le client peuvent se développer simultanément. Se moquer de l'API peut améliorer cet avantage.
  2. Améliore la compréhension de l'ensemble. Lors de la rédaction des documents, vous serez confronté à des cas marginaux, découvrirez des incohérences et remarquerez des problèmes de conception. Cela rendra le processus de développement beaucoup plus facile et réduira la quantité de retouches.
  3. Développement du guide. L'utilisation de la documentation comme base pour un développement piloté par les spécifications garantit que l'API fait exactement ce qu'elle promet et, en offrant une excellente couverture de test, diminue la quantité de bogues échappés.

Avec notre documentation en main, nous pouvons commencer le processus de développement. Il est très similaire à BDD, à la différence près que nous nous appuyons sur nos documents API plutôt que sur les user stories: