kite

package module
v0.0.0-...-a91fe3a Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Sep 14, 2024 License: MIT Imports: 1 Imported by: 0

README

Kite

kite - Personal developer tool command application.

app cmds

Git 仓库

主要功能

  • kite g/git git 常用命令操作
  • kite gl gitlab 常用命令操作
  • kite gh github 常用命令操作
  • kite str/text 字符串处理工具: 分析，格式化，提取信息，转换
  • kite json json 处理工具: 格式化，查找，过滤等
  • go, php, java 代码生成，转换等 TODO
  • json, yaml, sql 格式化，查看，转换
  • kite tool jump 记录并快速跳转目录
  • kite sys 系统、环境信息查看
  • kite run 快速运行系统命令
    • kite script 快速运行内置脚本
  • kite fs/file 内容查看, 查找，处理, 渲染等
  • kite http http 服务(echo,fs),快速发送请求等
  • kite brun 批量运行命令 TODO
  • kite doc 文档搜索、查看等 TODO

安装

快速安装
curl https://raw.githubusercontent.com/inhere/kite-go/main/cmd/install.sh | bash

从代理下载安装脚本

curl https://ghproxy.com/https://raw.githubusercontent.com/inhere/kite-go/main/cmd/install.sh | bash -s proxy
从 Releases 下载
wget -c https://github.com/inhere/kite-ge/releases/latest/download/kite-{OS}-{ARCH}.tar.gz
通过GO安装
go install github.com/inhere/kite-go/cmd/kite
初始化
  • 下载完成后,将解压后的可执行文件移动到 PATH 目录下,注意设置执行权限
  • 运行 kite app init 执行初始化. 会生成默认的配置文件等到 ~/.kite-go 目录
$ kite app init

开始使用

kite # 查看全部命令
kite COMMAND # 运行一个命令
kite COMMAND -h # 查看命令帮助信息
kite COMMAND SUBCOMMAND # 运行一个子级命令
配置Shell命令别名

推荐配置常用命令组别名到 ~/.bashrc 或者 ~/.zshrc，这样可以快速使用常用的命令。

## aliases for kite
alias kg="kite git"
alias kgl="kite gitlab"
alias kgh="kite github"
alias kj="kite json"
alias kjson="kite json"
alias kstr="kite text"
alias kdev="kite dev"
alias ktool="kite tool"
alias kjump="kite tool jump"

jump 目录快速跳转

kite tool jump 可以记录历史并快速跳转到指定目录.

启用快速跳转

为 bash 启用快速跳转(add to ~/.bashrc):

# 默认跳转函数为: jump
eval "$(kite tool jump shell bash)"

为 zsh 启用快速跳转(add to ~/.zshrc):

# 默认跳转函数为: jump
eval "$(kite tool jump shell zsh)"
# 设置绑定的跳转函数为: j
eval "$(kite tool jump shell --bind j zsh)"
可能的问题
  • 如果在 zsh 中使用 jump 函数, 提示 command not found: compdef 错误.

解决方法:

autoload -Uz compinit
compinit
  • zsh 提示 zsh compinit: insecure directories, run compaudit for list 错误

解决方法:

找到有问题的目录, 并移除组写权限.

compaudit | xargs chmod g-w
# or 
# 查看有问题的目录,并调整权限
compaudit
chmod g-w /usr/local/share/zsh
# or
# chmod -R 755 /usr/local/share/zsh
快速跳转使用
$ j ~/Workspace/godev/gookit/kite-go # 首次跳转到目录后将会记住
$ j kite go # 快速跳转到 ~/Workspace/godev/gookit/kite-go 目录
$ j kite # 可以双击 TAB 自动补全历史目录路径

Note: 可以使用多个关键字确定目录(如 j kite go ), 但是关键字必须是目录名的一部分.

  • ^ 表示匹配排除目录名 j kite go ^pkg 目录路径包含 kite,go 不包含 pkg 的目录
  • $ 表示必须以目录名结尾 eg: j kite-go$ 只匹配 kite-go 结尾目录
添加命名目录
$ kite jump add wp ~/Workspace
# 添加之后可以使用名称跳转
$ j wp
查看跳转历史
$ kite jump list

Git 命令使用

kite git 提供了一些 git 命令行快速使用命令的封装.

$ kite g # 查看封装的可用的 git 命令

Note: 通过 kite git CMD 运行未知命令会自动转发到系统上的 git 下面执行. 因此, 可以执行任何 git 命令.

Gitlab 命令使用

kite gitlab 提供了一些 gitlab 命令行快速使用命令的封装.

$ kite gl # 查看封装的可用的 gitlab 命令

Note: 通过 kite gl CMD 运行未知命令会自动转发到 kite git 命令组下面执行. 因此, 可以执行任何 git 命令.

