8lSrSSKJr SSKJr SSKJr SSKrSSKJr SSKJ r SSKJ r SS KJ r "S S \ R5r "S S \ 5r "SS\ \5r"SS\\R"S9r"SS\5r"SS\5r"SS\5r"SS\5r"SS\5rS SjrS SjrSrg)!aClasses to handle dependencies for concepts. At runtime, resources can be parsed and initialized using the information given in the Deps object. All the information given by the user in the command line is available in the Deps object. It may also access other information (such as information provided by the user during a prompt or properties that are changed during runtime before the Deps object is used) when Get() is called for a given attribute, depending on the fallthroughs. )absolute_import)division)unicode_literalsN)util) exceptions) properties) resourcesc\rSrSrSrSrg)Error%z$Base exception type for this module.N__name__ __module__ __qualname____firstlineno____doc____static_attributes__r ,lib/googlecloudsdk/calliope/concepts/deps.pyr r %s,rr c\rSrSrSrSrg)FallthroughNotFoundError)zDRaised when an attribute value is not found by a Fallthrough object.r Nrr rrrr)sLrrc\rSrSrSrSrg)AttributeNotFoundError-z@Raised when an attribute value cannot be found by a Deps object.r Nrr rrrr-sHrrcn\rSrSrSrS SjrSr\RS5r Sr \ S5r Sr S rS rg ) _FallthroughBase1aRepresents a way to get information about a concept's attribute. Specific implementations of Fallthrough objects must implement the method: _Call(): Get a value from information given to the fallthrough. GetValue() is used by the Deps object to attempt to find the value of an attribute. The hint property is used to provide an informative error when an attribute can't be found. c(XlX lX0lg)aInitializes a fallthrough to an arbitrary function. Args: hint: str | list[str], The user-facing message for the fallthrough when it cannot be resolved. active: bool, True if the fallthrough is considered to be "actively" specified, i.e. on the command line. plural: bool, whether the expected result should be a list. Should be False for everything except the "anchor" arguments in a case where a resource argument is plural (i.e. parses to a list). N_hintactiveplural)selfhintr#r$s r__init___FallthroughBase.__init__>sJKKrchURU5nU(aURU5$[5e)zGets a value from information given to the fallthrough. Args: parsed_args: the argparse namespace. Raises: FallthroughNotFoundError: If the attribute is not found. Returns: The value of the attribute. )_Call _Pluralizer)r% parsed_argsvalues rGetValue_FallthroughBase.GetValueNs- JJ{ #E __U ## " $$rcgNr r%r,s rr*_FallthroughBase._Call_srcjUR(a[U[5(aU$U(aU/$/$)zCPluralize the result of calling the fallthrough. May be overridden.r$ isinstancelistr%r-s rr+_FallthroughBase._Pluralizecs) ;;*UD11 lE7##rcUR$)zCString representation of the fallthrough for user-facing messaging.)r"r%s rr&_FallthroughBase.hintis ::rcX[UR5[UR5-$r1)hashr&r#r;s r__hash___FallthroughBase.__hash__ns  ?T$++. ..rc[XR5=(aY URUR:H=(a9 URUR:H=(a URUR:H$r1)r6 __class__r&r#r$r%others r__eq___FallthroughBase.__eq__qsU unn - H%** 2I H LLDKK ' H,1LLDKK,GIrr!NFF)rrrrrr'r.abcabstractmethodr*r+propertyr&r?rErr rrrr1sO  %"  $   /Irr) metaclasscH^\rSrSrSrSU4SjjrSrU4SjrSrSr U=r $) FallthroughvzIA fallthrough that can get an attribute value from an arbitrary function.cZ>U(d [S5e[[U]X#US9 Xlg)aInitializes a fallthrough to an arbitrary function. Args: function: f() -> value, A no argument function that returns the value of the argument or None if it cannot be resolved. hint: str, The user-facing message for the fallthrough when it cannot be resolved. Should start with a lower-case letter. active: bool, True if the fallthrough is considered to be "actively" specified, i.e. on the command line. plural: bool, whether the expected result should be a list. Should be False for everything except the "anchor" arguments in a case where a resource argument is plural (i.e. parses to a list). Raises: ValueError: if no hint is provided zHint must be provided.r#r$N) ValueErrorsuperrMr' _function)r%functionr&r#r$rBs rr'Fallthrough.__init__ys-"  / 00 +t%d&%INrc$AUR5$r1rSr2s rr*Fallthrough._Calls >> rcj>[[U] U5=(a URUR:H$r1)rRrMrErS)r%rDrBs rrEFallthrough.__eq__s, +t +E 2 . OOt~~ -/rc,[UR5$r1)r>rSr;s rr?Fallthrough.__hash__s  rrWrG rrrrrr'r*rEr?r __classcell__rBs@rrMrMvsQ,/  rrMcB^\rSrSrSrSU4SjjrSrSrSrSr U=r $) ValueFallthrough"Gets an attribute from a property.cb>UcSRU5OUn[[U]X#US9 Xlg)aInitializes a fallthrough for the property associated with the attribute. Args: value: str, Denoting the fixed value to provide to the attribute. hint: str, Optional, If provided, used over default help_text. active: bool, Optional, whether the value is specified by the user on the command line. plural: bool, whether the expected result should be a list. Should be False for everything except the "anchor" arguments in a case where a resource argument is plural (i.e. parses to a list). NzThe default is `{}`rP)formatrRrar'r-)r%r-r&r#r$rBs rr'ValueFallthrough.__init__s637, ' ' .DD D*4v*NJrcAUR$r1r-r2s rr*ValueFallthrough._Calls ::rcj[XR5(dgURUR:H$NF)r6rBr-rCs rrEValueFallthrough.__eq__s' e^^ , ,  ;;$** $$rc,[UR5$r1)r>r-r;s rr?ValueFallthrough.__hash__s  rrh)NFFr]r_s@rraras*"% rracB^\rSrSrSrSU4SjjrSrSrSrSr U=r $) PropertyFallthroughrccV>SRU5n[[U]X2S9 Xlg)aYInitializes a fallthrough for the property associated with the attribute. Args: prop: googlecloudsdk.core.properties._Property, a property. plural: bool, whether the expected result should be a list. Should be False for everything except the "anchor" arguments in a case where a resource argument is plural (i.e. parses to a list). zset the property `{}`)r$N)rerRrpr'rJ)r%propr$r&rBs rr'PropertyFallthrough.__init__s- # ) )$ /D t-d-BMrcAURR5$![R[R4a gf=fr1)rJ GetOrFailrInvalidValueErrorRequiredPropertyErrorr2s rr*PropertyFallthrough._Calls@ ]] $ $ &&  ( (**J*J K s$AAcj[XR5(dgURUR:H$rk)r6rBrJrCs rrEPropertyFallthrough.__eq__' e^^ , ,  >>T]] **rc,[UR5$r1)r>rJr;s rr?PropertyFallthrough.__hash__  r)rJFr]r_s@rrprps* + rrpcH^\rSrSrSrS U4SjjrSrSrSrSr Sr U=r $) ArgFallthroughz?Gets an attribute from the argparse parsed values for that arg.cV>[[U] SRU5SUS9 Xlg)aPInitializes a fallthrough for the argument associated with the attribute. Args: arg_name: str, the name of the flag or positional. plural: bool, whether the expected result should be a list. Should be False for everything except the "anchor" arguments in a case where a resource argument is plural (i.e. parses to a list). z-provide the argument `{}` on the command lineTrPN)rRrr'rearg_name)r%rr$rBs rr'ArgFallthrough.__init__s4 .$(7>>xH)Mrc\[U[R"UR5S5nU$r1)getattrrNamespaceFormatr)r%r, arg_values rr*ArgFallthrough._Calls% T%9%9$--%H$OI rcUR(d%[U[5(aU(aUS$S$U$U(a[U[5(dU/$U(aU$/$)Nrr5r8s rr+ArgFallthrough._PluralizesQ ;; E4  uQx*d* l Zt,,Wn5!r!rcj[XR5(dgURUR:H$rk)r6rBrrCs rrEArgFallthrough.__eq__r|rc,[UR5$r1)r>rr;s rr?ArgFallthrough.__hash__rr)rr) rrrrrr'r*r+rEr?rr^r_s@rrrs$G  "+ rrcJ^\rSrSrSrS U4SjjrSrSrSrSr Sr U=r $) FullySpecifiedAnchorFallthroughizAA fallthrough that gets a parameter from the value of the anchor.c>U(aSnOSnUVs/sHofRSU3PM nn[SU55n[[U]XxUS9 X0lX l[U5Ul[RR5Ul URRUR RUR R5 gs snf)aInitializes a fallthrough getting a parameter from the anchor. For anchor arguments which can be plural, returns the list. Args: fallthroughs: list[_FallthroughBase], any fallthrough for an anchor arg. collection_info: the info of the collection to parse the anchor as. parameter_name: str, the name of the parameter plural: bool, whether the expected result should be a list. Should be False for everything except the "anchor" arguments in a case where a zwith fully specified nameszwith a fully specified name c38# UHoRv M g7fr1)r#).0fs r ;FullySpecifiedAnchorFallthrough.__init__.. s0>c[XR5=(aY URUR:H=(a9 URUR:H=(a URUR:H$r1)r6rBrrrrCs rrE&FullySpecifiedAnchorFallthrough.__eq__As` unn - 8   4#5#5 5 8  ! !T%9%9 9 8  D$7$7 79rc [[[UR[ UR 5UR /55$r1)summapr>rstrrrr;s rr?(FullySpecifiedAnchorFallthrough.__hash__Gs>  D    $$ %       r)rrrrr) rrrrrr'rr*rEr?rr^r_s@rrrs+I  H@ <-9   rrc:URU/5n[X2US9$)aGets the value of an attribute based on fallthrough information. If the attribute value is not provided by any of the fallthroughs, an error is raised with a list of ways to provide information about the attribute. Args: attribute_name: str, the name of the attribute. attribute_to_fallthroughs_map: {str: [_FallthroughBase], a map of attribute names to lists of fallthroughs. parsed_args: a parsed argparse namespace. Returns: the value of the attribute. Raises: AttributeNotFoundError: if no value can be found. r)getr)rattribute_to_fallthroughs_mapr,rs rGetrPs*&/22>2F,  @@rcLUHnURU5s $ [U5nSRUVs/sHnSR U5PM sn5n[ SR Uc SU55eSR U5U55e![a Mf=fs snf)aGets the value of an attribute based on fallthrough information. If the attribute value is not provided by any of the fallthroughs, an error is raised with a list of ways to provide information about the attribute. Args: fallthroughs: [_FallthroughBase], list of fallthroughs. parsed_args: a parsed argparse namespace. attribute_name: str, the name of the attribute. Used for error message, omitted if not provided. Returns: the value of the attribute. Raises: AttributeNotFoundError: if no value can be found.  z- {}zOFailed to find attribute{}. The attribute can be set in the following ways: {}z [{}])r.rGetHintsjoinrer)rr,r fallthroughhintsr&fallthroughs_summarys rrrhs&"k  ! !+ .." < %',-utv}}Tu-/#V&"   !!-4NN>,J   !! $ .sBB! BBc0nUHOn[UR[5(a URO UR/nUHnXA;aM SX'M MQ [UR55$)z0Gathers deduped hints from list of fallthroughs.T)r6r&r7keys)r hints_setr new_hintsr&s rrrsb ) a$QVVT22I io  inn rr1)r __future__rrrrH googlecloudsdk.calliope.conceptsrgooglecloudsdk.corerrr r rrrobjectABCMetarrMrarprrrrrr rrrs'' 1**)-J  -MuMIUNIBIvBIJ" "" J'B*B'%'TF &6F R@0!!H r