
                             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 packages.    )absolute_import)division)unicode_literals)base)flags)package_utilz    table(
         name.sub("%5E", "^"):label=PACKAGE,
         createTime.date(tz=LOCAL),
         updateTime.date(tz=LOCAL),
         annotations
       )c                   0    e Zd ZdZdddZed        Zd Zy)ListzList Artifact Registry packages.

  List all Artifact Registry packages in the specified repository and project.

  To specify the maximum number of packages to list, use the --limit flag.
  z{description}a  
      The following command lists a maximum of five packages:

          $ {command} --limit=5

      To list packages with name as `my-pkg`:

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

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

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

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

      To list files that have annotations:

          $ {command} --filter=annotations:*

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

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

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

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

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

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

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

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

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

      To list packages ordered by create_time:

        $ {command} --sort-by=create_time

      To list packages ordered by update_time reversely:

        $ {command} --sort-by=~update_time
  )DESCRIPTIONEXAMPLESc                     | j                   j                  t               t        j                  j                  |        t        j                         j                  |        y )N)	display_info	AddFormatDEFAULT_LIST_FORMATr   URI_FLAGRemoveFromParserr   GetRepoFlagAddToParser)parsers    &lib/surface/artifacts/packages/list.pyArgsz	List.Args^   s@    
!!"56MM""6*	##F+    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 packages.
    )r   ListPackages)selfargss     r   RunzList.Rund   s     $$T**r   N)__name__
__module____qualname____doc__detailed_helpstaticmethodr   r    r   r   r
   r
   "   s2     -	2-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 =  K+4 K+ K+r   