D*SrSSKJr SSKJr SSKJr SSKJr SSKJr SSK J r SSK J r SS K J r SS K J r SS K Jr SS K Jr SS K Jr SSKJr SrSrSr\R,\R."\R0R25"SS\R4555r\R,\R."\R0R85"SS\555rg)z(Command to list Cloud Storage resources.)absolute_import)division)unicode_literals) cloud_api)base)encryption_util)errors)flags) list_util)ls_command_util)stdin_iterator) storage_url)logz List your Cloud Storage buckets in a project and objects in a bucket. This command treats forward slashes in object names as directories. See below for examples of how to use wildcards to get the listing behavior you want. a The following command lists the buckets in the default project: $ {command} The following command lists the buckets in the specified project: $ {command} --project=my-project The following command lists the contents of a bucket: $ {command} gs://my-bucket You can use [wildcards](https://cloud.google.com/storage/docs/wildcards) to match multiple paths (including multiple buckets). Bucket wildcards are expanded to match only buckets contained in your current project. The following command matches ``.txt'' objects that begin with ``log'' and that are stored in buckets in your project that begin with ``my-b'': $ {command} gs://my-b*/log*.txt You can use double-star wildcards to match zero or more directory levels in a path. The following command matches all ``.txt'' objects in a bucket. $ {command} gs://my-bucket/**/*.txt The wildcard `**` retrieves a flat list of objects in a single API call and does not match prefixes. The following command would not match `gs://my-bucket/dir/log.txt`: $ {command} gs://my-bucket/**/dir Double-star expansion also can not be combined with other expressions in a given path segment and operates as a single star in that context. For example, the command `gs://my-bucket/dir**/log.txt` is treated as `gs://my-bucket/dir*/log.txt`. To get the recursive behavior, the command should instead be written the following way: gs://my-bucket/dir*/**/log.txt The following command lists all items recursively with formatting by using `--recursive`: $ {command} --recursive gs://bucket Recursive listings are similar to `**` except recursive listings include line breaks and header formatting for each subdirectory. ao The following command filters objects based on specified filter while listing. Note that the flag is only supported for Google Cloud Storage URLs and only applies to objects. This means that directories or buckets will still be listed even if they do not contain objects that match the filter. $ {command} gs://my-bucket --metadata-filter='contexts."foo"="bar"' cH\rSrSrSr\\S.r\S5r \S5r Sr Sr g) Lsc'List Cloud Storage buckets and objects. DESCRIPTIONEXAMPLEScURSSSS9 URSSSSS 9 URS S SS S 9 URS SSSS 9 URSSS9 URSSSS 9 URSSSSSS 9 URSS9nURSSSSS 9 URSSSS S 9 URS!S"SS#S 9 [R"U5 [R"US$S%9 [R "US$S&9 [R "U5 [R"U5 UR5[RR:Xa[R"U5 g'g')(z-Edit argparse.ArgumentParser for the command.path*zzThe path of objects and directories to list. The path must begin with gs:// and is allowed to contain wildcard characters.)nargshelpz-az--all-versions store_trueaInclude noncurrent object versions in the listing. This flag is typically only useful for buckets with [object versioning](https://cloud.google.com/storage/docs/object-versioning) enabled. If combined with the `--long` option, the metageneration for each listed object is also included.)actionrz-bz --bucketszWhen given a bucket URL, only return buckets. Useful for avoiding the rule that prints the top-level objects of buckets matching a query. Typically used in combination with `--full` to get the full metadata of buckets.z-ez--etagz=Include ETag metadata in listings that use the `--long` flag.z--formatzUse "gsutil" to get the style of the older gsutil CLI. (e.g. "--format=gsutil"). Other format values (e.g. "json") do not work. See different ls flags and commands for alternative formatting.)rz--readable-sizeszgWhen used with `--long`, print object sizes in human readable format, such as 1 KiB, 234 MiB, or 2 GiB.z-Rz-rz --recursivezPRecursively list the contents of any directories that match the path expression.True)mutexz-lz--longz=For objects only. List size in bytes, creation time, and URL.z-Lz--fullz0List all available metadata about items in rows.z-jz--jsonz7List all available metadata about items as a JSON dump.T)command_only_reads_data)is_listN) add_argument add_groupr add_additional_headers_flagadd_encryption_flags&add_fetch_encrypted_object_hashes_flagadd_read_paths_from_stdin_flagadd_soft_delete_flags ReleaseTrackrALPHAadd_metadata_filter_flag)clsparser output_styless lib/surface/storage/ls.pyArgsLs.Argsos  I    8     )     L      B      $$6$2M  L    ?    F  %%f- vtD 00F ((0 ' T..444 $$V,5cX[USS5n[USS5n[USS5nX#U4$)zGet the args for the command. soft_deletedF all_versionsbuckets)getattr)r,argsr4r5r6s r/ _get_args Ls._get_argss947L47LdIu-G w ..r2cv[R"U5 URU5up#nU(aU(a[R"S5 U(aU(a[R"S5 [ R "U5nSnUR(dUR(a+[R"URURSS9nO[RRS-/n[USS5nUV s/sHn [R "U 5PM n n U Hn [#U [R$5(d/[&R("S R+U R,55eUb4U R.[R:wa[&R0"S 5eU R.[RLdMSnM UR2(a6R8n OrUR:(a6R<n OFUR>(a6R@n O[4R6RBn [DRF"U UU URH[US S5(+URJS[US S5[ RL"U5URNURPUU=(a UUS 9RS5 U(a)UR2(a[R"S5 gggs sn f)zCommand execution logic.zThe --all-versions flag has no effect when used with the --soft-deleted flag. When --soft-deleted is used, all soft-deleted versions of the resource are returned.z;The --all-versions flag has no effect when listing buckets.FT) allow_emptyz://metadata_filterNz+Ls only works for cloud URLs. Error for: {}z/Metadata filter is only supported for GCS URLs. exhaustivenext_page_token) buckets_flagdisplay_detailfetch_encrypted_object_hasheshalt_on_empty_response include_etaginclude_managed_foldersr? object_statereadable_sizesrecursion_flaguse_gsutil_stylesoft_deleted_buckets list_filterz:For additional metadata information, please run ls --json.)*rinitialize_key_storer9rwarningr check_if_use_gsutil_stylerread_paths_from_stdinr get_urls_iterablerDEFAULT_PROVIDERvaluer7rstorage_url_from_string isinstanceCloudUrlr InvalidUrlErrorformat url_stringschemeErrorfullr DisplayDetailFULLjsonJSONlongLONGSHORTr LsExecutorrBetagget_object_state_from_flagsrG recursive list_urls) selfr8r4r5r6rIfound_non_default_providerpathsr=r storage_urlsurlrAs r/RunLs.Runse((. +/..*>'L  kk A < kkOP66t<!& yyD.... ))T//Te))//%78ed$5t66t<**~~)$5#ik!dii kkNO'0!QQs L6N) __name__ __module__ __qualname____firstlineno____doc___COMMAND_DESCRIPTION _GA_EXAMPLES detailed_help classmethodr0r9rm__static_attributes__ror2r/rrcsH0*- ^-^-@//KPr2rc(\rSrSrSr\\\-S.rSr g)LsAlphai&rrroN) rprqrrrsrtrurv_ALPHA_EXAMPLESrwryror2r/r{r{&s0*0-r2r{N)rt __future__rrrgooglecloudsdk.api_lib.storagergooglecloudsdk.callioper"googlecloudsdk.command_lib.storagerr r r r r rgooglecloudsdk.corerrurvr|UniverseCompatible ReleaseTracksr)GACommandrr*r{ror2r/rs /&'4(>548>=:# / `D%%(()~P~P*~PBD%%++,b-r2