Teddy Payet

Des astuces et mémos pour SVN

Teddy Payet — 2018-06-15T09:00:00Z

Je travaille encore très souvent sur des projets sous SVN avec grand plaisir. J'utilise des lignes de commandes pour aller plus vite. Il arrive parfois que je me creuse les méninges pour certaines lignes de commandes. Alors, un petit article mémo ne fera pas de mal.

Lorsqu'on est sous SVN, il est parfois utile de voir la liste des éléments qui ne sont pas encore reconnus dans le dépôt.

svn st | grep ^?

Et si on ne veut pas avoir le " ?" et les espaces entre ce " ?" et le nom des éléments :

svn st | grep ^? | cut -c9-

Pour lister tous les éléments qui ont été modifié :

svn st | grep ^M

Pour lister tous les éléments qui ont été ajouté :

svn st | grep ^A

Pour lister tous les éléments qui sont introuvables :

svn st | grep ^!

Si vous désirez afficher tous les éléments autres que modifiés ou ajoutés :

svn st | grep -v ^[AM]

Afficher tous les fichiers ayant été modifié, ou ajouté ou qui ne sont pas reconnus par svn :

svn st | grep ^[AMD\!?]

Il arrive parfois qu'on ait besoin de déposer des fichiers (exemple : un dump d'une base de données) mais sans vouloir télécharger tout le répertoire cible sur son local. Voici la commande adéquate :

svn co http://example.org/url_depot/bdd_dump/ --depth empty

Cela permettra de faire un checkout sur son local sans télécharger tous les fichiers présents sur le dépôt.

Règle générique

De manière générale, SVN en lignes de commande ajoute 9 caractères avant le nom de l'élément affiché. De ce fait, à chaque fois que vous ne désirez pas voir ces 9 caractères (ou 9 colonnes), il faut mettre à la fin de votre commande | cut -c9-

En bash, si on désire exporter le résultat de notre commande dans un fichier, il faut rajouter à la fin de notre commande " > nom_fichier.txt"
Soit pour exemple, la liste des fichiers autres que modifiés et/ou ajoutés :

svn st | grep -v ^[AM] > files.txt

Ajouter de nouveaux fichiers/répertoires au dépôt

for new_element in $(svn st | grep "^?" | cut -c9-); do svn add ${new_element}; done;

Supprimer des fichiers/répertoires obsolètes au dépôt

for delete_element in $(svn st | grep "^\!" | cut -c9-); do svn delete ${delete_element}; done;

Visuel : Photo by Moja Msanii on Unsplash

Plugin « Agrandir la largeur de page »

Teddy Payet — 2015-08-03T07:00:00Z

Ce plugin permet d'agrandir la largeur de la page dans l'espace privé de SPIP. Vous pourrez personnaliser cette largeur si besoin.

Pour informations, le préfixe du plugin est spip_hop. Il vient de l'onomatopée "Hop" qui, selon Wikipedia, signifie une « exclamation suggérant l'exécution d'un saut ou d'une manœuvre habile ». De par sa fonctionnalité principale "les écrans", j'aurais pu l'appeler spip_ecran mais ce terme est trop proche de l'idée "écran de sécurité" induisant ainsi l'utilisateur en erreur.
Mais "Hop" est aussi la réaction des beta-testeurs de ce plugin après son activation. "Et hop !"

Pour plus d'informations :

Plugin « Initialiser Zcore »

Teddy Payet — 2015-07-31T16:00:00Z

Suite à l'article Créer des squelettes avec Zcore, ce plugin voit le jour. Il permet de créer pour tous les objets éditoriaux le squelette nécessaire pour fonctionner avec l'architecture « Z » et plus précisément avec Zcore.

Présentation

Ce plugin reprend les principes dans l'article "Créer des squelettes avec Zcore" et vous aide à faire ces différentes opérations depuis l'espace privé. Après activation, un lien est ajouté dans le menu "Squelettes" : "Squelettes Zcore". Il vous amènera sur la page suivante :

Sur cette dernière, vous avez 3 tableaux :

Les contrôles ;
Les répertoires ;
Les objets éditoriaux.

Plus d'informations :

Créer un trunk sur la zone SPIP

Teddy Payet — 2015-07-30T07:00:00Z

Il arrive parfois que lorsqu'on a créé un plugin sur SPIP-Zone (ou qu'on veuille reprendre le développement d'un plugin sur SPIP-Zone) que ce plugin n'est pas sur la structure trunk/branches/tags. Pour reprendre ce plugin, il est conseillé de mettre le répertoire sous cette structure avant de commencer.

Un script pour les commander tous !

