IUT de Montpellier Contrôle de version A2 Génie Logiciel Université Montpellier 2 avec subversion (svn) octobre 2013

Transcription

1 IUT de Montpellier Contrôle de version A2 Génie Logiciel Université Montpellier 2 avec subversion (svn) octobre 2013 Ces exercices sont à effectuer sous Linux, sur la ligne de commande. Auteur : J-Ph. Prost Note 1 Dans ce sujet, la chaîne de caractères $USER est mise pour une référence à la variable d environnement Unix USER. Si vous ne connaissez pas cette notation, par curiosité tapez la commande echo $USER dans un terminal pour afficher sa valeur. Note 2 Ceux qui ne sont pas familiers avec la notion de variable d environnement sont renvoyés au cours d architecture. En attendant, ils pourront visionner la liste de toutes les variables d environnement accessibles, en utilisant la commande env. Exercice 1. Créer une copie de travail : checkout Question 1.1. Créer une copie de travail (locale, donc) pour la branche principale (trunk) du projet bacasablesvn hébergé sur le dépôt SVN de Google Code à l adresse suivante : Question 1.2. Consultation de la copie locale : lister tous les fichiers de votre copie locale (ls -la). Que constatez-vous? Question 1.3. Quel est le statut actuel de la copie de travail [svn status]? Question 1.4. Utiliser la commande Unix touch pour modifier artificiellement la date de dernière modification d un fichier de la copie locale, puis consulter à nouveau le statut. Que constatez-vous? Justifier le comportement de la commande status dans ce cas précis. Exercice 2. Créer un projet versionné : import Pour cet exercice, vous utiliserez votre dépôt personnel. Le but est de mettre votre code (par exemple celui d un TD) sous gestion de version sur le dépôt SVN de l IUT. L adresse du dépôt central est : La procédure qui suit vous guide, étape par étape, dans la création d un projet versionné. 1. Se placer à un emplacement neutre, comme /tmp/tp-svn/monprojet, et créer une structure arborescente type de projet versionné sous svn, avec les 3 sous-répertoires trunk, tags et branches 2. Copier les fichiers de votre projet à l emplacement approprié dans cette structure 3. Importer le projet sur le dépôt, à l aide de la commande import 4. Créer un fichier ReadMe.txt dans /tmp/tp-svn/monprojet, et tenter de mettre à jour le dépôt ; que se passe-t-il? Que vous dit le message svn? Pourquoi? Exercice 3. Modifier une copie de travail : commit et update Question 3.5. Créer une copie de travail pour la version principale de votre projet personnel (celui créé à l exercice précédent). 1

