(dZddlmZddlmZddlmZddlmZddlmZddl m Z ddl m Z dd l m Z dd l m Z dd l mZdd l mZdd l mZddlmZdZdZdZej,ej.ej0j2Gddej4Zej,ej.ej0j8GddeZy)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.  c@eZdZdZeedZedZedZ dZ y)Ls'List Cloud Storage buckets and objects. DESCRIPTIONEXAMPLESc"|jddd|jdddd |jd d dd |jd ddd |jdd|jddd |jddddd |jd}|jdddd |jdddd |jd!d"dd# tj|tj|d$%tj |d$&tj |tj||jtjjk(rtj|y'y')(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.pyArgszLs.Argshs  I    8     )     L      B      $$6$2M  L    ?    F  %%f- vtD 00F ((0 ' T..444 $$V,5cZt|dd}t|dd}t|dd}|||fS)zGet the args for the command. soft_deletedF all_versionsbuckets)getattr)r,argsr3r4r5s r/ _get_argsz Ls._get_argss;47L47LdIu-G w ..r1ctj||j|\}}}|r|rtjd|r|rtjdt j |}d}|js |jr-tj|j|jd}ntjjdzg}t|dd}|D cgc]} tj | } } | D]} t#| tj$s.t'j(d j+| j,|2| j.tjk7rt'j0d | j.tjusd}|j2rt4j6j8} nh|j:rt4j6j<} nA|j>rt4j6j@} nt4j6jB} tEjF| || |jHt|d d |jJdt|d dt jL||jN|jP||xr|| jS|r#|j2rtjdyyycc} w)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_storer8rwarningr check_if_use_gsutil_stylerread_paths_from_stdinr get_urls_iterablerDEFAULT_PROVIDERvaluer6rstorage_url_from_string isinstanceCloudUrlr InvalidUrlErrorformat url_stringschemeErrorfullr DisplayDetailFULLjsonJSONlongLONGSHORTr LsExecutorr@etagget_object_state_from_flagsrE recursive list_urls) selfr7r3r4r5rGfound_non_default_providerpathsr;r storage_urlsurlr?s r/RunzLs.Runsd((. +/..*>'L,  kk A < kkOP66t<!& yyD.... ))T//Te))//%78ed$5t66t<**~~)$5#ik!dii kkNO'0!QQs(K$N) __name__ __module__ __qualname____doc___COMMAND_DESCRIPTION _GA_EXAMPLES detailed_help classmethodr0r8rkr1r/rr\sH0*- ^-^-@//KPr1rc eZdZdZeeezdZy)LsAlpharrN)rlrmrnrorprq_ALPHA_EXAMPLESrrrtr1r/rvrvs0*0-r1rvN)ro __future__rrrgooglecloudsdk.api_lib.storagergooglecloudsdk.callioper"googlecloudsdk.command_lib.storagerr r r r r rgooglecloudsdk.corerrprqrwUniverseCompatible ReleaseTracksr)GACommandrr*rvrtr1r/rs /&'4(>548>=:# / `D%%(()~P~P*~PBD%%++,b-r1