xcmd

Documentation

Overview

运行CMD命令 此处的命令需要在Linux下执行，请注意

Index

• func Audio2times(filepath string) (uint, error)
• func CheckCommand(name ...string) error
• func Exec(name string, arg ...string) (string, error)
• func File2type(path string) (uint8, error)
• func Find(path string, arg ...string) ([]string, error)
• func GetCommand(name string) string
• func GuiOpen(url string) error
• func Image2averageColor(input string) (string, error)
• func Image2mimeType(input string) (string, error)
• func Image2webp(input, output string) error
• func Image2wh(filepath string) (uint, uint, error)
• func Qrcode(input, output string, conf *QrcodeConfig) error
• func QrcodeIdentification(f string) (map[string][]string, error)
• func Quality(input, output string, quality int) error
• func Tar(to string, from []string) (string, error)
• func Thumb(input, output string, size uint) error
• func ThumbResize(input, output string, size uint) error
• func Video2convert(input, output string) error
• func Video2image(input, output string, times uint) error
• func Video2times(filepath string) (uint, error)
• func Video2wh(filepath string) (uint, uint, error)
• type Cmds
  • func GetCommandInfo(name string) Cmds
• type QrcodeConfig
• type SshConfig
  • func SSH(cliConf *SshConfig) *SshConfig
  • func (c *SshConfig) Exec(shell string) (string, error)

Functions

func Audio2times

func Audio2times(filepath string) (uint, error)

根据音频获取音频时长，返回单位：毫秒 内部会调用Video2times命令中的ffmpeg来获取音频时长

filepath	视频地址[绝对路径]

func CheckCommand

func CheckCommand(name ...string) error

检测命令信息

name	待检测命令

func Exec

func Exec(name string, arg ...string) (string, error)

Exec 执行Shell命令并等待结果输出【避免僵尸进程】

如果要使用管道进行输出，则需要使用bash进行嵌套，如：

xgotool.Exec("bash", "-c", "ps aux | grep go")

name	命令参数
arg...	参数列表

func File2type

func File2type(path string) (uint8, error)

获取文件类型

path	文件路径

uint8返回类型确定：
0-未知 1-目录 2-Linux可执行程序 3-Linux下超链接 4-Linux Socket文件 5-Windows 可执行程序
10-JPEG图片文件 11-PNG图片文件 12-WEBP格式图片 13-GIF格式图片 14-BMP位图 15-TIFF格式图片 19-未知格式图片文件
20-ASCII编码的文本文件 21-UTF-8编码的文本文件 29-未知格式文本文件
31-7Z压缩文件 32-ZIP压缩文件 39-未知压缩文件
41-PDF文档 42-Word文档 43-Excel文档 44-PPT文档

func Find

func Find(path string, arg ...string) ([]string, error)

获取指定目录内的文件列表

func GetCommand

func GetCommand(name string) string

获取指定命令的相关信息

name	待获取详情的命令列表

func GuiOpen

func GuiOpen(url string) error

GUI环境下打开连接 此处使用Linux环境下的方式来调用，其他环境使用拆分编译的形式来实现

func Image2averageColor

func Image2averageColor(input string) (string, error)

获取图片的平均颜色【值为16进制的颜色色值（6位长度无前缀#，如：C6BEB2）】

input	输入的图片文件

func Image2mimeType

func Image2mimeType(input string) (string, error)

获取图片的Mime Type值，如：image/webp

input	输入的图片文件

func Image2webp

func Image2webp(input, output string) error

图片格式转换，智能根据后缀推测图片格式

input	输入图片的路径
output	输出图片的路径

func Image2wh

func Image2wh(filepath string) (uint, uint, error)

根据图片文件获取图片宽高，返回单位：px

filepath	图片地址

func Qrcode

func Qrcode(input, output string, conf *QrcodeConfig) error

转换为二维码

input	待转换的字符串
output	二维码文件存储位置（生成的文件为png格式图片，所以建议直接传入图片后缀png）
conf	二维码配置项

func QrcodeIdentification

func QrcodeIdentification(f string) (map[string][]string, error)

二维码识别

f	要识别的文件地址[支持输入图片文件地址]

func Quality

func Quality(input, output string, quality int) error

图像压缩，将图片压缩为指定质量的压缩图，宽高度不定

input	输入图片的路径
output	输出图片的路径
quality	压缩等级，0~100

func Tar

func Tar(to string, from []string) (string, error)

文件压缩（简易压缩，判断环境变量中的7z、tar等命令来进行压缩）

to	目标文件(会自动在后面追加.7z、.tzr.gz等后缀)
from	来源文件

func Thumb

func Thumb(input, output string, size uint) error

生成缩略图，画质较低

input	输入图片的路径
output	输出图片的路径
size	缩略图大小

func ThumbResize

func ThumbResize(input, output string, size uint) error

生成缩略图

和Thumb的区别为此处使用的-resize参数进行生成，效率稍慢，画质较高

func Video2convert

func Video2convert(input, output string) error

视频获取封面图【获取时长为00:00:00秒的图片】

func Video2image

func Video2image(input, output string, times uint) error

视频获取指定时长位置的图片

input	输入视频位置
output	输出图片位置
times	视频时长，单位：毫秒

func Video2times

func Video2times(filepath string) (uint, error)

根据视频获取视频时长，返回单位：毫秒

filepath	视频地址[绝对路径]

func Video2wh

func Video2wh(filepath string) (uint, uint, error)

根据视频获取视频宽高，返回单位：px

filepath	视频地址

Types

type Cmds

type Cmds struct {
	Name  string // 命令名称
	Path  string // 命令地址
	Exist bool   // 是否存在
}

命令结构体【命令不再强制存在】

func GetCommandInfo

func GetCommandInfo(name string) Cmds

获取指定命令的相关信息

name	待获取详情的命令列表

type QrcodeConfig

type QrcodeConfig struct {
	Size       uint   // 二维码大小（多少个像素点）【specify module size in dots (pixels). (default=3)】
	Level      string // 二维码质量【specify error correction level from L (lowest) to H (highest){LMQH}. (default=L)】
	Border     uint   // 外边距大小（多少个像素点）【specify the width of the margins. (default=2))】
	Background string // 背景色格式为RRGGBB[AA]，默认：FFFFFF
	Foreground string // 前景色格式为RRGGBB[AA]，默认：000000
	Replace    bool   // 若存在输出文件则直接覆盖？【默认false，返回错误信息】
}

二维码生成的配置信息

type SshConfig

type SshConfig struct {
	Host     string //ip
	Port     int    // 端口
	Username string //用户名
	Password string //密码
	IsPK     bool   // 是否是证书【如果是证书的话，password项填写证书位置】
	Error    error  // 错误信息
	// contains filtered or unexported fields
}

连接的配置

func SSH

func SSH(cliConf *SshConfig) *SshConfig

创建连接

func (*SshConfig) Exec

func (c *SshConfig) Exec(shell string) (string, error)

运行Shell并获取输出内容

shell	待运行的命令