文档章节

使用go构建命令行程序的快捷之道

mkideal
 mkideal
发布于 2016/04/17 09:08
字数 1118
阅读 21
收藏 0
点赞 1
评论 0

cli开源在github上https://github.com/mkideal/cli

入门介绍

命令行程序虽然没有华丽的界面,但是在服务器端,命令行程序是不可或缺的,而且在很多时候比图形界面更加好用。在unix/linux操作系统上命令行程序极其常见,系统上预装大量程序。cli这个工具正是用来便捷构建这种命令行程序的go语言库。 先看一个简单的示例:

package main

import (
	"github.com/mkideal/cli"
)

type argT struct {
	cli.Helper
}

func main() {
	cli.Run(&argT{}, func(ctx *cli.Context) error {
		argv := ctx.Argv().(*argT)
		if argv.Help {
			ctx.WriteUsage()
		} else {
			ctx.String("hello\n")
		}
		return nil
	})
}

编译运行这段代码

$ go build -o app
$ ./app
hello
$ ./app -h
Options:
  -h, --help     display help

当然这段代码没有任何实质功能。代码第12行调用cliRun函数,函数原型如下:

func Run(argv interface{}, fn func(*Context) error, descs ...string)

参数 argv 在执行时会通过解析命令行参数来赋值,然后塞进Context对象,最终传递给回调函数 fn。在回调函数中通过 ctx.Argv()获得argv

本示例代码的argT继承于cli.Helper,它的定义如下:

type Helper struct {
	Help bool `cli:"!h,help" usage:"display help"`
}

好了,下面创建一个实用一点的程序来做更详细的讲解。

一个简易的http服务器

package main

import (
	"fmt"
	"net/http"
	
	"github.com/mkideal/cli"
)

type argT struct {
	cli.Helper
	Host string `cli:"H,host" usage:"specify host" dft:"0.0.0.0"`
	Port uint16 `cli:"p,port" usage:"specify port" dft:"8080"`
	Dir  string `cli:"d,dir" usage:"static files directory" dft:"./"`
}

func main() {
	cli.SetUsageStyle(cli.ManualStyle)
	cli.Run(new(argT), func(ctx *cli.Context) error {
		argv := ctx.Argv().(*argT)
		if argv.Help {
			ctx.WriteUsage()
			return nil
		}
		http.Handle("/", http.FileServer(http.Dir(argv.Dir)))
		addr := fmt.Sprintf("%s:%d", argv.Host, argv.Port)
		ctx.String("listening on %s\n", addr)
		http.ListenAndServe(addr, nil)
		return nil
	})
}

在这个例子里,参数对象argT多了几个有用的字段:Host Port Dir

还是先编译运行一下

$ go build -o httpd
$ ./httpd -h

htppd help information

好了,现在创建一个html目录,然后新建一个文件index.html,内容为

<h1>Hello, this is my http server!</h1>

然后启动 http server

$ mkdir html
$ echo "<h1>Hello, this is my http server!</h1>" > html/index.html
$ ./httpd -d html
listening on 0.0.0.0:8080

现在通过浏览器访问 127.0.0.1:8080 就可以看到

htppd screenshot

你还可以指定别的端口,而非默认的端口8080,比如指定端口为3000

可以这样启动

$ ./httpd -d html --port=3000

或者

$ ./httpd -d html --port 3000

或者

$ ./httpd -d html -p=3000

或者

$ ./httpd -d html -p 3000

接下来讲述一下出现在参数定义中的标签,它们是解析参数以及显示帮助时器关键作用的因素。

标签 cliusagedft

cli 支持4个标签

  • cli - 参数flag名,如示例中的 cli:"h,help" cli:"H,host" 等

  • usage - 参数使用描述,是会显示在帮助中的文本

  • dft - 指定参数默认值,可以指定环境变量为默认值,比如这样dft:"$HOME"

  • name - 参数引用名,并无实质功能

创建命令行程序的命令行工具 clier goplus