配置Gitlab

通常只需要配置下面两个信息即可使用

# gitlab host，不带 http 协议前缀
GITLAB_HOST=gitlab.your.com
# fork 模式下，源仓库的 remote 名称
GITLAB_SRC_REMOTE=main
快速克隆仓库

可用直接使用 group/path 快速克隆仓库, 会自动填充配置的 GITLAB_HOST 进行克隆.

$ kite gl clone group/path
快速提交信息

kite gl ac 快速提交:

$ kite gl ac -m "fix: fix a bug"

kite gl acp 快速提交并推送:

$ kite gl acp -m "fix: fix a bug"
Fork开发模式

通过配置 config/gitx.yml 中的 fork_mode: true 开启 fork 模式.

gitlab:
  fork_mode: true

Note: gitlab 的配置默认会继承 gitx.yml->git 的配置信息.

其他gitlab命令
$ kite gl open # 快速在浏览器打开当前仓库

GitHub 命令使用

GitHub 大部分命令与 git gitlab 组下面的相同. 同样提供了 ac acp clone open 等命令.

Note: 通过 kite gh CMD 运行未知命令会自动转发到 kite git 命令组下面执行.

配置

通常只需要配置下面de信息即可使用

# github
GITHUB_USER=inhere

Note: github 的配置默认会继承 gitx.yml->git 的配置信息.

快速克隆仓库

可用直接使用 group/path 快速克隆仓库, 会自动填充配置的 GITLAB_HOST 进行克隆.

$ kite gl clone group/path

Http 工具使用

启动一个简单的echo服务

启动一个简单的 echo 服务用于快速测试发送请求是否正确响应. 不论请求任何路由,都会返回请求的方法,headers,请求数据等.

$ kite http echo-server
启动一个文件服务

在指定目录快速启动一个文件服务, 用于测试请求服务文件,比如 图片.

# file: public/some.png
# access http://localhost:8090/fs/some.png
$ kite http fs-server --port 8090 -w public
通过模板快速发送请求

通过定义API请求模板和设置请求变量来快速发送请求. 快速实现操作三方工具.

$ kite http tpl-send -d jenkins --api api-build.json5 -e dev --var branch=qa -v group=my -v repoName=user

配置模板信息和目录.

# domain: gitlab, jenkins, feishu
http_tpl:
  domains:
    gitlab:
      config_file: $data/http_tpl/gitlab-domain.json5
    jenkins:
      config_file: $data/http_tpl/jenkins-domain.json5

fs 文件/目录命令组

kite fs 封装了一些对文件或目录的常用操作命令.

查看文件内容

kite fs cat 跟系统的 cat 类似, 但是会针对不同扩展文件提供语法高亮渲染并输出.

$ kite fs cat README.md
渲染模板文件

kite fs render 可以通过输入变量或指定变量文件,快速的将模板内容或文件渲染并输出.

两种引擎模式:

  • simple/replace 快速替换模板变量,简单方便,但是不支持表达式.
  • go/go-tpl 使用 go text/template 渲染模板,功能强大.
# simple example
$ kite fs render -v name=inhere -v age=234 'hi, {{name}}, age is {{ age }}'

# go-tpl example
$ kite fs render --eng go-tpl -v name=inhere -v age=234 'hi, {{.name}}, age is {{ .age }}'

# use variable file and template file
$ kite fs render --var-file /path/to/_variables.yaml @/path/to/my-template.tpl

Kite 信息查看

在 kite app 命令下内置了一些命令,可以查看kite自身的信息.

  • kite app init 初始化kite配置目录和默默配置信息
查看基本信息
$ kite app info

可以方便的查看kite的基本信息

  • kite版本, 编译的go版本
  • 加载的 dotenv 文件
  • 加载的配置文件列表
  • 配置文件目录等
查看内置命令别名

使用kite别名可以快速运行一些常用子命令. kite app alias 可以方便的查看配置的 kite 内置命令别名列表.

Note: 可以直接运行 kite env, 就是因为配置了别名 env: sys env. kite env 等同于在执行 kite sys env

$ kite app alias -l
查看详细配置信息

通过 kite app config 可以查看加载合并后的全部配置信息,也可以按key查看指定的配置信息.

$ kite app config -a

查看指定key:

$ kite app config git
$ kite app config gitlab
查看kite的路径信息

通过 kite app path 命令可以查看获取kite的路径信息, 例如: 配置目录,临时目录,缓存目录等等

$ kite app path -a # 列出所有kite相关的目录信息
$ kite app path base # 获取kite基础目录
$ kite app path config # 获取配置目录
列出自定义路径别名

kite app pathmap 查看用户自定义的快速路径别名列表.

$ kite app pathmap
列出kite所有命令

