Python Package for Automatic Generation of RPM Release Fields and Changelogs

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

  This project hosts the ``rpmautospec`` python package and script, which has these functions:

  - Attempt to automatically calculate release numbers and generate an RPM changelog from the dist-git

  .. _using-autochangelog:

  `rpmautospec` combines two sources of information to generate a changelog

  which is inserted in the spec file where the ``%autochangelog`` macro is set.

  still bumped for such commits.

  .. _only commits example:

  If a package has no ``changelog`` file, `rpmautospec` will only use the git

  history to generate the changelog.

  .. _commits and changelog example:

  If a package has a ``changelog`` file, `rpmautospec` will only generate entries

  from the commits after its last change and then append its contents verbatim.

  .. _using-autorelease:

  Fedora's `Versioning Guidelines`_ define the different elements of which a

  release field consists. They are as follows:

    the option when bumping the version the next time).

  * ``-n``: Don’t render the dist tag, e.g. for use in macros, if the dist tag is added later.

  .. important::

      To date, the ``%autorelease`` parameters are ignored in the headers of automatically generated

      changelog entries.

      In the prototype version the macro was named ``%autorel``. To make its purpose more obvious, it is

      ``%autorelease`` now.

  .. _simple example:

  .. literalinclude:: examples/test-autorelease.spec

     :language: spec

  .. _baserelease example:

  .. literalinclude:: examples/test-autorelease-baserelease.spec

     :language: spec

  In the modern versioning, those fields are embedded in the package `Version` instead.

  .. _prerelease example:

  .. literalinclude:: examples/test-autorelease-prerelease.spec

     :language: spec

  .. _extraver case:

  .. literalinclude:: examples/test-autorelease-extraver.spec

     :language: spec

  .. _snapshot case:

  .. literalinclude:: examples/test-autorelease-snapshot.spec

     :language: spec

  .. _snapshot_and_extraver case:

  .. literalinclude:: examples/test-autorelease-extraver-snapshot.spec

     :language: spec

  `rpmautospec` is a program and library used to automatically generate the

  release and changelog fields in RPM spec files opting to use it.

     autochangelog

     peculiarities

     install

  Installing `rpmautospec`

  `rpmautospec` consists of these components:

      The library requires a minimum Python version of 3.6.

  The Koji plugin ``rpmautospec_builder`` is meant to be installed on all the

  Koji builders running the ``buildSRPMFromSCM`` task in:

  .. code-block:: spec

      documented here: :ref:`using-autorelease`.

  For new packages

  ^^^^^^^^^^^^^^^^

  Use the ``convert`` command to do this automatically:

  After the change, the content of the ``%changelog`` section should be:

  history of your git repository up until the most recent commit that

  changes the ``changelog`` file.

  .. note::

  .. _peculiarities:

  Peculiarities of `rpmautospec`

  `rpmautospec` has few peculiarities that we are aware of. Some may get

  fixed, others are considered negligible, but we still want to document them

  as the merge commit and disregard the others.

  .. code-block:: bash

  When preprocessing spec files for building, `rpmautospec` adds a header to the

  top of the spec file containing, among other things, information about its