orient下載 - orient原始碼下載

orient

其他源碼

v0.3.1

下載

東方

簡體中文

跨平台檔案系統索引器和搜尋器，結合了find 、 locate和Everything的優點以及檔案內容搜尋。適用於 Linux、macOS 和 Windows。

在您閱讀之前

倒排索引是plocate背後的技術，它使搜尋在接近恆定的時間內完成，在v0.4.0及更高版本中實現。不幸的是v0.4沒有經過充分測試，目前發布的是v0.3.x 。此外，自述文件中的所有演示都是在v0.3.0上完成的。對於檔案通常小於 3M 的個人電腦來說，倒排索引並沒有太大的差異。

內容搜尋未編入索引。如果此儲存庫達到 512 顆星，則將建立索引檔案內容索引，因此，如果該應用程式證明對您有用或您發現它有趣，請粉碎該星形按鈕！
（更多相關資訊請點擊此處。）

本自述文件是關於 CLI 應用程式的。對於 GUI 前端，請參閱 SearchEverywhere。（也很不穩定）

該專案自 2022 年 8 月開始工作，但由於存在無數 bug，直到 2023 年 4 月才發布。不過，即使在穩定版本（ v0.3.x ）上，目前仍可能存在無數錯誤。

獨特的特點

極輕

唯一的運行時相依性是 PCRE2，完全靜態的可執行檔大小僅為 2.5MiB（已刪除）。

Linux、macOS 和Windows

macOS 和 Windows 上第一個 Libre 檔案索引器！

忽略技巧find macOS Firmlink /System/Volumes/Data
在 Windows 上使用本機 UTF-16，只需對程式碼進行最少的修改（透過範本），即可實現效能和簡單性
處理 Windows 磁碟機就好像它們是 Unix 目錄一樣（當然，'' 是分隔符號）

分別在 macOS 和 Windows 上的螢幕截圖：
奧裡麥克
奧裡溫

非根、多執行緒`updatedb` （僅限SSD）

與locate不同，重建檔案系統索引不需要root權限（或Windows上的管理員權限）。也沒有setugid。
對於SSD來說，為並發目錄讀取設定了執行緒池，大大加快了讀取速度。
對於 HDD，應停用此功能，因為多執行緒 IO 由於其旋轉特性而不會帶來明顯的效能提升。
是否應啟用多執行緒updatedb可以按路徑切換。

從圖中可以看出，在cache drop的情況下， orient可以在1秒內掃描810000個文件，但使用的磁碟是相當高階的磁碟。不過，請持保留態度。
更新資料庫

快速模糊和內容匹配

與updatedb一樣，相同的執行緒池也用於內容匹配。當快取被丟棄時，從 75000 個檔案的 Linux 核心原始碼樹中模糊匹配hello world需要 5.5 秒，而當快取被丟棄時，則需要 1.5 秒。

（保留態度；16x Intel i7 11800H 和 NVMe SSD）

在 Windows 上，內容匹配速度明顯較慢，這是 UTF8 到 UTF16 轉換、缺乏有效的內核記憶體映射 ( mmap(2) ) 以及 Windows 臃腫、低效本質的綜合影響。

~~再見， find ... | xargs grep ...並find ... -a -exec grep ...~~

類似`find`的語法

如下所示， orient還實現了find的大部分匹配功能，使用戶能夠輕鬆熟悉find現有使用經驗，同時也增加了應用程式的多功能性。

匹配父目錄或子文件

與僅將父級匹配硬編碼為字串匹配的Everything不同，在orient中， -updir -downdir可以應用於任何謂詞。

此外， -downdir開銷幾乎為 0，而-updir透過快取最近的匹配項使搜尋速度更快。
匹配父級：
上目錄
配對的孩子：
下目錄

比較

	Linux	視窗	macOS	安卓	執照
`Everything`	？	？	？	？	所有權
`find`	？	？	？	？	GPLv3
`fsearch`	？	？	？	？	GPLv2
`locate`	？	？	？	？	GPLv3
`orient`	？	？	？	？	GPLv3

續表

	`-and -or`	倒排索引	配對家長	圖形使用者介面	命令列介面
`Everything`	？	？	部分的	？	？
`find`	？	？	？	？	？
`fsearch`	？	？	部分的	？	？
`locate`	？	？	？	？	？
`orient`	？	？	？	？	？

筆記：

部分匹配父級和子級意味著雖然它們確實提供了匹配文件父級或目錄子級的選項，但此類搜索僅限於字串匹配，而不是應用程式的所有功能。
Everything CLI 似乎所有結果都經過美化，使其很難與其他工具結合使用，因此？臉。
eVeRyThInG專有的，僅提供 SDK！我們親愛的領袖理查德·斯托曼將會用核武摧毀它！
更糟的是， Everything SDK充滿了全域狀態。

快速入門

使用類似`find`的語法

熟悉find的使用者可以立即使用orient的find相容謂詞，例如-regex 、 -lname 、 -okdir等。
請注意， orient謂詞有時是其find項的超集，例如-quit可選擇接受整數參數，這意味著在退出之前可以產生多少個結果。它的預設值為 1，因此當使用不帶參數的-quit時，它與find中的沒有區別。

對於特定於orient謂詞，僅提供orient樣式語法，請參閱下文。

 # mp3 or mp4 file excluding under hidden dirs
find ~ ( -name " .* " -a -prune -a -false ) -o -name " *.mp[34] "
orient ~ ( -name " .* " -a -prune -a -false ) -o -name " *.mp[34] "

