Klasse ChangelogMojo
java.lang.Object
org.apache.maven.plugin.AbstractMojo
com.github.koraktor.mavanagaiata.mojo.AbstractGitMojo
com.github.koraktor.mavanagaiata.mojo.AbstractGitOutputMojo
com.github.koraktor.mavanagaiata.mojo.ChangelogMojo
- Alle implementierten Schnittstellen:
org.apache.maven.plugin.ContextEnabled
,org.apache.maven.plugin.Mojo
@Mojo(name="changelog",
defaultPhase=PROCESS_RESOURCES,
threadSafe=true)
public class ChangelogMojo
extends AbstractGitOutputMojo
This goal allows to generate a changelog of the currently checked out branch
of the Git repository. It will use information from tags and commit messages
to build a reverse chronological summary of the development. It can be
configured to display the changelog or save it to a file.
- Seit:
- 0.2.0
- Autor:
- Sebastian Staudt
-
Verschachtelte Klassen - Übersicht
Modifizierer und TypKlasseBeschreibung(Package privat) class
(Package privat) static enum
Pre-defined base URLs used for links -
Feldübersicht
Modifizierer und TypFeldBeschreibungprotected ChangelogFormat
The format to use while generating the changelog(Package privat) ChangelogFormat.Formats
The formatting template to use while generating the changelog(Package privat) ChangelogMojo.LinkToBaseUrl
Used to select the service to create links to(Package privat) String
Can be used to override the pre-defined URLs fromlinkTo
with a customized URL(Package privat) String
The project name for GitHub links(Package privat) String
The user name for GitHub linksprotected File
The file to write the changelog to(Package privat) String
Whether to skip commits that match the given regular expressionprivate Pattern
(Package privat) boolean
Whether to skip merge commits’ messages(Package privat) boolean
Whether to skip tagged commits' messages
This is useful when usually tagging commits like "Version bump to X.Y.Z"Von Klasse geerbte Felder com.github.koraktor.mavanagaiata.mojo.AbstractGitOutputMojo
encoding, footer, printStream
Von Klasse geerbte Felder com.github.koraktor.mavanagaiata.mojo.AbstractGitMojo
baseDir, dateFormat, dirtyFlag, dirtyIgnoreUntracked, failGracefully, gitDir, head, project, propertyPrefixes, skip, skipNoGit
Von Schnittstelle geerbte Felder org.apache.maven.plugin.Mojo
ROLE
-
Konstruktorübersicht
-
Methodenübersicht
Modifizierer und TypMethodeBeschreibungReturns the output file for the generated changelogprotected void
void
setOutputFile
(File outputFile) Sets the output file for the generated changelogprotected void
writeOutput
(GitRepository repository) Walks through the history of the currently checked out branch of the Git repository and builds a changelog from the commits contained in that branch.Von Klasse geerbte Methoden com.github.koraktor.mavanagaiata.mojo.AbstractGitOutputMojo
createPrintStream, generateOutput, init, run, unescapeFormatNewlines
Von Klasse geerbte Methoden com.github.koraktor.mavanagaiata.mojo.AbstractGitMojo
addProperty, execute, initRepository, prepareParameters
Von Klasse geerbte Methoden org.apache.maven.plugin.AbstractMojo
getLog, getPluginContext, setLog, setPluginContext
-
Felddetails
-
format
The format to use while generating the changelog- Seit:
- 0.9.0
- Siehe auch:
-
formatTemplate
@Parameter(property="mavanagaiata.changelog.formatTemplate", defaultValue="DEFAULT") ChangelogFormat.Formats formatTemplateThe formatting template to use while generating the changelogThis may be one of
DEFAULT
orMARKDOWN
.Individual attributes may be overridden using
format
.- Seit:
- 0.9.0
-
linkToProject
The project name for GitHub links- Seit:
- 0.9.0
-
linkToUser
The user name for GitHub links- Seit:
- 0.9.0
-
linkTo
@Parameter(property="mavanagaiata.changelog.linkTo", defaultValue="GITHUB") ChangelogMojo.LinkToBaseUrl linkToUsed to select the service to create links toGITHUB
andGITLAB
are available.- Seit:
- 0.9.0
-
linkToBaseUrl
Can be used to override the pre-defined URLs fromlinkTo
with a customized URL- Seit:
- 0.9.0
-
outputFile
The file to write the changelog to- Seit:
- 0.4.1
-
skipMergeCommits
@Parameter(property="mavanagaiata.changelog.skipMergeCommits", defaultValue="true") boolean skipMergeCommitsWhether to skip merge commits’ messages- Seit:
- 0.9.0
-
skipTagged
@Parameter(property="mavanagaiata.changelog.skipTagged", defaultValue="false") boolean skipTaggedWhether to skip tagged commits' messages
This is useful when usually tagging commits like "Version bump to X.Y.Z" -
skipCommitsMatching
Whether to skip commits that match the given regular expression- Seit:
- 0.8.0
-
skipCommitsPattern
-
-
Konstruktordetails
-
ChangelogMojo
public ChangelogMojo()
-
-
Methodendetails
-
writeOutput
Walks through the history of the currently checked out branch of the Git repository and builds a changelog from the commits contained in that branch.- Angegeben von:
writeOutput
in KlasseAbstractGitOutputMojo
- Parameter:
repository
- The repository the mojo is running in- Löst aus:
MavanagaiataMojoException
- if retrieving information from the Git repository fails
-
getOutputFile
Returns the output file for the generated changelog- Angegeben von:
getOutputFile
in KlasseAbstractGitOutputMojo
- Gibt zurück:
- The output file for the generated changelog
-
initConfiguration
protected void initConfiguration()- Setzt außer Kraft:
initConfiguration
in KlasseAbstractGitOutputMojo
-
setOutputFile
Sets the output file for the generated changelog- Angegeben von:
setOutputFile
in KlasseAbstractGitOutputMojo
- Parameter:
outputFile
- The output file for the generated changelog
-