clier 是 mkideal/cli下的一个命令行程序,它也是使用cli构建的。clier 用于创建一条命令,比如这样

$ clier hello
$ clier -s "this is hello command's description" hello

goplus 的 new 子命令可以构建完整的基于cli的命令行程序。使用示例

$ goplus new hello # 最基本的单命令程序
$ goplus new -t http httpd # 通过 `-t` 参数指定程序类型为`http`
$ goplus new -t tree demo # 基本的多命令程序

本文只是一个cli的简要介绍。下面几篇是关于cli的更详细的介绍


本文转载自:http://www.mkideal.com/golang/cli.html

共有 人打赏支持
mkideal
粉丝 0
博文 1
码字总数 0
作品 1
朝阳
Apache Commons CLI官方文档翻译 —— 快速构建命令行启动模式

昨天通过几个小程序以及Hangout源码学习了CLI的基本使用,今天就来尝试翻译一下CLI的官方使用手册。 下面将会通过几个部分简单的介绍CLI在应用中的使用场景。 昨天已经联系过几个基本的命令行...

青夜之衫 ⋅ 2017/12/05 ⋅ 0

使用Android开发方便快捷的8 个好工具

Android是目前最流行的移动操作系统之一,Android应用开发目前也正变得越来越流行。这里有8个最好的 Android工具,在这些工具的帮助下,开发人员可以更方便、快捷地开发应用程序。 1. SDK和A...

android技术开发 ⋅ 2013/07/29 ⋅ 0

前端的一些工具和概念、框架

前端目前发展真是百家争鸣热闹的很,也涌现出了大量的框架、工具,下面就是对热门的前端的一个梳理: 1. Node.js:一个事件驱动I/O服务端JavaScript环境,基于Google的V8引擎,V8引擎执行Jav...

IT追寻者 ⋅ 2016/06/16 ⋅ 0

Gradle学习(十一)——构建脚本基础知识

转载请注明出处:http://blog.csdn.net/lastsweetop/article/details/78962619 项目和任务 Gradle的所有都是基于两个基础概念:项目和任务 每个Gradle构建是由一个或者多个项目构成的,项目表...

lastsweetop ⋅ 01/03 ⋅ 0

无忧之道:Docker中容器的备份、恢复和迁移

今天,我们将学习如何快速地对docker容器进行快捷备份、恢复和迁移。Docker是一个开源平台,用于自动化部署应用,以通过快捷的途径在称之为容器的轻量级软件层下打包、发布和运行这些应用。它...

奔跑的阿飞 ⋅ 2017/08/30 ⋅ 0

Android 开发工具简介

Introduction 译者署名:MeetAndroid 译者链接:http://blog.csdn.net/meetandroid 版本:Android 3.1 r1 原文 http://developer.android.com/guide/developing/index.html 简介 使用SDK提供......

阿酷 ⋅ 2011/11/17 ⋅ 0

打造一个全命令行的Android构建系统

IDE都是给小白程序员的,大牛级别的程序员一定是命令行控,终端控,你看大牛都是使用vim,emacs 就一切搞定” 这话说的虽然有些绝对,但是也不无道理,做开发这行要想效率高,自动化还真是缺少...

拉偶有所依 ⋅ 2015/06/29 ⋅ 10

Terminator 安装与使用

对Linux系统进行管理时,我们经常需要通过终端窗口输入各种操作命令。在GNOME桌面环境下,GNOME终端(gnome-terminal) 是我们经常使用的终端程序,每次运行该程序都将打开一个单独的终端窗口。...

御风林海 ⋅ 2016/10/06 ⋅ 0

Python调用Ant构建时根据构建状态来决定命令行退出状态

在使用python执行Ant构建时遇到的问题: 使用os.system()调用Ant构建时,不论构建成功还是失败(BUILD SUCCESSFUL/BUILD FAILED),命令行的总是正常退出 要解决问题: 首先想到的是获取ant...

