HEX

File: //usr/lib/python3/dist-packages/hgext/__pycache__/notify.cpython-310.pyc
o

�]LbmP�@s�dZddlmZddlmZddlmZddl	Z	ddl
Z
ddlZddlZddl
mZddlmZmZmZmZmZmZmZmZmZddlmZmZdZiZe�e�Zedd	dd
�edddd
�eddd
d
�edddd
�edddd
�edddd
�edddd
�edddd
�edddd
�edddd
�edddd
�eddd
d
�edddd
�edddd
�edddd
�edddd
�edd dd
�edd!dd
�edd"dd
�edd#d
d
�d$��Z d%Z!d	e!iZ"Gd&d'�d'e#�Z$d,d(d)�Z%d*d+�Z&dS)-a�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.
  It is also used for the domain part of the ``Message-Id`` when using
  ``notify.messageidseed``.

notify.messageidseed
  Create deterministic ``Message-Id`` headers for the mails based on the seed
  and the revision identifier of the first commit in the changeset.

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.

notify.reply-to-predecessor (EXPERIMENTAL)
  If set and the changeset has a predecessor in the repository, try to thread
  the notification mail with the predecessor. This adds the "In-Reply-To" header
  to the notification mail with a reference to the predecessor with the smallest
  revision number. Mail threads can still be torn, especially when changesets
  are folded.

  This option must  be used in combination with ``notify.messageidseed``.

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``.

�)�absolute_importN)�_)	�encoding�error�
logcmdutil�mail�obsutil�patch�pycompat�	registrar�util)�dateutil�
stringutilsships-with-hg-core�notify�changegroup)�default�config�diffstatT�domain�
messageidseed�
fromauthorsincoming�maxdiffi,�maxdiffstat����
maxsubject�C�mbox�merge�outgoing�reply-to-predecessorF�sourcessserve�showfunc�strip�style�template�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}
c@sReZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	dd�Z
ddd�ZdS)�notifierzemail notification class.cCs~||_|j�dd�}|r|jj|ddgd�||_t|j�dd��|_|�|jj�|_|j�dd�|_|j�dd�|_	|j�
dd	�|_t�
|j�|_|��|_|j�
dd
�|_|j�
dd�|_|j�dd�|_|j�
dd
�|_|jr||js|t�td���|jdur�|j�
dd�|_d}|j�d|�p�|j�dd�}|s�|j�dd�}|s�|s�t�|�p�t}t�||�}t�|j|j|�|_dS)Nrr�usersubs�reposubs)�sectionsr"rrr%rr!rrs=notify.reply-to-predecessor used without notify.messageidseedsdiffr$r#)�ui�config�
readconfig�repo�int�
stripcount�strip�root�domain�mbox�
configbool�testr�	_charsets�charsets�subscribers�subs�merge�showfunc�
messageidseed�replyr�Abortr�deftemplates�get�single_templater�templatespec�changesettemplater�t)�selfr*r-�hooktype�cfg�mapfile�template�spec�rK�./usr/lib/python3/dist-packages/hgext/notify.py�__init__AsD
��
�znotifier.__init__cCsTt�|�}|j}|dkr(|�d�}|dkr	|S||dd�}|d8}|dks|S)z?strip leading slashes from local path, turn into web-safe path.r�/r�N)r�pconvertr/�find)rE�path�count�crKrKrLr0is

