Parce que j’en avais ma claque de chercher le texte des licences à ajouter en en-tête de mes sources¹, voici un bundle TextMate pour palier à cette répétitive perte de temps.

Table des matières

1. Installation
2. Utilisation du bundle
3. Personnaliser le sélecteur des licences
4. Corriger le formatage de la licence
5. Licences supportées
6. Développement

Installation

Depuis les sources, avec Git

cd ~/Library/Application\ Support/TextMate/Bundles
git clone git://github.com/piouPiouM/license-helper.tmbundle.git "License Helper.tmbundle"
osascript -e 'tell app "TextMate" to reload bundles'

Depuis les sources, sans Git

cd ~/Library/Application\ Support/TextMate/Bundles
wget http://github.com/piouPiouM/license-helper.tmbundle/tarball/master
tar zxf license-helper.tmbundle.tar.gz
rm license-helper.tmbundle.tar.gz
mv license-helper.tmbundle "License Helper.tmbundle"
osascript -e 'tell app "TextMate" to reload bundles'

Téléchargement direct

Après récupération, décompressez l’archive, renommez le dossier en License Helper.tmbundle. Acceptez le changement d’extension. Il ne reste plus qu’à installer le bundle d’un double-clic sur le fichier.

Utilisation du bundle

Utilisez le lanceur license⇥ pour sélectionner une licence via la boîte de dialogue qui s’affiche.

Choix d’une licence – License Helper Textmate Bundle

Un bloc de licence est inséré en tant que Snippet. Utilisez la touche de tabulation pour vous déplacez sur les différents placeholders.

Liste des variables d’environnement utilisées

Déclarez dans votre projet les variables d’environnement qui suivent pour auto-compléter les blocs de licence à insérer :

• TM_PROJECT_YEAR. L’année de production. Par défaut : l’année courante.
• TM_PROJECT_COPYRIGHT_HOLDERS ou TM_AUTHOR ou TM_ORGANIZATION_NAME. Les détenteurs du copyright.
• TM_ORGANIZATION_EMAIL. Adresse mail de l’organisation détentrice du copyright.
• TM_PROJECT_DESCRIPTION. Description brève du projet.

Notez que les variables sont utilisées en fonction de la licence choisie et qu’il n’est pas nécessaire de toutes les renseigner si vous n’en avez pas l’usage.

Vous pouvez fixer la licence de votre projet en ajoutant la variable d’environnement de projet TM_PROJECT_LICENSE. Ainsi, vous n’aurez plus à la sélectionner.

Personnaliser le sélecteur des licences

La commande accessible depuis le menu License Helper → Edit licenses order lance l’édition du fichier de configuration du bundle.
Modifiez l’ordre des licences déclarées selon vos préférences d’apparition dans le sélecteur de licences.

Corriger le formatage de la licence

Il est possible qu’avec certains langages, le rendu des blocs de licences ne corresponde pas à vos attentes. Si tel est le cas, définissez votre propre format :

1. Bundles → Bundle Editor
2. Dans l’entrée License Helper, créez une nouvelle Preference et donnez-lui le nom du langage.
3. Remplissez le champ Scope Selector avec le scope approprié – i.e. source.java pour les sources java.
4. Définissez les shellVariables TM_LICENSE_HELPER_HEADER (début du bloc de commentaire) et TM_LICENSE_HELPER_FOOTER (fin du bloc de commentaire), comme suit :

{  shellVariables = (
        {   name = 'TM_LICENSE_HELPER_HEADER';
            value = '/*';
        },
        {   name = 'TM_LICENSE_HELPER_FOOTER';
            value = '*/';
        },
    );
}

Note : chacune des lignes de la licence peut être préfixée de la variable TM_LICENSE_HELPER_LINE.

Licences supportées

La liste des licences prises en charge par le plugin n’est pas figée. N’hésitez pas à me soumettre celles qui vous font défaut.

