
                             d Z ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlm	Z	 dZ
ej                   G d	 d
ej                               Zy)zList Artifact Registry files.    )absolute_import)division)unicode_literals)base)	file_util)flagsa      table(
      name.basename().sub("%2F", "/").sub("%2B", "+").sub("%5E", "^"):label=FILE,
      createTime.date(tz=LOCAL),
      updateTime.date(tz=LOCAL),
      sizeBytes.size(zero='0',precision=3,units_out=M):label="SIZE (MB)",
      owner:label=OWNER,
      annotations
    )c                   0    e Zd ZdZdddZed        Zd Zy)ListzList Artifact Registry files.

  List all Artifact Registry files in the specified repository and location.

  To specify the maximum number of files to list, use the --limit flag.
  z{description}a	        To list files in the current project under repository `my-repo` in `us`:

          $ {command} --repository=my-repo --location=us

      The following command lists a maximum of five files:

          $ {command} --repository=my-repo --location=us --limit=5

      To list files in the current project under repository `my-repo` in `us` owned by package `my-package`:

          $ {command} --repository=my-repo --location=us --package=my-package

      To list files in the current project under repository `my-repo` in `us` owned by package `my-package` and version `1.0.0`:

          $ {command} --repository=my-repo --location=us --package=my-package --version=1.0.0

      To list files in the current project under repository `my-repo` in `us` owned by package `my-package` and tag name `my-tag`:

          $ {command} --repository=my-repo --location=us --package=my-package --tag=my-tag

      To list files with name as `my-file`:

          $ {command} --filter='name="projects/my-project/locations/us/repositories/my-repo/files/my-file"'

      To list files with a given partial name, use `*` to match any character in name:

          $ {command} --filter='name="projects/my-project/locations/us/repositories/my-repo/files/*file"'

          $ {command} --filter='name="projects/my-project/locations/us/repositories/my-repo/files/my-*"'

      To list files that have annotations:

          $ {command} --filter=annotations:*

      To list files with annotations pair as [annotation_key: annotation_value]

          $ {command} --filter='annotations.annotation_key:annotation_value'

      To list files with annotations containing key as `my_key`:

          $ {command} --filter='annotations.my_key'

          If the key or value contains special characters, such as `my.key` and `my.value`, backtick("`") is required:

          $ {command} --filter='annotations.`my.key`'

          $ {command} --filter='annotations.`my.key`:`my.value`'

      To list files with given partial annotation key or value, use `*` to match any character:

          $ {command} --filter='annotations.*key:`*.value`'

      To list files in the current project under repository `my-repo` in `us`, ordering by create_time:

          $ {command} --repository=my-repo --location=us --sort-by=create_time

      To list files in the current project under repository `my-repo` in `us`, ordering by update_time reversely:

          $ {command} --repository=my-repo --location=us --sort-by=~update_time

      )DESCRIPTIONEXAMPLESc                 >   | j                   j                  t               t        j                  j                  |        t        j                         j                  |        | j                  ddd       | j                  ddd       | j                  ddd       y )	Nz	--packageFzList all files in a specified artifact, such as a container image or a language package. If you do not use --tag or --version in the command, the command lists files in all versions of the artifact.)requiredhelpz	--versionzaList all files in the specified artifact version. Use the --package flag to specify the artifact.z--tagzList all files in the artifact version with the specified tag. This flag only works with formats that use tags, such as container images. Use the --package flag to specify the artifact.)
display_info	AddFormatDEFAULT_LIST_FORMATr   URI_FLAGRemoveFromParserr   GetRepoFlagAddToParseradd_argument)parsers    #lib/surface/artifacts/files/list.pyArgsz	List.Argsq   s    
!!"56MM""6*	##F+
 V  
 p  
  I      c                 ,    t        j                  |      S )zThis is what gets called when the user runs this command.

    Args:
      args: an argparse namespace. All the arguments that were provided to this
        command invocation.

    Returns:
      A list of files.
    )r   	ListFiles)selfargss     r   RunzList.Run   s     t$$r   N)__name__
__module____qualname____doc__detailed_helpstaticmethodr   r     r   r   r
   r
   $   s3     =
	B-H  (%r   r
   N)r$   
__future__r   r   r   googlecloudsdk.callioper   $googlecloudsdk.command_lib.artifactsr   r   r   DefaultUniverseOnlyListCommandr
   r'   r   r   <module>r-      sN    $ &  ' ( : 6	  l%4 l% l%r   