File: //lib64/python2.7/site-packages/hgext/notify.pyc
�
1�3\c @@ sk d Z d d l m Z d d l j Z d d l j Z d d l Z d d l
Z
d d l Z d d l m
Z
d d l m Z m Z m Z m Z m Z m Z m Z d d l m Z m Z d Z i Z e j e � Z e d d d
d �e d d d
d �e d d d
e �e d d
d
d �e d d d
d �e d d d
d �e d d d
d �e d d d
d �e d d d
d �e d d d
d �e d d d
e �e d d d
d �e d d d
d �e d d d
d �e d d d
d �e d d d
d �e d d d
d �e d d d
e �d j � Z d! Z i e d 6Z! d" e" f d# � � YZ# d d d$ � Z$ d S(% s� hooks for sending email push notifications
This extension implements hooks to send email notifications when
changesets are sent from or received by the local repository.
First, enable the extension as explained in :hg:`help extensions`, and
register the hook you want to run. ``incoming`` and ``changegroup`` hooks
are run when changesets are received, while ``outgoing`` hooks are for
changesets sent to another repository::
[hooks]
# one email for each incoming changeset
incoming.notify = python:hgext.notify.hook
# one email for all incoming changesets
changegroup.notify = python:hgext.notify.hook
# one email for all outgoing changesets
outgoing.notify = python:hgext.notify.hook
This registers the hooks. To enable notification, subscribers must
be assigned to repositories. The ``[usersubs]`` section maps multiple
repositories to a given recipient. The ``[reposubs]`` section maps
multiple recipients to a single repository::
[usersubs]
# key is subscriber email, value is a comma-separated list of repo patterns
user@host = pattern
[reposubs]
# key is repo pattern, value is a comma-separated list of subscriber emails
pattern = user@host
A ``pattern`` is a ``glob`` matching the absolute path to a repository,
optionally combined with a revset expression. A revset expression, if
present, is separated from the glob by a hash. Example::
[reposubs]
*/widgets#branch(release) = qa-team@example.com
This sends to ``qa-team@example.com`` whenever a changeset on the ``release``
branch triggers a notification in any repository ending in ``widgets``.
In order to place them under direct user management, ``[usersubs]`` and
``[reposubs]`` sections may be placed in a separate ``hgrc`` file and
incorporated by reference::
[notify]
config = /path/to/subscriptionsfile
Notifications will not be sent until the ``notify.test`` value is set
to ``False``; see below.
Notifications content can be tweaked with the following configuration entries:
notify.test
If ``True``, print messages to stdout instead of sending them. Default: True.
notify.sources
Space-separated list of change sources. Notifications are activated only
when a changeset's source is in this list. Sources may be:
:``serve``: changesets received via http or ssh
:``pull``: changesets received via ``hg pull``
:``unbundle``: changesets received via ``hg unbundle``
:``push``: changesets sent or received via ``hg push``
:``bundle``: changesets sent via ``hg unbundle``
Default: serve.
notify.strip
Number of leading slashes to strip from url paths. By default, notifications
reference repositories with their absolute path. ``notify.strip`` lets you
turn them into relative paths. For example, ``notify.strip=3`` will change
``/long/path/repository`` into ``repository``. Default: 0.
notify.domain
Default email domain for sender or recipients with no explicit domain.
notify.style
Style file to use when formatting emails.
notify.template
Template to use when formatting emails.
notify.incoming
Template to use when run as an incoming hook, overriding ``notify.template``.
notify.outgoing
Template to use when run as an outgoing hook, overriding ``notify.template``.
notify.changegroup
Template to use when running as a changegroup hook, overriding
``notify.template``.
notify.maxdiff
Maximum number of diff lines to include in notification email. Set to 0
to disable the diff, or -1 to include all of it. Default: 300.
notify.maxdiffstat
Maximum number of diffstat lines to include in notification email. Set to -1
to include all of it. Default: -1.
notify.maxsubject
Maximum number of characters in email's subject line. Default: 67.
notify.diffstat
Set to True to include a diffstat before diff content. Default: True.
notify.showfunc
If set, override ``diff.showfunc`` for the diff content. Default: None.
notify.merge
If True, send notifications for merge changesets. Default: True.
notify.mbox
If set, append mails to this mbox file instead of sending. Default: None.
notify.fromauthor
If set, use the committer of the first changeset in a changegroup for
the "From" field of the notification mail. If not set, take the user
from the pushing repo. Default: False.
If set, the following entries will also be used to customize the
notifications:
email.from
Email ``From`` address to use if none can be found in the generated
email content.
web.baseurl
Root repository URL to combine with repository paths when making
references. See also ``notify.strip``.
i ( t absolute_importN( t _( t encodingt errort
logcmdutilt mailt patcht registrart util( t dateutilt
stringutils ships-with-hg-coret notifyt changegroupt defaultt configt diffstatt domaint
fromauthort incomingt maxdiffi, t maxdiffstati����t
maxsubjectiC t mboxt merget outgoingt sourcest servet showfunct stript stylet templatet tests�
Subject: changeset in {webroot}: {desc|firstline|strip}
From: {author}
changeset {node|short} in {root}
details: {baseurl}{webroot}?cmd=changeset;node={node|short}
description:
{desc|tabindent|strip}
sx
changeset {node|short} in {root}
details: {baseurl}{webroot}?cmd=changeset;node={node|short}
summary: {desc|firstline}
t notifierc B@ sY e Z d Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d d � Z RS(
s email notification class.c C@ s� | | _ | j j d d � } | rC | j j | d d d g �n | | _ t | j j d d � � | _ | j | j j � | _ | j j d d � | _ | j j d d � | _ | j j
d d � | _ t j
| j � | _ | j � | _ | j j
d d
� | _ | j j
d d � | _ | j d k rH| j j
d d � | _ n d } | j j d | � pu| j j d d
� } | s�| j j d d � } n | r�| r�t j | � p�t } n t j | | � } t j | j | j | � | _ d S( NR R t sectionst usersubst reposubsR R R R R R t diffR R ( t uiR t
readconfigt repot intt
stripcountR t rootR R t
configboolR R t _charsetst charsetst subscriberst subsR R t Nonet deftemplatest gett single_templateR t templatespect changesettemplatert t( t selfR% R' t hooktypet cfgt mapfileR t spec( ( s2 /usr/lib64/python2.7/site-packages/hgext/notify.pyt __init__ s2 c C@ sf t j | � } | j } xG | d k ra | j d � } | d k rF Pn | | d } | d 8} q W| S( s? strip leading slashes from local path, turn into web-safe path.i t /i����i ( R t pconvertR) t find( R7 t patht countt c( ( s2 /usr/lib64/python2.7/site-packages/hgext/notify.pyR s c C@ sh t j | j � � } | j rd | j d � } | d k rF | | } n d | k rd | d | j Sn | S( s try to clean up email addresses.s
@localhosti����t @( R
t emailR R R? ( R7 t addrt a( ( s2 /usr/lib64/python2.7/site-packages/hgext/notify.pyt fixmail) s
c C@ s� t � } x� | j j d � D]� \ } } x� | j d � D]p } d | k re | j d d � \ } } n d } t j | j j | j � � r8 | j | j
| � | f � q8 q8 Wq Wx� | j j d � D]� \ } } d | k r� | j d d � \ } } n d } t j | j j | � r� x6 | j d � D]" } | j | j
| � | f � q$Wq� q� Wg t | � D]3 \ } } t j
| j | | j | j � | f ^ q^S( s; return list of email addresses of subscribers to this repo.R" t ,t #i R# N( t setR% t configitemst splitR0 t fnmatchR' R* R t addRG t sortedR t
addressencodeR- R ( R7 R/ t usert patst patt revst userst st r( ( s2 /usr/lib64/python2.7/site-packages/hgext/notify.pyR. 5 s" ' 'c K@ ss | j r& t | j � � d k r& t S| j j | d | j � d | j j d d � d | j j
d | j
| �t S( s6 format one changeset, unless it is a suppressed merge.i t changest baseurlt webR* t webroot( R t lent parentst FalseR6 t showt changesetR% R R' R* t True( R7 t ctxt props( ( s2 /usr/lib64/python2.7/site-packages/hgext/notify.pyt nodeK s "c C@ s% | j j d d � j � } | | k S( s< true if incoming changes from this source should be skipped.R R ( R% R RL ( R7 t sourcet
ok_sources( ( s2 /usr/lib64/python2.7/site-packages/hgext/notify.pyt
skipsourceT s c C@ s9 t � } xs | j D]h \ } } | d k r> | j | � q n | j j d | | j � � } t | � r | j | � q q q Wt | � d k r� | j j d � d St
j � } y | j t
j | � � } Wn% t j k
r� }
t j |
� � n Xt
j | d � } t
j | d � } | d =| d =| j � s�| j � }
| j � } t j | j | | j | j � } x! |
D] \ } } | | | <quWn t
j t j d d � � | d <| s | d
k r�t d � | j | f } q | j � j � j! d d
� d j" � } d
| j | f } n t# | j j$ d d � � } | rSt% j& | | � } n t
j t j' | j | | j | j � � | d <| s�| j j$ d d � p�| j j( � } n d | k s�d | k r�| j) | � } n t
j t j* | j | | j | j � � | d <d | | d <| d skt
j d | t# t+ j+ � � t, | j j � t
j t- j. � � f � | d <n t
j d j/ t0 | � � � | d <t
j | j1 � � } | j r�| j j2 | � | j3 d � s5| j j2 d � q5nU | j j4 t d � t | � | f � t j5 | j t% j6 | d � | | d | j7 �d S( s
send message.s
%r and %d:i s3 notify: no subscribers to selected repo and revset
Nt Fromt Subjectt formats %a, %d %b %Y %H:%M:%S %1%2t Datei s %s: %d new changesetss
s %s: %sR R RD t fromRC s
@localhosts changeset %ss X-Hg-Notifications
Message-Ids <hg.%s.%d.%d@%s>s , t Tos* notify: sending %d subscribers %d changes
R (8 RJ R/ R0 RN R' RT t revR\ R% t debugt emailparsert Parsert parsestrR t strfromlocalt emailerrorst MessageParseErrorR t Abortt
strtolocalt is_multipartt itemst get_payloadR t
mimeencodeR- R R t datestrR R* t descriptiont lstripRL t rstripR( R R
t ellipsist
headencodet usernameRG RP t timet hasht sockett getfqdnt joinRO t as_stringt writet endswitht statust sendmailRD R ( R7 Rb RA t dataR/ t subR; RT t pt msgt instt sendert subjectt headerst payloadt kt vRV R t msgtext( ( s2 /usr/lib64/python2.7/site-packages/hgext/notify.pyt sendY sx
! (('(
#" c C@ s= t | j j d d � � } | j � j � } | rB | j � } n | j � } t j | j � } | j | _ t j | j | | d | �} d j
| � j � } | j j d d � r�t | j j d d � � } t j
| � } | r�| d k rp| j d � | d k rp| j d � } t d
� }
| j j |
t | � d | f � | j j d j
| | | d � � q�| j j t d
� | � q�n | d k r�d S| d k r�t | � | k r�t d � }
| j j |
t | � | f � | | } n) | r | j j t d � t | � � n | j j d j
| � � d S( NR R t optst R R i s
i s,
diffstat (truncated from %d to %d lines):
i i����s
diffstat:
%ss)
diffs (truncated from %d to %d lines):
s
diffs (%d lines):
( R( R% R t p1Rd R t diffalloptsR R$ R' R� t
splitlinesR+ R RA RL R R� R\ ( R7 Rb t refR t prevt diffoptst chunkst difflinesR RV R� ( ( s2 /usr/lib64/python2.7/site-packages/hgext/notify.pyR$ � s8 % $(
#N( t __name__t
__module__t __doc__R< R RG R. Rd Rg R� R0 R$ ( ( ( s2 /usr/lib64/python2.7/site-packages/hgext/notify.pyR � s
Sc
K@ sT t | | | � } | j � | } | j sC | j d | j � d S| j | � rg | j d | � d S| j � d } d } d }
| d k s� | d k r_x� | j j d | j � � D]� } | j
| | � r� | d 7} |
s;| | j � }
q;q� | | j � 7} | j
t d
� | | | j � d f � | j � q� W| r�| j | | d � q�n� | j � | k r�| j
| � s�| j � | j
t d
� | j � | j � d f � d S| d 7} | j | � |
s�| j � }
q�n | | j � 7} | j d
d � } |
r4| r4d j d |
| g � } n | rP| j | | | � n d S( s� send email notifications to interested subscribers.
if used as changegroup hook, send one email for all changesets in
changegroup. else send one email per changeset.s( notify: no subscribers to repository %s
Ns, notify: changes have source "%s" - skipping
R� i R R t starti s1 notify: suppressing notification for merge %d:%s
i t tipR R s
s From: %s( R t
unfilteredR/ Ro R* Rg t
pushbuffert changelogRT Rn Rd RQ t popbuffert noteR t hexR$ R R� R� (
R% R' R8 Rd Re t kwargst nRb R� RA t authorRn R ( ( s2 /usr/lib64/python2.7/site-packages/hgext/notify.pyt hook� sP
"
(% R� t
__future__R t email.errorst errorsRt t email.parsert parserRp RM R� R� t mercurial.i18nR t mercurialR R R R R R R t mercurial.utilsR R
t
testedwitht configtablet
configitemR0 Ra R~ R3 t multiple_templateR1 t objectR R� ( ( ( s2 /usr/lib64/python2.7/site-packages/hgext/notify.pyt <module>� sl 4
