ó Ú"wTc @sydZddddddddd g Zd d lZd d lZd d lZd d lZd d lZd d lZd d l Td d l Td d l Tde fd „ƒYZ de efd„ƒYZde efd„ƒYZde efd„ƒYZde efd„ƒYZde fd„ƒYZdefd„ƒYZdefd„ƒYZd efd„ƒYZdefd„ƒYZd S(suClasses implementing destinations (files, directories, or programs getmail can deliver mail to). Currently implemented: Maildir Mboxrd MDA_qmaillocal (deliver though qmail-local as external MDA) MDA_external (deliver through an arbitrary external MDA) MultiSorter (deliver to a selection of maildirs/mbox files based on matching recipient address patterns) tDeliverySkeletontMaildirtMboxrdtMDA_qmaillocalt MDA_externaltMultiDestinationBasetMultiDestinationtMultiSorterBaset MultiSorteriÿÿÿÿN(t*cBs/eZdZd„Zd„Zeed„ZRS(sÉBase class for implementing message-delivery classes. Sub-classes should provide the following data attributes and methods: _confitems - a tuple of dictionaries representing the parameters the class takes. Each dictionary should contain the following key, value pairs: - name - parameter name - type - a type function to compare the parameter value against (i.e. str, int, bool) - default - optional default value. If not preseent, the parameter is required. __str__(self) - return a simple string representing the class instance. showconf(self) - log a message representing the instance and configuration from self._confstring(). initialize(self) - process instantiation parameters from self.conf. Raise getmailConfigurationError on errors. Do any other validation necessary, and set self.__initialized when done. retriever_info(self, retriever) - extract information from retriever and store it for use in message deliveries. _deliver_message(self, msg, delivered_to, received) - accept the message and deliver it, returning a string describing the result. See the Maildir class for a good, simple example. cKs|tj||y|jƒWn#tk rC}td|ƒ‚nXd|_d|_d|_d|_ |j j dƒdS(Ns+missing required configuration parameter %ssdone ( tConfigurableBaset__init__t initializetKeyErrortgetmailConfigurationErrortNonet received_fromt received_witht received_byt retrievertlogttrace(tselftargsto((s</usr/lib/python2.7/dist-packages/getmailcore/destinations.pyR Is    cCs>|jjƒ|j|_|j|_|j|_||_dS(N(RRRRRR(RR((s</usr/lib/python2.7/dist-packages/getmailcore/destinations.pytretriever_infoWs     cCsD|jjƒ|j|_|j|_|j|_|j|||ƒS(N(RRRRRt_deliver_message(Rtmsgt delivered_totreceived((s</usr/lib/python2.7/dist-packages/getmailcore/destinations.pytdeliver_message^s     (t__name__t __module__t__doc__R RtTrueR(((s</usr/lib/python2.7/dist-packages/getmailcore/destinations.pyR(s   c BseZdZedddeƒeddƒedddeddƒedddeddƒfZd „Z d „Z d „Z d „Z d „Z RS(s¦Maildir destination. Parameters: path - path to maildir, which will be expanded for leading '~/' or '~USER/', as well as environment variables. tnamet configparsertrequiredtpathtusertdefaulttfilemodet0600cCsz|jjƒtƒ|_d|_y!t|jddƒ|jd|jjƒ|jddkr:td|jdƒ‚ndS(NR^R_tflocksunknown mbox lock type: %s(R_R`(RRR/R(R((s</usr/lib/python2.7/dist-packages/getmailcore/destinations.pyR ës cCs|jjƒd|jdS(Ns Mboxrd %sR&(RRR/(R((s</usr/lib/python2.7/dist-packages/getmailcore/destinations.pyR1ñs cCs|jjd|jƒƒdS(Ns Mboxrd(%s) (RR2R3(R((s</usr/lib/python2.7/dist-packages/getmailcore/destinations.pyR4õscCsEyðtjdkrp|r+td||ƒntjƒdkrLtdƒ‚ntjƒdkrptdƒ‚qpntjj|j dƒs£t d|j dƒ‚ntjj |j dƒsÖt d|j dƒ‚ntj |j dtj ƒ}tj|ƒ} tj|dƒ} t| |j d ƒ| jddƒ| jƒ} | r‡| jd ƒ r‡t| |j d ƒt d|j dƒ‚n| jdd ƒyÑ| j|j||d td tƒtjƒ| jƒtj|ƒtj|ƒ} y'tj|j d| j| jfƒWn=tk rR} |jdƒ|jƒtj|jƒƒnXt| |j d ƒWnwt k rá} y | j!s™| j"| j#ƒnWn$t$k r°‚nt%k rÀnXt d|j d| fƒ‚nXtj&dƒWnNt%k r@} |jd| ƒ|jƒtj|jƒƒtj&dƒnXdS(s7Delivery method run in separate child process. R5isrefuse to deliver mail as rootsrefuse to deliver mail as GID 0R&smboxrd does not exist (%s)snot an mboxrd file (%s)sr+bR^sFrom it include_fromt mangle_froms%failed to updated mtime/atime of mboxs.failure writing message to mbox file "%s" (%s)s!mbox delivery process failed (%s)iN('R6R#R7RR8RR9R&texistsR/RTtisfiletopentO_RDWRtfstattfdopent lock_fileRQtreadlinet startswitht unlock_fileR<R;R"tlinesepR=R>tutimetst_atimetst_mtimetOSErrorR?tIOErrortclosedttruncatetst_sizetKeyboardInterruptRAR@(RRBRCRRRRDREtfdt status_oldRFt first_linet status_newR((s</usr/lib/python2.7/dist-packages/getmailcore/destinations.pyt__deliver_message_mboxøst          cCs×|jjƒd}d}tj|jdƒ}|jd}tjdkr½|r„t|ƒtjƒkr„t|ƒ}t |ƒ}n|dkrŸt dƒ‚n|dkr½t dƒ‚q½n|j ƒt j ƒ}t j ƒ} tjƒ} | s|j||||||| ƒn|jjd| ƒ|j| ƒ} |jdƒ| jdƒ|jƒjƒ} | jƒjƒ} |jjd| | fƒ| sš| r¶td | | | fƒ‚n| rÓ|jjd | ƒn|S( NR&R'R5isrefuse to deliver mail as rootsrefuse to deliver mail as GID 0sspawned child %d s%mboxrd delivery process %d exited %d s!mboxrd delivery %d error (%d, %s)smbox delivery: %s(RRRR6tstatR/R#RHR8RIRRJRKRLRMt_Mboxrd__deliver_message_mboxRORPRQRRRSRT(RRRRRBRCtst_mboxR'RDRERURVRWRX((s</usr/lib/python2.7/dist-packages/getmailcore/destinations.pyRPsH               N(RR R!RYRZt ConfMboxPathR\RR]R R1R4R}R(((s</usr/lib/python2.7/dist-packages/getmailcore/destinations.pyR×s      XcBsjeZdZedddeƒedddeddƒedddedeje j ƒƒj ƒedddeddƒe dd dedeje j ƒƒjƒedd dedeƒƒedd dedd ƒedd deddƒedddeddƒedddedeƒedddedeƒf Zd„Zd„Zd„Zd„Zd„ZRS(s6 qmail-local MDA destination. Passes the message to qmail-local for delivery. qmail-local is invoked as: qmail-local -nN user homedir local dash ext domain sender defaultdelivery Parameters (all optional): qmaillocal - complete path to the qmail-local binary. Defaults to "/var/qmail/bin/qmail-local". user - username supplied to qmail-local as the "user" argument. Defaults to the login name of the current effective user ID. If supplied, getmail will also change the effective UID to that of the user before running qmail-local. group - If supplied, getmail will change the effective GID to that of the named group before running qmail-local. homedir - complete path to the directory supplied to qmail-local as the "homedir" argument. Defaults to the home directory of the current effective user ID. localdomain - supplied to qmail-local as the "domain" argument. Defaults to localhostname(). defaultdelivery - supplied to qmail-local as the "defaultdelivery" argument. Defaults to "./Maildir/". conf-break - supplied to qmail-local as the "dash" argument and used to calculate ext from local. Defaults to "-". localpart_translate - a string representing a Python 2-tuple of strings (i.e. "('foo', 'bar')"). If supplied, the retrieved message recipient address will have any leading instance of "foo" replaced with "bar" before being broken into "local" and "ext" for qmail- local (according to the values of "conf-break" and "user"). This can be used to add or remove a prefix of the address. strip_delivered_to - if set, existing Delivered-To: header fields will be removed from the message before processing by qmail-local. This may be necessary to prevent qmail-local falsely detecting a looping message if (for instance) the system retrieving messages otherwise believes it has the same domain name as the POP server. Inappropriate use, however, may cause message loops. allow_root_commands (boolean, optional) - if set, external commands are allowed when running as root. The default is not to allow such behaviour. For example, if getmail is run as user "exampledotorg", which has virtual domain "example.org" delegated to it with a virtualdomains entry of "example.org:exampledotorg", and messages are retrieved with envelope recipients like "trimtext-localpart@example.org", the messages could be properly passed to qmail-local with a localpart_translate value of "('trimtext-', '')" (and perhaps a defaultdelivery value of "./Maildirs/postmaster/" or similar). R#R$R%t qmaillocalR(s/var/qmail/bin/qmail-localR'tgroupthomedirt localdomaintdefaultdeliverys ./Maildir/s conf-breakt-tlocalpart_translates('', '')tstrip_delivered_totallow_root_commandscCs|jjƒdS(N(RR(R((s</usr/lib/python2.7/dist-packages/getmailcore/destinations.pyR ÓscCs|jjƒd|jƒS(NsMDA_qmaillocal %s(RRR3(R((s</usr/lib/python2.7/dist-packages/getmailcore/destinations.pyR1Ös cCs|jjd|jƒƒdS(NsMDA_qmaillocal(%s) (RR2R3(R((s</usr/lib/python2.7/dist-packages/getmailcore/destinations.pyR4Úsc Cs÷y¢|jd|jdd|jd|jd|d|d|d|jd|d |jd f }|jjd t|ƒƒ|jd r¡|jd ƒd}ntjƒ}|j|j ||ƒƒ|j ƒt j |j ƒƒ|jdƒt j|j ƒdƒt j|j ƒdƒt j|j ƒdƒt|j|jd|jdƒt jƒdkswt jƒdkr”|jd r”tdƒ‚nt j|ŒWnNtk rò} |jd| ƒ|j ƒt j |j ƒƒt jdƒnXdS(NR€s--R'R‚tlocaltdashtextRƒtsenderR„sabout to execl() with args %s R‡s delivered-toiiiRRˆs>refuse to invoke external commands as root or GID 0 by defaultsexec of qmail-local failed (%s)i(R/RROtstrt remove_headerRRKRLR<R;R=R6R>R?RQtdup2tchange_usergroupR8R9RtexeclRAR@( RRtmsginfoRRRDRERtmsgfileR((s</usr/lib/python2.7/dist-packages/getmailcore/destinations.pyt_deliver_qmaillocalÝs:      !$  cCsî|jjƒ|jƒ|jdkr5tdƒ‚ni|jd6dj|jjƒj dƒd ƒd6}|jj d|dƒ|j d\}}|s¢|r|dj |ƒrî|jj d||fƒ||dt |ƒ|drefuse to invoke external commands as root or GID 0 by defaultR&R–tmailboxR¦s%%(%s)sabout to execl() with args %s sexec of command %s failed (%s)R©i(RKRLR<R;R/R=R6R>R?RQRRRR8R9RRtmailbox_selectedtexpand_user_varstitemstreplacetappendRORR‘RAR@( RRR’RRRDRER“RtargtkeytvalueR((s</usr/lib/python2.7/dist-packages/getmailcore/destinations.pyt_deliver_command¢s<   !$    c Cs|jjƒ|jƒi}|j|d<|jdkrŒ|j|d<|jjƒjdƒd|d%s(RRR(RÑR×(RRÏR×RË((s</usr/lib/python2.7/dist-packages/getmailcore/destinations.pyR3s   (RR R!R R3(((s</usr/lib/python2.7/dist-packages/getmailcore/destinations.pyR{s c BseeZdZedddeƒeddƒedddeddƒfZd„Zd„Z d „Z RS( s8Multiple destination with envelope recipient address matching. Parameters: default - the default destination. Messages not matching any "local" patterns (see below) will be delivered here. locals - an optional tuple of items, each being a 2-tuple of quoted strings. Each quoted string pair is a regular expression and a maildir/mbox/other destination. In the general case, an email address is a valid regular expression. Each pair is on a separate line; the second and subsequent lines need to have leading whitespace to be considered a continuation of the "locals" configuration. If the recipient address matches a given pattern, it will be delivered to the corresponding destination. A destination is assumed to be a maildir if it starts with a dot or slash and ends with a slash. A destination is assumed to be an mboxrd file if it starts with a dot or a slash and does not end with a slash. A destination may also be specified by section name, i.e. "[othersectionname]". Multiple patterns may match a given recipient address; the message will be delivered to /all/ destinations with matching patterns. Patterns are matched case-insensitively. example: default = /home/kellyw/Mail/postmaster/ locals = ( ("jason@example.org", "/home/jasonk/Maildir/"), ("sales@example.org", "/home/karlyk/Mail/sales"), ("abuse@(example.org|example.net)", "/home/kellyw/Mail/abuse/"), ("^(jeff|jefferey)(\.s(mith)?)?@.*$", "[jeff-mail-delivery]"), ("^.*@(mail.)?rapinder.example.org$", "/home/rapinder/Maildir/") ) In it's simplest form, locals is merely a list of pairs of email addresses and corresponding maildir/mbox paths. Don't worry about the details of regular expressions if you aren't familiar with them. R#R$R%R(RÐs()cCs|jjƒd|jƒS(NsMultiSorter (%s)(RRR3(R((s</usr/lib/python2.7/dist-packages/getmailcore/destinations.pyR1Ös cCs|jjd|jƒƒdS(NsMultiSorter(%s) (RR2R3(R((s</usr/lib/python2.7/dist-packages/getmailcore/destinations.pyR4ÚscCs7|jjƒg}|jdkr:|jr:tdƒ‚nx|jD]„\}}|jjd|j|jfƒ|j|jƒrD|jjd|j|fƒ|j |||ƒ|j t |ƒƒqDqDW|s/|jrþ|jjd|j|j fƒn|jjd|j ƒd|j j |||ƒSd|S(NshMultiSorter recipient matching requires a retriever (message source) that preserves the message envelopes)checking recipient %s against pattern %s srecipient %s matched target %s s+recipient %s not matched; using default %s susing default %s sMultiSorter (default %s)sMultiSorter (%s)( RRR—RRÑRROR×tsearchRR´RR((RRRRtmatchedR×RÈ((s</usr/lib/python2.7/dist-packages/getmailcore/destinations.pyRÝs*       ( RR R!RYRZR\tConfTupleOfTupleOfStringsR]R1R4R(((s</usr/lib/python2.7/dist-packages/getmailcore/destinations.pyR¨s'   t MultiGuesserc BseeZdZedddeƒeddƒedddeddƒfZd„Zd„Z d „Z RS( s°Multiple destination with header field address matching. Parameters: default - see MultiSorter for definition. locals - see MultiSorter for definition. R#R$R%R(RÐs()cCs|jjƒd|jƒS(NsMultiGuesser (%s)(RRR3(R((s</usr/lib/python2.7/dist-packages/getmailcore/destinations.pyR1 s cCs|jjd|jƒƒdS(NsMultiGuesser(%s) (RR2R3(R((s</usr/lib/python2.7/dist-packages/getmailcore/destinations.pyR4 sc Csâ|jjƒg}g}ddddddf}x±|D]©}xf|D]^}|jjd |ƒ|jgtjj|j|gƒƒD]\} } | r„| ^q„ƒqEW|rÑ|jjd t|ƒ|fƒPq8|jjd ƒq8Wx˜|j D]\} } x~|D]v} |jjd| | j fƒ| j | ƒr|jjd| | fƒ| j |||ƒ|j t| ƒƒPqqWqïW|sÚ|j r©|jjd|jƒn|jjd|jƒd|jj |||ƒSd|S(Ns delivered-tos envelope-tos x-envelope-tos apparently-tos resent-tos resent-ccs resent-bccttotcctbccs*looking for addresses in %s header fields s!found total of %d addresses (%s) sno addresses found, continuing s'checking address %s against pattern %s saddress %s matched target %s s'no addresses matched; using default %s susing default %s sMultiGuesser (default %s)sMultiGuesser (%s)(s delivered-to(s envelope-to(s x-envelope-to(s apparently-to(s resent-tos resent-ccs resent-bcc(RÜRÝRÞ(RRROtextendtemailtUtilst getaddressestget_allR›RÑR×RØRR´RR(( RRRRRÙt header_addrst fieldnamestfieldstfieldR#taddrR×RÈ((s</usr/lib/python2.7/dist-packages/getmailcore/destinations.pyRsP               ( RR R!RYRZR\RÚR]R1R4R(((s</usr/lib/python2.7/dist-packages/getmailcore/destinations.pyRÛùs    (R!t__all__R6RÒRKttypest email.UtilsRàRŸtgetmailcore.exceptionstgetmailcore.utilitiestgetmailcore.baseclassesR Rt ForkingBaseRRRRRRRRRÛ(((s</usr/lib/python2.7/dist-packages/getmailcore/destinations.pyt s8          >q­Ï«G6-Q