)SrSSKJr SSKJr SSKJr SSKrSSKrSSKJr SSKJ r SSK J r SSK J r SS K Jr SS K Jr SS KJr SS KJr SSKr\R,(a SS K Jr SSK Jr SrSrSrSrSr\R<"\R>R@\R>RB5"SS\RD55r#g)z;Extensible interactive shell with auto completion and help.)absolute_import)division)unicode_literalsN)base)cli_tree)config) exceptions) properties)render_document)encoding) application)bindingsz| * auto-completion and active help for all commands * state preservation across commands: *cd*, local/environment variables a # Welcome to the gcloud interactive shell environment. Tips: * start by typing commands to get auto-suggestions and inline help * use `tab`, `up-arrow`, or `down-arrow` to navigate completion dropdowns * use `space` or `/` to accept the highlighted dropdown item * run gcloud interactive --help for more info Run *$ gcloud feedback* to report bugs or request new features. c[RRRR 5=(d SnU(aUS- nX- n[ R "[RSU5 g)a Appends tag to the Cloud SDK metrics environment tag. The metrics/environment tag is sent via the useragent. This tag is visible in metrics for all gcloud commands executed by the calling command. Args: tag: The string to append to the metrics/environment tag. .CLOUDSDK_METRICS_ENVIRONMENTN) r VALUESmetrics environmentGetr SetEncodedValueosenviron)tagmetrics_environments lib/surface/interactive.py_AppendMetricsEnvironmentr?s[#))11==AACIr3 2::'E.0c L[R(ag/n[R"5RHYnUR SS9nU(dMUR SR URSS955 UR U5 M[ SRU5$)z0Returns the function key bindings help markdown.rT)markdownz {}::: ) sixPY2r KeyBindingsGetHelpappendformatGetLabeljoin)lineskey help_texts r_GetKeyBindingsHelpr-Ps~WW %  ! ! # , ,c T *Iy ll9##CLL$L$?@A ll9 - 5 rcf/n[[RRSS9HnUR(dMUR SR UR55 UR UR5 URnUcMl[U[R5(aSR U5nO;US;a$[R"U5R5nSR U5nUR SR U55 M SRU5$) z%Returns the properties help markdown.cUR$)N)name)ps r$_GetPropertiesHelp..`s!&&r)r+z *{}*::z"{}")FTz*{}*zThe default value is {}.r!)sortedr r interactiver,r&r'r0default isinstancer" string_types text_typelowerr))r*propr6s r_GetPropertiesHelpr<]s %Z&&228HId ~~~ ll:$$TYY/0 ll4>>" g   gs// 0 0MM'*'  %mmG,224GMM'*' /66w?@J 5 rc:\rSrSrSr\\\S.r\ S5r Sr Sr g) InteractivepaStart the gcloud interactive shell. *{command}* provides an enhanced *bash*(1) command line with features that include: {features} ### Display The *{command}* display window is divided into sections, described here from top to bottom. *Previous Output*:: Command output scrolls above the command input section as commands are executed. *Command Input*:: Commands are typed, completed, and edited in this section. The default prompt is "$ ". If a context has been set, then its tokens are prepopulated before the cursor. *Active Help*:: As you type, this section displays in-line help summaries for commands, flags, and arguments. You can toggle active help on and off via the *F2* key. Hit *F8* to display the help text in your browser. *Status Display*:: Current *gcloud* project and account information, and function key descriptions and settings are displayed in this section. Function keys toggle mode/state settings or run specific actions. {bindings} ### Auto and Tab Completion Command completions are displayed in a scrolling pop-up menu. Use `tab` and up/down keys to navigate the completions, and `space` or `/` to select the highlighted completion. Completions for _known_ commands, flags, and static flag values are displayed automatically. Positional and dynamic flag value completions for known commands are displayed after `tab` is entered. Known commands include `gcloud`, `bq`, `gsutil`, `kubectl`, and any command with a man page that has been executed at least once in any *interactive* session. `tab` completion for unknown commands defers to *bash*(1), while still using the *interactive* user interface. Absent specific command information, a file/path completer is used when `tab` is entered for unknown positionals (arguments that do not start with '-'). The default completer handles '~' path notation and embedded _$var_ references, but does not expand their values in completions. Configure bash completions as you normally would. *{command}* starts up bash in a mode that sources *~/.bashrc* with the environment variable *COSHELL_VERSION* set to a non-empty version value. Command completion resets with each simple command in the command line. Simple commands are separated by '|', ';', '&' and may appear after '$(', '(', '{', '!', *if*, *then*, *elif*, *while*, and _name_=_value_ per command exports. Use `tab` on an empty line to enable command executable search on PATH for the first token in each simple command. Currently simple and compound commands must be entered in a single line. Refer to [Using gcloud interactive](https://cloud.google.com/sdk/docs/interactive-gcloud) for more information and animated GIFs. ### Control Characters Control characters affect the currently running command or the current command line being entered at the prompt. *ctrl-c*:: If a command is currently running, then that command is interrupted. This terminates the command. Otherwise, if no command is running, ctrl-c clears the current command line. *ctrl-d*:: Exits when entered as the first character at the command prompt. You can also run the *exit* command at the prompt. *ctrl-w*:: If a command is not currently running, then the last word on the command line is deleted. This is handy for "walking back" partial completions. ### Command history *{command}* maintains persistent command history across sessions. #### emacs mode *^N*:: Move ahead one line in the history. *^P*:: Move back one line in the history. *^R*:: Search backwards in the history. #### vi mode /:: Search backwards in the history. *j*:: Move ahead one line in the history. *k*:: Move back one line in the history. *n*:: Search backwards for the next match. *N*:: Search forwards for the next match. #### history search mode *ENTER/RETURN*:: Retrieve the matched command line from the history. *^R*:: Search backwards for the next match. *^S*:: Search forwards for the next match. ### Layout Configuration Parts of the layout are configurable via *$ gcloud config set* interactive/_property_. These properties are only checked at startup. You must exit and restart to see the effects of new settings. {properties} ### CLI Trees *{command}* uses CLI tree data files for typeahead, command line completion, and help snippet generation. A few CLI trees are installed with their respective Google Cloud CLI components: *gcloud* (core component), *bq*, *gsutil*, and *kubectl*. Trees for commands that have man(1) pages are generated on the fly. See `$ gcloud topic cli-trees` for details. ## EXAMPLES To set the command context of *{command}* to "gcloud ", run: {command} --context="gcloud " ## NOTES On Windows, install *git*(1) for a *bash*(1) experience. *{command}* will then use the *git* (MinGW) *bash* instead of *cmd.exe*. Please run *$ gcloud feedback* to report bugs or request new features. )rfeaturesr cURSSS9 URSSSSSS9 URS SSSS S9 URS SS S 9 URSSSSSS9 g)Nz --contextzDefault command context. This is a string containing a command name, flags, and arguments. The context is prepopulated in each command line. You can inline edit any part of the context, or ctrl-c to eliminate it.)helpz--debugT store_truezEnable debugging display.)hiddenactionr6rBz--hiddenz/Enable completion of hidden commands and flags.z--promptzThe interactive shell prompt.)rDrBz --suggestz_Enable auto suggestion from history. The defaults are currently too rudimentary for prime time.) add_argument)parsers rArgsInteractive.Argss 46   ( *   > @   ,. 0 2rc2[R(a[R"S5e[R "5R nU(a [R"URSSS9 UR(d,[R"[R"[5S9 [ R""UR$UR&UR(UR*UR,S9n[/S5 [0R2"XS9 g)NzCThis command does not support Python 2. Please upgrade to Python 3.F)cliforceverbose)fin)contextdebugrDpromptsuggestinteractive_shell)argsr)r"r#r Error gcloud_configPathssdk_rootrLoad_cli_do_not_use_directlyquietr RenderDocumentioStringIO_SPLASH configurationConfigrOrPrDrQrRrr main)selfrTrXrs rRunInteractive.Run's ww   4 55""$--Hmm55UER ::$$W)=>  ! ! jj{{{{ F12$.rN) __name__ __module__ __qualname____firstlineno____doc__r- _FEATURESr< detailed_help staticmethodrHrd__static_attributes__rfrrr>r>ps4L^&&- 22>/rr>)$rk __future__rrrr]rgooglecloudsdk.callioperr&googlecloudsdk.command_lib.interactiverr`googlecloudsdk.corerVr r &googlecloudsdk.core.document_renderersr googlecloudsdk.core.utilr r"PY3r rrlr_rr-r< ReleaseTracks ReleaseTrackALPHABETACommandr>rfrrr|s B&' (,J7**B- 77@=  0" &D%%++T->->-C-CDI/$,,I/EI/r