cmdopt

README

cmdopt

cmdopt 命令行选项的增强，可以轻松处理子命令。高度重用 flag 包。

opt := cmdopt.New(...)

// 子命令 build，为一个 flag.FlagSet 实例
build := opt.New("build", func(output io.Writer)error{
    output.Write([]byte("build"))
})

// 子命令 install
install := opt.New("install", func(output io.Writer)error{
    output.Write([]byte("install"))
})

文档

版权

本项目采用 MIT 开源授权许可证，完整的授权说明可在 LICENSE 文件中找到。

Documentation

Overview

Package cmdopt 用于创子命令功能的命令行。

Index

• type CmdOpt
  • func New(output io.Writer, errHandling flag.ErrorHandling, usage DoFunc, ...) *CmdOpt
  • func (opt *CmdOpt) Commands() []string
  • func (opt *CmdOpt) Exec(args []string) error
  • func (opt *CmdOpt) Help(name string, usage DoFunc)
  • func (opt *CmdOpt) New(name string, do, usage DoFunc) *flag.FlagSet
• type DoFunc

Types

type CmdOpt

type CmdOpt struct {
	// contains filtered or unexported fields
}

CmdOpt 带子命令的命令行操作

func New

func New(output io.Writer, errHandling flag.ErrorHandling, usage DoFunc, notFound func(string) string) *CmdOpt

New 新的 CmdOpt 对象

output 表示命令输出内容所指向的通道； errHandling 传递给每一个 FlagSet 的内容； usage 表示命令行的默认显示内容，在未指定子命令或是未找到子命令时会显示此内容； notFound 未找到子命令时，会额外显示此内容。

func (*CmdOpt) Commands

func (opt *CmdOpt) Commands() []string

Commands 所有的子命令列表

func (*CmdOpt) Exec

func (opt *CmdOpt) Exec(args []string) error

Exec 执行命令行程序

args 第一个元素应该是子命令名称。

func (*CmdOpt) Help

func (opt *CmdOpt) Help(name string, usage DoFunc)

Help 注册 help 子命令

func (*CmdOpt) New

func (opt *CmdOpt) New(name string, do, usage DoFunc) *flag.FlagSet

New 注册一条新的子命令

name 为子命令的名称，必须唯一； do 为该条子命令执行的函数体； usage 为该条子命令的帮助内容输出。 如果 usage 为 nil，则采用自带的内容，也可以通过返回值再次指定。

返回 FlagSet，不需要手动调用 FlagSet.Parse，该方法会在执行时自动执行。 FlagSet.Args 返回的是包含了子命令在内容的所有内容。

type DoFunc

type DoFunc func(io.Writer) error

DoFunc 子命令的执行函数