# Ask user to whether to show its realpath when a symlink found in /usr
# until user inputs "yes" (realpath executes)
find /usr -type l -a -okdir realpath {} ; -a -quit
orient /usr -type l -a -okdir realpath {} ; -a -quit
# Until 2 user inputs "yes"
orient /usr -type l -a -okdir realpath {} ; -a -quit 2
# Even better, -quitmod
orient /usr -quitmod ( -type l -a -okdir realpath {} ; )
# -quit -quitmod has some quirks; see docs/predicates.md

使用`orient`的替代語法

orient沒有像find那麼多（唯一）謂詞。相反， orient使用-PRED --ARG語法，為單一謂詞提供多個匹配方案，從而提高程式碼的可重用性。

路徑比對謂詞： -name -bregex -strstr -fuzz
參數： --ignore-case （除了-fuzz ） --full --readlink
內容符合謂詞： -content-{strstr,fuzz,regex}
參數： --ignore-case （fuzz 除外） --blocked --allow-binary
檔案統計謂詞： -size -{a,m,c}{time,min} -inum
參數：檔名或前綴為+或-整數
還有更多...

許多find相容謂詞其實是別名，例如
-lname與-name --readlink相同
-regex - -bregex --ignore-case （ b代表基本名稱）
-samefile基本上是-inode因為-inode也接受檔名

也可以將兩種文法混合在一起，但不建議
像-iname --full或-anewer +5

以下是一些簡單的例子。請在此處查看有關如何使用它們的更多資訊。

 # Find C source files containing "hello"; orient style only
orient / -content-strstr hello -name " *.c "

# Many `find` style predicates are actually aliases, ex:
orient / -iname " *.cpp " # find style
orient / -name --ignore-case " *.cpp " # orient style

# Assuming /home/a/b links to /var/tmp, then
# all the following 3 lines matches /home/a/b
# `-lname` is identical to `-name --readlink`  
orient / -lname " *tmp "
orient / -name --readlink " *tmp "
# `orient` style is more versatile:
orient / -bregex --readlink ' tmp$ ' # No `find` style alternative

修飾符

透過引入修飾謂詞，可以在傳播到其他 pred 之前“做某事”，這正是-updir和-downdir的作用：它們匹配文件的父級和目錄的子級。
使用修飾符， -updir -downdir可以應用於orient中的任何謂詞，這與硬編碼父級匹配僅與字串匹配的Everything不同。
任何謂詞都包括-updir -downdir本身的遞歸使用。

此外， -downdir開銷幾乎為 0，而-updir透過快取最近的匹配項使搜尋速度更快。

更多修飾符包括-prunemod 、 -quitmod和-not 。前任：

 # Find bin/gcc*
orient / -updir -name " gcc* " -a -executable
# Find bin/gcc* or bin/clang*
orient / -updir ( -name " gcc* " -o -name " clang* " ) -a -executable

# Find git repositories, first level only
orient / -downdir ( -name .git -a -type d ) -a -prune
# Must use -exec test on find and is extremely slow
find .. -type d -a -exec test -d ' {}/.git ' ; -a -print -a -prune

# .cc files under src directory of a git repository
orient / -updir ( -name src -a -updir -downdir -name .git ) -name " *.cc "

安裝

由於該應用程式是 CLI，因此只需獲取系統的可執行檔即可運行。

在 Linux 上， -user -nouser -group -nogroup需要 glibc 才能運作。

不幸的是，由於我沒有這樣的機器，所以缺少 macOS ARM 版本？請隨意報告它是否適用於問題或討論。

目前這個應用程式測試太少，無法發佈到發行版。
順便說一句，可能會首先發佈到 Arch AUR。

從原始碼構建

建議在發布的早期階段從原始碼建置。試一試吧！（ v0.4.0必需）
或者更好的是，同時建構orient和 SearchEverywhere。透過建構SearchEverywhere ， orient也隨之建構起來。建構依賴關係：

CMake
PCRE2
快速模糊
GoogleTest（僅測試）

除了CMake之外，所有依賴項都可以由 CMake 自動下載。
如果您已經透過切換下面的這些設定選項將其中一些安裝到您的系統上，那麼也可以使用已安裝的選項。

配置選項：

ORIE_TEST ：建立 GoogleTest 測試套件
ORIE_SYSTEM_PCRE2 ：使用系統 PCRE2 函式庫而不是編譯新的函式庫。
ORIE_LINK_STATIC ：靜態連結定向可執行文件
ORIE_SYSTEM_RAPIDFUZZ ：使用系統rapidfuzz函式庫（僅限標頭）

將下面的OPTION替換為您啟用的選項，然後執行以下命令：

git clone https://github.com/cxxsucks/orient.git
cd orient ; mkdir build ; cd build
cmake -DOPTION1=ON -DOPTION2=ON -DCMAKE_BUILD_TYPE=Release ..
make -j $( nproc )
sudo make install

注意事項

預設多執行緒讀取

預設配置產生對一些起始點進行硬編碼，並在所有起始點上啟用多執行緒讀取，這對於旋轉硬碟來說不是最佳選擇。
如果您碰巧使用 HDD，請在第一次執行orient時執行以下操作：

運行orient -updatedb
使用Ctrl-C立即中斷
開啟~/.config/orie/default.txt或%APPDATA%.oriedefault.txt
檢查ROOT之後的路徑，如果這些路徑中的任何一個實際上不在 SSD 上，則刪除SSD欄位。
如果未列出任何 HDD 根路徑，請寫入ROOT "/path/to/mountpoint"或乾脆不使用IGNORED "/path/to/mountpoint"對其進行索引。

在 Linux 上， /sys/block/sda/queue/rotational提供了有關磁碟是否可旋轉的信息，不幸的是（但在意料之中）macOS 和 Windows 沒有這一功能。
在未來的版本中，將從/etc/mtab和/sys/.../rotational取得根點，它們會在 Linux 和 macOS 上自動配置根路徑。