Ctags: ctags -R-xの出力からタグ名と種類を解析する方法

作成日 2019年03月12日  ·  8コメント  ·  ソース: universal-ctags/ctags


パーサーの名前:任意の1つ

ctagsの実行に使用したコマンドライン:

$ ctags --options=NONE -R -x

入力ファイルの内容:

$ git clone https://github.com/liuchengxu/vista.vim
$ cd vista.vim
$ ctags --options=NONE -R -x

満足できないタグ出力:

ctags -R -xの出力を解析する方法がわかりません。 ctags -R -xの出力からタグ名とスコープをフィルタリングしたいのですが、正しく行う方法がわかりません。

期待するタグ出力:

ctags -Rの特定の形式もあれば、それは実行可能です。

{tagname}<Tab>{tagfile}<Tab>{tagaddress}[;"<Tab>{tagfield}..]

ctagsのバージョン:

$ ctags --version
Universal Ctags 0.0.0(1208e45), Copyright (C) 2015 Universal Ctags Team
Universal Ctags is derived from Exuberant Ctags.
Exuberant Ctags 5.8, Copyright (C) 1996-2009 Darren Hiebert
  Compiled: Mar 11 2019, 17:01:27
  URL: https://ctags.io/
  Optional compiled features: +wildcards, +regex, +iconv, +option-directory, +xpath, +case-insensitive-filenames, +packcc

ctagsバイナリを取得するにはどうすればよいですか?

macOSではbrew install ctags

全てのコメント8件

私はあなたの質問を理解していません。

ctags -Rの出力に満足していますか? はいの場合、 -xオプションを使用してみませんか?
あなたの質問に答えるために、ユースケースの背景をもっと知りたいです。

私はvimスクリプトを知りません。 ただし、ctagsのvimパーサーであるvim.cを読み取る限り、スコープフィールドには入力されません。 バグだと思われる場合は、vimパーサーがどのような入力のスコープフィールドに入力するかを教えてください。

はっきりさせなくてすみません。

なぜ-xオプションを使用するのですか?

ctags -Rは私のニーズを満たしますが、タグファイルを生成したくないので、 -xオプションを使用します。

私のユースケース。

現在、vista.vimは一部のファイルでのタグの表示のみをサポートしていますが、一部のユーザーはプロジェクト内のすべてのタグを表示したいと考えています(https://github.com/liuchengxu/vista.vim/issues/14)。 ctags -Rのサポートを追加しようとしましたが、これらの出力を正しく抽出する方法がわかりません。

つまり、それぞれvista#util#Trimfunction18autoload/vista/util.vimvista#util#Trim(str)を抽出する方法は?

ctags -R -x

...
vista#util#Trim  function     18 autoload/vista/util.vim function! vista#util#Trim(str)
vista#util#Truncate function     13 autoload/vista/util.vim function! vista#util#Truncate(msg) abort
vista#util#Warning function     90 autoload/vista/util.vim function! vista#util#Warning(msg) abort
vista#viewer#Display function     90 autoload/vista/viewer.vim function! vista#viewer#Display(data) abort
vista#viewer#Render function     86 autoload/vista/viewer.vim function! vista#viewer#Render(data) abort
vista#viewer#prefixes function     94 autoload/vista/viewer.vim function! vista#viewer#prefixes() abort

-o -オプションを使用すると、ctagsは次のように出力をstdoutに出力します。

[yamato@slave]/tmp/vista.vim% u-ctags -R -o - | head 
/   ftplugin/vista.vim  /^nnoremap <buffer> <silent> \/    :<c-u>call vista#finder#fzf#Run()<CR>$/;"    m
<CR>    ftplugin/vista.vim  /^nnoremap <buffer> <silent> <CR> :<c-u>call vista#cursor#FoldOrJump()<CR>$/;"  m
Commands    README.md   /^### Commands$/;"  S
Contributing    README.md   /^## Contributing$/;"   s
Features    README.md   /^## Features$/;"   s
Installation    README.md   /^## Installation$/;"   s
Introduction    README.md   /^## Introduction$/;"   s
License README.md   /^## License$/;"    s
NeoVim  README.md   /^#### NeoVim$/;"   t
Options README.md   /^### Options$/;"   S

--_xformat=オプションを使用して出力をカスタマイズできます。

 u-ctags -R -x --_xformat='TAGNAME:%N @@@ KIND:%K !!! LINE:%n +++ INPUT-FILE:%F === PATTERN:%P' | head
TAGNAME:/ @@@ KIND:map !!! LINE:38 +++ INPUT-FILE:ftplugin/vista.vim === PATTERN:/^nnoremap <buffer> <silent> \/    :<c-u>call vista#finder#fzf#Run()<CR>$/
TAGNAME:<CR> @@@ KIND:map !!! LINE:37 +++ INPUT-FILE:ftplugin/vista.vim === PATTERN:/^nnoremap <buffer> <silent> <CR> :<c-u>call vista#cursor#FoldOrJump()<CR>$/
TAGNAME:Commands @@@ KIND:subsection !!! LINE:101 +++ INPUT-FILE:README.md === PATTERN:/^### Commands$/
TAGNAME:Contributing @@@ KIND:section !!! LINE:164 +++ INPUT-FILE:README.md === PATTERN:/^## Contributing$/
TAGNAME:Features @@@ KIND:section !!! LINE:37 +++ INPUT-FILE:README.md === PATTERN:/^## Features$/
TAGNAME:Installation @@@ KIND:section !!! LINE:69 +++ INPUT-FILE:README.md === PATTERN:/^## Installation$/
TAGNAME:Introduction @@@ KIND:section !!! LINE:25 +++ INPUT-FILE:README.md === PATTERN:/^## Introduction$/
TAGNAME:License @@@ KIND:section !!! LINE:168 +++ INPUT-FILE:README.md === PATTERN:/^## License$/
TAGNAME:NeoVim @@@ KIND:subsubsection !!! LINE:90 +++ INPUT-FILE:README.md === PATTERN:/^#### NeoVim$/
TAGNAME:Options @@@ KIND:subsection !!! LINE:113 +++ INPUT-FILE:README.md === PATTERN:/^### Options$/

http://docs.ctags.io/en/latest/news.html?highlight=--_xformat#customizing-xref-outputを参照してください。

パーサーを作成したくない場合は、 --output-format=jsonを選択できます。

u-ctags -R --output-format=json | head
{"_type": "tag", "name": "/", "path": "ftplugin/vista.vim", "pattern": "/^nnoremap <buffer> <silent> \\/    :<c-u>call vista#finder#fzf#Run()<CR>$/", "kind": "map"}
{"_type": "tag", "name": "<CR>", "path": "ftplugin/vista.vim", "pattern": "/^nnoremap <buffer> <silent> <CR> :<c-u>call vista#cursor#FoldOrJump()<CR>$/", "kind": "map"}
{"_type": "tag", "name": "Commands", "path": "README.md", "pattern": "/^### Commands$/", "kind": "subsection"}
{"_type": "tag", "name": "Contributing", "path": "README.md", "pattern": "/^## Contributing$/", "kind": "section"}
{"_type": "tag", "name": "Features", "path": "README.md", "pattern": "/^## Features$/", "kind": "section"}
{"_type": "tag", "name": "Installation", "path": "README.md", "pattern": "/^## Installation$/", "kind": "section"}
{"_type": "tag", "name": "Introduction", "path": "README.md", "pattern": "/^## Introduction$/", "kind": "section"}
{"_type": "tag", "name": "License", "path": "README.md", "pattern": "/^## License$/", "kind": "section"}
{"_type": "tag", "name": "NeoVim", "path": "README.md", "pattern": "/^#### NeoVim$/", "kind": "subsubsection"}
{"_type": "tag", "name": "Options", "path": "README.md", "pattern": "/^### Options$/", "kind": "subsection"}

ありがとう! brewによってインストールされたctagsは、 brew install ctagsまたはbrew install --HEAD universal-ctags/universal-ctags/universal-ctagsのどちらであっても、デフォルトで--output-format=jsonをサポートしていないため、 --_xformat=オプションを試してみます。

@ KazuakiM 、ctagsをlibjansson.so.4にリンクすることは可能ではありませんか?
u-ctagsにはjson出力モードがあります。 u-ctagsがlibjanssonにリンクされている場合に利用できます。
これをhomebrew-universal-ctagsリポジトリの新しい問題として報告する必要があるかどうか教えてください。

@liuchengxu 、タグファイル、ctagsのネイティブ形式は、readtags.cの関数を使用して解析できます。
readtagsコマンドとpython-ctags3、pythonライブラリはreadtags.cを使用します。

@masatake
こんにちは、homebrew-universal-ctagsはjanssonをサポートしています。

$ brew info universal-ctags
universal-ctags/universal-ctags/universal-ctags: HEAD
Maintained ctags implementation
https://github.com/universal-ctags/ctags
Conflicts with:
  ctags (because this formula installs the same executable as the ctags formula)
/usr/local/Cellar/universal-ctags/HEAD-1b747b3 (325 files, 4.3MB) *
  Built from source on 2019-02-02 at 16:45:17
From: https://github.com/universal-ctags/homebrew-universal-ctags/blob/master/universal-ctags.rb
==> Dependencies
Build: autoconf ✔, automake ✔, pkg-config ✔
Optional: jansson ✔, libyaml ✔
==> Options
--with-jansson
        Build with jansson support
--with-libyaml
        Build with libyaml support
--without-doc
        Compile without man pages
--without-xml
        Compile without libxml2
--HEAD
        Install HEAD version
==> Caveats
Under some circumstances, emacs and ctags can conflict. By default,
emacs provides an executable `ctags` that would conflict with the
executable of the same name that ctags provides. To prevent this,
Homebrew removes the emacs `ctags` and its manpage before linking.
However, if you install emacs with the `--keep-ctags` option, then
the `ctags` emacs provides will not be removed. In that case, you
won't be able to install ctags successfully. It will build but not
link.

@KazuakiM良いキャッチ、私は助けを逃した。 JSONサポートにはオプション--with-janssonが必要です。

$ brew reinstall --with-jansson universal-ctags/universal-ctags/universal-ctags
このページは役に立ちましたか?
0 / 5 - 0 評価