SrSSKJr SSKJr SSKJr SSKrSSKr"SS\R"\R\ 55r "SS \ 5r "S S \ 5r g) aXAbstract base class for concepts. This base class cannot be used as a concept on its own but must be subclassed, and the methods Attribute(), GetPresentationName(), and Parse() must be implemented. Example usage: class IntConcept(Concept): def __init__(self, **kwargs): super(IntConcept, self).__init__(name='int', **kwargs) def Attribute(self): return Attribute(concept=self, fallthroughs=self.fallthroughs, help=self.BuildHelpText(), required=self.required, hidden=self.hidden, completer=self.completer, metavar=self.metavar) def GetPresentationName(self): return googlecloudsdk.command_lib.concepts.names.FlagNameFormat( self.name) def BuildHelpText(self): super(IntConcept, self).BuildHelpText() + ' Must be an int.' def Parse(self, dependencies): try: return int(dependencies.value) except ValueError: raise googlecloudsdk.command_lib.concepts.exceptions.Error( 'Could not parse int concept; you provided [{}]' .format(dependencies.value)) * Note for Concept Implementers * When implementing a new concept that produces a single argument, you can subclass googlecloudsdk.command_lib.concepts.all_concepts.SimpleArg in order to take advantage of general functionality, such as creating a simple presentation name based on whether concept.positional is True, determining whether the produced attribute is required, raising an exception if no value is found and the concept is required, and storing fallthroughs. )absolute_import)division)unicode_literalsNc\rSrSrSrS Sjr\RS5r\RS5r Sr Sr \RS 5r \RS 5r S rS rg)ConceptEa Abstract base class for concept args. Attributes: name: str, the name of the concept. Used to determine the argument or group name of the concept. key: str, the name by which the parsed concept is stored in the dependency view. If not given, is the same as the concept's name. Generally, this should only be set and used by containing concepts when parsing from a DependencyView object. End users of concepts do not need to use it. help_text: str, the help text to be displayed for this concept. required: bool, whether the concept must be provided by the end user. If False, it's acceptable to have an empty result; otherwise, an empty result will raise an error. hidden: bool, whether the associated argument or group should be hidden. NchXlX0lX@lXPlU=(d URUlgN)name help_textrequiredhiddenkey)selfr rr r rs /lib/googlecloudsdk/command_lib/concepts/base.py__init__Concept.__init__Ws&INMKdiiDHc[e)zReturns an Attribute object representing the attributes. Must be defined in subclasses. Returns: Attribute | AttributeGroup, the attribute or group. NotImplementedErrorrs r AttributeConcept.Attribute_s  rc[e)z&Returns the main name for the concept.rrs rGetPresentationNameConcept.GetPresentationNamejs  rcUR$)zRBuilds and returns the help text. Returns: str, the help text for the concept. )r rs r BuildHelpTextConcept.BuildHelpTextos >>rcg)z8Returns the list of concepts that this concept marshals.Nrs rMarshalConcept.Marshalws rc[e)zParses the concept. Args: dependencies: a DependenciesView object. Returns: the parsed concept. Raises: googlecloudsdk.command_lib.concepts.exceptions.Error, if parsing fails. r)r dependenciess rParse Concept.Parse{s  rcg)zEReturns whether this concept is required to be specified by argparse.Fr"rs r IsArgRequiredConcept.IsArgRequireds rcZUR5UR5URS.$)z9Returns argparse kwargs shared between all concept types.)helpr r)rr*rrs r MakeArgKwargsConcept.MakeArgKwargss-""$&&(++ r)r rrr r )NFF)__name__ __module__ __qualname____firstlineno____doc__rabcabstractmethodrrrr#r'r*r.__static_attributes__r"rrrrEs"=B   rrc2\rSrSrSrSSjr\S5rSrg)raAn attribute that gets transformed to an argument. Attributes: concept: Concept, the underlying concept. key: str, the name by which the Attribute is looked up in the dependency view. fallthroughs: [deps.Fallthrough], the list of fallthroughs for the concept. kwargs: {str: any}, other metadata describing the attribute. Available keys include: required (bool), hidden (bool), help (str), completer, default, nargs. **Note: This is currently used essentially as a passthrough to the argparse library. Nc <XlU=(d /UlX0lgr concept fallthroughskwargs)rr=r>r?s rrAttribute.__init__sL$*DKrc6URR5$)z7A string property representing the final argument name.)r=rrs rarg_nameAttribute.arg_names << + + --rr<NN) r1r2r3r4r5rpropertyrBr8r"rrrrs    . .rrc"\rSrSrSrSSjrSrg)AttributeGroupa?Represents an object that gets transformed to an argument group. Attributes: concept: Concept, the underlying concept. key: str, the name by which the Attribute is looked up in the dependency view. attributes: [Attribute | AttributeGroup], the list of attributes or attribute groups contained in this attribute group. kwargs: {str: any}, other metadata describing the attribute. Available keys include: required (bool), mutex (bool), hidden (bool), help (str). **Note: This is currently used essentially as a passthrough to the argparse library. Nc ^XlURUlU=(d /UlX0lgr )r=r attributesr?)rr=rJr?s rrAttributeGroup.__init__s#L{{DH &BDOKr)rJr=rr?rD)r1r2r3r4r5rr8r"rrrGrGs  rrG) r5 __future__rrrr6sixwith_metaclassABCMetaobjectrrrGr"rrrQsT,\'' Pc  f5Pf..2Vr