Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- changelog-generator [2023/09/18 00:12] – 46.114.222.68
+++ changelog-generator [2023/11/22 22:13] (aktuell) – gelöscht weis
@@ Zeile 1: / Zeile 1: @@
-**Abstract:** Python-Skript zur automatisierten Erzeugung eines Changelogs (Markdown) aus einem git-Repository (Conventional commits).
-//Work-in-progress//
-**Verantwortliche:** Daniel Fütterer, M.A. (Wissenschaftlicher Mitarbeiter), Prof. Dr. Marlon Schumacher
-**Ressourcen:** [[https://git.marlonschumacher.de/summary/?r=~fuetterer/changelog_generator.git | Software Repository]]
-Die Idee zum Skript enstand aus dem Bedarf, bei öffentlichen Repositories einen unkomplizierten Weg zu finden, Entwicklungsvorgänge anhand eines Logs (Changelog) zu dokumentieren und sauber zu formatieren. Mit Hilfe der Verwendung von [[https://www.conventionalcommits.org/en/v1.0.0/ | Conventional Commits]] ist es möglich, das zu automatisieren. Conventional Commits ist ein Regelwerk, das einen einheitlichen Aufbau für sämtliche Commit Messages eines Repositorys vorgibt.
-Ziel ist es, diese verschiedenen Parameter (//type//: Kategorie von Commits, //scope//: deren Umfangsbereich, //tag//: Versionsnummern, hash etc.) zu erfassen und strukturiert darzustellen.
-Das Skript steht in Python, ist objektorientiert implementiert und noch nicht veröffentlicht, mit ihm erzeugte Changelogs sind aber bereits in Verwendung, z.B. [[https://github.com/marleynoe/Binauralix/releases | Binauralix]] (Applikation zur Binauralisierung beliebiger Lautsprecher Konfigurationen) von M. Schumacher.
-{{:changelog_screenshot.jpg?400|}}
-# Beispiel-Changelog (vgl. Beitragsbild)
-## Version 1.0
-### Features
-- *scope*
-    - message (short-hash)
-### Fixes
-- *scope*
-    - message (short-hash)
-### Other
-- *scope*
-    - (type) message (short-hash)
-### Non-conform commits
-- full message (short-hash)
-Commits werden nach den Types der //conventional commits// Syntax sortiert: //feature// und //fix// werden separat aufgezählt, andere Typen werden unter //other// gesammelt. Innerhalb der Types wird nach //scope// untersortiert; diese werden durch das Skript ausgelesen und gegliedert. Commits, die nicht nach der cc-Syntax erfassbar sind, werden nicht verworfen, sondern am Ende gesammelt. Diese Gruppierung gilt jeweils für eine Versionsnummer.
-In der aktuellen Entwicklungsversion sind diese Einstellungen noch statisch, in Zukunft sollen sie dynamisch über Kommandozeilenparameter flexibler gestaltet werden können. Das Programm wird ohne Parameter aufgerufen:
-python changelog-generator.py
-Daraufhin fragt das Skript den Pfad zum git-Repository ab und wo der Changelog gespeichert werden soll.