z3c.recipe.tag

z3c.recipe.tag är en Python recept som genererar en MÄRKER databasfil som kan användas med ett antal olika redaktörer att snabbt slå upp klass- och funktionsdefinitioner i ditt pakets källkodsfiler och äggprodukter beroenden.
Beroenden
Innan du kör en taggar aktiverat utbyggnad, måste du installera lämpliga kommandoraden tag generation verktyg: exuberant-ctags och id-utils. I Ubuntu kan du installera dessa med apt-get:
& Nbsp; sudo apt-get install sprudlande-ctags id-utils
På en Mac hämta och installera hamn från http://www.macports.org/ och sedan installera ctags och idutils på detta sätt:
& Nbsp; sudo port installera ctags idutils
Hur du använder detta recept
Med buildout
Anta att du har ett ägg som heter MyApplication. För att använda detta recept med utbyggnad, skulle du lägga till följande till buildout.cfg filen:
[taggar]
Receptet = z3c.recipe.tag: taggar
ägg = MyApplication
Detta ger ett skript fil i bin / katalogen som du sedan kan köra så här:
& nbsp; ./ bin / taggar
Som standard skapar skriptet tre filer i katalogen som du körde skriptet:
- En ctags fil som heter taggar för användning av emacs,
- En ctags fil som heter taggar för användning med vi, och
- En idutils fil kallad ID för användning av endera.
Du kan sedan använda dessa filen i din redaktör för val.
Alternativt kan du välja vilka filer som ska bygga. Följande är utsignalen från ./bin/tags --help:
användnings: build_tags [alternativ]
Alternativ:
& Nbsp; -h, --help visa denna hjälpmeddelande och avsluta
& Nbsp; -l SPRÅK, --languages ​​= SPRÅK
& nbsp; ctags kommaseparerad lista med språk. standard
& Nbsp; `` -JavaScript``
& Nbsp; -e, --ctags-emacs flagga för att bygga emacs ctags `` TAGS`` fil
& Nbsp; -v, --ctags-vi flagga för att bygga vi ctags `` tags`` fil
& Nbsp; -b, --ctags-BBEdit flaggan att bygga BBEdit ctags `` tags`` fil
& Nbsp; -i, --idutils flagga för att bygga idutils `` ID`` fil
Med Maskin
Om du använder Paver och redan har z3c.recipe.tag installerat, så allt du behöver göra är att lägga till denna rad i din pavement.py fil:
import z3c.recipe.tag
Och kör sedan z3c.recipe.tag.tags uppgiften från kommandoraden:
& nbsp; asfaltläggare z3c.recipe.tag.tags
Ytterligare resurser
För ytterligare information om hur du använder taggar bord med olika redaktörer se följande webbplatser:
- Emacs: http://www.gnu.org/software/emacs/manual/html_node/emacs/Tags.html
- Att hoppa till platsen för ett tag, typ Mx hitta-tagg och namnet på taggen. Eller använd M-. att hoppa till taggen matchar token markören för närvarande är på. Första gången du gör detta kommer du att bli tillfrågad om platsen för TAGS filen.
- VIM: http://vimdoc.sourceforge.net/htmldoc/tagsrch.html
- BBEdit: http://pine.barebones.com/manual/BBEdit_9_User_Manual.pdf Kapitel 14, sid 324
För mer information om ctags, besök http://ctags.sourceforge.net/

What är ny i den här versionen:

• Stöd och kräver zc.buildout 2,0.
• Lägg stöds Python-version (3.6, 2.7, 3.2, 3.3) till klassificerare setup.py

Vad är nytt i version 0.6:

• Uppdatera manifest att tillåta paketgenerering fron icke-VCS export. Motverkar den 0,5 & quot; brun väska & quot; frigivning.

Vad är nytt i version 0.4.1:

• Hoppa obefintliga sys.path kataloger för att undvika ctags varningar .

Krav :

• Python