按层级列出kite所有命令,包含所有子级命令列表. TODO

kite app cmd-map

运行任意命令或脚本

使用 kite run COMMAND 运行任意命令. 它会自动尝试检查 COMMAND 是 否是 alias|script|plugin|system-cmd 中的一个命令. 匹配成功则执行.

$ kite run {script|alias|plugin|system-cmd}

使用并运行脚本

kite 里 script 分两种,一种是配置的 一条或多条命令;一种是脚本文件(如 bash 文件).

查看所有的 scripts 命令:

$ kite run --script -l
# 或者(配置了内置别名 script: run --script)
$ kite script -l

Note: 你可以自定义配置任意的 scripts 命令, 请查看 $config/module/scripts.yml

运行定义脚本
运行脚本文件

sys 系统命令组

kite sys 系统命令组提供了一些常用的系统命令包装,方便查询或操作系统工具.

在子目录或多个目录同时执行命令

batch-run 可以在一个目录的每个子目录或指定的多个目录同时执行命令 TODO

$ kite sys batch-run
读取或写入系统剪切板

kite sys clip 可以方便的通过命令方式读取或写入内容到系统剪切板.

$ kite sys clip -r # read contents
$ kite sys clip -w "some contents" # read contents

Note: 你会发现在 kite 里很多操作 字符串 或者 文件 的命令都支持读取剪切板数据.

搜索查找可执行文件

kite sys find-exe 将会在 PATH 的目录里模糊匹配搜索可执行文件列表.

指定查找可执行文件

kite sys which 跟系统的 whereis which 一样将会在 PATH 的目录里完全匹配查找可执行文件.

查看ENV环境信息

显示全部环境变量信息：

kite sys env
# or
# 因为配置了kite别名 env: sys env, 因此可以直接运行 kite env
kite env

搜索ENV变量信息:

$ kite env -s term

展开ENV变量信息:

Note: --expand 将会把变量值按系统分隔符分割为多行方便查看.

$ kite sys env --expand path

常用工具命令

运行命令时自动设置代理环境

可以配置在运行一些特殊命令时自动设置代理环境,方便使用.

配置示例:

# will set local_proxy before run matched command
proxy_cmd:
  command_ids:
    - 'github:tag:delete'
  group_limits:
    github: [acp, push, pull, update, update-push]

# local proxy hosts
local_proxy:
  # export http_proxy=http://127.0.0.1:1081;export https_proxy=http://127.0.0.1:1081;
  http_proxy: ${PROXY_SERVE}
  https_proxy: ${PROXY_SERVE}

开发

Dev build
KITE_INIT_LOG=debug go run ./cmd/kite
Install to GOBIN
make install
# or
go build -o $GOPAHT/bin/kite ./cmd/kite

Gookit Packages

Refers

Documentation

Index

Constants

This section is empty.

Variables

View Source 
var (
	Version  = "0.1.0"
	Branch   string
	Revision string

	GoVersion string
	BuildDate string

	PublishAt  = "2021-02-14 13:14"
	UpdatedAt  = "2021-02-14 13:14"
	GithubRepo = "https://github.com/inhere/kite-go"
)
View Source

Banner text from http://patorjk.com/software/taag/#p=testall&f=Graffiti&t=Kite font: Doom,Graffiti,Isometric1 - Isometric3, Ogre, Slant

View Source 
var EmbedFs embed.FS

Functions

This section is empty.

Types

This section is empty.

Source Files

View all Source files

Directories

Path Synopsis
cmd
htu
kite
pacgo
internal
app
appconst
apputil
biz/cmdbiz
bootstrap
cli
cli/appcmd
cli/devcmd
cli/devcmd/gencmd
cli/devcmd/gocmd
cli/devcmd/javacmd
cli/devcmd/jsoncmd
cli/devcmd/phpcmd
cli/devcmd/sqlcmd
cli/devcmd/yamlcmd
cli/extcmd
cli/fscmd
cli/gitcmd
cli/gitcmd/ghubcmd
cli/gitcmd/glabcmd
cli/httpcmd
cli/pkgcmd
cli/syscmd
cli/textcmd
cli/toolcmd
cli/toolcmd/convcmd
cli/toolcmd/doccmd
cli/toolcmd/mdcmd
cli/toolcmd/swagcmd
initlog
web
web/controller
web/webapi
web/webhook
pkg
cmdutil
common
gitx
gitx/github
gitx/gitlab
httpserve
httptpl
idetool
kautorw
kiteext
kplugin
kscript
kserve
ktask
lcproxy
lcstorage
openapi3
pacutil
pkgutil
proxysrv
Package proxysrv provides a proxy server for Kite.
 Package proxysrv provides a proxy server for Kite.
quickjump
textconv
textconv/dbmeta
textparse

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.