Ctags: Como analisar o tagname e o tipo da saída de ctags -R -x

Criado em 12 mar. 2019 · 8Comentários · Fonte: universal-ctags/ctags

O nome do analisador: qualquer um

A linha de comando que você usou para executar ctags:

$ ctags --options=NONE -R -x

O conteúdo do arquivo de entrada:

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

A saída de tags com a qual você não está satisfeito:

Não tenho ideia de como analisar a saída de ctags -R -x . Eu quero filtrar o tagname e o escopo da saída de ctags -R -x , mas não sei como fazer corretamente.

A saída de tags que você espera:

É viável se houver também um formato específico para ctags -R :

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

A versão do 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

Como você obtém ctags binários:

brew install ctags no macOS

Fonte

liuchengxu

Todos 8 comentários

Eu não entendo sua pergunta.

Você está satisfeito com a saída de ctags -R ? Se sim, por que você não usa a opção -x ?
Gostaria de saber mais sobre o histórico do caso de uso para responder à sua pergunta.

Eu não sei script vim. No entanto, no que diz respeito à leitura do vim.c, o analisador vim de ctags, ele não preenche os campos de escopo. Se você acha que é um bug, diga-nos que o analisador vim preenche o campo de escopo para que tipo de entrada.

masatake em 12 mar. 2019

Desculpe por não deixar claro.

por que usar a opção -x ?

Embora ctags -R atenda minha necessidade, não quero gerar o arquivo de tag, então uso a opção -x .

meu caso de uso.

Atualmente o vista.vim suporta apenas mostrar as tags em algum arquivo, mas alguns usuários gostariam de mostrar todas as tags em um projeto (https://github.com/liuchengxu/vista.vim/issues/14). Tentei adicionar suporte a ctags -R , mas não sei como extrair essas saídas corretamente.

Em uma palavra, como extrair vista#util#Trim , function , 18 , autoload/vista/util.vim , vista#util#Trim(str) respectivamente?

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

liuchengxu em 12 mar. 2019

Com a opção -o - , ctags emite a saída para stdout como:

[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

Você pode personalizar a saída com a opção --_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$/

Consulte http://docs.ctags.io/en/latest/news.html?highlight=--_xformat#customizing -xref-output .

Se você não quiser escrever um analisador, --output-format=json pode ser uma escolha:

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"}

masatake em 12 mar. 2019

Obrigado! Eu tentaria a opção --_xformat= , já que ctags instalado pelo brew não suporta --output-format=json por padrão, seja brew install ctags ou brew install --HEAD universal-ctags/universal-ctags/universal-ctags .

liuchengxu em 12 mar. 2019

@KazuakiM , não é possível vincular ctags a libjansson.so.4?
u-ctags tem modo de saída json. Está disponível se u-ctags estiver vinculado a libjansson.
Diga-me se devo relatar isso como um novo problema no repositório homebrew-universal-ctags.

masatake em 12 mar. 2019

👍1

@liuchengxu , arquivo de tags, o formato nativo de ctags pode ser analisado com funções em readtags.c.
comando readtags e python-ctags3, uma biblioteca python usa readtags.c.

masatake em 12 mar. 2019

@masatake
Oi, homebrew-universal-ctags suporta 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 em 16 mar. 2019

👍1

@KazuakiM Boa pegada, perdi a ajuda. O suporte a JSON precisa da opção --with-jansson .

$ brew reinstall --with-jansson universal-ctags/universal-ctags/universal-ctags

liuchengxu em 16 mar. 2019

😄1

Esta página foi útil?

0 / 5 - 0 avaliações

Questões relacionadas

ctags --version não funciona em macOs

softinio · 6Comentários

rst2man: erro: nenhuma opção: --syntax-highlight

songouyang · 15Comentários

Suporte para a linguagem de expressão Nix (Nix / NixOS)

blueyed · 4Comentários

TeX: patch [aprimoramento] para LaTeX para apresentações de projetor

jagjordi · 9Comentários

Pergunta: Não consigo fazer meu dotfile ctags funcionar

trevordmiller · 9Comentários