How to exclude multiple directories with Exuberant ctags?

VimCtagsExuberant Ctags

Vim Problem Overview


I have looked and tried to use exuberant ctags with no luck with what I want to do. I am on a Mac trying to work in a project where I want to exclude such directories as .git, node_modules, test, etc. When I try something like ctags -R --exclude=[.git, node_modules, test] I get nothing in return. I really only need to have it run in my core directory. Any ideas on how to accomplish this?

Vim Solutions


Solution 1 - Vim

The --exclude option does not expect a list of files. According to ctags's man page, "This option may be specified as many times as desired." So, it's like this:

ctags -R --exclude=.git --exclude=node_modules --exclude=test

Solution 2 - Vim

Read The Fantastic Manual should always be the first step of any attempt to solve a problem.

From $ man ctags:

--exclude=[pattern]
  Add  pattern to a list of excluded files and directories. This option may
  be specified as many times as desired. For each file name  considered  by
  both the complete path (e.g. some/path/base.ext) and the base name  (e.g.
  base.ext)  of  the  file, thus allowing patterns which match a given file
  name irrespective of its path, or match only a specific path.  If  appro-
  priate  support is available from the runtime library of your C compiler,
  then pattern may contain the usual shell wildcards (not  regular  expres-
  sions)  common  on Unix (be sure to quote the option parameter to protect
  the wildcards from being expanded by the shell  before  being  passed  to
  ctags;  also be aware that wildcards can match the slash character, '/').
  You can determine if shell wildcards are available on  your  platform  by
  examining  the output of the --version option, which will include "+wild-
  cards" in the  compiled  feature  list;  otherwise,  pattern  is  matched
  against file names using a simple textual comparison.

  If  pattern begins with the character '@', then the rest of the string is
  interpreted as a file name from which to read exclusion patterns, one per
  line.  If  pattern  is  empty,  the list of excluded patterns is cleared.
  Note that at program startup, the default exclude list contains "EIFGEN",
  "SCCS",  "RCS", and "CVS", which are names of directories for which it is
  generally not desirable to descend while processing the --recurse option.

From the two first sentences you get:

$ ctags -R --exclude=dir1 --exclude=dir2 --exclude=dir3 .

which may be a bit verbose but that's what aliases and mappings and so on are for. As an alternative, you get this from the second paragraph:

$ ctags -R --exclude[email protected] .

with the following in .ctagsignore:

dir1
dir2
dir3

which works out to excluding those 3 directories without as much typing.

Solution 3 - Vim

You can encapsulate a comma separated list with curly braces to handle multiples with one --exclude option:

ctags -R --exclude={folder1,folder2,folder3}

This appears to only work for folders in the root of where you're issuing the command. Excluding nested folders requires a separate --exclude option.

Solution 4 - Vim

The other answers were straight to the point, and I thought a little example may help:

You should add an asterisk unix-like style to exclude the whole directory.

ctags -R --exclude={.git/*,.env/*,.idea/*} ./

Solution 5 - Vim

> I really only need to have it run in my core directory.

Simply remove the -R (recursion) flag!!!

Attributions

All content for this solution is sourced from the original question on Stackoverflow.

The content on this page is licensed under the Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license.

Content TypeOriginal AuthorOriginal Content on Stackoverflow
Questionpertrai1View Question on Stackoverflow
Solution 1 - VimaalazzView Answer on Stackoverflow
Solution 2 - VimromainlView Answer on Stackoverflow
Solution 3 - VimvoodooGQView Answer on Stackoverflow
Solution 4 - VimYuvalHelmanView Answer on Stackoverflow
Solution 5 - VimS NarumView Answer on Stackoverflow