upstream/mercurial-mirror Files · tests/test-releasenotes-formatting.t

identify: add template support...

identify: add template support This is based on a patch proposed last year by Mathias De Maré[1], with a few changes. - Tags and bookmarks are now formatted lists, for more flexible queries. - The templater is populated whether or not [-nibtB] is specified. (Plain output is unchanged.) This seems more consistent with other templated commands. - The 'id' property is a string, instead of a list. - The parents of 'wdir()' have their own list of attributes. I left 'id' as a string because it seems very useful for generating version info. It's also a bit strange because the value and meaning changes depending on whether or not --debug is passed (short vs full hash), whether the revision is a merge or not (one hash or two, separated by a '+'), the working directory or not (node vs p1node), and local or not (remote defaults to tip, and never has '+'). The equivalent string built with {rev} seems much less useful, and I couldn't think of a reasonable name, so I left it out. The discussion seemed to be pointing towards having a list of nodes, with more than one entry for a merge. It seems simpler to give the nodes a name, and use {node} for the actual commit probed, especially now that there is a virtual node for 'wdir()'. Yuya mentioned using fm.nested() in that thread, so I did for the parent nodes. I'm not sure if the plan is to fill in all of the context attributes in these items, or if these nested items should simply be made {p1node} and {p1rev}. I used ':' as the tag separator for consistency with {tags} in the log templater. Likewise, bookmarks are separated by a space for consistency with the corresponding log template. [1] https://www.mercurial-scm.org/pipermail/mercurial-devel/2016-August/087039.html

Rishabh Madan - - Load All Authors

File last commit:

r32779:2510823c default


                r33051:15a79ac8

default

Download file

             test-releasenotes-formatting.t
        
                    326 lines
            
             | 5.7 KiB
            
                | text/troff
            
             |
                Tads3Lexer
            
             / tests / test-releasenotes-formatting.t
          
                    History
                
                 |
                  Source
                 | Raw
                 |Copy content
                 |Copy permalink

        Gregory Szorc
    
