+ Dfj]0Rt^RIt^RIt^RIHt^RIHtHtHt^RI H t ^RI H t ^RI HtHtRtRRlt!R R 4t]!] 4!R R ]44t]!] P(4!R R44t]!] 4!RR]44t!RR]4t]!] P(4!RR44t!RR]P44t]!] 4!RR]44t]!] P(4!RR44t]!] 4!RR]44tR#)zD Support for aliases(5) configuration files. @author: Jp Calderone N) implementer)deferprotocolreactor)smtp)IAlias)failurelogcVPR^4Uu.uFqDP4NK pp\V4^8wd$RpW23p\P!Wg,4R#VwrVP VP4.4P \\PV PR444R#uupi)a Parse a line from an aliases file. @type result: L{dict} mapping L{bytes} to L{list} of L{bytes} @param result: A dictionary mapping username to aliases to which the results of parsing the line are added. @type line: L{bytes} @param line: A line from an aliases file. @type filename: L{bytes} @param filename: The full or relative path to the aliases file. @type lineNo: L{int} @param lineNo: The position of the line within the aliases file. :z+Invalid format on line %d of alias file %s.,N) splitstriplenr err setdefaultextendmapstr) resultlinefilenamelineNoppartsfmtarguseraliass &&&& 4/usr/lib/python3/dist-packages/twisted/mail/alias.pyhandler s"!% 3 2 3 21WWY 2E 3 5zQ;    $**,+223syy%++cBR3ST 4sB>cf/pRpVf\V4pRpM \VRR4p^pRpVFpV^, pVP4pVP4P R4'dKCVP R4'gVP R4'd Wg,pK{V'd \ W6W4TpK V'dVP 4T'd \ Y6Y4TP4Fwr\YT4Y8&K T# T'dTP 4ii;i) a: Load a file containing email aliases. Lines in the file should be formatted like so:: username: alias1, alias2, ..., aliasN Aliases beginning with a C{|} will be treated as programs, will be run, and the message will be written to their stdin. Aliases beginning with a C{:} will be treated as a file containing additional aliases for the username. Aliases beginning with a C{/} will be treated as the full pathname to a file to which the message will be appended. Aliases without a host part will be assumed to be addresses on localhost. If a username is specified multiple times, the aliases for each are joined together as if they had all been on one line. Lines beginning with a space or a tab are continuations of the previous line. Lines beginning with a C{#} are comments. @type domains: L{dict} mapping L{bytes} to L{IDomain} provider @param domains: A mapping of domain name to domain object. @type filename: L{bytes} or L{None} @param filename: The full or relative path to a file from which to load aliases. If omitted, the C{fp} parameter must be specified. @type fp: file-like object or L{None} @param fp: The file from which to load aliases. If specified, the C{filename} parameter is ignored. @rtype: L{dict} mapping L{bytes} to L{AliasGroup} @return: A mapping from username to group of aliases. FTnamez #  ) opengetattrrstriplstrip startswithr closeitems AliasGroup) domainsrfprr,iprevruas &&& r loadAliasFiler53sRF E z (^2v{3 A DD FA;;=D{{}'',,%%)>)>{65  HHJ vX) q1-  M  HHJ sADDD.DD0c:a]tRt^{toRtRtRtRRltRtVt R#) AliasBasez The default base class for aliases. @ivar domains: See L{__init__}. @type original: L{Address} @ivar original: The original address being aliased. c HWn\P!V4VnR#)z @type domains: L{dict} mapping L{bytes} to L{IDomain} provider @param domains: A mapping of domain name to domain object. @type original: L{bytes} @param original: The original address being aliased. N)r/rAddressoriginal)selfr/r:s&&&r__init__AliasBase.__init__s  X. c PVPVPP,#)z Return the domain associated with original address. @rtype: L{IDomain} provider @return: The domain for the original address. )r/r:domainr;s&rr@AliasBase.domains||DMM0011r>Nc nVf/p\V4V9dR#RV\V4&VP4#a Map this alias to its ultimate destination. @type aliasmap: L{dict} mapping L{bytes} to L{AliasBase} @param aliasmap: A mapping of username to alias or group of aliases. @type memo: L{None} or L{dict} of L{AliasBase} @param memo: A record of the aliases already considered in the resolution process. If provided, C{memo} is modified to include this alias. @rtype: L{IMessage } or L{None} @return: A message receiver for the ultimate destination or None for an invalid destination. N)rcreateMessageReceiverr;aliasmapmemos&&&rresolveAliasBase.resolves9 <D t9 SY))++r>)r/r:N) __name__ __module__ __qualname____firstlineno____doc__r<r@rI__static_attributes____classdictcell__ __classdict__s@rr7r7{s /2,,r>r7cLa]tRt^toRtRtV3RlRltRtR RltRt Vt R#) AddressAliasz{ An alias which translates one email address into another. @type alias : L{Address} @ivar alias: The destination address. c l\P!V.VO5!\P!V4VnR#)a @type alias: L{Address}, L{User}, L{bytes} or object which can be converted into L{bytes} @param alias: The destination address. @type args: 2-L{tuple} of (0) L{dict} mapping L{bytes} to L{IDomain} provider, (1) L{bytes} @param args: Arguments for L{AliasBase.__init__}. N)r7r<rr9r)r;rargss&&*rr<AddressAlias.__init__s' 4'$'\\%( r>c <V^8dQhRS[/#returnr)formatrTs"r __annotate__AddressAlias.__annotate__)))r>c "RVP R2#)z Build a string representation of this L{AddressAlias} instance. @rtype: L{bytes} @return: A string containing the destination address. z
rrAs&r__str__AddressAlias.__str__s4::,a((r>c fVP4P\VP44#)z Create a message receiver which delivers a message to the destination address. @rtype: L{IMessage } provider @return: A message receiver. )r@existsrrrAs&rrE"AddressAlias.createMessageReceivers#{{}##C O44r>Nc Vf/p\V4V9dR#RV\V4&VP4P\P!VP RRR4V4!4# \P dMi;iTP PT9d,YP P,PY4#R#rD) rr@rirUserr SMTPBadRcptlocalrIrFs&&&rrIAddressAlias.resolves <D t9 SY ;;='' $**dD$(OQUVX X    ::  x 'JJ,,-55hE EsAA..BBrerK) rLrMrNrOrPr<rfrErIrQrRrSs@rrVrVs( )))5r>rVcNa]tRt^toRtRtRtRtRtV3RlRlt Rt Vt R #) FileWrapperz A message receiver which delivers a message to a file. @type fp: file-like object @ivar fp: A file used for temporary storage of the message. @type finalname: L{bytes} @ivar finalname: The name of the file in which the message should be stored. c F\P!4VnWnR#)zk @type filename: L{bytes} @param filename: The name of the file in which the message should be stored. N)tempfile TemporaryFiler0 finalname)r;rs&&rr<FileWrapper.__init__s ((*!r>c JVPPVR,4R#)zq Write a received line to the temporary file. @type line: L{bytes} @param line: A received line of the message.  N)r0writer;rs&&r lineReceivedFileWrapper.lineReceiveds  dTk"r>c VPP^^4\VPR4pT;_uu_4TPTPP44TPP4RRR4\ P!TP4# \d-\ P !\P!44u#i;i +'giLj;i)a+ Handle end of message by writing the message to the file. @rtype: L{Deferred } which successfully results in L{bytes} @return: A deferred which succeeds with the name of the file to which the message has been stored or fails if the message cannot be saved to the file. r4N) r0seekr'ru BaseExceptionrfailrFailureryreadr,succeed)r;fs& r eomReceivedFileWrapper.eomReceiveds  Q 1T^^S)AQ GGDGGLLN # GGMMO}}T^^,, 1::goo/0 0 1QsB*AC$*4C! C!$ C4 c HVPP4RVnR#)z7 Close the temporary file when the connection is lost. N)r0r,rAs&rconnectionLostFileWrapper.connectionLost-s  r>c <V^8dQhRS[/#r[r^)r_rTs"rr`FileWrapper.__annotate__4s111r>c "RVP R2#)z Build a string representation of this L{FileWrapper} instance. @rtype: L{bytes} @return: A string containing the file name of the message. z )rur0N rLrMrNrOrPr<r{rrrfrQrRrSs@rrqrqs( "#-,11r>rqcBa]tRtRtoRtRtV3RlRltRtRtVt R#) FileAliasi>zS An alias which translates an address to a file. @ivar filename: See L{__init__}. c B\P!V.VO5!WnR#)z @type filename: L{bytes} @param filename: The name of the file in which to store the message. @type args: 2-L{tuple} of (0) L{dict} mapping L{bytes} to L{IDomain} provider, (1) L{bytes} @param args: Arguments for L{AliasBase.__init__}. N)r7r<r)r;rrXs&&*rr<FileAlias.__init__Fs 4'$' r>c <V^8dQhRS[/#r[r^)r_rTs"rr`FileAlias.__annotate__Rrbr>c "RVP R2#)z Build a string representation of this L{FileAlias} instance. @rtype: L{bytes} @return: A string containing the name of the file. zc ,\VP4#)z Create a message receiver which delivers a message to the file. @rtype: L{FileWrapper} @return: A message receiver which writes a message to the file. )rqrrAs&rrEFileAlias.createMessageReceiver[s4==))r>rN) rLrMrNrOrPr<rfrErQrRrSs@rrr>s# !))**r>rc]tRtRtRtRtR#)ProcessAliasTimeoutiezV An error indicating that a timeout occurred while waiting for a process to complete. N)rLrMrNrOrPrQrr>rrresr>rcna]tRtRtoRtRt^} provider @ivar _timeoutCallID: The call used to time out delivery, started when the connection to the child process is closed. @type done: L{bool} @ivar done: A flag indicating whether the child process has exited (C{True}) or not (C{False}). @type reactor: L{IReactorTime } provider @ivar reactor: A reactor which will be used to schedule timeouts. @ivar protocol: See L{__init__}. @type processName: L{bytes} or L{None} @ivar processName: The process name. @type completion: L{Deferred } @ivar completion: The deferred which will be triggered by the protocol when the child process exits. FNc W nWn\P!4VnVPVPnVPP VP4Ve W0nR#R#)aV @type protocol: L{ProcessAliasProtocol} @param protocol: The protocol associated with the child process. @type process: L{bytes} or L{None} @param process: The process name. @type reactor: L{None} or L{IReactorTime } provider @param reactor: A reactor which will be used to schedule timeouts. N) processNamerrDeferred completiononEndaddBoth _processEndedr)r;rprocessrs&&&&rr<MessageWrapper.__init__sU# ..*"oo   2 23  "L r>c vRVnVPe$VPP4RVnR#V#)a_ Record process termination and cancel the timeout call if it is active. @type result: L{Failure } @param result: The reason the child process terminated. @rtype: L{None} or L{Failure } @return: None, if the process end is expected, or the reason the child process terminated, if the process end is unexpected. TN)done_timeoutCallIDcancel)r;rs&&rrMessageWrapper._processEndeds:    *    & & ("&D Mr>c VP'dR#VPPPVR,4R#)zp Write a received line to the child process. @type line: L{bytes} @param line: A received line of the message. Nrx)rr transportryrzs&&rr{MessageWrapper.lineReceiveds, 999  %%dTk2r>c VP'gZVPPP4VPP VP VP4VnVP#)z Disconnect from the child process and set up a timeout to wait for it to exit. @rtype: L{Deferred } @return: A deferred which will be called back when the child process exits. ) rrrloseConnectionr callLatercompletionTimeout_completionCancelrrrAs&rrMessageWrapper.eomReceivedsWyyy MM # # 2 2 4"&,,"8"8&&(>(>#D r>c RVnVPPPR4\ RVP R24pRVPnVPP\P!V44R#)z Handle the expiration of the timeout for the child process to exit by terminating the child process forcefully and issuing a failure to the L{completion} deferred. NKILLzNo answer after z seconds) rrr signalProcessrrrrerrbackrr)r;excs& rr MessageWrapper._completionCancelsf # --f5!$4T5K5K4LH"UV"   45r>c R#)z) Ignore notification of lost connection. NrrAs&rrMessageWrapper.connectionLostsr>c <V^8dQhRS[/#r[r^)r_rTs"rr`MessageWrapper.__annotate__s666r>c "RVP R2#)z Build a string representation of this L{MessageWrapper} instance. @rtype: L{bytes} @return: A string containing the name of the process. z)rrrrrrNN)rLrMrNrOrPrrrrr<rr{rrrrfrQrRrSs@rrrlsI< DNG#*, 3 6 66r>rc.a]tRtRtoRtRtRtRtVtR#)ProcessAliasProtocoliz A process protocol which errbacks a deferred when the associated process ends. @type onEnd: L{None} or L{Deferred } @ivar onEnd: If set, a deferred on which to errback when the process ends. Nc \VPeVPPV4R#R#)zv Call an errback. @type reason: L{Failure } @param reason: The reason the child process terminated. N)rr)r;reasons&&r processEnded!ProcessAliasProtocol.processEndeds% :: ! JJ  v & "r>r) rLrMrNrOrPrrrQrRrSs@rrrs E''r>rcLa]tRtRtoRt]tRtV3RlRltRtRt Rt Vt R #) ProcessAliasi a An alias which is handled by the execution of a program. @type path: L{list} of L{bytes} @ivar path: The arguments to pass to the process. The first string is the executable's name. @type program: L{bytes} @ivar program: The path of the program to be executed. @type reactor: L{IReactorTime } and L{IReactorProcess } provider @ivar reactor: A reactor which will be used to create and timeout the child process. c \P!V.VO5!VP4VnVP^,VnR#)a  @type path: L{bytes} @param path: The command to invoke the program consisting of the path to the executable followed by any arguments. @type args: 2-L{tuple} of (0) L{dict} mapping L{bytes} to L{IDomain} provider, (1) L{bytes} @param args: Arguments for L{AliasBase.__init__}. N)r7r<r pathprogram)r;rrXs&&*rr<ProcessAlias.__init__s3 4'$'JJL yy| r>c <V^8dQhRS[/#r[r^)r_rTs"rr`ProcessAlias.__annotate__.s(((r>c "RVP R2#)z Build a string representation of this L{ProcessAlias} instance. @rtype: L{bytes} @return: A string containing the command used to invoke the process. z c :VPPWV4#)a Spawn a process. This wraps the L{spawnProcess } method on L{reactor} so that it can be customized for test purposes. @type proto: L{IProcessProtocol } provider @param proto: An object which will be notified of all events related to the created process. @type program: L{bytes} @param program: The full path name of the file to execute. @type path: L{list} of L{bytes} @param path: The arguments to pass to the process. The first string should be the executable's name. @rtype: L{IProcessTransport } provider @return: A process transport. )r spawnProcess)r;protorrs&&&&rrProcessAlias.spawnProcess7s0||((>>r>c \4p\WPVP4pVP WPVP 4V#)z Launch a process and create a message receiver to pass a message to the process. @rtype: L{MessageWrapper} @return: A message receiver which delivers a message to the process. )rrrrrr)r;rms& rrE"ProcessAlias.createMessageReceiverQs= ! " 1llDLL 9 !\\4995r>)rrN) rLrMrNrOrPrr<rfrrErQrRrSs@rrr s/"G $((?4  r>rcNa]tRtRtoRtRtRtRtRtV3RlRlt R t Vt R #) MultiWrapperi_zw A message receiver which delivers a single message to multiple other message receivers. @ivar objs: See L{__init__}. c WnR#)z @type objs: L{list} of L{IMessage } provider @param objs: Message receivers to which the incoming message should be directed. Nobjs)r;rs&&rr<MultiWrapper.__init__hs  r>c NVPFpVPV4K R#)zj Pass a received line to the message receivers. @type line: L{bytes} @param line: A line of the message. N)rr{)r;ros&& rr{MultiWrapper.lineReceivedpsA NN4 r>c \P!VPUu.uFqP4NK up4#uupi)a Pass the end of message along to the message receivers. @rtype: L{DeferredList } whose successful results are L{bytes} or L{None} @return: A deferred list which triggers when all of the message receivers have finished handling their end of message. )r DeferredListrrr;rs& rrMultiWrapper.eomReceivedzs/!!DII"FIq==?I"FGG"Fs>c LVPFpVP4K R#)zA Inform the message receivers that the connection has been lost. N)rrrs& rrMultiWrapper.connectionLostsA   r>c <V^8dQhRS[/#r[r^)r_rTs"rr`MultiWrapper.__annotate__s999r>c @R\\VP4: R2#)z Build a string representation of this L{MultiWrapper} instance. @rtype: L{bytes} @return: A string containing a list of the message receivers. zrNrrSs@rrr_s)! H99r>rcVa]tRtRtoRt]tRtRtV3RlRlt Rt R R lt R t Vt R#) r.ia0 An alias which points to multiple destination aliases. @type processAliasFactory: no-argument callable which returns L{ProcessAlias} @ivar processAliasFactory: A factory for process aliases. @type aliases: L{list} of L{AliasBase} which implements L{IAlias} @ivar aliases: The destination aliases. c  0\P!V.VO5!.VnV'EdVP4P 4pVP R4'dw\ VR,4pT;_uu_4RPVUu.uFqUP 4NK up4pRRR4VPVPR44KVP R4'd8VPPVP!VR,.VO5!4EKVP R4'dh\P P#V4'd\P!R 4EKWVPP\%V.VO5!4EKVPP\'V.VO5!4EKR#uupi +'giEL/;i \d'\P!RTR,: 24EKi;i) a: Create a group of aliases. Parse a list of alias strings and, for each, create an appropriate alias object. @type items: L{list} of L{bytes} @param items: Aliases. @type args: n-L{tuple} of (0) L{dict} mapping L{bytes} to L{IDomain} provider, (1) L{bytes} @param args: Arguments for L{AliasBase.__init__}. r :NNr%Nr zInvalid filename in alias file |/z Directory delivery not supported)r7r<aliasespoprr+r'joinrr rr rappendprocessAliasFactoryosrisdirrrV)r;r-rXaddrrls&&* rr<AliasGroup.__init__sv 4'$' e99;$$&Ds##2T"XA"xxA(>AqA(>?LLC1%% ##D$<$?LL'' $(>(>? ##L$=$=>')?%LGG=d2h\JKKLs0G$;G G #G G G! $,HHc ,\VP4#)zi Return the number of aliases in the group. @rtype: L{int} @return: The number of aliases in the group. )rrrAs&r__len__AliasGroup.__len__s4<<  r>c <V^8dQhRS[/#r[r^)r_rTs"rr`AliasGroup.__annotate__sIIIr>c bRRP\\VP44,#)z Build a string representation of this L{AliasGroup} instance. @rtype: L{bytes} @return: A string containing the aliases in the group. zz, )rrrrrAs&rrfAliasGroup.__str__s##diiC0F&GHHr>c p\VPUu.uFqP4NK up4#uupi)z Create a message receiver for each alias and return a message receiver which will pass on a message to each of those. @rtype: L{MultiWrapper} @return: A message receiver which passes a message on to message receivers for each alias in the group. )rrrE)r;r4s& rrE AliasGroup.createMessageReceivers, M 1446 MNNMs3Nc Vf/p.pVPF#pVPVPW44K% \\ RV44#)a) Map each of the aliases in the group to its ultimate destination. @type aliasmap: L{dict} mapping L{bytes} to L{AliasBase} @param aliasmap: A mapping of username to alias or group of aliases. @type memo: L{None} or L{dict} of L{AliasBase} @param memo: A record of the aliases already considered in the resolution process. If provided, C{memo} is modified to include this alias. @rtype: L{MultiWrapper} @return: A message receiver which passes the message on to message receivers for the ultimate destination of each alias in the group. N)rrrIrfilter)r;rGrHrr4s&&& rrIAliasGroup.resolvesG <D A HHQYYx. /F4O,,r>)rrK)rLrMrNrOrPrrr<rrfrErIrQrRrSs@rr.r.s9 '$?L!II O--r>r.r)rPrrszope.interfacertwisted.internetrrr twisted.mailrtwisted.mail.interfacesrtwisted.pythonrr r r5r7rVIMessagerqr ExceptionrrProcessProtocolrrrr.rr>rrsU  &55*'U6EP3,3,l VC9CCL T]]B1B1B1J V#* #*#*L) T]]D6D6D6N'833', VQ9QQh T]]393939l Vf-f-f-r>