$ . d Z ddlmZ ddlmZ ddlmZ ddlmZ ddlZddlZddlZddl Z ddl
Z
ddl m Z ddl m
Z
ddlZdd lmZ dd
lmZ ddlZdd lmZ dd lmZ dd
lmZ ddlmZ ddlm Z ddlm Z ddlm Z ddlm Z dZ de z dz Z!dZ" G d de Z#y)&Implementation of gsutil help command. )absolute_import)print_function)division)unicode_literalsN)PIPE)Popen)Command)
OLD_ALIAS_MAP)CommandException) HelpProvider)MAX_HELP_NAME_LEN) constants)
IS_WINDOWS)IsRunningInteractively) GetTermLines) text_utilz"
gsutil help [command or topic]
z
SYNOPSIS
a
DESCRIPTION
The following command provides a summary of gsutil commands and additional topics on which
help is available:
gsutil help
The following command provides help about the specified command or topic:
gsutil help [command or topic]
The following command provides help about the specified sub-command:
gsutil help [command] [sub-command]
For example, running the following provides help about the "set" sub-command of the "acl" command:
gsutil help acl set
If you set the PAGER environment variable to the path to a pager program
(such as /bin/less on Linux), long help sections are piped through
the specified pager.
zUsage: gsutil [-D] [-DD] [-h header]... [-i service_account] [-m] [-o section:flag=value]... [-q] [-u user_project] [command [opts...] args...]c e Zd ZdZ ej
dddgeddddd d
Z ej ddgd d e i
Z
d Z d Z d Z
y) HelpCommandr help?manr TF)command_name_aliasesusage_synopsismin_argsmax_argssupported_sub_args file_url_okprovider_url_okurls_start_arg command_helpz"Get help about commands and topics) help_namehelp_name_aliases help_typehelp_one_line_summary help_textsubcommand_help_textc d | j \ }}g }| j s|j dt z dt t
z dz }t
|d d D ]@ }|j ||j j |j j fz B |j d t
|d d D ]@ }|j ||j j |j j fz B |j d
nd }| j d }||vr|j d
|z n|| }d}t | j dkD r|j j } | r9| j d | v r(|dz | j d z }| | j d }
nvd}| s|j d|d|d nYg } | D ] } | j d|d| |j d| j d d|d|ddj | |s|s,|j j }|j j }
|j d |j d|d |j j d |j d |j
j d t j |dg d }
|
r+d |d |
d }|j d! |j | | j# d"j | y )#z)Command entry point for the help command.z%s
Available commands:
z %-zs%s
r# c . | j j S N help_specr$ hps &platform/gsutil/gslib/commands/help.pyz(HelpCommand.RunCommand..r R\\-C-C )keyz
Additional help topics:
additional_helpc . | j j S r, r- r/ s r1 r2 z(HelpCommand.RunCommand..w r3 r4 z6
Use gsutil help for detailed help.Fr zNo help available for "%s"N TzThe "zV" command has no subcommands. You can ask for the full help by running:
gsutil help
z
gsutil help z Subcommand "z " does not exist for command "zT".
You can either ask for the full help about the command by running:
gsutil help z9
Or you can ask for help about one of the subcommands:
z NAME
z z - z
z
The "zT" alias is deprecated, and will eventually be removed completely.
Please use the "z" command instead.z
DEPRECATION WARNING
r )
_LoadHelpMapsargsappendtop_level_usage_stringstrr sortedr. r$ r' lenr) joinr( stripr get _OutputHelp)self
help_type_map
help_name_mapoutput
format_str help_provinvalid_subcommandargr$ subcommand_mapr( subcommand_examples
subcommand new_aliasdeprecation_warnings r1
RunCommandzHelpCommand.RunCommandj s %)%7%7%9"]M
F 99 mm/2HHIC 1 22W"CE)
jI$7$7$A$A$-$7$7$M$M$O O PE
mmMN IIaLc M !
2S89!#& tyy>A $..CC.
! >c DIIaL0I&tyy|4I!% !mmEH#OP %'! .*#**,/,= > !/ mm
yy|S#tyy9L/M OP "!++55I!++55I
--
(
--"I$7$7$M$MO P
--
-- -
.#''dV4Q7)
.1)#=
MM> ? MM- .RWWV_% r4 c @ t s
t sDt j dd| }t j dd| }t j
| yt j dd| }t j dd| }t
|j d }dt j v r|t k\ rt j d j d }|d
j d r|j d t j r |j t j" }n|}t% |t& d
j) | yt j
| y# t* $ r%}t- dd j/ | d| d}~ww xY w)zOutputs simply formatted string.
This function paginates if the string is too long, PAGER is defined, and
the output is a tty.
Args:
help_str: String to format.
zr zNz[1mz[0;0mr: PAGERr9 r lessz-rT)stdinuniversal_newlines)inputzUnable to open pager (z): )r r resubr print_to_fdrA splitosenvironr endswithr= sixPY2encoder UTF8r r communicateOSErrorr rB )rF help_str num_linespagerinput_for_pageres r1 rE zHelpCommand._OutputHelp sD /1r8,hH-hH% vveY1Hvvfk84HHNN4()I"** ln!<jj!'',e q 6 "
T 5 77 $OOINN ;/ $/
e4!% ''2{ {'I
H% 5 # 4 5 55s AE/ / F 8 FF c t j t j j D ] \ }}}t d|z t j t j j D ] \ }}}t d|z i }i }t j j D ] }g ||< t j t j t j D ] }|t u r t j j || |||j j < |j j" D ] }|||< ||j j$ j' | ||fS )a. Returns tuple of help type and help name.
help type is a dict with key: help type
value: list of HelpProviders
help name is a dict with key: help command name or alias
value: HelpProvider
Returns:
(help type, help name)
zgslib.commands.%szgslib.addlhelp.%s)pkgutil iter_modulesgslibcommands__path__
__import__addlhelp
help_providerALL_HELP_TYPES itertoolschainr
__subclasses__r
SanityCheckr. r$ r% r& r= )rF _ module_namerG rH srK r% s r1 r; zHelpCommand._LoadHelpMaps sP % 1 1%..2I2I J;${23 K % 1 1%..2I2I J;${23 K MM
/
/mA 0 __\%@%@%B%,%;%;%=? g %%i ?5>mI''112 ( 2 2 D D
+4
'( EI''11299)D?
= ))r4 N)__name__
__module__ __qualname____doc__r
CreateCommandSpec _SYNOPSIS command_specHelpSpec_DETAILED_HELP_TEXTr. rS rE r; r4 r1 r r Q sr . +** <
, g @#
)B
H#&J$*r4 r )$r
__future__r r r r rv r^ rm rZ ra
subprocessr r gslib.addlhelpro
gslib.commandr
r gslib.commandsgslib.exceptionr gslib.help_providerr
r gslib.utilsr gslib.utils.system_utilr r r r r r r> r r r4 r1 r s - & % '
! ' , , 1 ! . : 0 !
:Y f*' f*r4