x:SrSSKJr SSKJr SSKJr SSKJr SrSr Sr S r \ "\\ \ \ 45r "S S \5r"S S \R 5rg)zPyYAML event builder handler Receives events from YAML listener and forwards them to a builder object so that it can construct a properly structured object. )absolute_import) yaml_errors) yaml_listener)yamldocumentsequencemappingkeycH\rSrSrSrSrSrSrSrSr Sr S r S r S r g ) Builder/zInterface for building documents and type from YAML events. Implement this interface to create a new builder. Builders are passed to the BuilderHandler and used as a factory and assembler for creating concrete representations of YAML files. cg)aBuild new document. The object built by this method becomes the top level entity that the builder handler constructs. The actual type is determined by the sub-class of the Builder class and can essentially be any type at all. This method is always called when the parser encounters the start of a new document. Returns: New object instance representing concrete document which is returned to user via BuilderHandler.GetResults(). Nselfs 0lib/googlecloudsdk/appengine/api/yaml_builder.py BuildDocumentBuilder.BuildDocument7cg)aInitialize document with value from top level of document. This method is called when the root document element is encountered at the top level of a YAML document. It should get called immediately after BuildDocument. Receiving the None value indicates the empty document. Args: document: Document as constructed in BuildDocument. value: Scalar value to initialize the document with. Nr)rrvalues rInitializeDocumentBuilder.InitializeDocumentErrcg)aeBuild a new mapping representation. Called when StartMapping event received. Type of object is determined by Builder sub-class. Args: top_value: Object which will be new mappings parant. Will be object returned from previous call to BuildMapping or BuildSequence. Returns: Instance of new object that represents a mapping type in target model. Nrr top_values r BuildMappingBuilder.BuildMappingSrrcg)aPreviously constructed mapping scope is at an end. Called when the end of a mapping block is encountered. Useful for additional clean up or end of scope validation. Args: top_value: Value which is parent of the mapping. mapping: Mapping which is at the end of its scope. Nr)rrr s r EndMappingBuilder.EndMappingarrcg)aiBuild a new sequence representation. Called when StartSequence event received. Type of object is determined by Builder sub-class. Args: top_value: Object which will be new sequences parant. Will be object returned from previous call to BuildMapping or BuildSequence. Returns: Instance of new object that represents a sequence type in target model. Nrrs r BuildSequenceBuilder.BuildSequencelrrcg)aPreviously constructed sequence scope is at an end. Called when the end of a sequence block is encountered. Useful for additional clean up or end of scope validation. Args: top_value: Value which is parent of the sequence. sequence: Sequence which is at the end of its scope. Nr)rrrs r EndSequenceBuilder.EndSequencezrrcg)a<Map value to a mapping representation. Implementation is defined by sub-class of Builder. Args: subject: Object that represents mapping. Value returned from BuildMapping. key: Key used to map value to subject. Can be any scalar value. value: Value which is mapped to subject. Can be any kind of value. Nr)rsubjectr rs rMapTo Builder.MapTorrcg)zAppend value to a sequence representation. Implementation is defined by sub-class of Builder. Args: subject: Object that represents sequence. Value returned from BuildSequence value: Value to be appended to subject. Can be any kind of value. Nr)rr*rs rAppendToBuilder.AppendTorrrN)__name__ __module__ __qualname____firstlineno____doc__rrrr!r$r'r+r.__static_attributes__rrrr r /s/        rr cx\rSrSrSrSrSrSrSrSr Sr S r S r S r S rS rSrSrSrSrSrSrg)BuilderHandlera1PyYAML event handler used to build objects. Maintains state information as it receives parse events so that object nesting is maintained. Uses provided builder object to construct and assemble objects as it goes. As it receives events from the YAML parser, it builds a stack of data representing structural tokens. As the scope of documents, mappings and sequences end, those token, value pairs are popped from the top of the stack so that the original scope can resume processing. A special case is made for the _KEY token. It represents a temporary value which only occurs inside mappings. It is immediately popped off the stack when it's associated value is encountered in the parse stream. It is necessary to do this because the YAML parser does not combine key and value information in to a single event. c[U[5(d[R"S5eXlSUlSUl/Ulg)zInitialization for builder handler. Args: builder: Instance of Builder class. Raises: ListenerConfigurationError when builder is not a Builder class. z2Must provide builder of type yaml_listener.BuilderN) isinstancer rListenerConfigurationError_builder_stack_top_results)rbuilders r__init__BuilderHandler.__init__sA gw ' '  2 2< >>MDKDIDMrc^X4UlURRUR5 g)aPush values to stack at start of nesting. When a new object scope is beginning, will push the token (type of scope) along with the new objects value, the latter of which is provided through the various build methods of the builder. Args: token: Token indicating the type of scope which is being created; must belong to _TOKEN_VALUES. value: Value to associate with given token. Construction of value is determined by the builder provided to this handler at construction. N)r>r=appendrtokenrs r_PushBuilderHandler._Pushs#DIKKtyy!rcUR/:wa URceURR5upUR(aURSUlU$SUlU$)zPop values from stack at end of nesting. Called to indicate the end of a nested scope. Returns: Previously pushed value at the top of the stack. N)r=popr>rEs r_PopBuilderHandler._Pops\ ;;" !88 8;;??$LE {{++b/di Ldi LrcX[US5(aURb [S5egg)a0Handle anchor attached to event. Currently will raise an error if anchor is used. Anchors are used to define a document wide tag to a given value (scalar, mapping or sequence). Args: event: Event which may have anchor property set. Raises: NotImplementedError if event attempts to use an anchor. anchorNz%Anchors not supported in this handler)hasattrrONotImplementedError)revents r _HandleAnchorBuilderHandler._HandleAnchors.uhELL$<  G HH%=rcURup#U[:XaGUR5nURupV[U:XdeURR XdU5 gU[:XaUR [U5 gU[:XaURRX15 gU[:XaURRX15 g[R"SU-5e)a(Handle given value based on state of parser This method handles the various values that are created by the builder at the beginning of scope events (such as mappings and sequences) or when a scalar value is received. Method is called when handler receives a parser, MappingStart or SequenceStart. Args: value: Value received as scalar value or newly constructed mapping or sequence instance. Raises: InternalError if the building process encounters an unexpected token. This is an indication of an implementation error in BuilderHandler. zUnrecognized builder token: %sN) r> _TOKEN_KEYrL_TOKEN_MAPPINGr<r+rG_TOKEN_SEQUENCEr._TOKEN_DOCUMENTrr InternalError)rrrFrr mapping_tokenr s r _HandleValueBuilderHandler._HandleValues$yyE  IIKc#yym } ,, , mm'. .  jjU# / ! mmY. / ! mm&&y8  % %&G%&O PPrcLURbe/UlSUl/Ulg)z?Initializes internal state of handler Args: event: Ignored. N)r=r>r?rrRloaders r StreamStartBuilderHandler.StreamStart&s) ;;  DKDIDMrcPUR/:Xa URbeSUlg)zKCleans up internal state of handler after parsing Args: event: Ignored. N)r=r>r_s r StreamEndBuilderHandler.StreamEnd1s& ;;" !22 2DKrcUR/:XdeUR[URR 55 g)zOBuild new document. Pushes new document on to stack. Args: event: Ignored. N)r=rGrYr<rr_s r DocumentStartBuilderHandler.DocumentStart:s1 ;;"  JJ ; ; =>rcURS[:XdeURRUR 55 g)z*End of document. Args: event: Ignored. rN)r>rYr?rDrLr_s r DocumentEndBuilderHandler.DocumentEndEs2 99QrWresolvernodes ScalarNoderimplicit IndexErrorDEFAULT_SCALAR_TAG start_markend_markstyleconstruct_objectr\)rrRr`rprnodes rScalarBuilderHandler.ScalarVs u yyTYYq\^;(nnTZZ22"[[%..: IIc {kkeZZ " "3#(;;#(#3#3#(>>#(;; 0d %%d+ee#(''(s?DDDcURU5 URup4U[:XaURSup4URR U5nUR U5 UR[U5 g)zStart of sequence scope Create a new sequence from the builder and then handle in the context of its parent. Args: event: SequenceStartEvent generated by loader. loader: Loader that generated event. N) rSr>rVr=r<r$r\rGrX)rrRr`rFparentrs r SequenceStartBuilderHandler.SequenceStart|sf uIIME kk"ome}}**62HhJJ)rcURS[:XdeUR5nURSnURR XC5 g)z>End of sequence. Args: event: Ignored loader: Ignored. rN)r>rXrLr<r'rrRr` end_objectrs r SequenceEndBuilderHandler.SequenceEndsD 99QrVr=r<rr\rGrW)rrRr`rFrr s r MappingStartBuilderHandler.MappingStartsf uIIME kk"omemm((0GgJJ~w'rcURS[:XdeUR5nURSnURR XC5 g)z;End of mapping Args: event: Ignored. loader: Ignored. rrN)r>rWrLr<r!rs r MappingEndBuilderHandler.MappingEndsD 99Q<> )) )J ! IMMY3rcrURb[R"S5e[UR5$)aYGet results of document stream processing. This method can be invoked after fully parsing the entire YAML file to retrieve constructed contents of YAML file. Called after EndStream. Returns: A tuple of all document objects that were parsed from YAML stream. Raises: InternalError if the builder stack is not empty by the end of parsing. zBuilder stack is not empty.)r=rrZtupler?rs r GetResultsBuilderHandler.GetResultss/ {{  % %&C DD  r)r<r?r=r>N)r0r1r2r3r4rArGrLrSr\rardrgrjrmr|rrrrrr5rrrr7r7s\$""""I"0Qd  ?&J$L*( 5(0 4 rr7N)r4 __future__rgooglecloudsdk.appengine.apirrruamelrrYrXrWrV frozenset _TOKEN_VALUESobjectr EventHandlerr7rrrrsl '46    kfk\q ]//q r