dZddlmZddlmZddlmZddlmZejGddejZ y) z*--flags-file=YAML_FILE supplementary help.)absolute_import)division)unicode_literals)baseceZdZdZy)CommandConventionsa --flags-file=YAML_FILE supplementary help. The *--flags-file*=_YAML-FILE_ flag, available to all *gcloud* commands, supports complex flag values in any command interpreter. Complex flag values that contain command interpreter special characters may be difficult to specify on the command line. The combined list of _special_ characters across commonly used command interpreters (shell, cmd.exe, PowerShell) is surprisingly large. Among them are ```", ', `, *, ?, [, ], (, ), $, %, #, ^, &, |, {, }, ;, \, <, >,``` _space_, _tab_, _newline_. Add to that the separator characters for *list* and *dict* valued flags, and it becomes all but impossible to construct portable command lines. The *--flags-file*=_YAML-FILE_ flag solves this problem by allowing command line flags to be specified in a YAML/JSON file. String, numeric, list and dict flag values are specified using YAML/JSON notation and quoting rules. Flag specification uses dictionary notation. Use a list of dictionaries for flags that must be specified multiple times. For example, this YAML file defines values for Boolean, integer, floating point, string, dictionary and list valued flags: ```yaml --boolean: --integer: 123 --float: 456.789 --string: A string value. --dictionary: a=b: c,d e,f: g=h i: none j=k=l: m=$n,o=%p "y:": ":z" meta: - key: foo value: bar - key: abc value: xyz --list: - a,b,c - x,y,z ``` If the file is named *my-flags.yaml* then the command line flag *--flags-file=my-flags.yaml* will set the specified flags on any system using any command interpreter. *--flags-file* may be specified in a YAML file, and its value can be a YAML list to reference multiple files. This example specifies the *--metadata* flag multiple times: ```yaml - --metadata: abc --integer: 123 - --metadata: xyz ``` Each *--flags-file* arg is replaced by its contents, so normal flag precedence applies. For example, given *flags-1.yaml*: ```yaml --zone: us-east2-a ``` *flags-2.yaml*: ```yaml --verbosity: info --zone: us-central1-a ``` and command line: ``` gcloud compute instances describe \ --flags-file=flags-1.yaml my-instance --flags-file=flags-2.yaml ``` the effective command line is: ``` gcloud compute instances describe \ --zone=us-east2-a my-instance --verbosity=info --zone=us-central1-a ``` using zone *us-central1-a* (not *us-east2-a*, because `flags-2.yaml`, to the right of `flags-1.yaml`, has higher precedence). N)__name__ __module__ __qualname____doc__lib/surface/topic/flags_file.pyrrsWrrN) r __future__rrrgooglecloudsdk.callioperUniverseCompatible TopicCommandrr rrrs@ 1&'( X**XXr