71 lines
1.6 KiB
ReStructuredText
71 lines
1.6 KiB
ReStructuredText
.. warning::
|
|
This project is now archived and the repository is set to read only.
|
|
|
|
Testbed for Automatically Generating RPM Release Fields and Changelogs
|
|
======================================================================
|
|
|
|
This project hosts the `rpmautospec` python package and script, which attempt to automatically
|
|
calculate release numbers and generate an RPM changelog from the dist-git repository of a package
|
|
and the information available in the Koji build system.
|
|
|
|
Dependencies:
|
|
|
|
* python3
|
|
* python3-pygit2
|
|
|
|
General
|
|
-------
|
|
|
|
The script `rpmautospec.py` allows testing the various algorithms for automatic release and
|
|
changelog generation. It accepts normal CLI options, run `python rpmautospec.py --help` for more
|
|
information.
|
|
|
|
Generating a Changelog
|
|
----------------------
|
|
|
|
This is how you can use it:
|
|
|
|
* Clone a dist-git repository
|
|
|
|
::
|
|
|
|
fedpkg clone -a guake
|
|
|
|
* Generating the changelog, pointing it to the repository cloned above
|
|
|
|
::
|
|
|
|
python rpmautospec.py generate-changelog guake
|
|
|
|
|
|
Note: You can also generate a good basic changelog using::
|
|
|
|
git log --after=2018-01-28 --pretty=oneline \
|
|
--format='%w(1000)**%h**%n* %cd %an <%ae>%n%w(60,0,2)- %s%n' \
|
|
--date="format:%a %b %d %Y"
|
|
|
|
|
|
Calculating the Next Value for the Release Field
|
|
------------------------------------------------
|
|
|
|
Calculate the next value for the RPM release field (i.e. to be used for the next build) by running
|
|
the script this way:
|
|
|
|
::
|
|
|
|
python rpmautospec.py calculate-release [--algorithm ...] <pkgname> <disttag> [<evr>]
|
|
|
|
E.g.:
|
|
|
|
::
|
|
|
|
python rpmautospec.py calculate-release bash fc31
|
|
|
|
::
|
|
|
|
python rpmautospec.py --algorithm holistic_heuristic gimp fc30
|
|
|
|
|
|
---
|
|
|
|
License: CC0
|