Au lieu de faire cela ligne par ligne, commande par commande, vous pouvez lancer un script à personnaliser selon le besoin. Les lignes de commande à taper ne sont pas forcément très nombreuses mais elles sont répétitives. Je vais de ce fait vous montrer un script bash qui simplifiera cette migration. Mais qui dit "bash", dit être donc sous un environnement UNIX : Linux, Mac OS.

Le script

#!/bin/bash
url_svn=svn://zone.spip.org/spip-zone/_plugins_/
plugin_nom=votreplugin
plugin_numero=0.9.0
svn mv ${url_svn}${plugin_nom} ${url_svn}${plugin_nom}_trunk -m "On commence la migration du plugin ${plugin_nom} en trunk/branches/tags"
svn mkdir ${url_svn}${plugin_nom} ${url_svn}${plugin_nom}/branches/ ${url_svn}${plugin_nom}/tags/ -m "On recrée le nom du répertoire ${plugin_nom} avec le répertoire branches/ et tags/"
svn cp ${url_svn}${plugin_nom}_trunk ${url_svn}${plugin_nom}/branches/v${plugin_numero:0:1} -m "On copie les fichiers du plugin ${plugin_nom} dans sa branche v${plugin_numero:0:1}"
svn cp ${url_svn}${plugin_nom}/branches/v${plugin_numero:0:1} ${url_svn}${plugin_nom}/tags/${plugin_numero} -m "On pose le tag correspondant à la version ${plugin_numero} du plugin ${plugin_nom}"
svn mv ${url_svn}${plugin_nom}_trunk ${url_svn}${plugin_nom}/trunk -m "On déplace enfin le répertoire initial vers le trunk pour le plugin ${plugin_nom} v${plugin_numero}"

Personnalisation

Il faut copier-coller ces lignes de commande dans un fichier qui aura pour extension .sh. Pour votre plugin, vous devez changer 2 valeurs :

plugin_nom : le nom du répertoire de votre plugin
plugin_numero : le numéro du plugin (sous la forme x.y.z) que vous trouverez dans le fichier plugin.xml ou paquet.xml

Vous n'avez pas besoin de changer l'URL du serveur svn de la zone sauf si le plugin que vous désirez reprendre le développement n'est pas dans le répertoire _plugins_.
Ce script va faire 5 commits au final avec les commentaires qui vont bien avec. Pour cela, ouvrez votre terminal et lancer le script que vous avez créé.

J'ai déjà éprouvé ce script à mon travail sur mes différents projets. Il est simple et efficace.

Explications

Même si le script est simple, on peut expliquer ce qui se passe et notamment l'écriture particulière de la syntaxe de bash.

Tout fichier bash commence par la ligne #!/bin/bash. Cela indique (en plus de l'extension .sh) que c'est bien un fichier… bash.
url_svn= : lorsque vous voyez un texte suivi d'un simple signe égal "=", c'est que vous créez une variable avec une valeur ;
Pour rappeler au besoin la variable, vous devez taper $ puis le nom de la variable désirée.
Pour pouvoir mettre du texte collé à votre variable, il faut mettre le nom de la variable entre accolades. Exemple : ${plugin_nom}_trunk donnera votreplugin_trunk
Si vous désirez avoir les premiers caractères de votre variable, dans le rappel de votre variable, vous pouvez utiliser la forme ${nom_variable:debut:longueur} où :
- nom_variable : le nom de votre variable ;
- debut : emplacement où commencer (0 étant le numéro du premier caractère) ;
- longueur : le nombre de caractères que vous désirez récupérer.

Plus de lecture

Le sujet du rangement sur la zone a été abordé à plusieurs reprises :

Image : © By Leroy

Plugin "Info Sites" - todo

Teddy Payet — 2014-08-25T19:28:51Z

:Pages
x Liste des organisations commit:z84316
x Liste des projets commit:z84316
x Liste des sites commit:z84316
x Liste des contacts commit:z84316
x Diagnostic ISO des différents sites d'un projet @projets_sites @projets commit:z84358
x Diagnostic d'un site @projets_sites commit:z84380
x Statistiques commit:z84755

:Fonctionnalités
+ Création d'un webservice pour insertion d'une fiche de site, ou projet dans une page externe
Mettre un token pour sécuriser les données

:Page diagnostic d'un site
x Lister les plugins d'un site commit:z97978
x Vérifier la version du plugin sur le site et la dernière mise à jour commit:z97978
x Créer un répertoire de procédure selon le CMS : inclure/diagnostic/spip/blabla.html commit:z97978
x Lien de téléchargement de l'archive commit:z97978
x Lien vers le svn du plugin commit:z97978
+ Version du logiciel