releasenotes: command to manage release notes files...

              r32778
            
        $ cat >> $HGRCPATH << EOF

        > [extensions]

        > releasenotes=

        > EOF

        $ hg init simple-repo

        $ cd simple-repo

      A fix with a single line results in a bullet point in the appropriate section

        $ touch fix1

        $ hg -q commit -A -l - << EOF

        > single line fix

        > 

        > .. fix::

        > 

        >    Simple fix with a single line content entry.

        > EOF

        $ hg releasenotes -r . $TESTTMP/relnotes-single-line

        $ cat $TESTTMP/relnotes-single-line

        Bug Fixes

        =========

        * Simple fix with a single line content entry.

      A fix with multiple lines is handled correctly

        $ touch fix2

        $ hg -q commit -A -l - << EOF

        > multi line fix

        > 

        > .. fix::

        > 

        >    First line of fix entry.

        >    A line after it without a space.

        > 

        >    A new paragraph in the fix entry. And this is a really long line. It goes on for a while.

        >    And it wraps around to a new paragraph.

        > EOF

        $ hg releasenotes -r . $TESTTMP/relnotes-multi-line

        $ cat $TESTTMP/relnotes-multi-line

        Bug Fixes

        =========

        * First line of fix entry. A line after it without a space.

          A new paragraph in the fix entry. And this is a really long line. It goes on

          for a while. And it wraps around to a new paragraph.

      A release note with a title results in a sub-section being written

        $ touch fix3

        $ hg -q commit -A -l - << EOF

        > fix with title

        > 

        > .. fix:: Fix Title

        > 

        >    First line of fix with title.

        > 

        >    Another paragraph of fix with title. But this is a paragraph

        >    with multiple lines.

        > EOF

        $ hg releasenotes -r . $TESTTMP/relnotes-fix-with-title

        $ cat $TESTTMP/relnotes-fix-with-title

        Bug Fixes

        =========

        Fix Title

        ---------

        First line of fix with title.

        Another paragraph of fix with title. But this is a paragraph with multiple

        lines.

        $ cd ..

      Formatting of multiple bullet points works

        $ hg init multiple-bullets

        $ cd multiple-bullets

        $ touch fix1

        $ hg -q commit -A -l - << EOF

        > commit 1

        > 

        > .. fix::

        > 

        >    first fix

        > EOF

        $ touch fix2

        $ hg -q commit -A -l - << EOF

        > commit 2

        > 

        > .. fix::

        > 

        >    second fix

        > 

        >    Second paragraph of second fix.

        > EOF

        $ touch fix3

        $ hg -q commit -A -l - << EOF

        > commit 3

        > 

        > .. fix::

        > 

        >    third fix

        > EOF

        $ hg releasenotes -r 'all()' $TESTTMP/relnotes-multiple-bullets

        $ cat $TESTTMP/relnotes-multiple-bullets

        Bug Fixes

        =========

        * first fix

        * second fix

          Second paragraph of second fix.

        * third fix

        $ cd ..

      Formatting of multiple sections works

        $ hg init multiple-sections

        $ cd multiple-sections

        $ touch fix1

        $ hg -q commit -A -l - << EOF

        > commit 1

        > 

        > .. fix::

        > 

        >    first fix

        > EOF

        $ touch feature1

        $ hg -q commit -A -l - << EOF

        > commit 2

        > 

        > .. feature::

        > 

        >    description of the new feature

        > EOF

        $ touch fix2

        $ hg -q commit -A -l - << EOF

        > commit 3

        > 

        > .. fix::

        > 

        >    second fix

        > EOF

        $ hg releasenotes -r 'all()' $TESTTMP/relnotes-multiple-sections

        $ cat $TESTTMP/relnotes-multiple-sections

        New Features

        ============

        * description of the new feature

        Bug Fixes

        =========

        * first fix

        * second fix

        $ cd ..

      Section with subsections and bullets

        $ hg init multiple-subsections

        $ cd multiple-subsections

        $ touch fix1

        $ hg -q commit -A -l - << EOF

        > commit 1

        > 

        > .. fix:: Title of First Fix

        > 

        >    First paragraph of first fix.

        > 

        >    Second paragraph of first fix.

        > EOF

        $ touch fix2

        $ hg -q commit -A -l - << EOF

        > commit 2

        > 

        > .. fix:: Title of Second Fix

        > 

        >    First paragraph of second fix.

        > 

        >    Second paragraph of second fix.

        > EOF

        $ hg releasenotes -r 'all()' $TESTTMP/relnotes-multiple-subsections

        $ cat $TESTTMP/relnotes-multiple-subsections

        Bug Fixes

        =========

        Title of First Fix

        ------------------

        First paragraph of first fix.

        Second paragraph of first fix.

        Title of Second Fix

        -------------------

        First paragraph of second fix.

        Second paragraph of second fix.

      Now add bullet points to sections having sub-sections

        $ touch fix3

        $ hg -q commit -A -l - << EOF

        > commit 3

        > 

        > .. fix::

        > 

        >    Short summary of fix 3

        > EOF

        $ hg releasenotes -r 'all()' $TESTTMP/relnotes-multiple-subsections-with-bullets

        $ cat $TESTTMP/relnotes-multiple-subsections-with-bullets

        Bug Fixes

        =========

        Title of First Fix

        ------------------

        First paragraph of first fix.

        Second paragraph of first fix.

        Title of Second Fix

        -------------------

        First paragraph of second fix.

        Second paragraph of second fix.

        Other Changes

        -------------

        * Short summary of fix 3

        Rishabh Madan
    
