dZddlmZddlmZddlmZddlZddlmZddlZejejGddejZ y) aThe Cloud SDK completion cache. A completion cache is a persistent cache that stores the current list of names for resources visible to the caller. The cache generates lists of resources that match prefixes and/or patterns, suitable for command line completers. The name representation is resource specific. See core.resource.resource_style for details. Refer to the resource_cache module for a detailed description of resource parsing and representation. +---------------------------+ | completion cache | | +-----------------------+ | | | completer | | | +-----------------------+ | | ... | +---------------------------+ A completion cache is implemented as an extended ResourceCache object that contains Completer objects. A Completer object: * has a Complete() method that returns resource strings matching a pattern * has methods to convert between strings and parameter tuples * has an underlying ResourceCache Collection object that holds parameter tuples * derives from resource_cache.Updater to update the collection parameter tuples This module is resource agnostic. All resource specific information is encapsulated in resource specific Completer objects. )absolute_import)division)unicode_literalsN)resource_cachecfeZdZdZej dZdZej ddZdZ y) CompleteraNA completion cache resource string completer. Along with the Complete() method, a completer has two main functions, each handled by a mixin: (1) Convert between resource string and parameter tuple representations. (2) Retrieve the current list of resources for the collection. See resource_cache.Updater for details. cy)zReturns the row representation of string. May fill in some column values Args: string: The resource string representation. Returns: The row representation of string. N)selfstrings 1lib/googlecloudsdk/core/cache/completion_cache.py StringToRowzCompleter.StringToRowE ct|}t||jkr|dg|jt|z zz }|Dcgc] }d|vr|n|dzc}Scc}w)aReturns the row template of row for the Resource.Complete method. By default all parameters are treated as prefixes. Args: row: The resource parameter tuple. Returns: The row template of row for the Resource.Complete method. *)listlencolumns)r row row_templatecs r RowToTemplatezCompleter.RowToTemplateSsb9L 3x$,,rddllSX566l0< = 1Aq3w & == =sANcy)aReturns the string representation of row. Args: row: The resource parameter tuple. parameter_info: A ParamaterInfo object for accessing parameter values in the program state. Returns: The string representation of row. Nr )r rparameter_infos r RowToStringzCompleter.RowToStringcrrc|j|}|j|}|j||}|Dcgc]}|j||c}Scc}w)aReturns the list of strings matching prefix. Args: prefix: The resource prefix string to match. parameter_info: A ParamaterInfo object for accessing parameter values in the program state. Returns: The list of strings matching prefix. )rrSelectr)r prefixrrrrowss r CompletezCompleter.CompleteqsY   6 "C%%c*L ;;|^ 4D=A BTcD  S. 1T BB BsA)N) __name__ __module__ __qualname____doc__abcabstractmethodrrrr"r rr rr:sF    >     Crr) r& __future__rrrr'googlecloudsdk.core.cachersix add_metaclassABCMetaUpdaterrr rr r/sV >'' 4 3;;DC&&DC DCr