Premiers pas Subversion...
Svn

Rappel

Pour faire cet exercice, vous devez avoir lu la présentation Subversion

Pour toute commande de commit passée avec svn, ne pas oublier de vérifier que le commit s'est bien passé. Une erreur commune consiste à être dans un autre répertoire que celui supposé. Aucune modification n'est alors transmise, mais ça n'est pas considéré par Subversion comme une erreur.

% svn commit . -m "Modif de la doc svn"
Sending        trunk/Html/svn.html
Transmitting file data .
Committed revision 1881.
%             ->Le commit s'est bien déroulé
      

% svn commit . -m "Modif de la doc svn"
%             ->Pas de message de Svn : rien n'a été commité !!!
      

Initialiser l'environnement de travail (30 minutes)

La première étape consiste à initialiser un espace de travail (répertoire) contenant une copie de la partie du repository (branche) Etudiants correspondant à son binome (vide au départ) et à y ajouter les fichiers produits au cours du TD précédent.

• Se mettre dans son répertoire Projet.
• Faire une copie de travail (checkout) de la branche correspondant à son binome (attention au '.' à la fin de la commande, remplacer ens<n> par son nom de binome, taper 'p' à la question posée à propos du certificat) :

  $> svn checkout https://svn.lal.in2p3.fr/projects/Etudiants/ens<n> .
            

• Indiquer les fichiers à ajouter au repository (Ici, tous les fichiers produits au cours de la séance précédente) :

  $> svn add Bonjour
            

• Vérifier l'état de l'espace de travail :

  svn status
            

• Enregistrer les modifications dans le repository, avec un message résumant les modifications (pas de caractères accentués, le password est celui qui vous a été indiqué pendant la présentation, paragraphe svn commit, celui-ci est différent de votre password local) :

  $> svn commit -m "Import des fichiers de la premiere seance"
            

Valider cette étape  

Modifier les fichiers (5 minutes)

Dans cette étape, il est proposé de modifier un ou plusieurs fichiers et de les enregistrer dans le repository. On utilisera successivement les commandes cp et rm traditionnelles et leurs équivalents Svn pour comparer les différences. L'opération peut être répétée plusieurs fois pour enrichir l'historique en vue de l'étape suivante.

On se déplace dans le répertoire src du projet que l'on vient d'enregistrer sous Svn.

• Modifier un fichier existant (par exemple bonjour.cpp, ajouter une ligne de commentaire), vérifier l'effet et enregistrer la modification dans le repository :

  ... Editer bonjour.cpp ... 
  $> svn status
  M      bonjour.cpp
  $> svn commit -m "Premiere modification de bonjour"
            

• Copier un fichier existant (sans utiliser svn cp), vérifier l'effet et enregistrer la modification dans le repository :

  $> cp bonjour.cpp bonjourLeMonde.cpp
  $> svn status
  ?      bonjourLeMonde.cpp
  $> svn add bonjourLeMonde.cpp
  $> svn commit -m "Ajout de bonjourLeMonde"
            

  Le ? signifie que le fichier donné n'existe pas dans le repository, mais existe en local

• Supprimer le fichier ajouté précédemment (sans utiliser svn rm), vérifier l'effet et enregistrer la modification dans le repository :

  $> rm bonjourLeMonde.cpp
  $> svn status
  !      bonjourLeMonde.cpp
  $> svn rm bonjourLeMonde.cpp
  $> svn commit -m "Suppression de bonjourLeMonde"
            

  Le ! signifie que le fichier donné existe dans le repository, mais n'existe pas en local

• Copier un fichier existant (en utilisant svn cp), comparer l'effet et enregistrer la modification dans le repository :

  $> svn cp bonjour.cpp bonjourLeMonde.cpp
  $> svn status
  A  +   bonjourLeMonde.cpp
  $> svn commit -m "Ajout de bonjourLeMonde"
            

• Supprimer le fichier ajouté précédemment (en utilisant svn rm), comparer l'effet et enregistrer la modification dans le repository :

  $> svn rm bonjourLeMonde.cpp
  $> svn status
  D      bonjourLeMonde.cpp
  $> svn commit -m "Suppression de bonjourLeMonde"
            

• Maintenant, à vous de supprimer le dossier Bonjour/v1/Darwin ...

  $> svn rm ...
          

Valider cette étape  

Lister les modifications (15 minutes)

Durant les étape suivantes, on va expérimenter deux utilisations de l'historique des versions stockées dans le repository : la visualisation des différences entre versions et le retour à une version antérieure. Pour pouvoir utiliser l'historique, il faut généralement commencer par visualiser la liste des révisions disponibles avec leur message de description.

• Afficher les modifications en mode normal :

  $> svn log
            

• Afficher les modifications en mode détaillé :

  $> svn log -v
            

• Afficher les modifications sur un fichier précis :

  $> svn log bonjour.cpp
            

• Comparer les différences.

Valider cette étape  

Visualiser les différences (15 minutes)

Il est proposé 2 utilisations de la capacité à afficher les différences : entre l'espace de travail et le repository ; entre 2 versions du repository.

• Afficher les différences entre l'espace de travail et la dernière version du repository :

  ... Modifier le fichier bonjour.cpp (ajouter un commentaire) ...
  $> svn diff bonjour.cpp
              

• Afficher les différences entre l'espace de travail et une révision arbitraire du repository. Comparer avec le résultat précédent :

  ... Sélectionner une révision n dans l'historique ...
  $> svn diff -r n bonjour.cpp
              

• Afficher les différences entre 2 révisions m et n du repository sélectionnées dans l'historique (la dernière révision s'appelle toujours HEAD). Le fichier bonjour doit exister dans les 2 (vérifier l'effet si ce n'est pas le cas)

  $> svn diff -r m:n bonjour.cpp
              

• Répéter l'action précédente en utilisant l'interface Web WebSVN. Pour cela se connecter à l'URL http://svn.lal.in2p3.fr/WebSVN/Etudiants et naviguer jusqu'au fichier bonjour.cpp de votre branche. Cliquer sur 'Journal des révisions', sélectionner 2 révisions dans la colonne Diff. et cliquer sur le bouton 'Voir les différences'.

Valider cette étape  

Revenir à une version antérieure ( 45 minutes)

L'intérêt de conserver un historique des révisions est aussi de pouvoir revenir à une version antérieure d'un fichier.

• Annuler les modifications de l'espace de travail et revenir à la version de la dernière révision du repository :

  $> svn status
  ... Vérifier que bonjour a été modifié ...
  $> svn revert bonjour.cpp
            

• Annuler les modifications de l'espace de travail et revenir à la version d'une révision n quelconque du repository :

  $> svn revert bonjour.cpp
  $> svn merge -r HEAD:n bonjour.cpp
  $> svn status
  $> svn commit -m "Retour a la version n de bonjour"
            

• Revenir à la version d'une révision n quelconque du repository, en préservant les modifications locales :

  $> svn merge -r HEAD:n bonjour.cpp
  $> svn status
  ... Vérifier les conflits et, le cas échéant, les résoudre ...
  $> svn commit -m "Retour a la version n de bonjour"
            

Valider cette étape  

Vérification générale à la fin du TP

• Pour cela, on créera un dossier vide dans lequel on exportera avec la commande ad hoc tous les exercices réalisés.
• On les recompilera tous.
• On s'assurera en les exécutant du bon fonctionnement de chacun.

Enseignement Lal <ens@lal.in2p3.fr>

Last modified: Thu Feb 11 16:51:23 CET 2010