
                             S r SSKJr  SSKJr  SSKJr  SSKJr  SSKJr  SSKJ	r	  Sr
\R                   " S	 S
\R                  5      5       rg)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                   8    \ rS rSrSrSSS.r\S 5       rS rSr	g	)
List"   zList 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                     U R                   R                  [        5        [        R                  R                  U 5        [        R                  " 5       R                  U 5        g )N)	display_info	AddFormatDEFAULT_LIST_FORMATr   URI_FLAGRemoveFromParserr   GetRepoFlagAddToParser)parsers    &lib/surface/artifacts/packages/list.pyArgs	List.Args^   s@    
!!"56MM""6*	##F+    c                 .    [         R                  " U5      $ )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   RunList.Rund   s     $$T**r    N)
__name__
__module____qualname____firstlineno____doc__detailed_helpstaticmethodr   r   __static_attributes__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   