o  @sPdZddlmZddlmZddlmZddlZddlZddlZddlZddl m Z ddl m Z ddl m Z dd lmZddlZdd lmZdd lmZd d ZddZdddZddZdddZdddZdddZddZ  ddd Zdd!d"Z $ dd%d&Zdd'd(Zdd*d+Z dd,d-Z!d.d/Z"dd0d1Z#d2d3Z$d4d5Z%dd7d8Z&dd:d;Z'dd?Z)d@dAZ*ddCdDZ+ddFdGZ,dHdIZ-ddJdKZ.dLdMZ/ddNdOZ0dPdQZ1ddRdSZ2dTdUZ3ddWdXZ4  ddZd[Z5dd]d^Z6dd_d`Z7ddadbZ8ddcddZ9dedfZ:dgdhZ;ddjdkZddqdrZ?idsedteduedvedwedxedyedzed{ed|e d}e!d~e"de#de$de%de&de'ide(de)de*de+de,de-de/de.de0de1de>de2de3de4de5de6de7e8e9e:e?e;etype conversions. That's why you may see e.g. int(arg) in some of the methods. (5) Unless it is documented to do so, a transform function must not raise any exceptions related to the resource r. The `undefined' arg is used to handle all unusual conditions, including ones that would raise exceptions. Exceptions for arguments explicitly under the caller's control are OK. )absolute_import)division)unicode_literalsN) console_attr)resource_exceptions)resource_property)times)map)urllibcCsb|dvr|S|s dSz |dkrWdSWn tyYnwztt|WSty0YdSw)z"Returns the Boolean value for arg.)TFFfalseT)lowerAttributeErrorboolfloat ValueError)argrL/tmp/google-cloud-sdk/lib/googlecloudsdk/core/resource/resource_transform.pyGetBooleanArgValue?s"   rcCsddlm}||S)z.Returns a parsed key from a dotted key string.r) resource_lex)googlecloudsdk.core.resourcerLexerKey)keyrrrr _GetParsedKeyQs rcCst|t||S)zReturns the value for key in r. Args: r: The resource object. key: The dotted attribute name string. undefined: This is returned if key is not in r. Returns: The value for key in r. )rGetr)rr undefinedrrr GetKeyValueXs rcCs|S)aDMarks a transform sequence to always be applied. In some cases transforms are disabled. Prepending always() to a transform sequence causes the sequence to always be evaluated. Example: `some_field.always().foo().bar()`::: Always applies foo() and then bar(). Args: r: A resource. Returns: r. rrrrrTransformAlwaysfsr cCsb|s|St|trdd|DSt|}dD]}||}|dkr,||ddSq|p0|S)zReturns the last path component. Args: r: A URI or unix/windows file path. undefined: Returns this value if the resource or basename is empty. Returns: The last path component. cSg|]}t|qSr)TransformBaseName.0irrr z%TransformBaseName..)/\rN) isinstancelistsix text_typerfind)rrs separatorr&rrrr#{s    r#cCs|S)zReturns the current resource collection. Args: r: A JSON-serializable object. undefined: This value is returned if r or the collection is empty. Returns: The current resource collection, undefined if unknown. rrrrrrTransformCollections r4c Ks\t|}d|fd|fd|fd|ffD]\}}|r+t||r+tj||fi|Sq|S)a<Colorizes the resource string value. The *red*, *yellow*, *green* and *blue* args are RE patterns, matched against the resource in order. The first pattern that matches colorizes the matched substring with that color, and the other patterns are skipped. Args: r: A JSON-serializable object. red: The substring pattern for the color red. yellow: The substring pattern for the color yellow. green: The substring pattern for the color green. blue: The substring pattern for the color blue. **kwargs: console_attr.Colorizer() kwargs. Returns: A console_attr.Colorizer() object if any color substring matches, r otherwise. Example: `color(red=STOP,yellow=CAUTION,green=GO)`::: For the resource string "CAUTION means GO FASTER" displays the substring "CAUTION" in yellow. redyellowgreenblue)r.r/researchr Colorizer) rr5r6r7r8kwargsstringcolorpatternrrrTransformColors  r@cCsL|siSzi}|D]}||d}|d||<q |WSty%iYSw)a2Counts the number of each item in the list. A string resource is treated as a list of characters. Args: r: A string or list. Returns: A dictionary mapping list elements to the number of them in the input list. Example: `"b/a/b/c".split("/").count()` returns `{a: 1, b: 2, c: 1}`. rr+)get TypeError)rcountitemcrrrTransformCounts  rF%Y-%m-%dT%H:%M:%Sr+c s>zWn tttfyYnw|rt|ndz tt|}Wn ttfy3d}Ynw|durPz t|}t|WStj yOYnwt dgd}|rbt |t jrb||rit|ndztjd}t|WStj yYnwfdd} z| WSttfyY|Sw)a#Formats the resource as a strftime() format. Args: r: A timestamp number or an object with 3 or more of these fields: year, month, day, hour, minute, second, millisecond, microsecond, nanosecond. format: The strftime(3) format. unit: If the resource is a Timestamp then divide by _unit_ to yield seconds. undefined: Returns this value if the resource is not a valid time. tz: Return the time relative to the tz timezone if specified, the explicit timezone in the resource if it has one, otherwise the local timezone. For example: `date(tz=EST5EDT, tz_default=UTC)`. tz_default: The default timezone if the resource does not have a timezone suffix. Returns: The strftime() date format for r or undefined if r does not contain a valid time. Ndatetimetzinfoc sd}g}tj}dD] }t|gd}|dur!t||d}n|d7}|t|q |dtgdD]"\}}t|gd}|durZ|dtt|d|d7<q8|dkrat|tj|}t |S) aReturns the formatted time from broken down time parts in r. Raises: TypeError: For invalid time part errors. ValueError: For time conversion errors or not enough valid time parts. Returns: The formatted time from broken down time parts in r. r)yearmonthdayhourminutesecondNr+) nanosecond microsecond millisecondi) rHnowrrgetattrappendint enumeraterrFormatDateTime)validpartsrVpartvaluer&dtformatrtz_intz_outrr_FormatFromPartss(   $  z'TransformDate.._FormatFromParts) isoformatr rBrr GetTimeZonerGetDateTimeFromTimeStampr[Errorrrr,r. string_types ParseDateTime) rrbunitrtz tz_default timestampr` original_reprrerrar TransformDatesF  $rqcCsL|dkrztt|WSYdD]}z |||WSYq|S)aReturns the decoded value of the resource that was encoded by encoding. Args: r: A JSON-serializable object. encoding: The encoding name. *base64* and *utf-8* are supported. undefined: Returns this value if the decoding fails. Returns: The decoded resource. base64)replacestrict)rrurlsafe_b64decodestrdecode)rencodingrerrorsrrrTransformDecode<srzrUTc Csz t|}t|}Wn ty|YSwt|}|r[z"tt||}|r,t||nd} | r6t| } ntj|jd} Wn tjyJ|YSw| |} tj | |dj ||dSz t |t |} Wn t tfyrd} Ynw| durztj d| |d} | j ||dWStjyYnwz t |} | j ||dWStjyYnwzt|}Wn tjy|YSwtj|jd} | |} tj | |dj ||dS)a`Formats the resource as an ISO 8601 duration string. The [ISO 8601 Duration](https://en.wikipedia.org/wiki/ISO_8601#Durations) format is: "[-]P[nY][nM][nD][T[nH][nM][n[.m]S]]". The 0 duration is "P0". Otherwise at least one part will always be displayed. Negative durations are prefixed by "-". "T" disambiguates months "P2M" to the left of "T" and minutes "PT5M" to the right. If the resource is a datetime then the duration of `resource - current_time` is returned. Args: r: A JSON-serializable object. start: The name of a start time attribute in the resource. The duration of the `end - start` time attributes in resource is returned. If `end` is not specified then the current time is used. end: The name of an end time attribute in the resource. Defaults to the current time if omitted. Ignored if `start` is not specified. parts: Format at most this many duration parts starting with largest non-zero part. precision: Format the last duration part with precision digits after the decimal point. Trailing "0" and "." are always stripped. calendar: Allow time units larger than hours in formatted durations if true. Durations specifying hours or smaller units are exact across daylight savings time boundaries. On by default. Use calendar=false to disable. For example, if `calendar=true` then at the daylight savings boundary 2016-03-13T01:00:00 + P1D => 2016-03-14T01:00:00 but 2016-03-13T01:00:00 + PT24H => 2016-03-14T03:00:00. Similarly, a +P1Y duration will be inexact but "calendar correct", yielding the same month and day number next year, even in leap years. unit: Divide the resource numeric value by _unit_ to yield seconds. undefined: Returns this value if the resource is not a valid timestamp. Returns: The ISO 8601 duration string for r or undefined if r is not a duration. Example: `duration(start=createTime,end=updateTime)`::: The duration from resource creation to the most recent update. `updateTime.duration()`::: The duration since the most recent resource update. NrI)deltacalendar)r] precisionzPT{0}S)r|)rYrrrrkrNowrJriGetDurationFromTimeDeltaFormatrrB ParseDurationrb)rstartendr]r}r|rlrstart_datetime end_value end_datetimer{secondsdurationrrrTransformDurationcsl,     rcCsX|dkrztt|}t|dWS|YSzt||WS|YS)a Returns the encoded value of the resource using encoding. Args: r: A JSON-serializable object. encoding: The encoding name. *base64* and *utf-8* are supported. undefined: Returns this value if the encoding fails. Returns: The encoded resource. rr )rr b64encoder EncodeToBytesSafeTextrstrip)rrxrbrrrTransformEncodes rFc Cst|}t||r dnd}|j|}|s7|r7|jt|d}|r7i}t|D]\}} ||| <q)||j|<|r?|||S|S)a}Returns the enums dictionary description for the resource. Args: r: A JSON-serializable object. projection: The parent ProjectionSpec. enums: The name of a message enum dictionary. inverse: Do inverse lookup if true. undefined: Returns this value if there is no matching enum description. Returns: The enums dictionary description for the resource. z inverse-enumenum)rGetTypeDataNamesymbolsrAr. iteritems) r projectionenumsinverser type_name descriptionsnormalkvrrr TransformEnums    rcCs|dur t|}t|)aRaises an Error exception that does not generate a stack trace. Args: r: A JSON-serializable object. message: An error message. If not specified then the resource is formatted as the error message. Raises: Error: This will not generate a stack trace. N)r.r/rrirmessagerrrTransformErrors  rcs:zfdd|D}dd|DWStygYSw)a,Extract a list of non-empty values for the specified resource keys. Args: r: A JSON-serializable object. *keys: The list of keys in the resource whose non-empty values will be included in the result. Returns: The list of extracted values with empty / null values omitted. csg|]}t|dqSNrr%rrrrr'z$TransformExtract..cSsg|]}|r|qSrrr%rrrrr'r(rB)rkeysvaluesrrrTransformExtract s   rcCst|dur |t|)aRaises an InternalError exception that generates a stack trace. Args: r: A JSON-serializable object. message: An error message. If not specified then the resource is formatted as the error message. Raises: InternalError: This generates a stack trace. N)r InternalErrorr.r/rrrrTransformFatals  rcCs^ddlm}|s |S||j}t|s||r|SdSg}|D] }||r,||q!|S)aHSelects elements of x that match the filter expression. Args: r: A JSON-serializable object. expression: The filter expression to apply to r. Returns: The elements of r that match the filter expression. Example: `x.filter("key:val")` selects elements of x that have 'key' fields containing 'val'. r)resource_filterr!)rrCompileEvaluater IsListLikerX)r expressionrselect transformedrDrrrTransformFilter-s    rcGs(|D]}t||}|dur|SqdS)aReturns the first non-empty attribute value for key in keys. Args: r: A JSON-serializable object. *keys: Keys to check for resource attribute values, Returns: The first non-empty r.key value for key in keys, '' otherwise. Example: `x.firstof(bar_foo, barFoo, BarFoo, BAR_FOO)`::: Checks x.bar_foo, x.barFoo, x.BarFoo, and x.BAR_FOO in order for the first non-empty value. Nr!r)rrrrrrrTransformFirstOfKs  r,csfddt|trEdkrddt|D}n'dkr4fddtt|D}nfddtt|D}|rgt|trgt|d ttfr^fd d|D}ttj|S|pjS) aFormats nested dicts and/or lists into a compact comma separated list. Args: r: A JSON-serializable object. show: If show=*keys* then list dict keys; if show=*values* then list dict values; otherwise list dict key=value pairs. undefined: Return this if the resource is empty. separator: The list item separator string. Returns: The key=value pairs for a dict or list values for a list, separated by separator. Returns undefined if r is empty, or r if it is not a dict or list. Example: `--format="table(field.map(2).list().map().list().list()"`::: Expression with explicit flattening. `--format="table(field.flatten()"`::: Equivalent expression using .flatten(). cst|dS)N)showrr2)TransformFlatten)x)r2rrrrFlattenwsz!TransformFlatten..FlattenrcSg|]}t|qSrr.r/rrrrr'~z$TransformFlatten..rcsg|] \}}t|qSrrr%_rrrrr'scs"g|] \}}dj||dqSz{k}={v})rrrbr%rrrrrr'srcsg|]}|qSrrrrrrr'r( r,dictjoinsortedr.rr-r r/rrrr2r)rr2rrrras(   rc Cszt|}Wn ttfy|YSw|dur%dj||d}|j|dSdj|d}|j|d}|d}|dkrNt||d d}|d krNd j|dS|S) a7Returns the string representation of a floating point number. One of these formats is used (1) ". _precision_ _spec_" if _spec_ is specified (2) ". _precision_" unless 1e-04 <= abs(number) < 1e+09 (3) ".1f" otherwise. Args: r: A JSON-serializable object. precision: The maximum number of digits before and after the decimal point. spec: The printf(3) floating point format "e", "f" or "g" spec character. undefined: Returns this value if the resource is not a float. Returns: The string representation of the floating point number r. Nz{{number:.{precision}{spec}}})r}spec)numberz{{number:.{precision}}}r}ze+r z {number:.1f})rrBrrbfindrY) rr}rrrfmtrepresentationexponent_indexexponentrrrTransformFloats       rcGsL|r|jdd|d|d|}n t|tr|}n|pdg}|j|S)aFormats resource key values. Args: r: A JSON-serializable object. projection: The parent ProjectionSpec. fmt: The format string with {0} ... {nargs-1} references to the resource attribute name arg values. *args: The resource attribute key expression to format. The printer projection symbols and aliases may be used in key expressions. If no args are specified then the resource is used as the arg list if it is a list, otherwise the resource is used as the only arg. Returns: The formatted string. Example: `--format='value(format("{0:f.1}/{1:f.1}", q.CPU.default, q.CPU.limit))'`::: Formats q.CPU.default and q.CPU.limit as floating point numbers. z({0})rT) by_columnsdefaultsr!)compilerrbrrr,r-)rrrargscolumnsrrrTransformFormats   rc Gs|sdSt}d}dd|D}|D]J}|r||nd}|s-|dt|q|dd}|D]!}|rB||d}nd }t||d}|durW|t|q6|d q|S) aFormats a [...] grouped list. Each group is enclosed in [...]. The first item separator is ':', subsequent separators are ','. [item1] [item1] ... [item1: item2] ... [item1: item2] [item1: item2, item3] ... [item1: item2, item3] Args: r: A JSON-serializable object. *keys: Optional attribute keys to select from the list. Otherwise the string value of each list item is selected. Returns: The [...] grouped formatted list, [] if r is empty. z[]NcSr"r)r)r%rrrrr'r(z"TransformGroup.. z[{0}][z, z: ]) ioStringIOwriterbr.r/rrgetvalue) rrbufsep parsed_keysrDsubrr_rrrTransformGroups0    rcC|}|S)aDisables the projection key if the flag name filter expr is false. Args: r: A JSON-serializable object. expr: A command flag filter name expression. See `gcloud topic filters` for details on filter expressions. The expression variables are flag names without the leading *--* prefix and dashes replaced by underscores. Example: `table(name, value.if(NOT short_format))`::: Lists a value column if the *--short-format* command line flag is not specified. Returns: r r)rexprrrrr TransformIfsrTcCst|d|dS)aFormats the resource to numeric ISO time format. Args: r: A JSON-serializable object. undefined: Returns this value if the resource does not have an isoformat() attribute. Returns: The numeric ISO time format for r or undefined if r is not a time. z%Y-%m-%dT%H:%M:%S.%3f%Oz)rbr)rqr3rrr TransformIsos rr)c Cs:zdd|D}||p|WSttfy|YSw)aJoins the elements of the resource list by the value of sep. A string resource is treated as a list of characters. Args: r: A string or list. sep: The separator value to use when joining. undefined: Returns this value if the result after joining is empty. Returns: A new string containing the resource values joined by sep. Example: `"a/b/c/d".split("/").join("!")` returns `"a!b!c!d"`. cSrrrr$rrrr'=rz!TransformJoin..)rr rB)rrrr]rrr TransformJoin,s rcCs zt|WStyYdSw)zReturns the length of the resource if it is non-empty, 0 otherwise. Args: r: A JSON-serializable object. Returns: The length of r if r is non-empty, 0 otherwise. r)lenrBrrrr TransformLenCs   rcCst|tr7|dkr|ddt|DS|dkr(|ddtt|DS|ddtt|DSt|trE|ttj|S|pH|S)aFormats a dict or list into a compact comma separated list. Args: r: A JSON-serializable object. show: If show=*keys* then list dict keys; if show=*values* then list dict values; otherwise list dict key=value pairs. undefined: Return this if the resource is empty. separator: The list item separator string. Returns: The key=value pairs for a dict or list values for a list, separated by separator. Returns undefined if r is empty, or r if it is not a dict or list. rcSrrrrrrrr'crz!TransformList..rcSsg|] \}}t|qSrrrrrrr'fscSsg|] \}}dj||dqSrrrrrrr'hsrrrrr TransformListRs    rcC|r t|tjr |S|S)z_Returns r in lowercase. Args: r: A resource key value. Returns: r in lowercase )r,r.rjr rrrrTransformLowero rcCr)aApplies the next transform in the sequence to each resource list item. Example: ```list_field.map().foo().list()```::: Applies foo() to each item in list_field and then list() to the resulting value to return a compact comma-separated list. ```list_field.*foo().list()```::: ```*``` is shorthand for map(). ```list_field.map().foo().map().bar()```::: Applies foo() to each item in list_field and then bar() to each item in the resulting list. ```abc.xyz.map(2).foo()```::: Applies foo() to each item in xyz[] for all items in abc[]. ```abc.xyz.**foo()```::: ```**``` is shorthand for map(2). Args: r: A resource. depth: The list nesting depth. Returns: r. r)rdepthrrrr TransformMap}srcCs(zdd|DWStygYSw)zRemove null values from the resource list. Args: r: A resource list. Returns: The resource list with None values removed. cSsg|]}|dur|qSrr)r%rrrrr'rz$TransformNotNull..rrrrrTransformNotNulls   rc sd}ittr ntD]}|ds!|ds!||<qfdd}|D]+\}}||}|dur8q+||} | durAq+t|rNdj|| dSdj|| dS|S) aFormats a human readable XY resolution. Args: r: object, A JSON-serializable object containing an x/y resolution. undefined: Returns this value if a recognizable resolution was not found. transpose: Returns the y/x resolution if true. Returns: The human readable x/y resolution for r if it contains members that specify width/height, col/row, col/line, or x/y resolution. Returns undefined if no resolution found. ))widthheight)screenxscreeny)colrow)rlinery__cs.D]}||vrt|gdSqdS)zGets the resolution dimension for d. Args: d: The dimension name substring to get. Returns: The resolution dimension matching d or None. N)rr)dmmemrrr _Dimensions  z'TransformResolution.._DimensionNz {y} x {x}rz {x} x {y})r,rdir startswithendswithr rrb) rr transposenamesrrname_xname_yrrrrrTransformResolutions$    r cGsv|sdStjt|}d|vr|S|pdD]}d|d}||vr,||dSq|dr9|ddS|S)aGets the /args/ suffix from a URI. Args: r: A URI. *args: Optional URI segment names. If not specified then 'regions', 'zones' is assumed. Returns: The URI segment after the first /*args/ in r, the last /-separated component in r if none found. Example: `"http://abc/foo/projects/bar/xyz".scope("projects")` returns `"bar/xyz"`. `"http://xyz/foo/regions/abc".scope()` returns `"abc"`. r!r))regionszonesrThttps://)r parseunquoter.r/splitr)rrscopesegmentrrrTransformScopes   rrTcCsN|s|Stjt|}|d}z |t|p|WSty&|YSw)aReturns the index-th URI path segment. Args: r: A URI path. index: The path segment index to return counting from 0. undefined: Returns this value if the resource or segment index is empty. Returns: The index-th URI path segment in r r))r rrr.r/rrY IndexError)rindexrsegmentsrrrTransformSegments   r0c Cs dd}|s |dur |Szt|}Wn ttfyd}Ynwt|}||kr-|}d} nd} ||\} } || 9}||\} } | rP|| }dj|d}||Sd }d D]}|d kr^|}n|d }qT|rid |}|t|krxd | t||Sdj|d}|| ||S)aCFormats a human readable size in bytes. Args: r: A size in bytes. zero: Returns this if size==0. Ignored if None. precision: The number of digits displayed after the decimal point. units_in: A unit suffix (only the first character is checked) or unit size. The size is multiplied by this. The default is 1.0. units_out: A unit suffix (only the first character is checked) or unit size. The size is divided by this. The default is 1.0. min: Sizes < _min_ will be listed as "< _min_". Returns: A human readable scaled size in bytes. c Sspdddddd}z dt|pdfWSttfyYnwz |d }|||fWStttfy7Yd Sw) zReturns the unit size for unit, 1.0 for unknown units. Args: unit: The unit suffix (only the first character is checked), the unit size in bytes, or None. Returns: A (unit_suffix, unit_size) tuple. iii@ll )KMGrPr!?r)r!r)rrBrupperrKeyError)rl unit_size unit_suffixrrr_UnitSuffixAndSize-s$  z)TransformSize.._UnitSuffixAndSizeNrz< r!z{{0:.{precision}f}}rPiB)bytesKiBMiBGiBTiBr$g@rz {0}{1}{2}z{{0}}{{1:.{precision}f}}{{2}})rrBrrbrY)rzeror}units_in units_outminr#sizemin_sizeprefixr units_in_sizeunits_out_suffixunits_out_sizerthe_unitrlrrr TransformSizes@         r5:c Cs|}|s|Szdddd|dDD}Wntttfy'|YSwt|dkr9||ddp7dz t|t|pC|WSttt fyR|YSw) aReturns a list slice specified by op. The op parameter consists of up to three colon-delimeted integers: start, end, and step. The parameter supports half-open ranges: start and end values can be omitted, representing the first and last positions of the resource respectively. The step value represents the increment between items in the resource included in the slice. A step of 2 results in a slice that contains every other item in the resource. Negative values for start and end indicate that the positons should start from the last position of the resource. A negative value for step indicates that the slice should contain items in reverse order. If op contains no colons, the slice consists of the single item at the specified position in the resource. Args: r: A JSON-serializable string or array. op: The slice operation. undefined: Returns this value if the slice cannot be created, or the resulting slice is empty. Returns: A new array containing the specified slice of the resource. Example: `[1,2,3].slice(1:)` returns `[2,3]`. `[1,2,3].slice(:2)` returns `[1,2]`. `[1,2,3].slice(-1:)` returns `[3]`. `[1,2,3].slice(: :-1)` returns `[3,2,1]`. `[1,2,3].slice(1)` returns `[2]`. cSsg|] }|r t|ndqSr)rY)r%sprrrr'sz"TransformSlice..css|]}|VqdSr)strip)r%prrr sz!TransformSlice..r6r+rN) r8rr rBrrrXr-slicer )ropropsrrrTransformSlicels'" r>cs |sgSfdd}t||dS)aoSorts the elements of the resource list by a given attribute (or itself). A string resource is treated as a list of characters. Args: r: A string or list. attr: The optional field of an object or dict by which to sort. Returns: A resource list ordered by the specified key. Example: `"b/a/d/c".split("/").sort()` returns `[a, b, c, d]`. css|St|Srr)rDattrrrSortKeys zTransformSort..SortKey)r)r)rr@rArr?r TransformSorts  rBc Cs2|s|Sz||WStttfy|YSw)aPSplits a string by the value of sep. Args: r: A string. sep: The separator value to use when splitting. undefined: Returns this value if the result after splitting is empty. Returns: A new array containing the split components of the resource. Example: `"a/b/c/d".split()` returns `["a", "b", "c", "d"]`. )rr rBr)rrrrrrTransformSplits rCcCstzt|}Wn ty|YSwzt|rtjnd}tjtjB|B}t|||||WStjy9|YSw)aeReplaces a pattern matched in a string with the given replacement. Return the string obtained by replacing the leftmost non-overlapping occurrences of pattern in the string by replacement. If the pattern isn't found, then the original string is returned unchanged. Args: r: A string pattern: The regular expression pattern to match in r that we want to replace with something. replacement: The value to substitute into whatever pattern is matched. count: The max number of pattern occurrences to be replaced. Must be non-negative. If omitted or zero, all occurrences will be replaces. ignorecase: Whether to perform case-insensitive matching. Returns: A new string with the replacements applied. Example: `table(field.sub(" there", ""))`::: If the field string is "hey there" it will be displayed as "hey". r) rYrrr9 IGNORECASE MULTILINEDOTALLrerror)rr? replacementrC ignorecaseflagsrrr TransformSubs  rKcGr)a:Synthesizes a new resource from the schema arguments. A list of tuple arguments controls the resource synthesis. Each tuple is a schema that defines the synthesis of one resource list item. Each schema item defines the synthesis of one synthesized_resource attribute from an original_resource attribute. There are three kinds of schema items: *name:literal*::: The value for the name attribute in the synthesized resource is the literal value. *name=key*::: The value for the name attribute in the synthesized_resource is the value of key in the original_resource. *key*::: All the attributes of the value of key in the original_resource are added to the attributes in the synthesized_resource. ::: Args: r: A resource list. *args: The list of schema tuples. Example: This returns a list of two resource items::: `synthesize((name:up, upInfo), (name:down, downInfo))` If upInfo and downInfo serialize to::: `{"foo": 1, "bar": "yes"}` and::: `{"foo": 0, "bar": "no"}` then the synthesized resource list is::: `[{"name": "up", "foo": 1, "bar": "yes"}, {"name": "down", "foo": 0, "bar": "no"}]` This could then be displayed by a nested table using::: `synthesize(...):format="table(name, foo, bar)"` Returns: A synthesized resource list. r)rrrrrrTransformSynthesizes,rLcCr)z_Returns r in uppercase. Args: r: A resource key value. Returns: r in uppercase )r,r.rjrrrrrTransformUpper/rrM.cCsXdd}t|tjr|dr|S|S|r*dD]}|t||gd}|r)|Sq|S)zGets the resource URI. Args: r: A JSON-serializable object. undefined: Returns this if a the URI for r cannot be determined. Returns: The URI for r or undefined if not defined. cSs2z|}Wn tyYnwt|tjr|SdS)zReturns the string value for attr or None if the value is not a string. Args: attr: The attribute object to get the value from. Returns: The string value for attr or None if the value is not a string. N)rBr,r.rjr?rrr_GetAttrHs   zTransformUri.._GetAttrr)selfLinkSelfLinkN)r,r.rjrrr)rrrOnameurirrr TransformUri=s  rTNocCs|r |dur|S|S|S)aWReturns no if the resource is empty, yes or the resource itself otherwise. Args: r: A JSON-serializable object. yes: If the resource is not empty then returns _yes_ or the resource itself if _yes_ is not defined. no: Returns this value if the resource is empty. Returns: yes or r if r is not empty, no otherwise. Nr)ryesnorrrTransformYesNobs rXc CsR|s|Sz|rt|}||r|p|WSW|SW|Stttfy(Y|Sw)aReturns does_match or r itself if r matches expression, nomatch otherwise. Args: r: A String. expression: expression to apply to r. does_match: If the string matches expression then return _does_match_ otherwise return the string itself if _does_match_ is not defined. nomatch: Returns this value if the string does not match expression. Returns: does_match or r if r matches expression, nomatch otherwise. )r9compilematchr rBr)rr does_matchnomatchmatch_rerrrTransformRegexqs    r^c CsZzt|}Wntttfy|YSw|dkr|St||kr#|S|d|ddS)aReturns r if less than limit, else abbreviated r followed by ellipsis. Args: r: A string. character_limit: An int. Max length of return string. Must be greater than 3 because ellipsis (3 chars) is appended to abridged strings. undefined: A string. Return if r or character_limit is invalid. Returns: r if below character_limit or invalid character_limit (non-int or not greater than 3), else abridged r. rUNz...)rYr rBrr)rcharacter_limitrcharacter_limit_intrrrTransformTrailOffs  raalwaysbasename collectionr>rCdaterwrencoderrGextractfatalfilterfirstofflattenrrbgroupifisorrr r-r notnullregex resolutionrrr.r;sort)rr synthesizetrailoffrrSyesno)z,googlecloudsdk.api_lib.cloudbuild.transforms GetTransforms)z)googlecloudsdk.api_lib.compute.transformsrv)z+googlecloudsdk.api_lib.container.transformsrv)z'googlecloudsdk.api_lib.debug.transformsrv)z+googlecloudsdk.api_lib.functions.transformsrv)z0googlecloudsdk.api_lib.runtime_config.transformsrv)z'googlecloudsdk.command_lib.dns.dns_keysrv) cloudbuildcompute containerdebug functions runtimeconfigdnscCsP|dvrtS|dd}t|d\}}|sdSt||gd}t||}|S)aPReturns the builtin or collection specific transform symbols dict. Args: collection: A collection, None or 'builtin' for the builtin transforms. Raises: ImportError: module_path __import__ error. AttributeError: module does not contain method_name. Returns: The transform symbols dict, None if there is none. )NbuiltinrNr)NNN)fromlist)_BUILTIN_TRANSFORMSr_API_TO_TRANSFORMSrA __import__rW)rdapi module_path method_namemodulemethodrrrrvs  rvobjectcCsdj||dS)zReturns the data name for name of type type_name. Args: name: The data name. type_name: The data type name. Returns: The data name for name of type type_name. z{name}::{type_name}rRrrrrrrrs rr)r!)NNNN)rGr+r!NN)r!r!rUrUTr+r!)Fr!)r!r!r)rNr!)r)r)r!)r+)r!F)rTr!)rr+NNr)r6r!)rT)rN)NrU)Nr!)r)D__doc__ __future__rrrrrrHrr9googlecloudsdk.core.consolerrrrgooglecloudsdk.core.utilrr. six.movesr r rrrr r#r4r@rFrqrzrrrrrrrrrrrrrrrrrrrrr rrr5r>rBrCrKrLrMrTrXr^rarrrvrrrrrs0               a' g     ,/-     7 " Q ?  $0  %        !"#1