• Affero GNU Public License 3.0
• Apache license 2.0
• CeCILL license
• Do What The Fuck You Want To Public License
• GNU General Public License version 2
• GNU General Public License version 3
• GNU Lesser General Public License version 3
• MIT license
• New and Simplified BSD licenses
• Original BSD license
• PostgreSQL license

Développement

Distribué sous license MIT, le code source du bundle est accessible sur GitHub.

Une suggestion, une amélioration, une critique ou un bug à me soumettre ? Ça se passe du côté du bugtracker associé.

Continuez votre lecture sur des sujets similaires

• TextMate : commande « Export words »
• TextMate : convertir une couleur hexadécimale en notation RGBA
• JavaScript : optimiser le calcul de l’intersection de tableaux de grandes tailles
• Une console JSLint pour aider vos validations JavaScript
• PHP : convertir un DATETIME en un timestamp UNIX

À l’intérieur du code source d’une classe PHP, je souhaite stocker dans un tableau la liste des mots de la version populaire de l’incontournable texte Lorem ipsum. Jusque là rien de bien sorcier. Mais pour des raisons de lisibilité et de conventions de codage je veux obtenir des lignes formées par un maximum de 72 caractères.

Certes je peux m’amuser à le faire à la main, mais pourquoi me fatiguer quand un langage de script tel que PHP me tend la main pour automatiser la procédure ? Et, cerise sur le gâteau, si en plus je peux l’intégrer à mon éditeur préféré, TextMate.

Exemple d’action de la commande TextMate Export words

Intégration dans Textmate

1. Allez dans le menu Bundles > Bundle Editor > Show Bundle Editor puis créez une nouvelle commande à l’aide de l’action New Command.
2. Donnez à la commande le nom Export words.
3. Veillez à ce que Save soit défini à Nothing.
4. Sélectionnez pour Input les options Selected Text or Nothing.
5. Placez Output à Replace Selected Text.
6. Choisissez une Activation de type Key Equivalent et définnez un raccourci. J’ai opté pour la séquence ⌥⇧W.
7. Laissez vide le champ Scope Selector afin de pouvoir jouir de la commande depuis n’importe quel type de fichier et scope.
8. Enfin, copiez-collez le code ci-dessous dans le champ Command(s).

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105

#!/usr/bin/env php -n
<?php
/**
 * Export a wrapped representation of the words of a text.
 *
 * Optional parameters in a line that follows the text:
 *      l<size>. The column width. Default: 72.
 *      s<characters>. Characters to remove. Default: punctuation.
 *      o<asc|desc>. Sort order. Default: none.
 */
/*
# ***** BEGIN LICENSE BLOCK *****
#
# Copyright (C) 2010 Mehdi Kabab <http://pioupioum.fr/>
#
# Permission is hereby granted, free of charge, to any person
# obtaining a copy of this software and associated documentation
# files (the "Software"), to deal in the Software without
# restriction, including without limitation the rights to use,
# copy, modify, merge, publish, distribute, sublicense, and/or sell
# copies of the Software, and to permit persons to whom the
# Software is furnished to do so, subject to the following
# conditions:
#
# The above copyright notice and this permission notice shall be
# included in all copies or substantial portions of the Software.
#
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
# OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
# HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
# WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
# OTHER DEALINGS IN THE SOFTWARE.
#
# ***** END LICENSE BLOCK ***** */
 
if (version_compare(PHP_VERSION, '5.0.0', '<')) {
    throw new Exception('You must have PHP >= 5.0.0!');
}
 
$lenght = 72;      // the default column width.
$strip  = '\p{P}'; // removes the ponctuation
$sort   = false;   // no sorting
 
