the_silver_searcher

Pencari Perak

Alat pencarian kode yang mirip dengan ack , dengan fokus pada kecepatan.

Tahukah kamu C? Ingin meningkatkan ag? Saya mengundang Anda untuk berpasangan dengan saya.

Apa hebatnya Ag?

• Ini adalah urutan besarnya lebih cepat dari ack .
• Ini mengabaikan pola file dari .gitignore dan .hgignore Anda.
• Jika ada file di repo sumber yang tidak ingin Anda cari, cukup tambahkan polanya ke file .ignore . (*batuk* *.min.js *batuk*)
• Nama perintahnya 33% lebih pendek dari ack , dan semua kunci ada di baris beranda!

Ag cukup stabil sekarang. Sebagian besar perubahan berupa fitur baru, perbaikan bug kecil, atau peningkatan kinerja. Ini jauh lebih cepat daripada Ack di benchmark saya:

 ack test_blah ~/code/  104.66s user 4.82s system 99% cpu 1:50.03 total

ag test_blah ~/code/  4.67s user 4.58s system 286% cpu 3.227 total

Ack dan Ag menemukan hasil yang sama, namun Ag 34x lebih cepat (3,2 detik vs 110 detik). Direktori ~/code saya sekitar 8GB. Berkat git/hg/ignore, Ag hanya mencari 700MB saja.

Ada juga grafik kinerja di seluruh rilis.

Bagaimana bisa begitu cepat?

• Ag menggunakan Pthreads untuk memanfaatkan beberapa inti CPU dan mencari file secara paralel.
• File-file tersebut mmap() diedit alih-alih dibaca ke dalam buffer.
• Pencarian string literal menggunakan strstr Boyer-Moore.
• Pencarian regex menggunakan kompiler JIT PCRE (jika Ag dibuat dengan PCRE >=8.21).
• Ag memanggil pcre_study() sebelum menjalankan regex yang sama pada setiap file.
• Daripada memanggil fnmatch() pada setiap pola dalam file abaikan Anda, pola non-regex dimuat ke dalam array dan pencarian biner.

Saya telah menulis beberapa postingan blog yang menunjukkan bagaimana saya meningkatkan kinerja. Ini termasuk cara saya menambahkan pthreads, menulis scandir() saya sendiri, membandingkan setiap revisi untuk menemukan regresi kinerja, dan membuat profil dengan gprof dan Valgrind.

Menginstal

macOS

 brew install the_silver_searcher

atau

 port install the_silver_searcher

Linux

• Ubuntu >= 13.10 (Caucy) atau Debian >= 8 (Jessie)

    apt-get install silversearcher-ag
  

• Fedora 21 dan lebih rendah

    yum install the_silver_searcher
  

• Fedora 22+

    dnf install the_silver_searcher
  

• RHEL7+

    yum install epel-release.noarch the_silver_searcher
  

• Gentoo

    emerge -a sys-apps/the_silver_searcher
  

• Lengkungan

    pacman -S the_silver_searcher
  

• perangkat lunak kendur

    sbopkg -i the_silver_searcher
  

• openSUSE

    zypper install the_silver_searcher
  

• CentOS

    yum install the_silver_searcher
  

• NixOS/Nix/Nixpkgs

    nix-env -iA silver-searcher
  

• SUSE Linux Enterprise: Ikuti petunjuk sederhana ini.

BSD

• FreeBSD

    pkg install the_silver_searcher
  

• OpenBSD/NetBSD

    pkg_add the_silver_searcher
  

jendela

• Menang32/64

  Tersedia versi harian tidak resmi.

