Manpages - ctags-lang-iPythonCell.7

ctags-lang-iPythonCell - The man page of the iPythonCell parser for Universal Ctags

  ctags ... --extras={subparser} --languages=+iPythonCell,Python \
  [--extras-IPythonCell=+{doubleSharps}] \
  [--regex-IPythonCell=/<PATTERN>/\n/c/] ...

iPythonCell is a subparser stacked on top of the Python parser. It works when:

• The Python parser is enabled,
• the subparser extra is enabled, and
• the iPythonCell parser itself is enabled.

iPythonCell extracts cells explained as in vim-ipython-cell (https://github.com/hanschen/vim-ipython-cell/blob/master/README.md).

The iPythonCell parser defines only a cell kind.

Tagging cells staring with ##… is disabled by default because the pattern is too generic; with that pattern unwanted tags can be extracted.

Enable doubleSharps language specific extra for tagging cells staring with ##….

If your favorite cell pattern is not supported in the parser, you can define the pattern in your .ctagd.d/your.ctags or command lines. Here is an example how to support “# CTAGS: …”:

“input.py”

#+begin_quote

      x=1
      # CTAGS: DEFINE F
      def F():
              # CTAGS: DO NOTING
              pass

#+end_quote

“output.tags” with “–options=NONE –sort=no –extras=+{subparser} –regex-IPythonCell=/[ t]*# CTAGS:[ ]?(.*)$/1/c/ -o - input.py”

#+begin_quote

      x    input.py        /^x=1$/;"       v
      DEFINE F     input.py        /^# CTAGS: DEFINE F$/;" c
      F    input.py        /^def F():$/;"  f
      DO NOTING    input.py        /^      # CTAGS: DO NOTING$/;"  c

#+end_quote

You can put “–regex-IPythonCell=/[ \t]*# CTAGS:[ ]?(.)$/\1/c/*” in your.ctags to avoid specifying the pattern repeatedly.

ctags(1), ctags-client-tools(7), ctags-lang-python(7)