Mais il est parfois fastidieux de trouver où est la gem, et gemedit facilite la vie en ajoutant une commande edit à gem.

$ sudo gem install gemedit
$ gem edit gemedit

Vous pouvez indiquer l’éditeur que vous voulez lancer grâce aux variables d’environnement $GEMEDITOR, $VISUAL ou $EDITOR. Pour utiliser TextMate, ajoutez cette ligne dans votre .profile :

export GEMEDITOR=mate

Ou pour Xcode :

export GEMEDITOR=xed

C’est tout de même plus rapide de taper gem edit gemedit que mate /usr/local/lib/ruby/gems/1.8/gems/gemedit-0.9.0 !

GEM Editor via Stop Googling (John Nunemaker)

5.2.1.1 Ressources et identificateurs de ressources

La ressource est le fondement de l’abstraction de l’information dans REST. Toute information qui peut être nommée peut être une ressource : un document ou une image, un service momentané (par exemple « le temps à Los Angeles aujourd’hui »), un ensemble d’autres ressources, un objet non virtuel (par exemple une personne), etc. Autrement dit, tout concept pouvant être la cible d’un lien hypertexte répond nécessairement à la définition de ressource. Une ressource est la référence conceptuelle¹ vers un ensemble d’entités, pas une entité qui correspondrait à la référence à un instant donné.

Plus précisément, une ressource R est une fonction d’appartenance² M_R(t), qui au temps t associe un ensemble d’entités, ou de valeurs, qui sont équivalentes. Les valeurs de cet ensemble peuvent être des représentation de ressources³ ou des identifiants de ressources⁴. Une ressource peut être associée à l’ensemble vide, ce qui permet de faire référence à un concept avant qu’aucune réalisation de ce concept n’existe — une notion étrangère à la plupart des systèmes hypertextes avant le Web. Certaines ressources sont statiques dans le sens où, examinées à tout moment après leur création, elles correspondent toujours au même ensemble de valeurs. D’autres ont un degré de variabilité élevé dans le temps. La seule chose qui doit être statique pour une ressource est la sémantique de la référence, puisque la sémantique est ce qui distingue une ressource d’une autre.

Par exemple, la « version préférée de l’auteur » d’une publication académique est une référence dont la valeur varie dans le temps, alors que la « version publiée dans les actes du colloque X » est statique. Ce sont deux ressources distinctes, même si elles font référence à la même valeur à un instant donné. La distinction est nécessaire pour que les deux ressources puissent être identifiées et classées indépendamment. Un exemple similaire dans le domaine de l’ingénierie logicielle est l’identification distincte d’un fichier de code source dans un système de gestion de versions, comme la « dernière révision », la « révision numéro 1.2.7 » ou la « révision incluse dans la version Orange ».

Cette définition abstraite d’une ressource rend possible des fonctions essentielles de l’architecture du Web. Premièrement, elle généralise en englobant plusieurs sources d’information sans les distinguer artificiellement par type ou par implémentation. Deuxièmement, elle autorise l’attachement tardif⁵ de la référence à une représentation, ce qui rend possible une négociation de contenu⁶ basée sur les caractéristiques de la requête. Finalement, elle permet à l’auteur de référencer le concept plutôt qu’une représentation singulière de ce concept, supprimant ainsi le besoin de modifier tous les liens existants à chaque fois que la représentation change (en supposant que l’auteur a utilisé les bons identificateurs).

REST utilise un identificateur de ressource⁷ pour identifier la ressource impliquée dans une interaction entre composants. Les connecteurs REST offrent une interface générique pour atteindre et manipuler l’ensemble de valeurs d’une ressource, indépendamment de la manière dont la fonction d’appartenance est définie ou du logiciel qui traite la requête. L’autorité de nommage qui a affecté l’identificateur de ressource, rendant possible le référencement de celle-ci, a la responsabilité du maintien de la validité sémantique de la référence⁸ dans le temps (c’est-à-dire de s’assurer que la fonction d’appartenance ne change pas).

Les systèmes hypertextes traditionnels, qui opèrent typiquement en environnement clos ou local, utilisent des nœuds uniques ou des identificateurs de documents qui changent à chaque fois que l’information change, s’appuyant sur des serveurs de liens pour maintenir la référence séparément du contenu. Comme les serveurs de liens centralisés sont un anathème pour les exigences pluri-organisationnelles et à échelle gigantesque du Web, REST se repose au contraire sur l’auteur pour choisir l’identificateur de ressource qui convient le mieux à la nature du concept identifié. Naturellement, la qualité d’un identificateur est souvent proportionnelle à l’argent dépensé pour maintenir sa validité, ce qui conduit aux liens brisés, au fur et à mesure de la disparition ou du déplacement d’information éphémère ou peu maintenue.