• sayap

    winget install "The Silver Searcher"
  

  Catatan:

  • Ini menginstal rilis ag.exe yang dioptimalkan untuk Windows.
  • winget dimaksudkan untuk menjadi klien manajer paket default untuk Windows.
    Pada Juni 2020, ini masih dalam versi beta, dan dapat diinstal menggunakan petunjuk di sana.
  • Skrip pengaturan dalam paket winget Ag menginstal ag.exe di direktori pertama yang cocok dengan salah satu kriteria berikut:
    1. Pada contoh ag.exe sebelumnya dari asal yang sama ditemukan di PATH
    2. Dalam direktori yang ditentukan dalam variabel lingkungan bindir_%PROCESSOR_ARCHITECTURE%
    3. Di direktori yang ditentukan dalam variabel lingkungan bindir
    4. Dalam direktori yang ditentukan dalam variabel lingkungan windir

• coklat

    choco install ag
  

• MSYS2

    pacman -S mingw-w64-{i686,x86_64}-ag
  

• Cygwin

  Jalankan setup-*.exe yang relevan, dan pilih "the_silver_searcher" di kategori "Utils".

Membangun dari sumber

Ahli bangunan

1. Instal dependensi (Automake, pkg-config, PCRE, LZMA):

   • macOS:

       brew install automake pkg-config pcre xz
     

     atau

       port install automake pkgconfig pcre xz
     

   • Ubuntu/Debian:

       apt-get install -y automake pkg-config libpcre3-dev zlib1g-dev liblzma-dev
     

   • fedora:

       yum -y install pkgconfig automake gcc zlib-devel pcre-devel xz-devel
     

   • CentOS:

       yum -y groupinstall "Development Tools"
       yum -y install pcre-devel xz-devel zlib-devel
     

   • openSUSE:

       zypper source-install --build-deps-only the_silver_searcher
     

   • Windows: Ini rumit. Lihat halaman wiki ini.

2. Jalankan skrip build (yang hanya menjalankan aclocal, automake, dll):

    ./build.sh
   

   Di Windows (di dalam shell msys/MinGW):

    make -f Makefile.w32
   

3. Lakukan instalasi:

    sudo make install
   

Membangun tarball rilis

Rilis bertanda tangan GPG tersedia di sini.

Membangun tarball rilis memerlukan dependensi yang sama, kecuali untuk automake dan pkg-config. Setelah Anda menginstal dependensi, jalankan saja:

 ./configure
make
make install

Anda mungkin perlu menggunakan sudo atau run as root untuk make install.

Integrasi Editor

Vim

Anda dapat menggunakan Ag dengan ack.vim dengan menambahkan baris berikut ke .vimrc :

 let g:ackprg = 'ag --nogroup --nocolor --column'

atau:

 let g:ackprg = 'ag --vimgrep'

Yang memiliki efek yang sama tetapi akan melaporkan setiap pertandingan yang dipertaruhkan.

Emacs

Anda dapat menggunakan ag.el sebagai front-end Emacs untuk Ag. Lihat juga: helm-ag.

Teman Teks

Pengguna TextMate dapat menggunakan Ag dengan fork saya dari plugin AckMate yang populer, yang memungkinkan Anda menggunakan Ack dan Ag untuk pencarian. Jika Anda sudah memiliki AckMate, Anda hanya ingin mengganti Ack dengan Ag, pindahkan atau hapus "~/Library/Application Support/TextMate/PlugIns/AckMate.tmplugin/Contents/Resources/ackmate_ack" dan jalankan ln -s /usr/local/bin/ag "~/Library/Application Support/TextMate/PlugIns/AckMate.tmplugin/Contents/Resources/ackmate_ack"

Hal lain yang mungkin Anda sukai

• Ack - Lebih baik dari grep. Tanpa Ack, Ag tidak akan ada.
• ack.vim
• Ctags yang bersemangat - Lebih cepat dari Ag, tetapi ia membuat indeks terlebih dahulu. Bagus untuk basis kode yang sangat besar.
• Git-grep - Secepat Ag tetapi hanya bekerja pada repo git.
• fzf - Pencari fuzzy baris perintah
• ripgrep
• Sack - Utilitas yang menggabungkan Ack dan Ag. Ini menghilangkan banyak pengulangan dari mencari dan membuka file yang cocok.