$ sudo gem install sqlite3
Password:
ERROR:  Error installing sqlite3:
	sqlite3 requires Ruby version >= 1.9.1.

Mais vous utilisez des gems qui ne sont pas compatibles avec Ruby 1.9 et vous devez donc faire cohabiter plusieurs versions de Ruby. C’est là que RVM intervient.

Installer RVM sur Leopard

Passez la commande suivante dans une fenêtre de Terminal :

$ bash < <( curl http://rvm.beginrescueend.com/releases/rvm-install-head )

Puis ajoutez cette ligne à la fin de votre fichier ~/.profile :

[[ -s $HOME/.rvm/scripts/rvm ]] && source $HOME/.rvm/scripts/rvm

Pour tous les détails additionnels, allez à la source.

Utiliser RVM

Vous pouvez maintenant utiliser rvm, par exemple pour installer Ruby 1.9.1.

$ rvm install 1.9.1 ; rvm 1.9.1
$ ruby -v
ruby 1.9.1p378 (2010-01-10 revision 26273) [i386-darwin9.8.0]
$ sudo gem install sqlite3
Building native extensions.  This could take a while...
...
Successfully installed sqlite3-0.1.1

Pour revenir à la version d’origine :

$ rvm system
$ ruby -v
ruby 1.8.7 (2009-06-12 patchlevel 174) [i686-darwin9.8.0]

  it "should render column titles" do
    render "/feeds/index.html.erb"
    response.should have_tag("tr>th", "name")
    response.should have_tag("tr>th", "url")
  end

Mais cette méthode ne permet pas de tester les bribes de HTML qui sont produites dans un content_for. En effet, ces bribes sont incluses directement dans le layout, pas dans la production de la vue. Pour ce faire, ajouter dans spec_helper.rb :

  def content_for(name)
    response.template.instance_variable_get("@content_for_#{name}")
  end

Puis dans les specs :

  it "should render a 'New feed' link" do
    render "/feeds/index.html.erb"
    content_for(:somewhere).should have_tag("a[href=?]", new_feed_path)
  end

Merci à Carl-Johan Kihlbom.

L’utilisation est simple : invoquer Ubiquity (alt-espace sur mon Mac), taper ruby <nom-de-fonction> puis <Enter> et la page s’ouvre dans un nouvel onglet.

La base : le chapitre 7 du manuel, The Lo-Down on Fixtures et la référence.

Une bonne introduction aux fixtures dans Rails 2.0 : Fixtures in Rails 2.0

Si vous n’aimez pas les screencasts, la même info dans un blog : What’s New in Edge Rails: Fixtures Just Got a Whole Lot Easier

Les avis

Le titre de l’article se passe de commentaire : Why Fixtures Suck (And How We Can Fix Them). Un peu vieux, il date du mois d’août 2006

Daniel Manges propose de remplacer les fixtures par des factories. Paul Gross propose un raffinement de la méthode. À creuser.

Chris Wanstrath propose des Fixtures scenarios. Les commentaires qui suivent sont particulièrement intéressants.

Les outils

Fabien Jakimowicz vous propose des tâches rake qui construisent vos fixtures à partir d’une base de données dans son article Rails plugin: named fixtures exporter

Clefs étrangères et intégrité référentielle

Les clefs étrangères présentent une difficulté : il n’est plus possible d’insérer ni de supprimer les enregistrements dans la base dans un ordre quelconque. Per Olesen propose une technique pour résoudre ce problème dans son article Rails Fixtures Tips.

Don’t get stuck on unit testing dogma
Embrace unit testing karma

Le même article en pdf.

Parfois les données brutes ne sont pas disponibles dans le bon format. L’éditeur vi (ou vim), disponible sur toutes les bonnes plateformes, dispose d’une commande d’édition par expressions régulières très puissante. Prenons un exemple. J’ai donc besoin de convertir une liste d’ATA au format YAML.

Format liste

21 : Air conditioning
22 : Auto flight
23 : Communications

Format YAML

21:
  number: 21
  description: Air conditioning
 
22:
  number: 22
  description: Auto flight
 
23:
  number: 23
  description: Communications

La commande vi de substitution

Une « simple » commande suffit:

:%s/\([0-9][0-9]\) : \(.*\)/\1:\r  number: \1\r  description: \2\r/

Ça paraît un peu rude, mais c’est facile à décortiquer. Prenons la commande dans l’ordre.

• % toutes les lignes du fichier
• s/.../.../ la commande de substitution qui va être appliquée à chaque ligne
• [0-9][0-9] deux chiffres ; je mémorise le numéro dans \1 en le mettant entre \( et \)
• : deux points entre deux espace
• .* tout le reste de la ligne, que je \(mémorise\) dans \2
• maintenant le remplacement : je récupère le numéro avec \1, que j’insère suivi de : et d’un saut de ligne
• insertion de number: puis le numéro
• insertion de description: puis le texte récupéré

Facile, non ?

wget -r -w 1 http://api.rubyonrails.com

Mais ce n’est pas la peine si vous avez installé Rails avec gem : vous avez un serveur local à disposition. Lancez :

gem server

Puis pointez votre navigateur sur http://localhost:8808/. Ça marche, mais je trouve l’interface utilisateur pénible. (Quand je suis connecté, j’utilise gotAPI.) Il y a une alternative sur RailsBrain.com avec un ZIP à télécharger.

Pour une raison que je n’ai pas cherché à élucider, je n’ai pas réussi à décomprimer le fichier sous Vista. Je l’ai décomprimé sous Mac OS X puis copié sur mon portable…

cap deploy:web:disable

Il est même possible d’y ajouter le motif et l’heure prévue de remise en service :

cap deploy:web:disable REASON="installing new version" UNTIL="lunch time"

Notez que la page est en anglais.

Le mécanisme est simple. À l’invocation de la commande, Capistrano copie le fichier maintenance.html dans /shared/system/maintenance.html. Pour que ce fichier apparaisse, il faut configurer le serveur. Prenons l’exemple d’Apache (en particulier parce que je n’ai pas la première idée de comment ça marche avec d’autres serveurs).

Nous allons utiliser mod_rewrite pour faire une redirection de tout le site vers cette simple page, quand elle est présente. Il faut modifier le contenu de httpd.conf de la manière suivante :

	RewriteEngine On
	# Just for debug 
	#RewriteLog /home/.../logs/rewrite.log
	#RewriteLogLevel 5
 
	# Check for maintenance file and redirect all requests
	#  ( this is for use with Capistrano's disable_web task )
	RewriteCond %{DOCUMENT_ROOT}/system/maintenance.html -f
	RewriteCond %{SCRIPT_FILENAME} !maintenance.html
	RewriteRule ^.*$ %{DOCUMENT_ROOT}/system/maintenance.html [L]

Bien sûr, quand le déploiement est terminé, on remet le site en service avec  :

cap deploy:web:enable

• La base : Using Capistrano with Rails
• Toutes les variables de deploy.rb : Available Configuration Parameter
• Quand tout le reste rate : le code source