Share
Embed
Transcript
22 slides
-
ࣗݾհ • ݈ଠ (@zoncoen) - ໋ཱؗ (ੜ໋Պֶ) → ಸྑઌ (ใ)
- ৽ଔݚमத@DeNA - Baby Gopher -
What is the flag pkg? • ίϚϯυϥΠϯͷϑϥάղੳΛఏڙ • String(), Bool(),
Int() ͳͲͰϑϥάΛఆٛ • Parse() ͰϑϥάΛύʔε͢Δ ? -
ҎԼͷίʔυΛ demo.go ͱͯ͠อଘ package main ! import ( "flag" "fmt"
"os" ) ! func main() { help := flag.Bool("help", false, "print help message and exit") flag.Parse() ! if *help { fmt.Println("demo.go - This is a demo of flag pkg.") os.Exit(0) } ! fmt.Println("Hello, Gopher!") } -
ΦϓγϣϯΛ༩͑Δͱڍಈ͕มΘΔ $ go run demo.go Hello, Gopher! ! $ go
run demo.go -help demo.go - This is a demo of flag pkg. ! $ go run --help // ϋΠϑϯ1ͭͰ2ͭͰOK demo.go - This is a demo of flag pkg. -
= Ͱͭͳ͙͔࣍ͷҾͰΘͨ͢ ... snip ... ! name := flag.String("name",
"Gopher", "set your name") flag.Parse() ! ...snip... ! fmt.Printf("Hello, %v!\n", *name) } $ go run demo.go Hello, Gopher! ! $ go run demo.go --name zoncoen Hello, zoncoen! ! $ go run demo.go --name=zoncoen Hello, zoncoen! -
ผশ StringVar()ɼ BoolVar()ɼIntVar() Λ͏ ... snip ... ! help :=
flag.Bool("help", false, "print help message and exit") flag.BoolVar(help, "h", false, "print help message and exit") flag.Parse() ! ...snip... $ go run demo.go --help demo.go - This is a demo of flag pkg. ! $ go run demo.go -h demo.go - This is a demo of flag pkg. -
Usage() Ͱඪ४Τϥʔʹ usage Λग़ྗ σϑΥϧτͷঢ়ଶͰh/helpΦϓγϣϯΛ͚ͭͯ ͜Ε͕ग़ྗ͞ΕΔ ... snip ... !
if *help { fmt.Println("demo.go - This is a demo of flag pkg.") flag.Usage() os.Exit(0) } ! ...snip... $ go run demo.go -h demo.go - This is a demo of flag pkg. Usage of /var/folders/c3/vwntnjg517v2pxzd6072hrnjhggkq_/T/go- build178147611/command-line-arguments/_obj/exe/demo: -h=false: print help message and exit -help=false: print help message and exit -name="Gopher": set your name -
• Bool() BoolVar() Ͱొͨ͠มΛฦ͢ • BoolVar() Var() Ͱม
p Λొ // flag.go L461-465 func (f *FlagSet) Bool(name string, value bool, usage string) *bool { p := new(bool) f.BoolVar(p, name, value, usage) return p } ! // flag.go L461-465 func (f *FlagSet) BoolVar(p *bool, name string, value bool, usage string) { f.Var(newBoolValue(value, p), name, usage) } -
• Var() formal ʹϑϥάΛొ • ॏෳొ͕͋ΕPanic() // flag.go L461-465
func (f *FlagSet) Var(value Value, name string, usage string) { flag := &Flag{name, usage, value, value.String()} _, alreadythere := f.formal[name] if alreadythere { var msg string if f.name == "" { msg = fmt.Sprintf("flag redefined: %s", name) } else { msg = fmt.Sprintf("%s flag redefined: %s", f.name, name) } fmt.Fprintln(f.out(), msg) panic(msg) } if f.formal == nil { f.formal = make(map[string]*Flag) } f.formal[name] = flag } -
// flag.go L262-275 type FlagSet struct { Usage func() !
name string parsed bool actual map[string]*Flag formal map[string]*Flag args []string errorHandling ErrorHandling output io.Writer } // flag.go L278-283 type Flag struct { Name string Usage string Value Value DefValue string } • formal ొ͞Εͨϑϥά໊σϑΥϧτΛ อ࣋ -
• Parse()ϑϥάΛ1ͭͣͭparseOne()Ͱparse͢Δ // flag.go L792-813 func (f *FlagSet) Parse(arguments []string)
error { f.parsed = true f.args = arguments // arguments = os.Args[1:] for { seen, err := f.parseOne() if seen { continue } if err == nil { break } switch f.errorHandling { case ContinueOnError: return err case ExitOnError: os.Exit(2) case PanicOnError: panic(err) } } return nil } -
• parseOne()ͰҾ͔ΒϑϥάΛऔಘ func (f *FlagSet) parseOne() (bool, error) { if
len(f.args) == 0 { // args ͕ۭʹͳͬͨΒऴྃ return false, nil } s := f.args[0] if len(s) == 0 || s[0] != '-' || len(s) == 1 { return false, nil } num_minuses := 1 if s[1] == '-' { num_minuses++ if len(s) == 2 { // "--" Ͱϑϥάղੳऴྃ f.args = f.args[1:] return false, nil } } name := s[num_minuses:] // = ͕͋ΕnameͱvalueΛ͚Δ if len(name) == 0 || name[0] == '-' || name[0] == '=' { return false, f.failf("bad flag syntax: %s", s) } ! ... cont ... -
... cont ... ! f.args = f.args[1:] has_value := false
value := "" for i := 1; i < len(name); i++ { // 1จࣈ = ͰͳΒͳ͍ if name[i] == '=' { value = name[i+1:] has_value = true name = name[0:i] break ɹ } } m := f.formal flag, alreadythere := m[name] // BUG if !alreadythere { if name == "help" || name == "h" { // usageͷදࣔ f.usage() return false, ErrHelp } return false, f.failf("flag provided but not defined: -%s", name) } ! ... cont ... -
... cont ... ! if fv, ok := flag.Value.(boolFlag); ok
&& fv.IsBoolFlag() { // bool valueඞཁͳ͍ if has_value { if err := fv.Set(value); err != nil { return false, f.failf("invalid boolean value %q for - %s: %v", value, name, err) } } else { fv.Set("true") } } else { // = ͕ͳ͚Ε࣍ͷҾΛ value ͱͯ͠ॲཧ if !has_value && len(f.args) > 0 { // value is the next arg has_value = true value, f.args = f.args[0], f.args[1:] } if !has_value { return false, f.failf("flag needs an argument: -%s", name) } if err := flag.Value.Set(value); err != nil { return false, f.failf("invalid value %q for flag -%s: %v", value, name, err) } } if f.actual == nil { f.actual = make(map[string]*Flag) } f.actual[name] = flag // औಘͨ͠ϑϥάΛ actual ʹՃ return true, nil } -
·ͱΊ • Go ͷΦϓγϣϯղੳ flag pkg ͰͰ͖Δ • ͱ͍͑͋·Γ͍উख͕Α͘ͳ͍ •
ུশఆٛͱ͔ϔϧϓͷࣗಈੜͱ͔ • go-flags docopt.go, docker ͷ mflag ͳͲ 3rd Party ͷ pkg Λ͍͍ͬͯͱࢥ͍·͢