$raw = file('php://filter/read=string.tolower/resource=php://stdin',
            FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
if (isset($raw[1])) {
    $args = array_pop($raw);
    if (preg_match('#^(?:\s{0,}(?:l(?<lenght>\d+)|s(?<strip>.*)|o(?<sort>asc|desc))\s{0,})+$#u', trim($args), $matches)) {
        if (isset($matches['lenght']) && $matches['lenght'])
            $lenght = (int) $matches['lenght'];
        if (isset($matches['strip']) && $matches['strip'])
            $strip .= '|' . $matches['strip'];
        if (isset($matches['sort']) && $matches['sort'])
            $sort = $matches['sort'];
    } else {
        array_push($raw, $args);
    }
}
$raw = implode(' ', $raw);
 
// Removes punctuation and user characters
if ($strip) {
    $strip = str_replace('#', '\#', $strip);
    $raw   = preg_replace('#(' . $strip . ')#u', '', $raw);
}
 
// Estimating indent
$start_index = 0;
if (isset($_SERVER['TM_INPUT_START_LINE_INDEX'])) {
    $start_index = $_SERVER['TM_INPUT_START_LINE_INDEX'];
}
if ('YES' === $_SERVER['TM_SOFT_TABS']) {
    $tab = str_repeat(' ', $_SERVER['TM_TAB_SIZE']);
} else {
    $tab = "\t";
}
$tab_count    = floor($start_index / $_SERVER['TM_TAB_SIZE']);
$extra_spaces = $start_index % $_SERVER['TM_TAB_SIZE'];
$tabs         = str_repeat($tab, $tab_count) . str_repeat(' ', $extra_spaces);
$tabs_len     = $tab_count * $_SERVER['TM_TAB_SIZE'] + $extra_spaces;
 
// Extracting words now!
$words = preg_split('#\s+#', $raw);
$words = array_map('trim', $words);
$words = array_filter(array_unique($words)); // removes empty fields
if ($sort) {
    natsort($words);
    if ('desc' === $sort) {
        $words = array_reverse($words);
    }
}
$words = sprintf('%s\'%s\'',
                 $tabs,
                 wordwrap(implode("', '", $words), $lenght - $tabs_len, "\n$tabs"));
if (0 !== $start_index) {
    $words = ltrim($words);
}
 
if ("''" === $words) {
    return;
}
echo $words;

Utilisation de la commande TextMate Export words

Sélectionnez le texte à transformer. La transformation du texte se contrôle en ajoutant à la suite une ligne d’arguments optionnels :

• l<size>. Ajuster la longueur de ligne. Exemple : l80 pour effectuer une coupure à la colonne 80. Défaut : 72.
• s<characters>. Exemple : slorem|ipsum pour exclure les mots lorem et ipsum. Défaut : toute ponctuation.
• o<asc|desc>. Trier la sortie selon les ordres ascendant et descendant. Défaut : aucun tri n’est réalisé.

Notez que si votre sélection est précédée par une indentation, alors le script va appliquer cette dernière à chacune des lignes générées en se conformant aux options courantes de TextMate : il générera des espaces si le mode Soft Tabs est activé. Sinon des tabulations complétées d’éventuels espaces.

Continuez votre lecture sur des sujets similaires

• Bundle License Helper pour TextMate
• TextMate : convertir une couleur hexadécimale en notation RGBA
• PHP : convertir un DATETIME en un timestamp UNIX
• PHP : fonction uncamel() pour inverser une notation en CamelCase
• Photon : guide d’installation sur Mac OS X Snow Leopard

CSS supporte divers formats de description des couleurs, le plus utilisé étant la notation héxadécimale #RRGGBB. L’introduction du support des couleurs RGBA par CSS 3 a été l’occasion pour certains de découvrir les notations rgba(255, 255, 255, 1) et sa version sans gestion de l’opacité rgb(255, 255, 255).

Il faut avouer que si nous disposons d’une palette d’outils d’aide à la saisie de couleurs en notation hexadécimale, il en est rien pour insérer une couleur au format rgb[a], et cela peut agacer. Mais c’était sans compter sur TextMate !

Convertir une couleur héxadécimale en notation RGBA

La commande TextMate Convert Hex to RGB(A) color va vous permettre de convertir via le raccourci clavier ⌘⇧X une couleur héxadécimale en son équivalent RGB(A).

Installation

Après avoir téléchargé le fichier qui suit, installez la commande d’un simple double-clique.

La nouvelle commande est maintenant disponible dans le bundle Source.

Pourquoi l’installer dans le bundle Source au lieu du bundle CSS ? Parce qu’elle peut être utile dans d’autre languages, comme JavaScript et sera ainsi disponible à tout moment, qu’importe le bundle actif.

Usage

Simple d’utilisation, positionnez-vous sur une couleur et activez la commande pour obtenir son équivalent en notation RGB :

#6633ff => rgb(102, 51, 255)
#63F    => rgb(102, 51, 255)

Ajoutez à une couleur héxadécimale la composante d’opacité pour remplacer la couleur par sa forme RGBA :

#6633FF80 => rgba(102, 51, 255, .50)
#63FA     => rgba(102, 51, 255, .67)
#63F0     => rgba(102, 51, 255, 0)

Vous pouvez également sélectionner une couleur (avec le sharp # initial) et lancer la convertion. Cela se révèle être particulièrement utile avec une sélection en colonne.

Code source

Voici le code ruby¹ utilisé au sein de la commande.

Continuez votre lecture sur des sujets similaires

• Du RGBA dans vos animations avec le plugin jQuery Color
• JavaScript : tester le support des couleurs RGBA
• Bundle License Helper pour TextMate
• TextMate : commande « Export words »
• PHP : convertir un DATETIME en un timestamp UNIX

La propriété CSS content qui s’utilise de concert avec les sélecteurs :before ou :after, sert essentiellement pour enrichir¹ le rendu d’un contenu HTML existant. Pratique, ajouter un petit en rythme après le texte « j’aime coder » ne pose aucun problème. Cependant, si nous sommes amenés à insérer des caractères non-ASCII ça se complique.

Chercher la représentation Unicode d’un caractère

La représentation Unicode d’un caractère peut se trouver de plusieurs manières :

• en perdant son temps dans la table des caractères Unicode ;
• en s’aidant d’une extension Firefox sic ;
• via la palette des caractères de Mac OS X, en survolant le caractère à insérer. Son code Unicode s’affiche alors dans l’infobulle.

Affichage de la représentation Unicode d’un caractère.

Dans notre feuille de styles, nous insérons le nombre héxadécimal récupéré préfixé du caractère d’échappement \, sans oublier de supprimer toute pollution comme 0x0. Nous obtiendrons ainsi :

• ♫ : \266b
• ⌘ : \2318

Ce qui se traduit dans une CSS par :

a:after {
  content:"\266b";
}

Nous arrivons à nos fins, mais ne pourrait-on pas accélérer le processus ?

Un coup de TextMate

Rien de plus simple avec TextMate. Téléchargez et décompressez l’archive qui suit². Double-cliquez sur le fichier tmCommand pour l’installer.

La nouvelle commande Convert Selection to Unicode est maintenant disponible dans le bundle CSS et s’active par le raccourci clavier ⌃⇧X sur tout caractère ou texte sélectionné.

Une astuce pour la route

L’espace insécable (entité caractère  ) s’insère au clavier via le raccourci clavier ⌥ + Espace et a pour représentation Unicode \A0.

Ressources

• Blog & Blues : Feuilles de style, jeux et codage de caractères.
• nanoum blog : before et after

Continuez votre lecture sur des sujets similaires

• Compass : supprimer le cache buster des sprites
• Instances multiples de Compass avec Ruby Version Manager (rvm)
• Photon : guide d’installation sur Mac OS X Snow Leopard
• Bundle License Helper pour TextMate
• TextMate : commande « Export words »