releasenotes: add more tests for formatting and merging of release notes

              r32779
            
      Multiple 'Other Changes' sub-sections for every section

        $ hg init multiple-otherchanges

        $ cd multiple-otherchanges

        $ touch fix1

        $ hg -q commit -A -l - << EOF

        > commit 1

        > 

        > .. fix:: Title of First Fix

        > 

        >    First paragraph of fix 1.

        > EOF

        $ touch feature1

        $ hg -q commit -A -l - << EOF

        > commit 2

        > 

        > .. feature:: Title of First Feature

        > 

        >    First paragraph of feature 1.

        > EOF

        $ touch feature2

        $ hg -q commit -A -l - << EOF

        > commit 3

        > 

        > .. feature::

        > 

        >    Short summary of feature 2.

        > EOF

        $ touch fix2

        $ hg -q commit -A -l - << EOF

        > commit 4

        > 

        > .. fix::

        > 

        >    Short summary of fix 2

        > EOF

        $ hg releasenotes -r 'all()' $TESTTMP/relnotes-multiple-otherchanges

        $ cat $TESTTMP/relnotes-multiple-otherchanges

        New Features

        ============

        Title of First Feature

        ----------------------

        First paragraph of feature 1.

        Other Changes

        -------------

        * Short summary of feature 2.

        Bug Fixes

        =========

        Title of First Fix

        ------------------

        First paragraph of fix 1.

        Other Changes

        -------------

        * Short summary of fix 2

	Site-wide shortcuts
/	Use quick search box
g h	Goto home page
g g	Goto my private gists page
g G	Goto my public gists page
g 0-9	Goto bookmarked items from 0-9
n r	New repository page
n g	New gist page

	Repositories
g s	Goto summary page
g c	Goto changelog page
g f	Goto files page
g F	Goto files page with file search activated
g p	Goto pull requests page
g o	Goto repository settings
g O	Goto repository access permissions settings
t s	Toggle sidebar on some pages

Gregory Szorc releasenotes: command to manage release notes files...	r32778	$ cat >> $HGRCPATH << EOF
		> [extensions]
		> releasenotes=
		> EOF

		$ hg init simple-repo
		$ cd simple-repo

		A fix with a single line results in a bullet point in the appropriate section

		$ touch fix1
		$ hg -q commit -A -l - << EOF
		> single line fix
		>
		> .. fix::
		>
		> Simple fix with a single line content entry.
		> EOF

		$ hg releasenotes -r . $TESTTMP/relnotes-single-line

		$ cat $TESTTMP/relnotes-single-line
		Bug Fixes
		=========

		* Simple fix with a single line content entry.

		A fix with multiple lines is handled correctly

		$ touch fix2
		$ hg -q commit -A -l - << EOF
		> multi line fix
		>
		> .. fix::
		>
		> First line of fix entry.
		> A line after it without a space.
		>
		> A new paragraph in the fix entry. And this is a really long line. It goes on for a while.
		> And it wraps around to a new paragraph.
		> EOF

		$ hg releasenotes -r . $TESTTMP/relnotes-multi-line
		$ cat $TESTTMP/relnotes-multi-line
		Bug Fixes
		=========

		* First line of fix entry. A line after it without a space.

		A new paragraph in the fix entry. And this is a really long line. It goes on
		for a while. And it wraps around to a new paragraph.

		A release note with a title results in a sub-section being written

		$ touch fix3
		$ hg -q commit -A -l - << EOF
		> fix with title
		>
		> .. fix:: Fix Title
		>
		> First line of fix with title.
		>
		> Another paragraph of fix with title. But this is a paragraph
		> with multiple lines.
		> EOF

		$ hg releasenotes -r . $TESTTMP/relnotes-fix-with-title
		$ cat $TESTTMP/relnotes-fix-with-title
		Bug Fixes
		=========

		Fix Title
		---------

		First line of fix with title.

		Another paragraph of fix with title. But this is a paragraph with multiple
		lines.

		$ cd ..

		Formatting of multiple bullet points works

		$ hg init multiple-bullets
		$ cd multiple-bullets
		$ touch fix1
		$ hg -q commit -A -l - << EOF
		> commit 1
		>
		> .. fix::
		>
		> first fix
		> EOF

		$ touch fix2
		$ hg -q commit -A -l - << EOF
		> commit 2
		>
		> .. fix::
		>
		> second fix
		>
		> Second paragraph of second fix.
		> EOF

		$ touch fix3
		$ hg -q commit -A -l - << EOF
		> commit 3
		>
		> .. fix::
		>
		> third fix
		> EOF

		$ hg releasenotes -r 'all()' $TESTTMP/relnotes-multiple-bullets
		$ cat $TESTTMP/relnotes-multiple-bullets
		Bug Fixes
		=========

		* first fix

		* second fix

		Second paragraph of second fix.

		* third fix

		$ cd ..

		Formatting of multiple sections works

		$ hg init multiple-sections
		$ cd multiple-sections
		$ touch fix1
		$ hg -q commit -A -l - << EOF
		> commit 1
		>
		> .. fix::
		>
		> first fix
		> EOF

		$ touch feature1
		$ hg -q commit -A -l - << EOF
		> commit 2
		>
		> .. feature::
		>
		> description of the new feature
		> EOF

		$ touch fix2
		$ hg -q commit -A -l - << EOF
		> commit 3
		>
		> .. fix::
		>
		> second fix
		> EOF

		$ hg releasenotes -r 'all()' $TESTTMP/relnotes-multiple-sections
		$ cat $TESTTMP/relnotes-multiple-sections
		New Features
		============

		* description of the new feature

		Bug Fixes
		=========

		* first fix

		* second fix

		$ cd ..

		Section with subsections and bullets

		$ hg init multiple-subsections
		$ cd multiple-subsections

		$ touch fix1
		$ hg -q commit -A -l - << EOF
		> commit 1
		>
		> .. fix:: Title of First Fix
		>
		> First paragraph of first fix.
		>
		> Second paragraph of first fix.
		> EOF

		$ touch fix2
		$ hg -q commit -A -l - << EOF
		> commit 2
		>
		> .. fix:: Title of Second Fix
		>
		> First paragraph of second fix.
		>
		> Second paragraph of second fix.
		> EOF

		$ hg releasenotes -r 'all()' $TESTTMP/relnotes-multiple-subsections
		$ cat $TESTTMP/relnotes-multiple-subsections
		Bug Fixes
		=========

		Title of First Fix
		------------------

		First paragraph of first fix.

		Second paragraph of first fix.

		Title of Second Fix
		-------------------

		First paragraph of second fix.

		Second paragraph of second fix.

		Now add bullet points to sections having sub-sections

		$ touch fix3
		$ hg -q commit -A -l - << EOF
		> commit 3
		>
		> .. fix::
		>
		> Short summary of fix 3
		> EOF

		$ hg releasenotes -r 'all()' $TESTTMP/relnotes-multiple-subsections-with-bullets
		$ cat $TESTTMP/relnotes-multiple-subsections-with-bullets
		Bug Fixes
		=========

		Title of First Fix
		------------------

		First paragraph of first fix.

		Second paragraph of first fix.

		Title of Second Fix
		-------------------

		First paragraph of second fix.

		Second paragraph of second fix.

		Other Changes
		-------------

		* Short summary of fix 3