2 Question 3.6. Dans la copie locale, créer un nouveau fichier non-vide (par exemple un ReadMe.txt, puis commitez 1 -le sur le dépôt. Pour la suite de l exercice, il nous faut simuler une configuration multi-utilisateurs. Question 3.7. Créer une seconde copie de travail, pour permettre la simulation d un autre développeur impliqué sur le même projet. Dans ce qui suit, nous appellerons cette copie usr2, tandis que celle créée à la question précédente s appellera usr1. Question 3.8. Se placer dans usr2, ouvrir le fichierreadme.txt, et lui ajouter une ligne de texte. Commitez. Question 3.9. Se placer dans usr1. quelle est la première action à faire? Exercice 4. Branchement, étiquetage, et opérations associées On souhaite maintenant internationaliser et localiser notre projet, en distinguant une version en anglais (tpsvn-en) d une version en français (tpsvn-fr). On souhaite, malgré tout, conserver la branche principale de développement indépendante de la langue. 1. Créer les branches anglaise et française du projet. Il existe plusieurs solutions... Quelle est la plus efficace? 2. Livrer les versions Votre documentation doit s adapter aux versions locales : renommer le fichier de documentation en tpsvn-doc-fr.txt dans la branche courante et la branche française. Mettre à jour le dépôt pour chacune de ces branches. 4. Se placer dans la branche anglaise, créer un nouveau fichier de documentation tpsvn-doc-en.txt et supprimer le fichier tpsvn-doc.txt. Mettre à jour le dépôt. Exercice 5. Fusion Pour simplifier la gestion des différentes versions locales du logiciel, et en prévision de nouvelles localisations, on envisage de paramétrer le code en fonction de la langue. Pour autant, on ne souhaite pas bouleverser le planning des prochaines livraisons déjà prévues, ni prendre le risque de modifier la branche principale en cours, sans être certain que ce paramétrage est possible. On décide donc de créer un sous-projet expérimental monprojet-expe, dont le but sera de tester s il est possible d externaliser complètement le paramètre langue du reste du logiciel. A terme, ce projet pourra, si nécessaire, proposer une nouvelle architecture plus adaptée que la solution courante. La procédure qui suit vous guide pas-à-pas dans la création de la branche expérimentale, puis sa fusion vers la branche principale (trunk). 1. Créer la branche monprojet-expe. Est-elle plus ou moins stable que la branche principale? 2. Se placer sur la branche principale, et modifier le fichier helloworld.java (par exemple en ajoutant une ligne de commentaire au début avec le nom du développeur). Mettre à jour le dépôt. 3. Se placer sur la branche expérimentale, et créer le fichier setup.sh (sous la racine du projet) destiné à recevoir les paramètres de configuration de la langue. Mettre à jour le dépôt. 4. Tandis que vous travaillez à la version expérimentale, vous apprenez que vos collègues de la branche principale ont découvert et résolu un bug, qui était déjà présent dans la version qui a servi de point de départ pour la version expérimentale : il vous faut donc prendre en compte les modifications effectuées par vos collègues, sans pour autant écraser les votres. 1. Précisons, pour la culture générale, que le verbe commiter n existe pas en français... C est un anglicisme néanmoins communément usité par les utilisateurs de systèmes de versionnage. Pour information, une traduction française de to commit pourrait être engager, ici au sens où vous vous engagez sur votre nouveau code, en l incluant dans le projet. 2

3 Exercice 6. (subsidiaire) Administration d un dépôt Dans cet exercice, nous expérimentons le rôle d administrateur d un dépôt subversion. La tâche est grandement simplifiée du fait que subversion sait gérer les deux. Autrement dit, il ne se décline pas en une partie serveur d un côté, et une partie client de l autre : le même programme sert à la fois à la gestion du dépôt (habituellement hébergé sur un serveur central), et à la gestion de copies de travail. Pour avoir accès aux commandes d administration il suffit donc d utiliser le programme svnadmin, qui fait partie intégrante de subversion. Remarque : Dans ce qui suit, nous utilisons une variable d environnement RACINEDEPOT, supposée contenir l adresse du dépôt svn. Question Créer un dépôt sur un support local : soit sur votre clé USB (/media/usb_disk/$user, soit dans /tmp/$user. Pour cela, créer d abord le répertoire $USER, puis créer le dépôt à l aide de la commande suivante : $ svnadmin create --fs-type fsfs $RACINEDEPOT/svn Question Vérifier le contenu du dépôt : $ ls $RACINEDEPOT/svn/ 3

4 Subversion Components Add Files or Folders Commit Changes to Repository svn svnversion svnlook svnadmin svndumpfilter mod_dav_svn svnserve svnsync Command line program Revision of working copy Inspect repository Repository administration Filter repository stream Apache module SVN server (SVN protocol) Mirror repository $ svn add * Add all items in folder, and recurse (ignores versioned directories) $ svn add itemname If itemname is folder, all subfolders and files will also be added $ svn add * --force Force recurse into versioned directories $ svn commit "/path" Commit changes to file or folder $ svn commit -m "Message" "/path" Commit with message Message $ svn commit -N "/path" Commit changes to folder without recurse Miscellaneous Commands ($ svn... ) Subversion Protocols file:// svn:// svn+ssh:// Subversion Help $ svn help $ svn help import Note Local machine HTTP (Apache) HTTPS (SSL) SVN (svnserve) SVN over SSH Show help for import command The $ symbol is used to denote commands to be typed. Repository Administration $ svnadmin create "/path/to/repository" Create repository $ svnadmin setlog "path" -r 7 message.txt Change log message for revision 7 of "path" to contents of message.txt $ svnadmin dump "repository" > filename Dump contents of repository to file $ svnadmin load "repository" < filename Load contents of file into repository Add Local Folder to Repository $ svn import folder "/path/to/repository" Checkout Working Copy $ svn checkout "/path/to/repository/folder" Creates working copy of "folder" $ svn checkout "/path" foldername Checkout into new folder "foldername" Update Working Copy from Repository $ svn update "/path" $ svn update -r9 "/path" Update to revision 9 Deleting, Copying and Moving $ svn delete "/path" $ svn -m "Deleting" delete "/path" Deletes with message Deleting $ svn copy "sourcepath" "targetpath" Copy source to target $ svn move "sourcepath" "targetpath" Note Move source to target Revert Local (Uncommitted) Changes $ svn revert "/path/filename" Reverts changes to file $ svn revert -R "/path/folder" Reverts changes to folder recursively Logs and Blame $ svn log "/path" Show log messages from repository $ svn blame "/path" Show commits with messages for path Differences Between Files $ svn diff "/path/file" See what has changed in "/path/file" $ svn diff "/path/file@2" "/path/file@7" Compares file in revisions 2 and 7 $ svn diff -r 2:7 "/path/folder" Compared all files in revisions 2 and 7 Merge Changes $ svn merge -r 2:7 "item" "/path/file" Apply the diff between revisions 2 and 7 of "item" to "/path/file" $ svn merge "url1" "url2" "/path/file" Apply the diff between "url1" and "url2" to "/path/file" This cheat sheet is based in large part on the SVN book, free from: resolve "/path" Resolve conflict cleanup "/path" Recursively remove locks and complete operations lock "/path" Lock path unlock "/path" Unlock path cat "/path" View file contents status "/path" Get path status Item and Property Statuses ' ' 'A' Addition 'D' Deletion 'M' Modified 'R' Item replaced 'C' In conflict 'X' Externals definition 'I' Ignored '?' Not in repository '!' Item missing '~' Object type changed Property Commands ($ svn... ) proplist "/path" List properties propset PROP VAL Set property PROP "/path" to value VAL propget PROP "/path" Get value of PROP propedit PROP "/path" Edit PROP propdel PROP "/path" Delete PROP Argument Shortcuts -m "Message" --message -q --quiet -v --verbose -r --revision -c --change -t --transaction -R --recursive -N --non-recursive Available free from AddedBytes.com

5 Daily Usage Check out a working copy svn checkout URL path Check out a specific revision svn checkout -r rev URL path Information about a working copy svn info path Add a file or directory svn add path Remove a file or directory svn remove path... Update a working copy svn update Update specific items svn update path Check in changes svn commit -m Message Status codes First column (items) A Added C Conflicted D Deleted G Merged I Ignored M Modified R Replaced X Unversioned, used as external? Unversioned! Missing - Obstructed by another item Second column (properties of the item) C Conflicted M Modified Third column (working copy lock) Not locked L Locked Branching and Tagging Create directories svn mkdir \ svn:// /tags -m tags Create a release branch svn:// /trunk \ Checkout a release branch Switch a working copy to a release branch Switch a working copy back to trunk svn:// /trunk Create a release tag svn:// /tags/rel-x.y Check out a release svn:// /tags/rel-x.y Find out when a release was created svn log --stop-on-copy \ svn:// /branches/branch Experimenting Create an experimental branch svn:// /trunk \ Use an experimental branch Return to the trunk svn switch svn:// /trunk Merge an experimental branches svn log --stop-on-copy \ cd trunk-working-copy svn merge \ -r branch-start-revision:head \ Bug fixing Merge a single-commit bugfix from a release branch to trunk svn update svn merge -rrev-1:rev \ Create a branch for complex bug fixing \ svn:// /branches/bug-track svn:// /branches/bug-track \ svn:// /tags/pre-track Checking out a bug fix branch svn:// /branches/bug-track Tag the end of a bugfix branch svn:// /branches/bug-track \ svn:// /tags/post-track Merge complex bugfix with a release branch cd RB-x.y svn merge \ svn:// /tags/pre-track \ svn:// /tags/post-track File magic Copying a file or directory svn copy source destination Moving a file or directory svn move source destination Renaming a file or directory svn rename oldname newname Show changes svn diff path Compare two revisions svn diff -rrev1:rev2 file Compare with latest revision svn diff -r HEAD file Show most recent changes svn diff -r PREV:BASE file Create a patch file svn diff > patchfile Apply a patch file patch -p0 -i patchfile Revert to a commit change svn merge -r rev:rev-1 path Properties Setting a property svn propset propname \ propvalue path Edit a property svn propedit propname path List properties svn proplist path Content of a property svn propget propname path Delete a property svn propdel propname path Ignore all files in a directory svn propset svn:ignore * path Make a file executable svn propset svn:executable \ true path Locking Enable locking on a file svn propset svn:needs-lock \ true file svn commit file \ -m Enabled locking Obtain a lock on a file svn lock file -m lock comment Release a lock on a file svn unlock file View lock information svn info file grep Lock Break another user s lock svn unlock --force URL Steal another user s lock svn lock --force file \ -m lock message Subversion Cheat Sheet by Ariejan de Vroom Find updates at: More Subversion articles: