---
name: "ctags-universal-lang-iPythonCell"
section: "7"
platform: "linux"
package: "universal-ctags"
version: "5.9.20210829.0-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/ctags-universal-lang-iPythonCell"
---

# ctags-universal-lang-iPythonCell(7)

The man page of the iPythonCell parser for Universal Ctags

## NAME

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

## SYNOPSIS

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

## DESCRIPTION

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\> ).

## 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.

## SEE ALSO

[ctags(1)](/ctags/1.md), [ctags-client-tools(7)](/ctags-client-tools/7.md), [ctags-lang-python(7)](/ctags-lang-python/7.md)