歡迎來到這個單一倉庫。此儲存庫中的所有資料夾都是單獨的 Rust 專案(板條箱),可能已發佈到 crates.io。這就構成了一個 Rust 工作區。
這是此 monorepo 或 Rust 工作區的變更日誌。這是一個開始熟悉 Rust 工作區中每個專案最近發生的變化的好地方。
目錄:
以下是構成此 Rust 工作區的每個套件的高級概述。
包的範圍從“完整”TUI 到“部分”TUI,以及中間的所有內容。
r3bl_tui
為您提供原始模式「備用螢幕」和「全螢幕」支持,同時完全非同步。 r3bl-cmdr
箱中的「完整 TUI」應用程式edi
就是一個例子。您可以使用以下命令安裝並運行它:
cargo install r3bl-cmdr
edi
r3bl_terminal_async
讓您能夠使用「async readline & stdout」輕鬆建立自己的非同步 shell 程式。
以下是這方面的範例:
r3bl_tuify
讓您能夠透過阻止互動輕鬆建立自己的 CLI 程式。這對於在阻塞主執行緒時獲取使用者輸入以及在主執行緒阻塞時使用原始模式非常有用。一個範例應用程式是r3bl-cmdr
箱中的giti
應用程式。您可以使用以下命令安裝並運行它:
cargo install r3bl-cmdr
giti
還有許多其他底層板條箱用於建造這些頂級板條箱。以下是其中的簡短清單:
r3bl_core
包含許多在其他板條箱中使用的低階實用程式。這包括聲明性巨集、顏色、樣式、unicode 支援等。被移至此crate。這記錄在變更日誌中。
r3bl_test_fixtures
包含許多在其他板條箱中使用的測試裝置。這包括 stdio 的模擬和事件流(由使用者互動產生的輸入事件)等內容。
r3bl_ansi_color
是一個與此工作區中的其他套件有些無關的套件。它提供了一個乾淨的 API,可讓您在終端程式中輕鬆使用 ANSI 顏色。如果您不想使用更複雜的 crate,而只需向終端輸出一些樣式文本,那麼這就是適合您的 crate。
甚至有一個板條箱只包含使用這些底層板條箱建立的面向使用者的應用程式。這是r3bl-cmdr
箱,它為您提供giti
和edi
應用程式(如上所述)。您可以使用以下命令安裝並運行它:
cargo install r3bl-cmdr
要了解我們如何建立這個箱子,請查看以下資源。
您可以使用nushell
腳本來執行此工作區的 CI/CD 管道等(僅限本機操作)。要取得這些列表,您可以查看此 repo run
根目錄中的nushell
腳本。若要了解可以運行的命令,請嘗試執行以下命令:
cargo install nu
nu run
您應該會看到如下所示的輸出:
Usage: run <command> [args]
<command> can be:
all
all-cicd
build
build-full
clean
install-cargo-tools
test
docs
check
check-watch
clippy
clippy-watch
serve-docs
upgrade-deps
rustfmt
help
例如:
nu run all-cicd
指令將執行此工作區的 CI/CD 管道。nu run all
指令來執行 CI/CD 管道等(僅限本機操作)。此工作區中包含的每個套件也可能有自己的nushell
腳本,也名為run
。這是此工作區中使用的約定。您可以在每個 crate 中執行run
腳本來取得特定於該 crate 的命令清單。
隨著這個倉庫的成長、變化和成熟,修剪是必要的。 r3bl-open-core-archive
是不再需要的所有程式碼和工件都移至的位置。
這樣就不會「遺失」任何內容,如果您需要使用某些已刪除的程式碼,您可以在那裡找到它。
另外,如果您想更改此程式碼並自行維護,請告訴我們。