gotosocial/vendor/github.com/jessevdk/go-flags
Vyr Cossont fc3741365c
[bugfix] Fix Swagger spec and add test script ()
* Add Swagger spec test script

* Fix Swagger spec errors not related to statuses with polls

* Add API tests that post a status with a poll

* Fix creating a status with a poll from form params

* Fix Swagger spec errors related to statuses with polls (this is the last error)

* Fix Swagger spec warnings not related to unused definitions

* Suppress a duplicate list update params definition that was somehow causing wrong param names

* Add Swagger test to CI

- updates Drone config
- vendorizes go-swagger
- fixes a file extension issue that caused the test script to generate JSON instead of YAML with the vendorized version

* Put `Sample: ` on its own line everywhere

* Remove unused id param from emojiCategoriesGet

* Add 5 more pairs of profile fields to account update API Swagger

* Remove Swagger prefix from dummy fields

It makes the generated code look weird

* Manually annotate params for statusCreate operation

* Fix all remaining Swagger spec warnings

- Change some models into operation parameters
- Ignore models that already correspond to manually documented operation parameters but can't be trivially changed (those with file fields)

* Documented that creating a status with scheduled_at isn't implemented yet

* sign drone.yml

* Fix filter API Swagger errors

* fixup! Fix filter API Swagger errors

---------

Co-authored-by: tobi <tobi.smethurst@protonmail.com>
2024-03-06 18:05:45 +01:00
..
.travis.yml [bugfix] Fix Swagger spec and add test script () 2024-03-06 18:05:45 +01:00
arg.go [bugfix] Fix Swagger spec and add test script () 2024-03-06 18:05:45 +01:00
check_crosscompile.sh [bugfix] Fix Swagger spec and add test script () 2024-03-06 18:05:45 +01:00
closest.go [bugfix] Fix Swagger spec and add test script () 2024-03-06 18:05:45 +01:00
command.go [bugfix] Fix Swagger spec and add test script () 2024-03-06 18:05:45 +01:00
completion.go [bugfix] Fix Swagger spec and add test script () 2024-03-06 18:05:45 +01:00
convert.go [bugfix] Fix Swagger spec and add test script () 2024-03-06 18:05:45 +01:00
error.go [bugfix] Fix Swagger spec and add test script () 2024-03-06 18:05:45 +01:00
flags.go [bugfix] Fix Swagger spec and add test script () 2024-03-06 18:05:45 +01:00
group.go [bugfix] Fix Swagger spec and add test script () 2024-03-06 18:05:45 +01:00
help.go [bugfix] Fix Swagger spec and add test script () 2024-03-06 18:05:45 +01:00
ini.go [bugfix] Fix Swagger spec and add test script () 2024-03-06 18:05:45 +01:00
LICENSE [bugfix] Fix Swagger spec and add test script () 2024-03-06 18:05:45 +01:00
man.go [bugfix] Fix Swagger spec and add test script () 2024-03-06 18:05:45 +01:00
multitag.go [bugfix] Fix Swagger spec and add test script () 2024-03-06 18:05:45 +01:00
option.go [bugfix] Fix Swagger spec and add test script () 2024-03-06 18:05:45 +01:00
optstyle_other.go [bugfix] Fix Swagger spec and add test script () 2024-03-06 18:05:45 +01:00
optstyle_windows.go [bugfix] Fix Swagger spec and add test script () 2024-03-06 18:05:45 +01:00
parser.go [bugfix] Fix Swagger spec and add test script () 2024-03-06 18:05:45 +01:00
README.md [bugfix] Fix Swagger spec and add test script () 2024-03-06 18:05:45 +01:00
termsize.go [bugfix] Fix Swagger spec and add test script () 2024-03-06 18:05:45 +01:00
termsize_nosysioctl.go [bugfix] Fix Swagger spec and add test script () 2024-03-06 18:05:45 +01:00
termsize_windows.go [bugfix] Fix Swagger spec and add test script () 2024-03-06 18:05:45 +01:00

go-flags: a go library for parsing command line arguments

GoDoc Build Status Coverage Status

This library provides similar functionality to the builtin flag library of go, but provides much more functionality and nicer formatting. From the documentation:

Package flags provides an extensive command line option parser. The flags package is similar in functionality to the go builtin flag package but provides more options and uses reflection to provide a convenient and succinct way of specifying command line options.

