ctags-universal-lang-iPythonCell7
The man page of the ipythoncell parser for universal ctags
Usage
ctags --extras
subparser
--languages=+iPythonCell,Python
\
[--extras-IPythonCell=+
doubleSharps]
\
[--regex-IPythonCell=/<PATTERN>/\n/c/] ...
Overview
iPythonCell is a subparser stacked on top of the Python parser. It works when:
- •
-
The Python parser is enabled,
- •
-
the
subparserextra 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> ).
Kind(s)
The iPythonCell parser defines only a cell kind.
Extra(s)
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 ##....
Customizing
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"
x=1
# CTAGS: DEFINE F
def F():
# CTAGS: DO NOTING
pass
"output.tags" with "--options=NONE --sort=no --extras=+{subparser} --regex-IPythonCell=/[ t]*# CTAGS:[ ]?(.*)$/1/c/ -o - input.py"
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
You can put "--regex-IPythonCell=/[ \t]*# CTAGS:[ ]?(.*)$/\1/c/" in your.ctags to avoid specifying the pattern repeatedly.
History
- Debian 13 (Trixie): the text shown here
- Debian 12 (Bookworm)