a %0É_ÝUã @súdZddlmZddlZddlZddlZddlmZddlm Z ddl m Z m Z m Z mZmZmZmZmZmZddlmZmZiZe e¡ZzddlmZejWney¶dZYn0dZd ed ƒfd ed ƒfd edƒfdedƒfdedƒfgZe d¡Z dZ!edƒZ"Gdd„de#ƒZ$Gdd„de#ƒZ%dd„Z&dd„Z'dd„Z(d d!„Z)d"d#„Z*d$d%„Z+d&d'„Z,d(d)„Z-d*d+„Z.d,d-„Z/d.d/„Z0d0d1„Z1ed2d3d4d5ed6ƒed7ƒfd8d9d:ed;ƒed7ƒfdƒdfged?ƒej2d@dHdAdB„ƒZ3edCdDdEdIdFdG„ƒZ4dS)Ja/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. é)Úabsolute_importN)Ú_)Úopen) ÚcmdutilÚconfigÚerrorÚminirstÚnodeÚpycompatÚ registrarÚscmutilÚutil)ÚprocutilÚ stringutilsships-with-hg-coresfeatures New FeaturessbcsBackwards Compatibility Changesófixs Bug FixessperfsPerformance Improvementssapis API Changess#^\.\. ([a-zA-Z0-9_]+)::\s*([^$]+)?$s\bissue ?[0-9]{4,6}(?![0-9])\bs Other Changesc@sTeZdZdd„Zdd„Zdd„Zdd„Zd d „Zd d „Zd d„Z dd„Z dd„Z dS)ÚparsedreleasenotescCs i|_dS©N©Úsections©Úself©rú4/usr/lib/python3/dist-packages/hgext/releasenotes.pyÚ__init__Eszparsedreleasenotes.__init__cCs ||jvSrr©rÚsectionrrrÚ __contains__Hszparsedreleasenotes.__contains__cCstt|jƒƒSr)ÚiterÚsortedrrrrrÚ__iter__Kszparsedreleasenotes.__iter__cCs.|j |ggf¡|j|d ||f¡dS)z Add a titled release note entry.rN©rÚ setdefaultÚappend)rrÚtitleÚ paragraphsrrrÚ addtitleditemNsz parsedreleasenotes.addtitleditemcCs*|j |ggf¡|j|d |¡dS)z[Adds a non-titled release note entry. Will be rendered as a bullet point. éNr )rrr$rrrÚaddnontitleditemSsz#parsedreleasenotes.addnontitleditemcCs|j |ggf¡dS)z|Returns titled entries in a section. Returns a list of (title, paragraphs) tuples describing sub-sections. r©rÚgetrrrrÚtitledforsection[sz#parsedreleasenotes.titledforsectioncCs|j |ggf¡dS)z5Returns non-titled, bulleted paragraphs in a section.r&r(rrrrÚnontitledforsectionbsz&parsedreleasenotes.nontitledforsectioncst‡fdd„| |¡DƒƒS)Nc3s|]}|dˆkVqdS)rNr©Ú.0Út©r#rrÚ góz8parsedreleasenotes.hastitledinsection..)Úanyr*)rrr#rr/rÚhastitledinsectionfsz%parsedreleasenotes.hastitledinsectionc Cs8ts| tdƒ¡|D]}t| |¡ƒt| |¡ƒ}| |¡D]|\}}| ||¡rn| tdƒ||f¡qBt||fgƒd}|dkr¢t |ƒ}|r¢t |||ƒr¢qBt |||ƒr°qB|  |||¡qB| |¡D]f}|| |¡vrÞqÊt|gƒd}|dkrt |ƒ}|rt |||ƒrqÊt |||ƒr$qÊ|  ||¡qÊqdS)z{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 rrN)ÚfuzzÚwarnrÚ converttitledr*Úconvertnontitledr+r3ÚwriteÚ getissuenumÚ findissueÚsimilarr%r') rÚuiÚotherrÚ existingnotesr#r$Ú incoming_strÚissuerrrÚmergeisRÿÿ ÿ þ ÿÿ   zparsedreleasenotes.mergeN) Ú__name__Ú __module__Ú __qualname__rrrr%r'r*r+r3rArrrrrDsrc@s.eZdZd dd„Zdd„Zdd„Zdd „ZdS) ÚreleasenotessectionsNcCsD|r6t t¡}t|ƒ}|r$| |¡tt |¡ƒ|_n ttƒ|_dSr) r ZsortdictÚDEFAULT_SECTIONSÚgetcustomadmonitionsÚupdateÚlistr Z iteritemsÚ _sections)rr<ÚreporZcustom_sectionsrrrr¢s  zreleasenotessections.__init__cCs t|jƒSr)rrJrrrrr¬szreleasenotessections.__iter__cCsdd„|jDƒS)NcSsg|] }|d‘qS)rrr,rrrÚ °r1z.releasenotessections.names..©rJrrrrÚnames¯szreleasenotessections.namescCs$|jD]\}}||kr|SqdSrrM)rr#ÚnameÚvaluerrrÚsectionfromtitle²s z%releasenotessections.sectionfromtitle)N)rBrCrDrrrNrQrrrrrE¡s rEcCs>g}|D]0\}}g}|D]}| |¡q| d |¡¡q|S)z. Convert titled paragraphs to strings ó ©Úextendr"Újoin)ZtitledparagraphsÚ string_listr#r$ÚlinesÚpararrrr6ºs  r6cCs:g}|D],}g}|D]}| |¡q| d |¡¡q|S)z/ Convert non-titled bullets to strings rRrS)ZnontitledparagraphsrVr$rWrXrrrr7Çs r7cCs t t|tj¡}|r| ¡}|S)zD Returns issue number from the incoming string if it exists )ÚreÚsearchÚRE_ISSUEÚ IGNORECASEÚgroup)r?r@rrrr9Ôsr9cs4t‡fdd„|Dƒƒr,| tdƒˆ¡dSdSdS)z? Returns true if issue number already exists in notes. c3s|]}ˆ|vVqdSrr©r-Ús©r@rrr0âr1zfindissue..s'"%s" already exists in notes; ignoring TFN)r2r8r)r<Úexistingr@rr`rr:Þsr:cCsBt| ¡ƒdkr:t||ƒ}|s4| tdƒ|¡dSdSndSdS)z? Returns true if similar note found in existing notes. é s,"%s" already exists in notes file; ignoring TFN)ÚlenÚsplitÚsimilaritycheckr8r)r<rar?rArrrr;és ÿÿr;cCs6tsdSd}|D] }t ||¡}|dkrd}q2q|S)zK Returns false when note fragment can be merged to existing notes. TéKF)r4Útoken_set_ratio)r?r>rAZbulletZscorerrrreûs recs<ˆd‰t ¡‰d‡‡‡‡fdd„ ‰dˆvr4ˆdƒˆdS)Nó.csD|ˆvr(ˆ| ¡}ˆ ||||ˆ¡nt tdƒˆ |¡¡‚dS)Ns#.hgreleasenotes file '%s' not found)ÚdataÚparserÚAbortrZpathto)ÚfrZremapri©ÚctxÚpÚreadrKrrrps  ÿz"getcustomadmonitions..reads.hgreleasenotesssections)NN)r)rKrrmrrG s  rGcsÊ|D]À}||}t t| ¡¡‰ˆrˆ d¡|vr6qq| tdƒˆ d¡| ¡dd…f¡‡fdd„‰‡fdd„|Dƒ}t|ƒdkr | td ƒ|d ¡q|rd   t |ƒ¡}| td ƒ|¡qdS) a` 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 r&s0Invalid admonition '%s' present in changeset %s Né cst dˆ d¡|¡ ¡S)Nr&)ÚdifflibZSequenceMatcherr]Zratio)Úx)Ú admonitionrrÚ6s ÿz"checkadmonitions..csg|]}ˆ|ƒdkr|‘qS)g333333ã?rr^)ÚsimrrrL:r1z$checkadmonitions..s(did you mean %s?) rs, s(did you mean one of %s?) ) rYrZÚ RE_DIRECTIVEÚ descriptionr]r8rÚhexrcrUr)r<rKÚ directivesÚrevsÚrevrnr;Zssr)rtrvrÚcheckadmonitionss$ ÿÿ  r}cCs(|D]}| d|d|df¡qdS)Ns%s: %s rr&)r8)r<rrrrrÚ_getadmonitionlistBsr~c Csrtƒ}|D]`}||}tj| ¡|d\}}t|ƒD]2\}} | ddkrNq6| d} | drn| dd ¡nd} |dt|ƒkr˜t t dƒ|| f¡‚g} t |dt|ƒƒD]t} || }|dd krÈq®|ddkrÚq$|dd krþ|j   t d ƒ|| f¡|d dkr|   |d¡q®q$q®| sH|j   t d ƒt | ¡¡¡| r^| | | | ¡q6| | | ¡q6q |S)N)Z admonitionsótypes admonitionsadmonitiontitleólinesrr&s6changeset %s: release notes directive %s lacks contentómarginó paragraphs=changeset %s: unexpected block in release notes directive %s óindents.error parsing releasenotes for revision: '%s' )rrrjrxÚ enumerateÚstriprcrrkrÚranger<r5r"r ryr%r')rKrzr{Únotesr|rnÚblocksZprunedÚiÚblockZ directiver#r$ÚjZpblockrrrÚparsenotesfromrevisionsGs^ ÿ  ÿüÿ    ÿüÿ ÿÿrŒc s tƒ}t |¡d‰d‡fdd„ }d}tˆƒD]Ö\}}|ddkrDq.|dd}|d d kr¤| |¡}|s|t td ƒ|¡‚|}||ƒ} | r¢| D]} | || ¡qq.|d d krò|t krØ||ƒ} | D]} | || ¡qÄn||d ƒ} |  ||| ¡q.t tdƒ|¡‚q.|S)z6Parse text content containing generated release notes.rFcs0g}t|dtˆƒƒD]}ˆ|}|ddkr4qnä|ddkrHq,nÐ|ddkrô|ddkrnt tdƒ¡‚|r’d d „|d Dƒ}| |¡qn`d d „|d Dƒg}ˆ|dd…D].}|dd vrÊqæ|ddkr¶| |d ¡q¶| |¡qn$|ddkrt tdƒ|d¡‚|r| |d ¡q|S)Nr&rrósectionóbulletrƒrs#indented bullet lists not supportedcSsg|]}|dd… ¡‘qS©r&N©r…©r-ÚlrrrrLžr1zJparsereleasenotesfile..gatherparagraphsbullets..r€cSsg|]}|dd… ¡‘qSrrr‘rrrrL¢r1)rŽrr‚s*unexpected block type in release notes: %s)r†rcrrkrr")Úoffsetr#Z notefragmentr‰rŠrW©rˆrrÚgatherparagraphsbulletss>        ÿÿz6parsereleasenotesfile..gatherparagraphsbulletsNrrr€s underlineó=s!unknown release notes section: %só-Tsunsupported section type for %s)F) rrrjr„rQrrkrr'ÚBULLET_SECTIONr%) rÚtextr‡r•Zcurrentsectionr‰rŠr#rOZ bullet_pointsrXr$rr”rÚparsereleasenotesfileŠs8%     ÿ  ršc Cs¨g}|D]x\}}||vrq| |¡| dt|ƒ¡| d¡| |¡D]v\}}| |¡| dt|ƒ¡| d¡t|ƒD]4\}}|r˜| d¡| tjd |¡dd ¡¡q‚| d¡qL|  |¡} | |¡r| r| t ¡| dtt ƒ¡| d¡| D]v}| tjd |d¡ddd d  ¡¡|d d …D]2}| d¡| tjd |¡dd d d  ¡¡q@| d¡q q|rž|d rž| d¡d |¡S)zÓ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–r1r—rRéN)Úwidthrs* s )rœZ initindentZ hangindentr&Néÿÿÿÿó ) r"rcr*r„rTrZwraprUÚ splitlinesr+r˜) rr‡rWZ sectionnameZ sectiontitler#r$r‰rXZ nontitledrrrÚserializenotesÙs\     ÿ     üÿ  üÿ  r ó releasenotesórórevr1s&revisions to process for release notessREVócócheckFs+checks for validity of admonitions (if any)ólólists/list the available admonitions with their titles"hg releasenotes [-r REV] [-c] FILE)Z helpcategoryc Ksjt |¡}t||ƒ}t |dddg¡| d¡r:t||ƒS| d¡}t ||pPdg¡}| d¡rrt |||  ¡|ƒSt ||  ¡|ƒ}|dur¤|  d¡|  t||ƒ¡Szs„   ,           û ]    $COIûûûñæ u