Skip to content

zopefoundation/z3c.recipe.tag

Repository files navigation

z3c.recipe.tag

buildstatus

This recipe generates a TAGS database file that can be used with a number of different editors to quickly look up class and function definitions in your package's source files and egg dependencies.

Before running a tags enabled buildout, you must install the appropriate command line tag generation tools: exuberant-ctags and id-utils. In Ubuntu, you can install these with apt-get:

$ sudo apt-get install exuberant-ctags id-utils

On a Mac, download and install port from http://www.macports.org/ and then install ctags and idutils in this way:

$ sudo port install ctags idutils

Suppose you have an egg called MyApplication. To use this recipe with buildout, you would add the following to the buildout.cfg file:

[tags]
recipe = z3c.recipe.tag
eggs = MyApplication

This produces a script file in the bin/ directory which you can then run like this:

$ ./bin/tags

By default, this script produces three files in the directory from which you ran the script:

  • a ctags file called TAGS for use by emacs,
  • a ctags file called tags for use by vi, and
  • an idutils file called ID for use by id-utils (gid, lid).

You can then use these files in your editor of choice.

Optionally, you can select which files to build. The following is the output of ./bin/tags --help:

usage: build_tags [options]

options:
  -h, --help            show this help message and exit
  -l LANGUAGES, --languages=LANGUAGES
                        ctags comma-separated list of languages. defaults to
                        ``-JavaScript``
  -e, --ctags-emacs     flag to build emacs ctags ``TAGS`` file
  -v, --ctags-vi        flag to build vi ctags ``tags`` file
  -b, --ctags-bbedit    flag to build bbedit ctags ``tags`` file
  -i, --idutils         flag to build idutils ``ID`` file

If you'd like to set command line options by default (e.g. to limit building to ctags-vi by default) you can pass the default option in your buildout.cfg:

[tags]
recipe = z3c.recipe.tag
eggs = MyApplication
default = ['-v']

You can use this with virtualenv too:

my_venv/bin/pip install z3c.recipe.tag
my_venv/bin/build_tags

this will build a tags file for all the packages installed in that virtualenv.

If you are using Paver and already have z3c.recipe.tag installed, then all you have to do is add this line to your pavement.py file:

import z3c.recipe.tag

And then run the z3c.recipe.tag.tags task from the command line:

$ paver z3c.recipe.tag.tags

For additional information on using tags tables with different editors see the following websites:

For more information on ctags, visit http://ctags.sourceforge.net/

(BBEdit is a Macintosh text editor.)

For more information about GNU id-utils (basically a local text indexing/search engine; think of it as a very fast version of grep -w), see the id-utils manual.

About

Generate ctags from eggs for development.

Resources

License

Security policy

Stars

Watchers

Forks

Packages

No packages published

Languages