�
1�3\c	@@s�dZd
dl
mZ
d
dlZd
dlZd
dlZd
dlmZ
d
dlm	Z	m
Z
mZmZm
Z
mZmZmZ
d
dlmZ
iZeje�
Zyd
dljZej
Wnek
r�


dZn
XdZded	�
fd
ed�
fded
�
fded�
fded�
fgZejd�
ZdZed�
Zde f
d��YZ!de f
d��YZ"d�Z#d�Z$d�Z%d�Z&d�Z'd�Z(d�Z)d �Z*d!�Z+d"�Z,d#�Z-d$�Z.ed%d&d'd(ed)�
ed*�
fd+d,e/ed-�
ed*�
fd.d/e/ed0�
dfged1�
d2ej0�
dd3�
�
Z1ed4d5e2�

dd6�
�
Z3dS(7s/
generate release notes from commit messages (EXPERIMENTAL)

It is common to maintain files detailing changes in a project between
releases. Maintaining these files can be difficult and time consuming.
The :hg:`releasenotes` command provided by this extension makes the
process simpler by automating it.
i(
tabsolute_importN(
t
_(tconfigterrortminirsttnodetpycompatt	registrartscmutiltutil(
t
stringutilsships-with-hg-coretfeaturesNew FeaturestbcsBackwards Compatibility Changestfixs	Bug FixestperfsPerformance ImprovementstapisAPI Changess#^\.\. ([a-zA-Z0-9_]+)::\s*([^$]+)?$s\bissue ?[0-9]{4,6}(?![0-9])\bs
Other Changestparsedreleasenotesc
B@sYeZ
d�Zd
�Zd�Zd�Zd�Zd�Zd�Zd�Z	d�Z
RS(	c

C@s
i|_dS(
N(
tsections(
tself((s8/usr/lib64/python2.7/site-packages/hgext/releasenotes.pyt__init__@s
cC@s
|
|jkS(
N(
R(Rtsection((s8/usr/lib64/python2.7/site-packages/hgext/releasenotes.pyt__contains__Cs
c

C@stt
|j�
�
S(
N(titertsortedR(
R((s8/usr/lib64/python2.7/site-packages/hgext/releasenotes.pyt__iter__Fs
cC@s;|jj
|
ggf�
|j|
d
j||f�

dS(s Add a titled release note entry.iN(Rt
setdefaulttappend(RRttitlet
paragraphs((s8/usr/lib64/python2.7/site-packages/hgext/releasenotes.pyt
addtitleditemIs
cC@s5|jj
|
ggf�
|j|
d
j|�

dS(s[Adds a non-titled release note entry.

        Will be rendered as a bullet point.
        i
N(RRR(RRR((s8/usr/lib64/python2.7/site-packages/hgext/releasenotes.pytaddnontitleditemNs
cC@s|jj
|
ggf�d
S(s|Returns titled entries in a section.

        Returns a list of (title, paragraphs) tuples describing sub-sections.
        i(Rtget(RR((s8/usr/lib64/python2.7/site-packages/hgext/releasenotes.pyttitledforsectionVscC@s|jj
|
ggf�d
S(s5Returns non-titled, bulleted paragraphs in a section.i
(RR(RR((s8/usr/lib64/python2.7/site-packages/hgext/releasenotes.pytnontitledforsection]sc@s#t�f
d
�|j
|
�
D�
�
S(Nc
3@s|]}
|
d�kV
qd
S(iN((t.0t
t(
R(s8/usr/lib64/python2.7/site-packages/hgext/releasenotes.pys	<genexpr>bs(tanyR (RRR((
Rs8/usr/lib64/python2.7/site-packages/hgext/releasenotes.pythastitledinsectionas
c	C@s�
ts|
j
td
�
�

nx�
|D]�
}t|j|�
�
t|j|�
�
}x�|j|�
D]�\}}|j||�r�|
jtd�
||f�

qant||fg
�
d}|dkr�t	|�
}|r�t
|
||�r�qaq�q�nt|
||�r
qan|j|||�
qaWx�|j|�
D]�}||j|�
krW
q6
nt|g
�
d}|dkr�
t	|�
}|r�
t
|
||�r�
q6
q�
q�
nt|
||�r�
q6
n|j
||�
q6
Wq#WdS(s{Merge another instance into this one.

        This is used to combine multiple sources of release notes together.
        sKmodule 'fuzzywuzzy' not found, merging of similar releasenotes is disabled
s*%s already exists in %s section; ignoring
iR
N(tfuzztwarnR
t
converttitledR tconvertnontitledR!R%twritetgetissuenumt	findissuetsimilarRR(	RtuitotherRt
existingnotesRRtincoming_strtissue((s8/usr/lib64/python2.7/site-packages/hgext/releasenotes.pytmergeds>





















(t__name__t
__module__RRRRRR R!R%R3(((s8/usr/lib64/python2.7/site-packages/hgext/releasenotes.pyR?s
								treleasenotessectionscB@s/eZ
dd�
Zd
�Zd�Zd�ZRS(cC@sb|rOtj
t�
}t|�
}|r7|j|�

nt|j��
|_ntt�
|_dS(
N(R	tsortdicttDEFAULT_SECTIONStgetcustomadmonitionstupdatetlistt	iteritemst	_sections(RR.trepoRtcustom_sections((s8/usr/lib64/python2.7/site-packages/hgext/releasenotes.pyR�s





c

C@s
t|j
�
S(
N(RR=(
R((s8/usr/lib64/python2.7/site-packages/hgext/releasenotes.pyR�s
c
C@sg|jD]}
|
d
^q
S(Ni(
R=(RR#((s8/usr/lib64/python2.7/site-packages/hgext/releasenotes.pytnames�s
cC@s.x'|jD]\}}||
kr
|Sq
WdS(
N(R=tNone(RRtnametvalue((s8/usr/lib64/python2.7/site-packages/hgext/releasenotes.pytsectionfromtitle�s


N(R4R5RARRR@RD(((s8/usr/lib64/python2.7/site-packages/hgext/releasenotes.pyR6�s

		c
C@s[g}
xN|D]F\}}g}x|D]}|j|�

q&W|
j
d
j|�
�

q
W|
S(s.
    Convert titled paragraphs to strings
    t
 (textendRtjoin(ttitledparagraphststring_listRRtlinestpara((s8/usr/lib64/python2.7/site-packages/hgext/releasenotes.pyR(�s






c
C@sUg}
xH|D]@}g}x|D]}|j|�

q W|
j
d
j|�
�

q
W|
S(s/
    Convert non-titled bullets to strings
    RE(RFRRG(tnontitledparagraphsRIRRJRK((s8/usr/lib64/python2.7/site-packages/hgext/releasenotes.pyR)�s







c
C@s1tj
t|tj�}
|
r-|
j�}
n|
S(
sD
    Returns issue number from the incoming string if it exists
    (tretsearchtRE_ISSUEt
IGNORECASEtgroup(R1R2((s8/usr/lib64/python2.7/site-packages/hgext/releasenotes.pyR+�s


c@s?t�f
d
�|
D�
�
r7|j
td�
��

tStSdS(s?
    Returns true if issue number already exists in notes.
    c
3@s|]}
�|
kV
qdS(
N((R"t
s(
R2(s8/usr/lib64/python2.7/site-packages/hgext/releasenotes.pys	<genexpr>�ss'"%s" already exists in notes; ignoring
N(R$R*R
tTruetFalse(R.texistingR2((
R2s8/usr/lib64/python2.7/site-packages/hgext/releasenotes.pyR,�s

cC@sWt|j
��
d
krOt||
�}|sH|jtd�
|�

tStSntSdS(s?
    Returns true if similar note found in existing notes.
    i
s,"%s" already exists in notes file; ignoring
N(tlentsplittsimilaritycheckR*R
RSRT(R.RUR1R3((s8/usr/lib64/python2.7/site-packages/hgext/releasenotes.pyR-�s




cC@sMts
t
St
}x6|
D].}tj||�}|d
krt}PqqW|S(sK
    Returns false when note fragment can be merged to existing notes.
    iK(R&RSttoken_set_ratioRT(R1R0R3tbullettscore((s8/usr/lib64/python2.7/site-packages/hgext/releasenotes.pyRX�s







c

@sU�d
�tj��
dd��
��fd��d�krM�d�

n�
dS(Nt
.c@s^|�kr8�|j�}�
j
|||
|��
n"tjtd
�
�j|�
�
�
dS(Ns#.hgreleasenotes file '%s' not found(tdatatparseRtAbortR
tpathto(t
fRtremapR](tctxt
ptreadR>(s8/usr/lib64/python2.7/site-packages/hgext/releasenotes.pyRe�s




s.hgreleasenotesR(RRA(
R>((RcRdReR>s8/usr/lib64/python2.7/site-packages/hgext/releasenotes.pyR9�s





c
@s*
x#
|D]
}|
|}tj
t|j����r�jd
�
|krPqq"
|jtd�
�jd
�
|j�d f�

�f
d�}g|D]}||�
dkr�|^q�}t|�
d
kr�|jtd�
|d�

q"
|r"
dj	t
|�
�
}	|jtd	�
|	�

q"
qqWd
S(s`

    Checks the commit messages for admonitions and their validity.

    .. abcd::

       First paragraph under this admonition

    For this commit message, using `hg releasenotes -r . --check`
    returns: Invalid admonition 'abcd' present in changeset 3ea92981e103

    As admonition 'abcd' is neither present in default nor custom admonitions
    i
s0Invalid admonition '%s' present in changeset %s
ic

@s"tj
d�jd
�
|�j�S(Ni
(tdifflibtSequenceMatcherRARQtratio(
t
x(
t
admonition(s8/usr/lib64/python2.7/site-packages/hgext/releasenotes.pyt<lambda>
s	
g333333�?s(did you mean %s?)
is, s(did you mean one of %s?)
N(RMRNtRE_DIRECTIVEtdescriptionRQR*R
thexRVRGR(
R.R>t
directivestrevstrevRctsimRRR-tss((
Rjs8/usr/lib64/python2.7/site-packages/hgext/releasenotes.pytcheckadmonitions
s








!
+




cC@s4x-|
D]%}|jd
|d|df�

qWdS(Ns%s: %s
ii
(
R*(R.RR((s8/usr/lib64/python2.7/site-packages/hgext/releasenotes.pyt_getadmonitionlist&
s


cC@s�
t�}x�
|D]�
}||}t
j|j�d
|
�

\}}x�
t|�
D]�
\}}	|	ddkrpqNn|	d}
|	dr�|	ddj�nd}|dt|�
kr�tj	t
d�
||
f�
�
ng}x�t|dt|�
�D]�}
||
}|dd	kr
q�n|ddkr0
Pn|dd
krc
|jj
t
d�
||
f�

n|ddkr�
|j|d�

q�Pq�W|s�
|jj
t
d
�
tj|j��
�

n|r�
|j|
||�
qN|j|
|�
qNWqW|S(NtadmonitionsttypeRjtadmonitiontitleRJii
s6changeset %s: release notes directive %s lacks contenttmargint	paragraphs=changeset %s: unexpected block in release notes directive %s
tindents.error parsing releasenotes for revision: '%s'
(RRR^Rmt	enumeratetstripRARVRR_R
trangeR.R'RRRnRR(R>RoRptnotesRqRctblockstprunedt
itblockt	directiveRRt
jtpblock((s8/usr/lib64/python2.7/site-packages/hgext/releasenotes.pytparsenotesfromrevisions*
sB
	







$


 










c@s�
t�}t
j|
�
d
�t�f
d�
}d}xH
t��
D]:
\}}|ddkrcqAn|dd
}|ddkr�|j|�
}|s�tjt	d�
|�
�
n|}||�
}	|	r{
x!|	D]}
|j
||
�
q�Wq{
qA|dd	krb
|tkr=
||�
}	xC|	D]}
|j
||
�
q 
Wq{
||t�}|j
|||�
qAtjt	d
�
|�
�
qAW|S(s6Parse text content containing generated release notes.ic@s�
g}x�
t|d
t
��
�D]�
}�|}|ddkrFq nJ
|ddkrZPn6
|ddkr`
|ddkr�tjtd�
�
�
n|
r�g|d	D]}|d
j�^q�}|j|�

q q�
g|d	D]}|d
j�^q�g
}xN�|d
D]>}|ddkr%
Pn|dd
kr
|j|d	�

q
q
W|j|�

q n0|dd
kr�
tjtd�
|d�
�
n|
r |j|d	�

q q W|S(
Ni
RwRyRRZR{is#indented bullet lists not supportedRJRzs*unexpected block type in release notes: %s(RZR(R~RVRR_R
R}R(toffsetRtnotefragmentR�R�t
lRJ(
R�(s8/usr/lib64/python2.7/site-packages/hgext/releasenotes.pytgatherparagraphsbulletse
s8
 









'


*











RwRRJt	underlinet
=s!unknown release notes section: %st
-sunsupported section type for %sN(RRR^RTRAR|RDRR_R
RtBULLET_SECTIONRSR(RttextRR�tcurrentsectionR�R�RRBt
bullet_pointsRKR((
R�s8/usr/lib64/python2.7/site-packages/hgext/releasenotes.pytparsereleasenotesfile_
s6	#


















c
C@sSg}x|D]\}}||
kr+q
n|j|�

|jd
t
|�
�

|jd�

x�|
j|�
D]�\}}|j|�

|jdt
|�
�

|jd�

x[t|�
D]M\}}|r�|jd�

n|jtjdj|�
dd�

j��

q�W|jd�

qlW|
j	|�
}	|
j|�
rp
|	rp
|jt
�

|jdt
t
�
�

|jd�

nx�|	D]�}|jtjdj|d�
dddd	d
d�
j��

xV|dD]J}|jd�

|jtjdj|�
ddddd
d�
j��

q�
W|jd�

qw
Wq
W|rF|d
rF|jd�

ndj|�
S(s�Serialize release notes from parsed fragments and notes.

    This function essentially takes the output of ``parsenotesfromrevisions()``
    and ``parserelnotesfile()`` and produces output combining the 2.
    R�tR�REtwidthiNit
initindents* t
hangindents  i
i����s

(RRVR R|RFR
twrapRGt
splitlinesR!R�(
RRRJtsectionnametsectiontitleRRR�RKt	nontitled((s8/usr/lib64/python2.7/site-packages/hgext/releasenotes.pytserializenotes�
sJ






























treleasenotest
rRqR�s&revisions to process for release notestREVt
ctchecks+checks for validity of admonitions (if any)R�R;s/list the available admonitions with their titles"hg releasenotes [-r REV] [-c] FILEthelpcategoryc	K@s�
tj
|�
}t||
�}|jd
�
}|rZ|jd�
rZtjtd�
�
�
n|r�|jd�
r�tjtd�
�
�
n|r�t||�S|jd�
}tj	|
|p�dg
�}|jd�
r�t
||
|j�|�St|
|j�|�}|d	kr3
|jd�

|jt||��
Sy1t|d��}	t||	j��}
Wd	QXWn4tk
r�

}
|jtjkr�
�nt�}
n
X|
j||�
t|d
��}	|	jt||
��

Wd	QXd	S(s�	parse release notes from commit messages into an output file

    Given an output file and set of revisions, this command will parse commit
    messages for release notes then add them to the output file.

    Release notes are defined in commit messages as ReStructuredText
    directives. These have the form::

       .. directive:: title

          content

    Each ``directive`` maps to an output section in a generated release notes
    file, which itself is ReStructuredText. For example, the ``.. feature::``
    directive would map to a ``New Features`` section.

    Release note directives can be either short-form or long-form. In short-
    form, ``title`` is omitted and the release note is rendered as a bullet
    list. In long form, a sub-section with the title ``title`` is added to the
    section.

    The ``FILE`` argument controls the output file to write gathered release
    notes to. The format of the file is::

       Section 1
       =========

       ...

       Section 2
       =========

       ...

    Only sections with defined release notes are emitted.

    If a section only has short-form notes, it will consist of bullet list::

       Section
       =======

       * Release note 1
       * Release note 2

    If a section has long-form notes, sub-sections will be emitted::

       Section
       =======

       Note 1 Title
       ------------

       Description of the first long-form note.

       Note 2 Title
       ------------

       Description of the second long-form note.

    If the ``FILE`` argument points to an existing file, that file will be
    parsed for release notes having the format that would be generated by this
    command. The notes from the processed commit messages will be *merged*
    into this parsed set.

    During release notes merging:

    * Duplicate items are automatically ignored
    * Items that are different are automatically ignored if the similarity is
      greater than a threshold.

    This means that the release notes file can be updated independently from
    this command and changes should not be lost when running this command on
    that file. A particular use case for this is to tweak the wording of a
    release note after it has been added to the release notes file.

    The -c/--check option checks the commit message for invalid admonitions.

    The -l/--list option, presents the user with a list of existing available
    admonitions along with their title. This also includes the custom
    admonitions (if any).
    R;Rqs$cannot use both '--list' and '--rev'R�s&cannot use both '--list' and '--check'snot public()R�trbNtwb(RtbyteskwargsR6RRR_R
RuRtrevrangeRtR@R�RAtpagerR*R�topenR�RetIOErrorterrnotENOENTRR3(R.R>tfile_toptsRtlistflagRqRptincomingtfhRt
e((s8/usr/lib64/python2.7/site-packages/hgext/releasenotes.pyR��
s6[


















tdebugparsereleasenotestnorepocC@sR
|
d
krtj
j�}n$t|
d��}|j�}WdQXt||�}t||�}x�|D]�}|jtd�
|�

xe|j|�
D]T\}}	|jtd�
|�

x.|	D]&}
|jtd�
dj	|
�
�

q�Wq�Wx[|j
|�
D]J}	|jtd�
�

x.|	D]&}
|jtd�
dj	|
�
�

q
Wq�WqgWdS(	s6parse release notes and print resulting data structureR�R�Nssection: %s
s  subsection: %s
s    paragraph: %s
REs  bullet point:
(RtstdinReR�R6R�R*R
R RGR!(R.tpathR>R�R�RRRRRRK((s8/usr/lib64/python2.7/site-packages/hgext/releasenotes.pyR�js 








(



(4t__doc__t
__future__RRfR�RMtmercurial.i18nR
t	mercurialRRRRRRRR	tmercurial.utilsR
tcmdtabletcommandtfuzzywuzzy.fuzzR&RYtImportErrorRAt
testedwithR8tcompileRlROR�tobjectRR6R(R)R+R,R-RXR9RtRuR�R�R�RTtCATEGORY_CHANGE_NAVIGATIONR�RSR�(((s8/usr/lib64/python2.7/site-packages/hgext/releasenotes.pyt<module>s`


:












U					
				 		5	K	?




	

	
y