| Server IP : 35.236.43.222 / Your IP : 216.73.216.143 Web Server : Apache System : Linux order-form-vm-001 5.10.0-37-cloud-amd64 #1 SMP Debian 5.10.247-1 (2025-12-11) x86_64 User : deploy ( 1002) PHP Version : 8.1.31 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : OFF | Sudo : ON | Pkexec : OFF Directory : /usr/lib/google-cloud-sdk/lib/surface/storage/__pycache__/ |
Upload File : |
�
��
' � �� � d Z ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddl m
Z
ddl m Z dd l m Z dd
l m
Z
dd l mZ dd l mZ dd
l mZ ddlmZ ej G d� dej � � � � ZdS )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)�logc �N � e Zd ZdZddd�Zed� � � Zed� � � Zd� ZdS ) �Lsz'List Cloud Storage buckets and objects.z� 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.
aL 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.
)� DESCRIPTION�EXAMPLESc �� � |� ddd�� � |� dddd� � � |� d
d dd � � � |� d
ddd� � � |� dd�� � |� ddd� � � |� ddddd� � � |� d�� � }|� dd dd � � � |� d d dd � � � |� d!d"dd#� � � t j |� � t j |d$�%� � t j |d$�&� � t j |� � t j |� � d'S )(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.)�nargs�helpz-az--all-versions�
store_truea Include 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.)�actionr z-bz --bucketsz�When 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--formatz�Use "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.)r z--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_flag�add_encryption_flags�&add_fetch_encrypted_object_hashes_flag� add_read_paths_from_stdin_flag�add_soft_delete_flags)�cls�parser�
output_styless �lib/surface/storage/ls.py�ArgszLs.Argsa s2 � � �����
I� � � � � ��� ���
8� � � � � ��� ���
)� �
�
�
� ��� ���
L� � � � � ����
� � � � � �����
B� � � � � ��� � ���
�
� � � � �$�$�6�$�2�2�M�� � � ���
L� � � � � � � � ���
?� � � � � � � � ���
F� � � � �
�%�f�-�-�-� � �v�t�D�D�D�D� �0���F�F�F�F� �(��0�0�0� � ��'�'�'�'�'� c �r � t |dd� � }t |dd� � }t |dd� � }|||fS )z Get the args for the command.� soft_deletedF� all_versions�buckets)�getattr)r& �argsr- r. r/ s r) � _get_argsz Ls._get_args� sD � � �4� ��7�7�L��4� ��7�7�L��d�I�u�-�-�G� � �w� .�.r+ c �d � t j |� � t j |� � | � |� � \ }}}|r|rt j d� � |r|rt j d� � t j |� � }d}|j s|j
r"t j |j |j
d�� � }nt j j dz g}d� |D � � }|D ]]} t! | t" j � � s,t' j d� | j � � � � �| j t j urd}�^|j rt2 j j }
nC|j rt2 j j }
n*|j rt2 j j }
nt2 j j }
tC j" |||
|j# tI |d d� � |j% dtI |d
d � � t j& |� � |j' |j( ||o|� �
�
�) � � |r |j rt j d
� � d S d S d S )zCommand execution logic.z�The --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://c �6 � g | ]}t j |� � ��S � )r �storage_url_from_string)�.0r s r) �
<listcomp>zLs.Run.<locals>.<listcomp>� s# � �P�P�P�$�K�7��=�=�P�P�Pr+ z+Ls only works for cloud URLs. Error for: {}�
exhaustive�next_page_tokenN) � buckets_flag�display_detail� fetch_encrypted_object_hashes�halt_on_empty_response� include_etag�include_managed_foldersr; � object_state�readable_sizes�recursion_flag�use_gsutil_style�soft_deleted_bucketsz:For additional metadata information, please run ls --json.)*r �RequireProjectIDr �initialize_key_storer2 r �warningr
�check_if_use_gsutil_styler �read_paths_from_stdinr
�get_urls_iterabler �DEFAULT_PROVIDER�value�
isinstancer �CloudUrlr �InvalidUrlError�format�
url_string�scheme�fullr �
DisplayDetail�FULL�json�JSON�long�LONG�SHORTr �
LsExecutorr> r0 �etag�get_object_state_from_flagsrC � recursive� list_urls) �selfr1 r- r. r/ rE �found_non_default_provider�paths� storage_urls�urlr= s r) �RunzLs.Run� s � � ��$� � � ��(��.�.�.�
+/�.�.��*>�*>�'�L�,�� � � � � �k� A�� � � � Q�<� Q� �k�O�P�P�P� �6�t�<�<��!&� � �y� 9�D�.� 9� �.�
�)�T�/�T�� � �e�e� �)�/�%�7�8�e�P�P�%�P�P�P�L�� *� *��
��[� 1�
2�
2�
��$� 9� @� @�� � P� P�
�
�
�
��9�5� 5� 5�%)�"�� �y� 5� �.�3�n�n�
�� 5� �.�3�n�n�
�� 5� �.�3�n�n� �.�4�n�� �� �%�&*�&H�#*�4� �u�#E�#E� E��Y� $� ��&7��>�>��6�t�<�<��*��~�)� $� 5� �� � � �i�k�k�k�!� P�d�i� P�
�k�N�O�O�O�O�O�P� P� P� Pr+ N) �__name__�
__module__� __qualname__�__doc__�
detailed_help� classmethodr* r2 rg r6 r+ r) r r " s� � � � � � �/�/�
� /
�7� 7�-�t �[(� [(� �;�[(�z �/� /� �;�/�EP� EP� EP� EP� EPr+ r N)rk �
__future__r r r � googlecloudsdk.api_lib.storager �googlecloudsdk.callioper �"googlecloudsdk.command_lib.storager r r
r r r
r �googlecloudsdk.corer �UniverseCompatible�Commandr r6 r+ r) �<module>ru sQ �� /� .� &� &� &� &� &� &� � � � � � � '� '� '� '� '� '� 4� 4� 4� 4� 4� 4� (� (� (� (� (� (� >� >� >� >� >� >� 5� 5� 5� 5� 5� 5� 4� 4� 4� 4� 4� 4� 8� 8� 8� 8� 8� 8� >� >� >� >� >� >� =� =� =� =� =� =� :� :� :� :� :� :� #� #� #� #� #� #� ��iP� iP� iP� iP� iP�� � iP� iP� ��iP� iP� iPr+