donhui ⋅ 2015/04/16 ⋅ 0

Java内存溢出如何处理

背景介绍 新建Java对象时会在JVM的Heap中分配内存,对象不可达时其内存会被JVM GC回收, 但是当Heap中没有多余内存可供分配时,就会报OutOfMemory错误(以下简称OOM): 解决方法 解决方式很简...

Arthur126 ⋅ 2016/07/20 ⋅ 0

没有更多内容

加载失败,请刷新页面

加载更多

下一页

win环境下jdk7与jdk8共存配置

1.jdk安装包 jdk安装包 安装步骤略 2.jdk等配置文件修改 在安装JDK1.8时(本机先安装jdk1.7再安装的jdk1.8),会将java.exe、javaw.exe、javaws.exe三个文件copy到了C:\Windows\System32,这...

泉天下 ⋅ 11分钟前 ⋅ 0

windows profesional 2017 build problem

.net framework .... https://stackoverflow.com/questions/43330915/could-not-load-file-or-assembly-microsoft-build-frameworkvs-2017...

机油战士 ⋅ 45分钟前 ⋅ 0

python3中报错的解决方法(长期更新)

1、ImportError: No module named ‘DjangoUeditor’ 出错原因:安装DjangoUeditor库适用于python2,需要下载适用python3的 下载地址:https://github.com/twz915/DjangoUeditor3 2、python3......

xiaoge2016 ⋅ 50分钟前 ⋅ 0

数据结构与算法之双向链表

一、双向链表 1.双向链表的结点结构 typedef struct DualNode{ ElemType data; struct DualNode *prior; // 前驱结点 struct DualNode *next; // 后继结点}DualNode, *DuL...

aibinxiao ⋅ 今天 ⋅ 0

五大最核心的大数据技术

大数据技术有5个核心部分,数据采集、数据存储、数据清洗、数据挖掘、数据可视化。关于这5个部分,有哪些核心技术?这些技术有哪些潜在价值?看完今天的文章就知道了。 大数据学习群:7165810...

董黎明 ⋅ 今天 ⋅ 0

PhpStorm 头部注释、类注释和函数注释的设置

首先,PhpStorm中文件、类、函数等注释的设置在:setting-》Editor-》FIle and Code Template-》Includes下设置即可,其中方法的默认是这样的: /**${PARAM_DOC}#if (${TYPE_HINT} != "v...

nsns ⋅ 今天 ⋅ 0

spring.net AOP

http://www.springframework.net/doc-latest/reference/html/aop-quickstart.html https://www.cnblogs.com/wujy/archive/2013/04/06/3003120.html AOP系列(一)——ProxyFactoryObject 显式创......

whoisliang ⋅ 今天 ⋅ 0

【HAVENT原创】创建 Dockerfile 生成新的镜像,并发布到 DockerHub

注意:Win7 与 Win10 的版本存在差异,Win7 版本使用 Docker Quickstart Terminal 进入控制台,Win10下面直接用管理员权限打开控制台或者 PowerShell 即可;另外 Win7 下面只能访问 C盘,/ap...

HAVENT ⋅ 今天 ⋅ 0

pom.xml出现web.xml is missing ...解决方案

提示信息应该能看懂。也就是缺少了web.xml文件,<failOnMissingWebXml>被设置成true了。 搜索了一下,Stack Overflow上的答案解决了问题,分享一下。 目前被顶次数最多的回答原文如下: This...

源哥L ⋅ 今天 ⋅ 0

js时间戳与日期格式之间相互转换

1. 将时间戳转换成日期格式 1 2 3 4 5 6 7 8 9 10 11 12 13 14 // 简单的一句代码 var date = new Date(时间戳); //获取一个时间对象 /** 1. 下面是获取时间日期的方法,需要什么样的格式自己...

Jack088 ⋅ 今天 ⋅ 0

没有更多内容

加载失败,请刷新页面

加载更多

下一页

返回顶部
顶部