:Page diagnostic ISO des sites d'un projet
x Tableau par champ de la table. commit:z84358
+ Séparation par onglet des listes (administrateurs, webmestres et plugins) du reste des informations. Sinon page trop longue.
+ Essayer de simplifier le code de la page. Possibilité de rendre automatique le retour des balises. On détermine tous les champs de la table, puis on construit les chaînes de langue, retour des valeurs, etc.

:Page projet
x Bouton de modification du projet commit:z84316
x Ajout de formulaires d'édition des liens entre les autres objets
x Ajout de champs liés au dépôt du projet (trac, svn/git, rss des commits etc.)
x Lister les derniers commits du dépôt
x Breadcrumb commit:z84316

:Page organisation
x Bouton de modification de l'organisation commit:z84316
x Liste des contacts commit:z84316
x Liste des projets commit:z84316
+ Création de la page d'édition d'une organisation directement depuis le FO
+ Ajout de formulaires d'édition des liens entre les autres objets
x Breadcrumb commit:z84316

Plugin « Info SPIP »

Teddy Payet — 2014-07-21T16:00:00Z

Ce plugin permet d'avoir une page, dans la partie privée, donnant la fiche identitaire de votre site et de votre serveur. Il offre aussi la possiblité d'avoir une page au format xml (dans la partie publique) reprenant les même informations que la page du privé.

Ce plugin après activation fournira une page accessible par http://example.org/ecrire/?exec=info_config.

Les pages livrées par le plugin http://example.org/ecrire/?exec=configurer_info_config et http://example.org/ecrire/?exec=info_config ne sont accessibles qu'aux webmestres du site.
En effet, ces informations, plutôt techniques, n'intéressent pas les administrateurs mais les développeurs.

Plus d'informations :

Nettoyer la médiathèque

Teddy Payet — 2014-05-28T07:00:00Z

Ce plugin pour SPIP 2.1 et + a pour but de faire du rangement dans le répertoire IMG/ d'un site SPIP. Il est intéressant dans l'un des cas suivants :

Vous avez un site SPIP avec une version inférieure à la 1.9.2 et vous voulez le monter de version ;
Vous avez un site depuis une version inférieure à SPIP 1.9.2 ;
Vous voulez faire le ménage des logos et des documents orphelins dans votre répertoire IMG/.
Dans tous les cas, ce plugin déplacera les fichiers obsolètes dans un sous-répertoire IMG/orphelins. A vous de décider de leur sort par la suite.

Plus d'informations :

Titre de logo, v2

Teddy Payet — 2014-05-23T07:00:00Z

Ce plugin est une refonte pour SPIP 3.0 du plugin "Titre de logo", créé initialement par ARNO*.

La version 2 du plugin Titre de logo reprend les mêmes fonctions que la v1 mais étend le titre et le descriptif aux logos de tout objet éditorial de SPIP. Il ajoute un titre et un descriptif aux logos.

Plus d'informations :

Prêts sur fonds d'épargne

Teddy Payet — 2014-05-15T14:14:00Z

Ce site du groupe de la Caisse des dépôts présente les prêts sur fonds d'épargne au service de l'intérêt général.
Il a été réalisé sous SPIP 3.0. L'intégration HTML des différents pages a été basé sur Bootstrap 3.0 par un développeur intégrateur.
J'ai développé pour ce site le formulaire d'évaluation d'un projet qui détermine le prêt associé. Création de formulaires CVT multi-étapes, nouveaux objets éditoriaux que les administrateurs peuvent mettre à jour selon leur besoin et les (…)

- Développement / SPIP, HTML, MySQL, PHP, Développeur Web, Salarié, Caisse des dépôts, Bootstrap (CSS et JS), Sublime Text, SVN

CDC Développement Solidaire

Teddy Payet — 2014-03-21T08:00:00Z

Ce site du groupe de la Caisse des Dépôts présente les actions d'une filiale du groupe dans le monde.
Il a été porté sous SPIP 3.0 et utilise le framework Bootstrap 3.0 (CSS et JS). L'intégration a été assuré par un développeur intégrateur.
J'ai développé un plugin gérant les dons et adhésions à cette filiale. Création de formulaire CVT multi-étapes, création d'empreintes stockées en base de données, envoi et retour d'informations à un webservice bancaire (norme à respecter) qui assure (…)

- Développement / SPIP, HTML, CSS, MySQL, PHP, Javascript, Développeur Web, Salarié, Bootstrap (CSS et JS), Sublime Text, SVN