概述

termutils 将您所有喜欢的命令行工具集中在一个地方。

目录

• 功能
• 功能描述
  • cls
  • gst
  • gcl
  • 自定义可调用命令创建（在 shell 中）
  • 自定义可调用命令创建用于 macOS 应用程序（外部和系统）
• 注意

功能

• cls
• gst
• gcl
• 自定义可调用命令创建
• 自定义可调用命令创建用于 macOS 应用程序（外部和系统）

功能描述

cls

Windows 的 cls 命令现在可以在 Linux/MacOS 中使用，而不会破坏 Linux/MacOS 的感觉和氛围。

使用方法

$ cls
last login: 2024-05-27 14:22:40.473684 +05:30
(@_@) XXXXX@XXXX termutils % 

gst

gst 是用 rust 编写的 git status 的简写，具有更好的格式化，主要关注文件。

使用方法

$ gst
on branch: main
Modified\
    Cargo.toml
    README.md

Ignored\
    Cargo.lock, target/

gcl

gcl 是对经典 git clone 命令的升级，是一个克隆存储库的优秀工具。
有关 gcl 的文档可以在 此处 找到。

使用方法

$ gcl help
gcl v1.0
Help Text

syntax: $ gcl [options] username repo <optional-destination-dir> [flags]

  | [Options]
  | help -> show help and exit.
  | version -> show version and exit.

  | [Flags]
  | --priv -> for private repos, add this flag.

自定义可调用命令创建（在 shell 中）

可以使用 termutils 创建自定义可调用命令。相同的代码可以在终端中使用 shell 代码编写。

使用方法 - 帮助

$ term help
termutils v0.1.0
HELP
  | OPTIONS |
      | help or -h     : show this help text and exit
      | license or -l  : show license and exit
      | version or -v  : show version and exit
      | create or -c   : create terminal utilities
          | SUBOPTIONS (for create) |
               | callable or -cal  : create a callable command for any application
                    | SUBOPTIONS (for callable) |
                         | init or -i          : initialise callables

...

使用方法 - 示例

# initialise callables
$ term create callable init
Initialised termutils for /Users/XXXX/.zshrc

$ term create callable
Command name: print hello world
Command nickname: hello world
Command Description (optional, press ENTER/RETURN for default): prints hello world in the terminal
Enter your command body here (shell):
echo "hello, world!"
END
Created command hello_world
 -> /Users/d33pster/.termutils
Restart Terminal!

$ hello_world
hello, world!

使用方法 - 描述

• 步骤 0.

初始化可调用命令（仅一次）。

• 步骤 1.

输入命令名称。

• 步骤 2.

输入昵称或您希望从终端调用的名称。注意：如果有多于两个单词，它们之间将添加 _。

• 步骤 3.

添加可选描述或按 RETURN/ENTER 使用默认描述。

• 步骤 4.

您需要逐行输入命令的 shell 代码，完成后，在新行中输入 END 并按 ENTER/RETURN。

注意：不要添加 function function_name() {}。只需写主体。

• 步骤 5.

完成。重新启动终端以开始使用您的命令。

自定义可调用命令创建用于 macOS 应用程序（外部和系统）

无法直接从终端调用 macOS 应用程序，但可以创建可调用命令，以便可以通过终端打开。

以下是方法

使用方法 - 帮助

$ term help
termutils v0.1.0
HELP
  | OPTIONS |
      | help or -h     : show this help text and exit
      | license or -l  : show license and exit
      | version or -v  : show version and exit
      | create or -c   : create terminal utilities
          | SUBOPTIONS (for create) |
               | callable or -cal  : create a callable command for any application
                    | SUBOPTIONS (for callable) |
                         | init or -i          : initialise callables
                         | application or -app : callable command for an application
                         | system or sys       : to specify if the app is a system app.
                    | SYNTAX |
                         $ term create callable init # need to be run before callables can be created.
                         $ term create callable -app <appname> <nickname> <optional-system-flag>

[COMMANDS]
cls    : clear the screen
gst    : git status
gcl    : git clone

使用方法 - 示例

# first usage only
$ term create callable init
Initialised termutils for /Users/XXXX/.zshrc

# general syntax
term create callable <app-flag> <app-name> <nickname> <sys-flag>
# Here, the app-flag tells the termutils you are creating a callable command for an Application.

# app-name should be same as the one you can see in the /Applications folder.

# nickname arg is optional, if not passed, it will be prompted anyway. This nickname will be the command that you can call in the terminal. NOTE: if more than one word is there `_` will be added in place of a white space.

# finally, if you the Application is a system app like the App Store, you need to add a sys-flag. else no need.


# example
# suppose you need to create a callable command for Google Chrome App.
$ term create callable application "Google Chrome" "chrome"
Created Trigger for GOOGLE CHROME as CHROME
Restart terminal!

# example
# suppose its a system app:
$ term create callable application "App Store" "store" system
Created Trigger for APP STORE as STORE
Restart terminal!

$ chrome
Opening chrome...
done.

$ store
Opening store...
done.

注意

所有长参数都在示例中使用，您可以使用参数的简短版本或它们的组合。

要在自己的Rust项目中创建类似的参数解析，请查看argrust。

欢迎提出建议和贡献，请在此提交问题或在此创建拉取请求。