d Z ddlmZ ddlmZ ddlmZ ddlmZ ddlZddlmZ dd gZ d
Z
d Z d e
z
Z d
Z
dZ G d de Zd Zd Zy)z=Module defining help types and providers for gsutil commands. )absolute_import)print_function)division)unicode_literalsN)CommandException command_helpadditional_help
P z
DESCRIPTIONz
SYNOPSISc > e Zd ZdZ ej
dg d ZdZy) HelpProviderz Interface for providing help.HelpSpec) help_namehelp_name_aliases help_typehelp_one_line_summary help_textsubcommand_help_textN)__name__
__module__ __qualname____doc__ collections
namedtupler help_spec &platform/gsutil/gslib/help_provider.pyr r ( s( % $[
#
#
($ )r r c
t | j j }|dkD r |t k s0J dj | j j t | j j
D ] }|rJ t | j j }|t k\ s1J dj | j j |t |t k s1J dj | j j |t t | j j dkD s+J d j | j j
| j j g}|j | j j
|D ]1 }||v st d |d | j d
|| j y)zGHelper for checking that a HelpProvider has minimally adequate content. z.The help name "{text}" must be less then {max})textmaxzZThe one line summary "{text}" with a length of {length} must be more then {min} characters)r" lengthminzZThe one line summary "{text}" with a length of {length} must be less then {max} characters)r" r$ r# r z+The length of "{text}" must be less then 10)r" zDuplicate help name/alias "z " found while loading help from z'. That name/alias was already taken by N)
lenr r MAX_HELP_NAME_LENformatr r MIN_ONE_LINE_SUMMARY_LENMAX_ONE_LINE_SUMMARY_LENr extendr r )
help_provider
help_name_map
help_name_lenhnaone_line_summary_lenname_check_list
name_or_aliass r SanityCheckr3 D s m--778-
!
0A A L < C C ))339J
D
LL
A
$
$
6
6c J3 7 ] 4 4 J JK
":
: (#$*F &&<<%& %+ %((
: ":
: (#$*F &&<<%& %+ %((
:
]
$
$
.
.
8AHH",,66 I 88
#,,667/ 00BBC&m
% -22 ' 2 2 4
5 5 'r c ( t | z t z |z S )zCHelper for adding help text headers given synopsis and description.)SYNOPSIS_PREFIXDESCRIPTION_PREFIX)synopsis descriptions r CreateHelpTextr9 j s 8 #&8 8; FFr )r
__future__r r r r r gslib.exceptionr ALL_HELP_TYPESr' r) r* r6 r5 objectr r3 r9 r r r r> si D & % ' , "34 11 6 8#5LGr