RegexSR - Guide Rapide
RegexSR est un utilitaire très facile d'utilisation (écrit en Java) pour créer et tester des expressions régulières complexes. Le système de plugin offre des fonctionnalités supplémentaires, comme transformer une expression en code Java, et permet de créer ses propres extensions.
Parmi les fonctionnalités on notera le test d'expressions régulières, la manipulation de texte à l'aide d'expressions ou des plugins, le renommage massif de fichiers, le développement de plugins personnels, et la gestion des expressions dans les archives.
Un excellent tutorial pour les développeurs Java francophones sur les expressions régulières peut être trouvé à http://cyberzoide.developpez.com/java/regex/ ou un autre en anglais à http://www.regular-expression.info/
Astuces pour les onglets Texte et Noms de fichiers
- Les références arrières sont de la forme
\n
dans le champ de recherche et de la forme $n
dans le champ de remplacement, où n
est la n
ième référence. Voir les exemples ci-dessous.
- Pour enregistrer temporairement (pour cette session) une expression, appuyez sur
return
durant l'édition dans le champ Chercher
ou le champ Remplacer par
. Utilisez les flèches haut et bas pour accéder aux expressions ainsi enregistrées.
- Pour enregistrer une expression de manière permanente, utilisez les archives.
Astuces pour l'onglet Texte uniquement
- Le fait de presser le bouton
Remplacer
ou le bouton Rempl. tout
ainsi que le fait d'exécuter un plugin sauvegarde le texte courant; le fait de presser le bouton Annuler
récupère le texte sauvegardé.
- Désélectionnez la case
Evaluation auto
pour traiter les gros fichiers. En pressant return
dans le champ Chercher
vous lancer la recherche.
- Les recherches et les remplacements s'effectuent sur le texte sélectionné si il y'en a un, sinon sur l'ensemble du texte.
Astuces pour l'onglet Noms de fichiers uniquement
- Il est possible d'ouvrir un dossier en le glissant-déposant sur la zone de texte.
Tests
Utilisez les expressions suivantes afin de tester le programme:
Chercher = [\w%-]+(\.[\w%-]+)*@[\w%-]+(\.[\w%-]+)*\.[\w%-]{2,4}
devrait faire concorder uniquement les adresses e-mail correctes.
Chercher = \b(\w+)\b \b\1\b
et Remplacer par = $1
devrait supprimer tous les doublons dans le texte, comme dans "J'aime vraiment beaucoup beaucoup les expressions régulières".
D'autres exemples peuvent être trouvés à http://www.regular-expression.info/examples.html
Archives
Les archives mémorisent leur contenu dans des fichiers XML, /system/repositoryText.xml
et /system/repositoryFilenames.xml
. Ces fichiers peuvent être édités directement depuis n'importe quel éditeur de texte, permettant ainsi des sauvegardes ou l'importation d'expressions provenant de quelqu'un d'autre.
Plugins
Si vous programmez en Java, l'écriture de plugins pour RegexSR vous semblera particulièrement facile. Commençons avec un petit exemple que nous nommerons MonPremierPlugin
. Créons la classe MonPremierPlugin.java
qui étend PluginText
et qui redéfinit la méthode execute
. Le fichier doit être sauvegardé dans le dossier /plugins/text/monpremierplugin
.
package plugins.text.monpremierplugin;
import kernel.*;
import javax.swing.*;
public class MonPremierPlugin extends PluginText {
public MonPremierPlugin() {
setSummary("Le résumé");
setDescription("La description.");
}
public void execute() {
JOptionPane.showMessageDialog(this, "Mon Premier Plugin!",
"Au sujet de...", JOptionPane.INFORMATION_MESSAGE);
}
}
Le classpath doit être reféfini au moment de la compilation afin de donner accès aux classes PluginText
et Tools
: javac -cp .;../../../dev MonPremierPlugin.java
C'est tout! RegexSR trouvera automatiquement le nouveau plugin lors de son exécution.
La documentation pour les classes PluginText
et Tools
se trouve dans le dossier /dev/javadoc
. Il est également recommandé d'étudier les plugins suivants (dans l'ordre indiqué): HelloWorld
, Paragraph
, Sort
, Accents
, et HelloWorldInt
.
Contact
Les bugs, les suggestions, ainsi que vos plugins sont les bienvenus à regexsr@fastmail.fm. Merci d'avance pour votre contribution!