Supported features:

  • Options with short names (-v)
  • Options with long names (--verbose)
  • Options with and without arguments (bool v.s. other type)
  • Options with optional arguments and default values
  • Multiple option groups each containing a set of options
  • Generate and print well-formatted help message
  • Passing remaining command line arguments after -- (optional)
  • Ignoring unknown command line options (optional)
  • Supports -I/usr/include -I=/usr/include -I /usr/include option argument specification
  • Supports multiple short options -aux
  • Supports all primitive go types (string, int{8..64}, uint{8..64}, float)
  • Supports same option multiple times (can store in slice or last option counts)
  • Supports maps
  • Supports function callbacks
  • Supports namespaces for (nested) option groups

The flags package uses structs, reflection and struct field tags to allow users to specify command line options. This results in very simple and concise specification of your application options. For example:

type Options struct {
	Verbose []bool `short:"v" long:"verbose" description:"Show verbose debug information"`
}

This specifies one option with a short name -v and a long name --verbose. When either -v or --verbose is found on the command line, a 'true' value will be appended to the Verbose field. e.g. when specifying -vvv, the resulting value of Verbose will be {[true, true, true]}.

Example:

var opts struct {
	// Slice of bool will append 'true' each time the option
	// is encountered (can be set multiple times, like -vvv)
	Verbose []bool `short:"v" long:"verbose" description:"Show verbose debug information"`

	// Example of automatic marshalling to desired type (uint)
	Offset uint `long:"offset" description:"Offset"`

	// Example of a callback, called each time the option is found.
	Call func(string) `short:"c" description:"Call phone number"`

	// Example of a required flag
	Name string `short:"n" long:"name" description:"A name" required:"true"`

	// Example of a flag restricted to a pre-defined set of strings
	Animal string `long:"animal" choice:"cat" choice:"dog"`

	// Example of a value name
	File string `short:"f" long:"file" description:"A file" value-name:"FILE"`

	// Example of a pointer
	Ptr *int `short:"p" description:"A pointer to an integer"`

	// Example of a slice of strings
	StringSlice []string `short:"s" description:"A slice of strings"`

	// Example of a slice of pointers
	PtrSlice []*string `long:"ptrslice" description:"A slice of pointers to string"`

	// Example of a map
	IntMap map[string]int `long:"intmap" description:"A map from string to int"`
}

// Callback which will invoke callto:<argument> to call a number.
// Note that this works just on OS X (and probably only with
// Skype) but it shows the idea.
opts.Call = func(num string) {
	cmd := exec.Command("open", "callto:"+num)
	cmd.Start()
	cmd.Process.Release()
}

// Make some fake arguments to parse.
args := []string{
	"-vv",
	"--offset=5",
	"-n", "Me",
	"--animal", "dog", // anything other than "cat" or "dog" will raise an error
	"-p", "3",
	"-s", "hello",
	"-s", "world",
	"--ptrslice", "hello",
	"--ptrslice", "world",
	"--intmap", "a:1",
	"--intmap", "b:5",
	"arg1",
	"arg2",
	"arg3",
}

// Parse flags from `args'. Note that here we use flags.ParseArgs for
// the sake of making a working example. Normally, you would simply use
// flags.Parse(&opts) which uses os.Args
args, err := flags.ParseArgs(&opts, args)

if err != nil {
	panic(err)
}

fmt.Printf("Verbosity: %v\n", opts.Verbose)
fmt.Printf("Offset: %d\n", opts.Offset)
fmt.Printf("Name: %s\n", opts.Name)
fmt.Printf("Animal: %s\n", opts.Animal)
fmt.Printf("Ptr: %d\n", *opts.Ptr)
fmt.Printf("StringSlice: %v\n", opts.StringSlice)
fmt.Printf("PtrSlice: [%v %v]\n", *opts.PtrSlice[0], *opts.PtrSlice[1])
fmt.Printf("IntMap: [a:%v b:%v]\n", opts.IntMap["a"], opts.IntMap["b"])
fmt.Printf("Remaining args: %s\n", strings.Join(args, " "))

// Output: Verbosity: [true true]
// Offset: 5
// Name: Me
// Ptr: 3
// StringSlice: [hello world]
// PtrSlice: [hello world]
// IntMap: [a:1 b:5]
// Remaining args: arg1 arg2 arg3

More information can be found in the godocs: http://godoc.org/github.com/jessevdk/go-flags