Notes

1. a conceptual mapping
2. membership function
3. resources representations
4. resource identifiers
5. late binding
6. content negociation
7. resource identifier
8. mapping

La structure de l’application est complexe. Si vous respectez l’architecture recommandée (version 0.11), vos feuilles de styles sont dans vendor/extensions/theme_xxxx/public/stylesheets/ (si votre thème s’appelle xxxx).

Le serveur web n’est pas configuré pour aller chercher les assets ailleurs que dans public. Au démarrage de votre application, les fichiers CSS sont donc recopiés des répertoires des extensions dans le répertoire public principal.

Remarque finale : pour la même raison, un commit ou un status dans votre système de gestion de version vous montrera les vieux fichiers dans public si vous n’avez pas relancé votre serveur entre temps.

$ 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]

response.should have_tag("h2", /Subtitle/)
response.should have_tag("form#swap[method=post]")
response.should have_tag("form#swap input[type=radio][name=?]", 'part1')
response.should have_tag("form#swap input[type=radio][name=?]", 'part2')
response.should have_tag("form#swap input.button_save[type=submit]")

Autre exemple, un formulaire AJAX dans sa div (id= »filter », mais vous avez compris maintenant) avec une liste déroulante, avec soumission par GET sur changement de la sélection :

response.should have_tag("select option", "All")
response.should have_tag("select option", /20/)
response.should_not have_tag("select option", /21/)
response.should have_tag("div#filter form[method=?]", 'get')
response.should have_tag("div#filter form select[onchange=?]", 'this.form.submit()')

La syntaxe du sélecteur a beau être proche de celle du CSS, il est difficile de s’en rappeler toutes les subtilités. C’est là qu’intervient l’excellente cheat sheet créée par Assaf Arkin de Labnotes. Indispensable 

C’est pourquoi j’ai été fort (désagréablement) surpris quand mon récent cap deploy a échoué avec le message d’erreur suivant :

c:/ruby/lib/ruby/gems/1.8/gems/capistrano-2.5.1/lib/capistrano/recipes/deploy.rb:97:in ``': No such file or directory - svn info http://svn.example.com/

Or Capistrano invoque l’exécutable sus-cité, et ne le trouve pas. Solution simple et rapide : installer le client officiel SVN, que l’on peut trouver ici.

Et hop !

  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.

Deux petits rappels :

1. ! est l’opérateur de négation logique.
2. Seuls false et nil ont la valeur booléenne FAUX. Tout le reste est vrai (y compris 0, la chaîne de caractère vide, etc.

Nous en déduisons la table de vérité suivante :

• = n’importe quoi sauf nil ou false, donc de valeur booléenne true.

CQFD.

Aucune méthode préférentielle ne se dégage. En particulier, les méthodes proposant de créer les données de test avec le code de l’application sont inapplicables pour une importation sérieuse, tant par leur lourdeur que par la difficulté de maintenir les données de test au fur de l’évolution du code. J’ai choisi trois articles qui couvrent bien le sujet.

Luke Francl a écrit un article qui balaye les diverses possibilités Loading seed data.

Michael Bleigh propose, dans son article Seed Fu: Simple Seed Data for Rails, de créer les données grâce à des scripts Ruby placés dans le répertoire db/fixtures.

Enfin, Jeffrey Allan Hardy décrit dans Seed Data in Rails la méthode simple et aisée à mettre en œuvre que j’ai retenue. Il s’agit d’utiliser le puissant mécanisme des fixtures dans une tâche rake.

Les données sont saisies dans des fichiers YAML placés dans le nouveau répertoire db/fixtures. Une tâche rake est ajouté en créant le fichier db_seed.rake dans le répertoire lib/tasks.

namespace :db do
  desc "Load seed fixtures (from db/fixtures) into the current environment's database." 
  task :seed => :environment do
    require 'active_record/fixtures'
    Dir.glob(RAILS_ROOT + '/db/fixtures/*.yml').each do |file|
      Fixtures.create_fixtures('db/fixtures', File.basename(file, '.*'))
    end
  end
end

Et voilà ! Les données sont chargées avec la commande rake db:seed.

L’internationalisation de Rails sera intégrée dans la version 2.2 qui est prévue pour la fin de l’année