S r SSKJr SSKJr SSKJr SSKJr SSKrSSKrSSKJ r SSK
J r SS K J
r
SS
KJr SS KJr SS KJr SS
KJr SSKJr \R, ( a \rSrS\- S- r " S S\ 5 rg)zDImplementation of Unix-like cat command for cloud storage providers. )absolute_import)print_function)division)unicode_literalsN)Command)CommandArgument) ApiSelector)CommandException)
cat_helper) constants)GcloudStorageFlag)GcloudStorageMapz
gsutil cat [-h] url...
z
SYNOPSIS
aJ
DESCRIPTION
The cat command outputs the contents of one or more URLs to stdout.
While the cat command does not compute a checksum, it is otherwise
equivalent to doing:
gsutil cp url... -
(The final '-' causes gsutil to stream the output to stdout.)
WARNING: The gsutil cat command does not compute a checksum of the
downloaded data. Therefore, we recommend that users either perform
their own validation of the output of gsutil cat or use gsutil cp
or rsync (both of which perform integrity checking automatically).
OPTIONS
-h Prints short header for each object. For example:
gsutil cat -h gs://bucket/meeting_notes/2012_Feb/*.txt
This would print a header with the object name before the contents
of each text object that matched the wildcard.
-r range Causes gsutil to output just the specified byte range of the
object. Ranges can be of these forms:
start-end (e.g., -r 256-5939)
start- (e.g., -r 256-)
-numbytes (e.g., -r -5)
where offsets start at 0, start-end means to return bytes start
through end (inclusive), start- means to return bytes start
through the end of the object, and -numbytes means to return the
last numbytes of the object. For example:
gsutil cat -r 256-939 gs://bucket/object
returns bytes 256 through 939, while:
gsutil cat -r -5 gs://bucket/object
returns the final 5 bytes of the object.
c " \ rS rSrSr\R " S/ \S\R SSSS\
R \
R /\
R \
R " 5 /S9 r\R " S/ S S
\0 S 9r\" S S/\" S
5 \" S5 S.S9rS rSrg)
CatCommand] z%Implementation of gsutil cat command.cat zhr:Fr ) command_name_aliasesusage_synopsismin_argsmax_argssupported_sub_args file_url_okprovider_url_okurls_start_arggs_api_supportgs_default_apiargparse_arguments command_helpz$Concatenate object content to stdout) help_namehelp_name_aliases help_typehelp_one_line_summary help_textsubcommand_help_textstoragez-d-r)-hr' )gcloud_commandflag_mapc SnSnSnSnU R ( Ga U R GH u pVUS:X a SnM US:X a UR 5 nUS:X a M. [ R " S5 nUR U5 nU( d [ S U- 5 eUR
S
5 ( a [ UR
S
5 5 nUR
S 5 ( a [ UR
S 5 5 nUR
S 5 ( a [ UR
S 5 5 nM M U R 5 GM [ R " U 5 R U R UUUS
9$ )z(Command entry point for the cat command.FNr r( Tr' -z;^(?P[0-9]+)-(?P[0-9]*)$|^(?P-[0-9]+)$zInvalid range (%s)startendendslice) show_header
start_byteend_byte)
sub_optsstriprecompilematchr
grouplong RaiseInvalidArgumentExceptionr CatHelper
CatUrlStringsargs) selfr0
request_ranger1 r2 oa
range_matcher range_matchs %platform/gsutil/gslib/commands/cat.py
RunCommandCatCommand.RunCommand sK KMJH }}}--$! 9 +
$Y'')- c
! **KM-%++M:+ "#7-#GH H
w
'
' k / / 89J
u
%
%K - -e 45H
z
*
* k / /
;rd ss K & % '
! 2 ( , " ! 3 277 $
-/ dEG EGrG