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 (
.gitignoresupport ) - Call
ctagscommand in parallel for acceleration- Up to x5 faster than universal-ctags
Install
Download binary
Download from release page, and extract to the directory in PATH.
Arch Linux
You can install from AUR.
If you use yay, you can install like below:
yay -S ptags // latest tagged version
yay -S ptags-git // current master of git repo
Cargo
You can install by cargo.
cargo install ptags
Requirement
ptags uses ctags and git command internally. The tested version is below.
| Command | Version |
|---|---|
ctags |
Universal Ctags 0.0.0(f9e6e3c1) / Exuberant Ctags 5.8 |
git |
git version 2.14.2 |
git-lfs |
git-lfs/2.3.3 |
Usage
ptags 0.1.12-pre
[email protected]
A parallel universal-ctags wrapper for git repository
USAGE:
ptags [FLAGS] [OPTIONS] [--] [DIR]
FLAGS:
--config Generate configuration sample file
--exclude-lfs Exclude git-lfs tracked files
-h, --help Prints help information
--include-ignored Include ignored files
--include-submodule Include submodule files
--include-untracked Include untracked files
-s, --stat Show statistics
--unsorted Disable tags sort
--validate-utf8 Validate UTF8 sequence of tag file
-V, --version Prints version information
-v, --verbose Verbose mode
OPTIONS:
--bin-ctags <bin_ctags> Path to ctags binary [default: ctags]
--bin-git <bin_git> Path to git binary [default: git]
--completion <completion> Generate shell completion file [possible values: bash, fish,
zsh, powershell]
-e, --exclude <exclude>... Glob pattern of exclude file ( ex. --exclude '*.rs' )
-c, --opt-ctags <opt_ctags>... Options passed to ctags
-g, --opt-git <opt_git>... Options passed to git
--opt-git-lfs <opt_git_lfs>... Options passed to git-lfs
-f, --file <output> Output filename ( filename '-' means output to stdout ) [default: tags]
-t, --thread <thread> Number of threads [default: 8]
ARGS:
<DIR> Search directory [default: .]
You can pass options to ctags by-c/--ctags_opt option like below.
ptags -c --links=no -c --languages=Rust
Searched file types per options are below. --include-submodule and --include_untracked are exclusive. This is the restriction of git ls-files. Any include/exclude options without the above combination can be used simultaneously.
| File type | Default | --exclude-lfs | --include-ignored | --include-submodule | --include-untracked |
|---|---|---|---|---|---|
| tracked | o | o | o | o | o |
| untracked | x | x | x | x | o |
| ignored | x | x | o | x | x |
| lfs tracked | o | x | o | o | o |
| in submodules | x | x | x | o | x |
You can override any default option by ~/.ptags.toml like below. The complete example of ~/.ptags.toml can be generated by --config option.
thread = 16
bin_ctags = "ctags2"
bin_git = "git2"
Benchmark
Environment
- CPU: Ryzen Threadripper 1950X
- MEM: 128GB
- OS : CentOS 7.4.1708
Data
| Name | Repository | Revision | Files | Size[GB] |
|---|---|---|---|---|
| source0 | https://github.com/neovim/neovim | f5b0f5e17 | 2370 | 0.1 |
| source1 | https://github.com/llvm-mirror/llvm | ddf9edb4020 | 29670 | 1.2 |
| source2 | https://github.com/torvalds/linux | 071e31e254e0 | 52998 | 2.2 |
| source3 | https://github.com/chromium/chromium | d79c68510b7e | 293205 | 13 |
Result
ptags is up to x5 faster than universal-ctags.
| Command | Version | source0 | source1 | source2 | source3 |
|---|---|---|---|---|---|
ctags -R |
Universal Ctags 0.0.0(f9e6e3c1) | 0.41s ( x1 ) | 3.42s ( x1 ) | 23.64s ( x1 ) | 32.23 ( x1 ) |
ptags -t 16 |
ptags 0.1.4 | 0.13s ( x3.15 ) | 0.58s ( x5.90 ) | 4.24s ( x5.58 ) | 7.27s ( x4.43 ) |
776 Dec 30, 2022
551 Jan 4, 2023
12 Jun 10, 2021
3.6k Jan 7, 2023
29 Dec 3, 2022
123 Dec 7, 2022
13 Apr 7, 2023
294 Dec 23, 2022
5 Sep 26, 2022
367 Dec 21, 2022
13 Sep 13, 2022
18 Nov 16, 2022
4 Aug 14, 2022
5k Jan 9, 2023
32 Dec 30, 2022
1 Jan 28, 2022
14 Aug 16, 2022
2 Jun 7, 2022
3 Aug 9, 2022
204 Jan 6, 2023