A library to parse command line arguments for Golang application.
This library provides the following functionalities:
- Supports POSIX & GNU like short and long options.
- This library supports
--
option. - This library doesn't support numeric short option.
- This library supports not
-ofoo
but-o=foo
as an alternative to-o foo
for short option.
- This library supports
- Supports parsing with option configurations.
- Supports parsing with a struct which stores option values and has struct tags of fields.
- Is able to parse command line arguments including sub commands.
- Generates help text from option configurations.
import "github.com/sttk/cliargs"
The usage of this library is described on the overview in the go package document.
See https://pkg.go.dev/github.com/sttk/cliargs#pkg-overview
This library supports Go 1.18 or later.
% gvm-fav
Now using version go1.18.10
go version go1.18.10 darwin/amd64
ok github.com/sttk/cliargs 0.907s coverage: 97.6% of statements
ok github.com/sttk/cliargs/errors 1.052s coverage: 100.0% of statements
ok github.com/sttk/cliargs/validators 0.553s coverage: 100.0% of statements
Now using version go1.19.13
go version go1.19.13 darwin/amd64
ok github.com/sttk/cliargs 0.915s coverage: 97.6% of statements
ok github.com/sttk/cliargs/errors 1.085s coverage: 100.0% of statements
ok github.com/sttk/cliargs/validators 0.569s coverage: 100.0% of statements
Now using version go1.20.14
go version go1.20.14 darwin/amd64
ok github.com/sttk/cliargs 0.559s coverage: 97.6% of statements
ok github.com/sttk/cliargs/errors 1.065s coverage: 100.0% of statements
ok github.com/sttk/cliargs/validators 1.590s coverage: 100.0% of statements
Now using version go1.21.13
go version go1.21.13 darwin/amd64
ok github.com/sttk/cliargs 1.613s coverage: 97.6% of statements
ok github.com/sttk/cliargs/errors 0.537s coverage: 100.0% of statements
ok github.com/sttk/cliargs/validators 1.061s coverage: 100.0% of statements
Now using version go1.22.6
go version go1.22.6 darwin/amd64
ok github.com/sttk/cliargs 0.607s coverage: 97.6% of statements
ok github.com/sttk/cliargs/errors 1.712s coverage: 100.0% of statements
ok github.com/sttk/cliargs/validators 1.160s coverage: 100.0% of statements
Now using version go1.23.0
go version go1.23.0 darwin/amd64
ok github.com/sttk/cliargs 1.743s coverage: 97.6% of statements
ok github.com/sttk/cliargs/errors 0.599s coverage: 100.0% of statements
ok github.com/sttk/cliargs/validators 1.160s coverage: 100.0% of statements
Back to go1.22.6
Now using version go1.22.6
Copyright (C) 2023-2024 Takayuki Sato
This program is free software under MIT License.
See the file LICENSE in this distribution for more details.