towncrier - manage a useful, summarised news file for your project

Commands

        [build] [--namePROJECT_NAME] [--versionRELEASE_VERSION] [--dateRELEASE_DATE] [--draft] [--yes]
        [--keep]

              Discover  all  the  news  fragments  in  FRAGMENTS_DIR,  and  collate them.  Render them as a news
              document for project PROJECT_NAME released on  RELEASE_DATE  as  version  RELEASE_VERSION.   Then,
              append  the  generated  news  document to the configured news file, use Git to stage the resulting
              file, and finally prompt the user for whether to delete the news fragment files.  (Or, if  --draft
              is  specified: Emit the news file text to the standard error stream, and do not change any files.)
              If --yes is specified, omit the prompt and assume “yes” to delete news fragment files.

              If --keep is specified, omit the prompt and assume “no” to delete news fragment files.

       create [--contentCONTENT] [--edit|--no-edit] FRAGMENT_FILE

              Create a news fragment with filename FRAGMENT_FILE.  If --content is specified, populate the  news
              fragment  file  with text content CONTENT.  If --edit is specified, launch the default text editor
              with the news fragment file.

       check [--compare-withGIT_COMMIT]

              Compare the current news file and fragments to  those  in  the  Git  commit  GIT_COMMIT  (default:
              origin/master); then, if the news file is the same, report any additional fragments found.

Copyright

       This manual page is Copyright © 2021–2024 Ben Finney and Sérgio de Almeida Cipriano Junior, and is freely
       available to anyone under certain conditions.  See the source document for details.

Description

towncrier  is  a  utility to produce useful, summarised news files for your project.  Rather than reading
       the VCS history to produce it, or having one single file which developers all write to,  towncrier  reads
       “news fragments” which contain information useful to end users.

Name

       towncrier - manage a useful, summarised news file for your project

Options

--configCONFIG_FILE
              Use  the  specified  CONFIG_FILE  to configure program behaviour.  (Default: towncrier.toml or, if
              that does not exist, pyproject.toml)

       --dirFRAGMENTS_DIR
              Manage news  fragments  in  the  directory  FRAGMENTS_DIR,  relative  to  the  project  directory.
              (Default: newsfragments)

       -v--version
              Emit the program version.

       -h--help Describe how to use the program.

Reporting Bugs

       Please report any bugs using the Towncrier project issue tracker.

Synopsis

towncrier … [--configCONFIG_FILE] [--dirFRAGMENTS_DIR] …

       towncrier [build] [--namePROJECT_NAME] [--versionRELEASE_VERSION] [--dateRELEASE_DATE] [--draft]
                 [--yes] [--keep]

       towncriercreate [--contentCONTENT] [--edit|--no-edit] FRAGMENT_FILEtowncriercheck [--compare-withGIT_COMMIT]

       towncrier--helptowncrier--version