ptags

A parallel universal-ctags wrapper for git repository

Description

ptags is a universal-ctags wrapper to have the following features.

• Search git tracked files only ( .gitignore support )
• Call ctags command in parallel for acceleration -- About x4 faster than universal-ctags at large repository

Install

Download from release page, and extract to the directory in PATH.

Alternatively you can install by cargo.

cargo install ptags

Requirement

ptags uses ctags and git command internally. The tested version is below.

Usage

ptags 0.1.0
dalance@gmail.com
A parallel ctags wrapper for git repository

USAGE:
    ptags [FLAGS] [OPTIONS] [--] [DIR]

FLAGS:
    -h, --help       Prints help information
    -s, --stat
    -V, --version    Prints version information
    -v, --verbose

OPTIONS:
        --ctags-bin <ctags_bin>        [default: ctags]
    -c, --ctags-opt <ctags_opt>...
        --git-bin <git_bin>            [default: git]
    -g, --git-opt <git_opt>...
    -f, --file <output>                [default: tags]
    -t, --thread <thread>              [default: 8]

ARGS:
    <DIR>     [default: .]

You can pass options to ctags by-c/--ctags_opt option like below.

ptags -c='--exclude=aaa/*' -c='--exclude=bbb/*'

Benchmark

Environment

• CPU: Ryzen Threadripper 1950X
• MEM: 128GB
• OS : CentOS 7.4.1708

Data

• https://github.com/torvalds/linux ( revision:071e31e254e0, 52998files, 2.2GB )

Result

ptags is about x4 faster than universal-ctags.