[Plugin de la semaine] Rails footnotes ou comment gagner des heures en développant

Publié le 25/07/08 par Jean-Baptiste Escoyez | 2 commentaires

Après une longue période d’inactivité, nous avons décidé de remettre un peu de vie sur frailers.net. Nous voilà donc reparti pour nos billets “Plugin de la semaine”.

Pour recommencer en force, je présente aujourd’hui le plugin Rails Footnotes. Un petit plugin de développement qui vous fera gagner des heures de débuggage (et encore plus pour les utilisateurs de Textmate).

C’est parti !

Débugger une appli Rails : Un plasir (ou pas…)

Ne vous êtes vous jamais lassé de scruter votre log serveur à la recherche de l’erreur qui vous empêche d’afficher correctement votre page ou de chercher parmi les nombreux fichiers de vos projets pour retrouvé celui mentionné dans la stacktrace de votre page d’erreur. Moi bien et plus d’une fois.

Rails Footnotes

Ce temps est révolu! Le plugin Rails footnotes ajoute quelques liens discrets au bas de vos pages :


Edit: Controller | View | Layout | Stylesheets (5) | Javascripts (7)
Show: Session | Cookies (1) | Params (2) | Filters | Routes | Queries (23) | Log | General Debug

Liens discrets… mais costauds. En effet, grâce à ces derniers, vous n’avez plus besoin de scruter vos logs serveur. Les informations dont vous avez besoin se trouvent au bas de chacune de vos pages.

Et on fait quoi avec ça ?

Commençons par la deuxième ligne : “Show”. Les différents liens permettent (dans l’ordre) d’examiner le contenu des variables stockées en session, de visualiser le contenu du/des cookie(s), d’obtenir les paramètres avec lesquels la page a été appelée, de connaitre les filtres exécutés lors du passage dans le contrôleur, d’afficher les différentes routes qui mènent à la page courante et enfin (peut-être le plus important) d’analyser les requêtes SQL générées par ActiveRecord. “Log” reprend toutes les informations générées lors de l’appel de la page et le lien “General” permet de debugger les aspects spécifiques de votre application.

La ligne “Edit” est réservée aux heureux utilisateurs de Textmate. En effet, les liens sur cette ligne permettent d’accéder directement aux fichiers qui composent la page que vous êtes en train de visualiser. Un gain de temps non négligeable.

C’est tout ?

Non ce n’est pas tout! En bonus, Rails Footnotes rend la stacktrace affichée sur les pages d’erreurs cliquable (encore pour les utilisateurs de Textmate). Vous accédez donc immédiatement à n’importe quel fichier de la stacktrace (y compris les fichiers du framework). Lorsque vous ne comprenez pas une erreur, plus de raisons pour ne pas plonger dans le code de Rails.

Plus qu’à installer (via git pour être cool):


cd myapp
git clone git://github.com/drnic/rails-footnotes.git vendor/plugins/footnotes
rm -rf vendor/plugins/footnotes/.git

Bon développement.

2 Commentaires

Commentaire posté par Doud le 25/07/08

C’est excellent! Merci pour cet article. J’envoie cela à mes développeurs… ils seront ravis :)

Commentaire posté par fungamer le 26/07/08

Ouais génial, j’envoie ca à mes patrons :)

Ajouter un commentaire

Vous devez être identifié pour poster un commentaire. Identifiez-vous, ou inscrivez-vous si ce n'est déjà fait.