> S r SSKJr SSKJr SSKJr SSKJr SSKrSSKrSSKJ r SSK
J r SS K
J r SS
K
J
r
SS KJr SS KJr SS
KJr SSKJr SSKJr SSKJr SSKJr SSKJr SSKJ r SSK J r SSK J r SSK J r SSK!J"r" Sr#S\#- S- r$ " S S \5 r%g) zEImplementation of Unix-like stat command for cloud storage providers. )absolute_import)print_function)division)unicode_literalsN)BucketListingObject)AccessDeniedException)EncryptionException)NotFoundException)Command)CommandArgument) ApiSelector)CommandException)InvalidUrlError)NO_URLS_MATCHED_TARGET)ContainsWildcard)StorageUrlFromString)NO_MAX)ENCRYPTED_FIELDS)PrintFullInfoAboutObject) UNENCRYPTED_FULL_LISTING_FIELDS)GcloudStorageMapz
gsutil stat url...
z
SYNOPSIS
a
DESCRIPTION
The stat command outputs `object metadata
`_ for the specified object
URLs. It is similar to running:
gsutil ls -L gs://some-bucket/some-object
but is more efficient because it avoids listing objects and gets the minimum
necessary amount of object metadata. Moreover, because it avoids listing
objects (which for some storage providers are eventually consistent) the
``gsutil stat`` command provides a strongly consistent way to check for the
existence (and read the metadata) of an object.
The ``gsutil stat`` command does, however, make listing object requests if
you specify URLs using wildcards.
If run with the ``gsutil -q`` option nothing is printed, e.g.:
gsutil -q stat gs://some-bucket/some-object
This behavior can be useful when writing scripts: even though nothing is
printed from the command, it still has an exit status of 0 for an existing
object and 1 for a non-existent object.
NOTE: Unlike the gsutil ls command, the stat command does not support
operations on sub-directories. For example, if you run the command:
gsutil -q stat gs://some-bucket/some-subdir/
gsutil looks for information about an object called "some-subdir/" (with a
trailing slash) inside the bucket "some-bucket", as opposed to operating on
objects nested under gs://some-bucket/some-subdir/. Unless you actually have
an object with that name, the operation fails. However, you can use the stat
command on objects within subdirectories. For example, this command works
as expected:
gsutil -q stat gs://some-bucket/some-subdir/file.txt
c \ rS rSrSr\R " S/ \S\SSSS\ R \ R /\ R \ R " 5 /S9 r\R " S/ S S
\0 S 9r\" / S Q0 S
9rS rSrg) StatCommand] z&Implementation of gsutil stat command.stat Fr ) command_name_aliasesusage_synopsismin_argsmax_argssupported_sub_args file_url_okprovider_url_okurls_start_arggs_api_supportgs_default_apiargparse_arguments command_helpzDisplay object status) help_namehelp_name_aliases help_typehelp_one_line_summary help_textsubcommand_help_text)storageobjectslistz --fetch-encrypted-object-hashesz--stat)gcloud_commandflag_mapc
[ [ - nSnU R GH nSn[ U5 nUR 5 ( d [ S5 e [
U5 ( a U R U5 R US9nOP U R R UR UR UR UR US9n[! XWS9/nU Hb nUR 5 ( d M US-
n[" R$ " 5 R' [" R( 5 ( d MX [+ USS9 Md U( a GM# [" R$ " 5 R' [" R( 5 ( a) [. R0 R3 [8 U- S
- 5 S nGM U( a gg! [ aM U R R UR UR UR UR [ S9n GNBf = f! [, a` [" R$ " 5 R' [" R( 5 ( a% [. R0 R3 S U- S
- 5 GN=[4 a e [6 a GNSf = f) z%Command entry point for stat command.Fr z,The stat command only works with object URLs)bucket_listing_fields)
generationproviderfields) root_objectr )incl_aclz+You aren't authorized to read %s - skipping
T) r r argsr IsObjectr r WildcardIterator IterObjects
gsutil_apiGetObjectMetadata bucket_name object_namer7 schemer r logging getLogger isEnabledForINFOr r sysstderrwriter r
r ) self stat_fieldsfound_nonmatching_argurl_str arg_matchesurlblr_iter
single_objblrs &platform/gsutil/gslib/commands/stat.py
RunCommandStatCommand.RunCommand s "%DDK !99k )c
\\^^ MNN"
G $ $**73??$/ @ 1( 8 :: >> " ; $J *#FG(C
\\^^ 1 K "// ==&sU; [ + +GLL 9 9
**
1G;dB
C $ W X
; % 8 :: >> 6 ; 8J 8 # + + +GLL 9 9
**
I" #%) * +
sK /H >AF/"H ):H 'H /AHH HH A&J 2J J N)__name__
__module__ __qualname____firstlineno____doc__r CreateCommandSpec _SYNOPSISr r
XMLJSONr MakeZeroOrMoreCloudURLsArgument command_specHelpSpec_DETAILED_HELP_TEXT help_specr gcloud_storage_maprW __static_attributes__rY rV r r ] s . **
//
!%%
9
9
; ,( 3#
) (
2
rj r )&r^
__future__r r r r rF rJ gslib.bucket_listing_refr gslib.cloud_apir r r
gslib.commandr gslib.command_argumentr gslib.cs_api_mapr
gslib.exceptionr r r gslib.storage_urlr r gslib.utils.constantsr gslib.utils.ls_helperr r r gslib.utils.shim_utilr r` rf r rY rj rV rv s L & % '
8 1 / - ! 2 ( , + 2 . 2 ( 2 : A 2
(* \_
' _
rj