x[h$(SrSSKrSSKrSSKrSSKrSSKJr SSKJ r SSK J r J r SSK Jr SrSrS r\R$"\5r"S S \5r\"S 5r"S S5r"SS\5rSSjr\R6S4SjrSr"SS5rSrg)z events for reporting. The events here are designed to be used with reporting. They can be published to registered handlers with report_event. N)List) performance)available_handlersinstantiated_handler_registry)ReportingHandlerfinishstart cloudinitc\rSrSrSrSrg)_namesetc,X;aU$[SU-5e)Nz%s not a valid value)AttributeError)selfnames [[U] [X5 X0lUc/nX@lU[ ;a[SU-5eg)NzInvalid result: %s)superr7r)FINISH_EVENT_TYPEresult post_filesstatus ValueError)rrr%r<r= __class__s rr)FinishReportingEvent.__init__NsO "D2 t   J$  1F:; ; rczSRURURURUR5$)Nz{0}: {1}: {2}: {3})r,r$rr<r%r-s rr.FinishReportingEvent.as_string[s0#** OOTYY T5E5E  rc>[[U] 5nURUS'UR(a[ UR5US'U$)z'The event represented as json friendly.r<files)r:r7r2r<r=_collect_file_info)rdatar@s rr2FinishReportingEvent.as_dict`s>)48:X ??.t?DM r)r=r<) rrrrr>rr)r.r2r __classcell__)r@s@rr7r7Ms (.4 < rr7c8U(d0n[RR5VVs1sHup#X!;dM UiM nnn[[RR 55nUH%n[ U5U;aMURU5 M' gs snnf)aReport an event to all registered event handlers except those whose type is in excluded_handler_types. This should generally be called via one of the other functions in the reporting module. :param excluded_handler_types: List of handlers types to exclude from reporting the event to. :param event_type: The type of the event; this should be a constant from the reporting module. N)rregistered_itemsitemslistrvaluestype publish_event)eventexcluded_handler_types hndl_typehndl_clsexcluded_handler_classeshandlershandlers r report_eventrXis "!#$6#F#F#L#L#N #N I  . #N  (,%66==?(H =4 4 e$ s BBc,[XX#S9n[U5$)zNReport a "finish" event. See :py:func:`.report_event` for parameter details. r=)r7rX) event_nameevent_descriptionr<r=rQs rreport_finish_eventr]s  !v E  rc8[[X5n[U5$)aReport a "start" event. :param event_name: The name of the event; this should be a topic which events would share (e.g. it will be the same for start and finish events). :param event_description: A human-readable description of the event that has occurred. )r START_EVENT_TYPErX)r[r\rQs rreport_start_eventr`s +Z KE  rc\rSrSrSrSSS\R S4SjrSrSr Sr \ S5r \ RS 5r \ S 5r\RS 5rS rS rSrg)ReportEventStackaContext Manager for using :py:func:`report_event` This enables calling :py:func:`report_start_event` and :py:func:`report_finish_event` through a context manager. :param name: the name of the event :param description: the event's description, passed on to :py:func:`report_start_event` :param message: the description to use for the finish event. defaults to :param:description. :param parent: :type parent: :py:class:ReportEventStack or None The parent of this event. The parent is populated with results of all its children. The name used in reporting is / :param reporting_enabled: Indicates if reporting events should be generated. If not provided, defaults to the parent's value, or True if no parent is provided. :param result_on_exception: The result value to set if an exception is caught. default value is FAIL. :param post_files: Can hold filepaths of files that are to get posted/created regarding a given event. Something like success or failure information in a given log file. For each filepath, if it's a valid regular file it will get: read & encoded as base64 at the close of the event. Default value, if None, is an empty list. NcBX@lXlX lX0lX`l[ R UlUc/nXplUcU(a URnOSnXPl U(a#SRURU45Ul OURUl 0Ul g)NT/) parentrr%messageresult_on_exceptionr>rr<r=reporting_enabledjoinfullnamechildren)rrr%rgrfrirhr=s rr)ReportEventStack.__init__s  & #6 nn  J$  $$*$<$<!$(!!2 HHOODM!IIDM rc\SUR<SUR<SUR<S3$)NzReportEventStack(z, z, reporting_enabled=))rr%rir-s r__repr__ReportEventStack.__repr__s% II     " "  rc[RUlUR(a [ UR UR 5 UR(a#SURRUR'U$)N)NN) r>rr<rir`rkr%rfrlrr-s r __enter__ReportEventStack.__enter__sNnn  ! ! t}}d.>.> ? ;;.:DKK  + rc[R[R4H?nURR 5Hunup4X1:XdMX0R 4s s $ MA UR UR 4$r#)r>rrrlrLrgr<)r cand_result_namevalue_msgs r_childrens_finish_info'ReportEventStack._childrens_finish_infos_"KK5K(, (;(;(=$}'!<<00)>6 T\\**rcUR$r#)_resultr-s rr<ReportEventStack.results ||rc@U[;a[SU-5eXlg)Nz'%s' not a valid result)r>r?r}rrxs rr<r~ s  6>? ? rcLURb UR$UR$r#)_messager%r-s rrgReportEventStack.messages" == $== rcXlgr#)rrs rrgrs rc`U(aURUR4$UR5$r#)rhrgrz)rexcs r _finish_infoReportEventStack._finish_infos) ,,dll; ;**,,rcURU5upEUR(a$XE4URRUR'UR(a [ UR XTURS9 gg)NrZ)rrfrlrrir]rkr=)rexc_type exc_value tracebackr<msgs r__exit__ReportEventStack.__exit__!sZ)))4  ;;/5mDKK  +  ! !  st  "r) rr}rlr%rkrgrrfr=rir<rh)rrrrr4r>rr)rprsrzpropertyr<setterrgrrrrrrrbrbs$T"KK%N + ]]    ^^- rrbcU(dg/nUHn[RRU5(dSnOi[R"SU35 [ US5n[ R"UR55R5nSSS5 SSS5 URUWSS.5 M U$!,(df  N1=f!,(df  N:=f)NzReading rbbase64)pathcontentencoding) osrisfilerTimedopenr b64encodereaddecodeappend)rEretfnamerfps rrFrF+s  Cww~~e$$G""XeW#56t9 **27795<<>96 Eg8LM J 9966s$ C 3B;C ; C C  C r#) r4rloggingos.pathrr'typingrr rcloudinit.reportingrrcloudinit.reporting.handlersrr;r_r5 getLoggerrLOGsetr r>r r7rXrr]r`rbrFrrrrs   !:" !8%@+1..T  EEP r