z3c.recipe.tag

z3c.recipe.tag est une recette de Python qui génère un fichier de base de données de balises qui peut être utilisé avec un certain nombre de différents éditeurs de rechercher rapidement des définitions de fonctions et des classes dans les fichiers source de votre paquet et dépendances d'œufs.
Dépendances
Avant d'exécuter un buildout balises activé, vous devez installer les ligne de commande outils de génération de tag appropriées: exuberant-ctags et id-utils. Dans Ubuntu, vous pouvez installer avec apt-get:
& Nbsp; sudo apt-get install id-utils exubérante-ctags
Sur un Mac, télécharger et installer le port de http://www.macports.org/ puis installer ctags et idutils de cette manière:
& Nbsp; sudo port install ctags idutils
Comment utiliser cette recette
Avec Buildout
Supposons que vous ayez un œuf appelé MyApplication. Pour utiliser cette recette avec buildout, vous ajoutez la ligne suivante dans le fichier de buildout.cfg:
[tags]
recette = z3c.recipe.tag: balises
oeufs = MyApplication
Cela produit un fichier de script dans le répertoire bin / que vous pouvez ensuite exécuter comme ceci:
& nbsp; ./ bin / tags
Par défaut, ce script produit trois fichiers dans le répertoire à partir duquel vous avez exécuté le script:
- Un fichier appelé ctags tags pour l'utilisation par emacs,
- Un fichier appelé ctags étiquettes pour utilisation par vi, et
- Un fichier de idutils appelé ID pour une utilisation soit.
Vous pouvez ensuite utiliser ces fichiers dans votre éditeur de choix.
En option, vous pouvez sélectionner les fichiers à construire. Ce qui suit est la sortie de ./bin/tags --help:
utilisation: build_tags [options]
restaurant:
& Nbsp; -h, --help afficher ce message d'aide et de sortie
& Nbsp; LANGUES -l, --languages ​​= LANGUES
& nbsp; ctags liste des langues séparées par des virgules. par défaut
& Nbsp; `` -JavaScript``
& Nbsp; -e, --ctags-emacs drapeau de construire emacs ctags `` fichier TAGS``
& Nbsp; -v, --ctags-vi drapeau de construire vi ctags `` fichier tags``
& Nbsp; -b, --ctags-bbedit drapeau de construire ctags de BBEdit `` fichier tags``
& Nbsp; -i, --idutils drapeau de construire idutils `` fichier ID``
Avec Pavé
Si vous utilisez Paver et ont déjà z3c.recipe.tag installé, tout ce que vous avez à faire est d'ajouter cette ligne à votre fichier pavement.py:
z3c.recipe.tag d'importation
Et puis exécuter la tâche de z3c.recipe.tag.tags de la ligne de commande:
& nbsp; z3c.recipe.tag.tags de pavés
Ressources supplémentaires
Pour plus d'informations sur l'utilisation de balises tables avec différents éditeurs voient les sites Web suivants:
- Emacs: http://www.gnu.org/software/emacs/manual/html_node/emacs/Tags.html
- Pour passer à l'emplacement d'une étiquette, tapez Mx find-tag et le nom de la balise. Ou utilisez M-. pour passer à l'étiquette correspondant le jeton le curseur est actuellement. La première fois que vous faites cela, vous serez invité pour l'emplacement du fichier de marqueurs.
- VIM: http://vimdoc.sourceforge.net/htmldoc/tagsrch.html
- BBEdit: http://pine.barebones.com/manual/BBEdit_9_User_Manual.pdf chapitre 14, à la page 324
Pour plus d'informations sur ctags, visitez http://ctags.sourceforge.net/

What est nouveau dans cette version:

• Soutien et nécessitent zc.buildout 2.0.
• Ajouter appuyé la version Python (3.6, 2.7, 3.2, 3.3) classificateurs à setup.py

Quoi de neuf dans la version 0.6:

• Mise à jour manifeste pour permettre la génération de package fron non-VCS exportation. Compteurs l'quot 0,5 &; sac brun & quot; de presse.

Ce qui est nouveau dans la version 0.4.1:

• Passer répertoires de sys.path inexistants pour éviter ctags avertissements .

Exigences :

• Python