��znotifier.stripcCsLt�|���}|jr$|�d�}|dkr|d|�}d|vr$|d|jS|S)z try to clean up email addresses.�
@localhostrN�@)r�emailr0r2rQ)rE�addr�arKrKrL�fixmailvs
znotifier.fixmailcs�t�}�j�d�D]/\}}|�d�D]%}d|vr!|�dd�\}}nd}t��jj|���r7|���	|�|f�qq	�j�d�D]-\}}d|vrP|�dd�\}}nd}t��jj|�rl|�d�D]}|���	|�|f�q_q?�fdd�t
|�D�S)	z;return list of email addresses of subscribers to this repo.r'�,�#rONr(cs*g|]\}}t��j|�j�j�|f�qSrK)r�
addressencoder*r7r5)�.0�s�r�rErKrL�
<listcomp>�s��z(notifier.subscribers.<locals>.<listcomp>)�setr*�configitems�split�fnmatchr-r1r0�addrZ�sorted)rEr9�user�pats�pat�revs�usersrKrarLr8�s*���
�znotifier.subscriberscKsP|js
t|���dkr
dS|jj|f|��|j�dd�|jj	|j	d�|��dS)z6format one changeset, unless it is a suppressed merge.rOFswebsbaseurl)�changes�baseurlr1�webrootT)
r:�len�parentsrD�show�	changesetr*r+r-r1)rE�ctx�propsrKrKrL�node�s���z
notifier.nodecCs|j�dd���}||vS)z<true if incoming changes from this source should be skipped.rr )r*r+re)rE�source�
ok_sourcesrKrKrL�
skipsource�sznotifier.skipsourcec
spt�}|jD]/\}}|dur|�|�qz|j�d|����}Wn
tjy*Yqwt|�r5|�|�qqt|�dkrD|j	�
d�dSzt�|�}Wnt
jy]}	zt�|	��d}	~	ww|d}
|d}|
durot�|
�}
|durxt�|�}|d=|d=|��s�|��}|jtjd�}
t�|j	|
|j|j�}|D]\}}|||<q�t�tjdd	��|d
<|s�|dkr�td�|j|f}n���� ��!d
d�d�"�}d|j|f}t#|j	�$dd��}|r�t%�&||�}t�'|j	||j|j�|d<|
s�|j	�$dd�p�|j	�(�}
d|
v�s	d|
v�r|�)|
�}
t�*|j	|
|j|j�|d<d�|d<|d�s0t+�|j,|j-�|d<|j.�rf|j�/���j0j1j2����fdd�t3�4�j5��6�g�D�}|�rft7|dd�d�}t+||j,|j-�|d<d�8t9|��|d<tj�rw|�:�n|�;�}|j�r�|j	�<|�|�=d
��s�|j	�<d
�dSdS|j	�>td �t|�|f�tj?|j	t@�A|d�d|||jBd!�dS)"z
send message.Ns
%r and %d:rs3notify: no subscribers to selected repo and revset
�From�Subject)�decodes%a, %d %b %Y %H:%M:%S %1%2)�format�DaterOs%s: %d new changesets�
s%s: %srrsemailsfromrVrUzchangeset %szX-Hg-Notificationz
Message-Idcs(g|]}|���kr�|�r�|�qSrK)rw)r^�ctx2�ru�has_node�unfirKrLrb�s
�z!notifier.send.<locals>.<listcomp>cSs|��S�N)�rev)rurKrKrL�<lambda>
sznotifier.send.<locals>.<lambda>)�keyzIn-Reply-Toz, �Tos*notify: sending %d subscribers %d changes
)r3)Crcr9rgr-rlr�r�RepoLookupErrorrqr*�debugr�
parsebytes�emailerrors�MessageParseErrorr>�
headdecode�is_multipart�items�get_payloadr
�ispy3�
mimeencoder7r5r�strfromlocalr
�datestrrr1�description�lstripre�rstripr.r+r�ellipsis�
headencode�usernamerZr]�	messageidr2r<r=�
unfiltered�	changelog�indexr�r�allpredecessors�obsstorerw�min�joinrh�as_bytes�	as_string�write�endswith�status�sendmail�
emailutils�	parseaddrr3)rErurS�datar9�subrJrl�msg�inst�sender�subject�headers�payload�k�vr_�
maxsubject�predecessors�pred�msgtextrKr�rL�send�s�
�
��
��



��
�


�
��
��
�z
notifier.sendNcCs�t|j�dd��}|����}|r|��}n|��}t�|j�}|j|_tj|j	|||d�}d�
|���}|j�dd�r�t|j�dd��}t�
|�}	|	r�|dkr�|	�d�|d	kr�|	�d�}	td
�}
|j�|
t|	�d|f�|j�d�
|	d|�|	dd���n
|j�td
�|	�|dkr�dS|dkr�t|�|kr�td�}
|j�|
t|�|f�|d|�}n|r�|j�td�t|��|j�d�
|��dS)Nrr)�opts�rrrr�rOs,
diffstat (truncated from %d to %d lines):

����s
diffstat:

%ss)
diffs (truncated from %d to %d lines):

s
diffs (%d lines):

)r.r*r+�p1rwr	�diffalloptsr;�diffr-r��
splitlinesr4�diffstatrSrerr�rq)rEru�ref�maxdiff�prev�diffopts�chunks�	difflines�maxdiffstatr_r�rKrKrLr�"s8


(z
notifier.diffr�)�__name__�
__module__�__qualname__�__doc__rMr0rZr8rwrzr�r�rKrKrKrLr&>s(
ur&c
Ks�t|||�}|��|}|js|�d|j�dS|�|�r'|�d|�dS|��d}d}	d}
|dks9|dkr�|jj|�	�d�D]3}|�
||�rX|	d	7}	|
sW||��}
qB||��7}|�
td
�|||��dd�f�|��qB|	r�|�||d�n3|�	�|vr�|�
|�s�|��|�
td
�|�	�|��dd�f�dS|	d	7}	|�|�|
s�|��}
||��7}|�d
d�}|
r�|r�d�d|
|g�}|	r�|�||	|�dSdS)z�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�rrr)�startrOs1notify: suppressing notification for merge %d:%s
�stiprrr�sFrom: %s)r&r�r9r�r1rz�
pushbufferr�rlr�rwri�	popbuffer�noter�hexr�r+r�r�)
r*r-rFrwrx�kwargs�nrur�rS�authorr��
fromauthorrKrKrL�hookHsb
���
�
��
�r�cCs~|r|r|}nt�t���}|r)t�|��|�}dt�|�	�dd��|f}nd|t
t���t|�
�j�|f}t�|�S)Ns
<hg.%s@%s>�@s<hg.%s.%d.%d@%s>)r�
strtolocal�socket�getfqdn�hashlib�sha512r�r
�sysbytes�	hexdigestr.�time�hashr-r1r�)rur2r<�host�messagehashr�rKrKrLr��s �
�
r�)NN)'r��
__future__r�email.errors�errorsr��email.utils�utilsr�rfr�r�r��mercurial.i18nr�	mercurialrrrrrr	r
rr�mercurial.utilsr
r�
testedwith�configtable�
configitemr�rA�multiple_templater?�objectr&r�r�rKrKrKrL�<module>s�,	
���������������������
�
9