Rishabh Madan releasenotes: add more tests for formatting and merging of release notes	r32779
		Multiple 'Other Changes' sub-sections for every section

		$ hg init multiple-otherchanges
		$ cd multiple-otherchanges

		$ touch fix1
		$ hg -q commit -A -l - << EOF
		> commit 1
		>
		> .. fix:: Title of First Fix
		>
		> First paragraph of fix 1.
		> EOF

		$ touch feature1
		$ hg -q commit -A -l - << EOF
		> commit 2
		>
		> .. feature:: Title of First Feature
		>
		> First paragraph of feature 1.
		> EOF

		$ touch feature2
		$ hg -q commit -A -l - << EOF
		> commit 3
		>
		> .. feature::
		>
		> Short summary of feature 2.
		> EOF

		$ touch fix2
		$ hg -q commit -A -l - << EOF
		> commit 4
		>
		> .. fix::
		>
		> Short summary of fix 2
		> EOF

		$ hg releasenotes -r 'all()' $TESTTMP/relnotes-multiple-otherchanges
		$ cat $TESTTMP/relnotes-multiple-otherchanges
		New Features
		============

		Title of First Feature
		----------------------

		First paragraph of feature 1.

		Other Changes
		-------------

		* Short summary of feature 2.

		Bug Fixes
		=========

		Title of First Fix
		------------------

		First paragraph of fix 1.

		Other Changes
		-------------

		* Short summary of fix 2