Package org.apache.maven.shared.release.config

Interface ReleaseDescriptor

public interface ReleaseDescriptor

ReleaseDescriptor interface.

Author:
Robert Scholte

  • Method Details

    • isUpdateDependencies

      boolean isUpdateDependencies()
      Get if updateDependencies is false, dependencies version won't be updated to the next development version.
      Returns:
      boolean

    • isUseReleaseProfile

      boolean isUseReleaseProfile()
      Get whether to use the release profile that adds sources and javadocs to the released artifact, if appropriate. If set to true, this will set the property "performRelease" to true.
      Returns:
      boolean

    • isAutoVersionSubmodules

      boolean isAutoVersionSubmodules()
      Get whether to use the parent pom version for submodule versions.
      Returns:
      boolean

    • isSnapshotReleasePluginAllowed

      boolean isSnapshotReleasePluginAllowed()
      Get whether a SNAPSHOT of the release plugin is allowed.
      Returns:
      boolean

    • isCommitByProject

      boolean isCommitByProject()
      Get the commits must be done by modules or not. Set it to true in case of flat directory structure.
      Returns:
      boolean

    • isBranchCreation

      boolean isBranchCreation()
      Get whether to create a branch instead of do a release.
      Returns:
      boolean

    • isUpdateBranchVersions

      boolean isUpdateBranchVersions()
      Get whether to update branch POM versions.
      Returns:
      boolean

    • isUpdateWorkingCopyVersions

      boolean isUpdateWorkingCopyVersions()
      Get whether to update working copy POM versions.
      Returns:
      boolean

    • isSuppressCommitBeforeTagOrBranch

      boolean isSuppressCommitBeforeTagOrBranch()
      Get whether to suppress a commit of changes to the working copy before a tag or branch is created.
      Returns:
      boolean

    • isAllowTimestampedSnapshots

      boolean isAllowTimestampedSnapshots()
      Get should timestamped SNAPSHOT dependencies be allowed? Default is to fail when any SNAPSHOT dependency is found.
      Returns:
      boolean

    • isUpdateVersionsToSnapshot

      boolean isUpdateVersionsToSnapshot()
      Get whether to update branch versions to SNAPSHOT.
      Returns:
      boolean

    • isRemoteTagging

      boolean isRemoteTagging()
      Get nOTE : currently only implemented with svn scm. Enable a workaround to prevent issue due to svn client > 1.5.0 (https://issues.apache.org/jira/browse/SCM-406).
      Returns:
      boolean

    • isScmSignTags

      boolean isScmSignTags()
      Get if the scm provider should sign the tag. NOTE: currently only implemented with git-exe.
      Returns:
      boolean true if SCM tag should be signed

    • isLocalCheckout

      boolean isLocalCheckout()
      Get if the scm provider should use local checkouts via file://${basedir} instead of doing a clean checkout over the network. This is very helpful for releasing large projects!
      Returns:
      boolean

    • isPushChanges

      boolean isPushChanges()
      Get should distributed changes be pushed to the central repository? For many distributed SCMs like Git, a change like a commit is only stored in your local copy of the repository. Pushing the change allows your to more easily share it with other users.
      Returns:
      boolean

    • getWorkItem

      String getWorkItem()
      Get default version to use for new working copy. Some SCMs may require a Work Item or a Task to allow the changes to be pushed or delivered. This field allows you to specify that Work Item or Task. It is optional, and only relevant if pushChanges is true.
      Returns:
      String

    • getDefaultDevelopmentVersion

      String getDefaultDevelopmentVersion()
      Get default version to use for new working copy.
      Returns:
      String

    • getScmRelativePathProjectDirectory

      String getScmRelativePathProjectDirectory()
      Get relative path of the project returned by the checkout command.
      Returns:
      String

    • getCheckoutDirectory

      String getCheckoutDirectory()
      Get the directory where the tag will be checked out.
      Returns:
      String

    • getPerformGoals

      String getPerformGoals()
      Get the goals to execute in perform phase for the release.
      Returns:
      String

    • getDefaultReleaseVersion

      String getDefaultReleaseVersion()
      Get default version to use for the tagged release or the new branch.
      Returns:
      String

    • getScmReleasedPomRevision

      String getScmReleasedPomRevision()
      Get nOTE : currently only implemented with svn scm. It contains the revision of the committed released pom to remotely tag the source code with this revision.
      Returns:
      String

    • isAddSchema

      boolean isAddSchema()
      Get whether to add the model schema to the top of the rewritten POM if it wasn't there already. If false then the root element will remain untouched.
      Returns:
      boolean

    • isGenerateReleasePoms

      boolean isGenerateReleasePoms()
      Get whether to generate release POMs.
      Returns:
      boolean

    • isInteractive

      boolean isInteractive()
      Get whether the release process is interactive and the release manager should be prompted to confirm values, or whether the defaults are used regardless.
      Returns:
      boolean

    • isScmUseEditMode

      boolean isScmUseEditMode()
      Get whether to use edit mode when making SCM modifications. This setting is disregarded if the SCM does not support edit mode, or if edit mode is compulsory for the given SCM.
      Returns:
      boolean

    • getActivateProfiles

      List<String> getActivateProfiles()

      getActivateProfiles.

      Returns:
      list of profiles to activate

    • getCompletedPhase

      String getCompletedPhase()
      Get the last completed phase.
      Returns:
      String

    • getCheckModificationExcludes

      List<String> getCheckModificationExcludes()
      Method getCheckModificationExcludes.
      Returns:
      List

    • getAdditionalArguments

      String getAdditionalArguments()
      Get additional arguments to pass to any executed Maven process.
      Returns:
      String

    • getPreparationGoals

      String getPreparationGoals()
      Get the goals to execute in preparation for the release.
      Returns:
      String

    • getCompletionGoals

      String getCompletionGoals()
      Get the goals to execute in on completion of preparation for the release.
      Returns:
      String

    • getPomFileName

      String getPomFileName()
      Get the file name of the POM to pass to any executed Maven process.
      Returns:
      String

    • getScmCommentPrefix

      String getScmCommentPrefix()
      Get the prefix of SCM modification messages.
      Returns:
      String

    • isScmShallowClone

      boolean isScmShallowClone()
      Get whether to use a shallow clone with no history or a full clone containing the full history during the release.
      Returns:
      boolean
      Since:
      3.0.0-M6

    • getScmReleaseCommitComment

      String getScmReleaseCommitComment()
      Get the SCM commit comment when setting pom.xml to release.
      Returns:
      String
      Since:
      3.0.0-M1

    • getScmDevelopmentCommitComment

      String getScmDevelopmentCommitComment()
      Get the SCM commit comment when setting pom.xml back to development.
      Returns:
      String
      Since:
      3.0.0-M1

    • getScmBranchCommitComment

      String getScmBranchCommitComment()
      Get the SCM commit comment when branching.
      Returns:
      String
      Since:
      3.0.0-M1

    • getScmRollbackCommitComment

      String getScmRollbackCommitComment()
      Get the SCM commit comment when rolling back.
      Returns:
      String
      Since:
      3.0.0-M1

    • getScmPrivateKeyPassPhrase

      String getScmPrivateKeyPassPhrase()
      Get pass phrase for the private key.
      Returns:
      String

    • getScmPassword

      String getScmPassword()
      Get the password for the user interacting with the scm.
      Returns:
      String

    • getScmPrivateKey

      String getScmPrivateKey()
      Get private key for an SSH based SCM repository.
      Returns:
      String

    • getScmReleaseLabel

      String getScmReleaseLabel()
      Get tag or branch name: the identifier for the tag/branch. Example: maven-release-plugin-2.0.
      Returns:
      String

    • getScmTagBase

      String getScmTagBase()
      Get where you are going to put your tagged sources Example https://svn.apache.org/repos/asf/maven/plugins/tags.
      Returns:
      String

    • getScmBranchBase

      String getScmBranchBase()
      Get where you are going to put your branched sources Example https://svn.apache.org/repos/asf/maven/plugins/branches.
      Returns:
      String

    • getScmId

      String getScmId()
      Get the id which can be used to get the (optionally encrypted) credentials with the given id from the settings.xml. Explicit credentials in getScmUsername(), getScmPassword(), getScmPrivateKey() or getScmPrivateKeyPassPhrase() always take precedence, though.
      Returns:
      the server id of a server in settings.xml

    • getScmSourceUrl

      String getScmSourceUrl()
      Get this is a MavenSCM of where you're going to get the sources to make the release with. Example: scm:svn:https://svn.apache.org/repos/asf/maven/plugins/trunk/maven-release-plugin.
      Returns:
      String

    • getScmUsername

      String getScmUsername()
      Get the user name to interact with the scm.
      Returns:
      String

    • getWaitBeforeTagging

      int getWaitBeforeTagging()
      Get wait the specified number of seconds before creating a tag.
      Returns:
      int

    • getWorkingDirectory

      String getWorkingDirectory()
      Get the directory where the release is performed.
      Returns:
      String

    • getScmTagNameFormat

      String getScmTagNameFormat()
      Get specifies the format for generating a tag name. Property expansion is used with the optional prefix of project, where properties are delimited with @{ and }.
      Returns:
      String

    • getProjectNamingPolicyId

      String getProjectNamingPolicyId()
      Get the role-hint for the NamingPolicy implementation used to calculate the project branch and tag names.
      Returns:
      String

    • getProjectVersionPolicyId

      String getProjectVersionPolicyId()
      Get the role-hint for the VersionPolicy implementation used to calculate the project versions.
      Returns:
      String

    • getProjectVersionPolicyConfig

      Object getProjectVersionPolicyConfig()
      Get the (optional) config for the VersionPolicy implementation used to calculate the project versions.
      Returns:
      The parsed XML of the provided config (an instance of PlexusConfiguration) or null.

    • getReleaseStrategyId

      String getReleaseStrategyId()
      Get the role-hint for the release Strategy implementation.
      Returns:
      String

    • getDependencyOriginalVersion

      String getDependencyOriginalVersion(String artifactKey)

      getDependencyOriginalVersion.

      Parameters:
      artifactKey - the artifact key String
      Returns:
      String The original version for the resolved snapshot dependency.

    • getDependencyReleaseVersion

      String getDependencyReleaseVersion(String artifactKey)

      getDependencyReleaseVersion.

      Parameters:
      artifactKey - the artifact key String
      Returns:
      String the release version for the resolved snapshot dependency.

    • getDependencyDevelopmentVersion

      String getDependencyDevelopmentVersion(String artifactKey)

      getDependencyDevelopmentVersion.

      Parameters:
      artifactKey - the artifact key String
      Returns:
      String the release version for the resolved snapshot dependency.

    • getProjectOriginalVersion

      String getProjectOriginalVersion(String projectKey)

      getProjectOriginalVersion.

      Parameters:
      projectKey - a String object
      Returns:
      a String object

    • getProjectDevelopmentVersion

      String getProjectDevelopmentVersion(String projectKey)

      getProjectDevelopmentVersion.

      Parameters:
      projectKey - a String object
      Returns:
      a String object

    • getProjectReleaseVersion

      String getProjectReleaseVersion(String key)

      getProjectReleaseVersion.

      Parameters:
      key - a String object
      Returns:
      a String object

    • getOriginalScmInfo

      org.apache.maven.model.Scm getOriginalScmInfo(String projectKey)

      getOriginalScmInfo.

      Parameters:
      projectKey - the project key String
      Returns:
      the original Scm information.

    • hasOriginalScmInfo

      boolean hasOriginalScmInfo(String projectKey)

      hasOriginalScmInfo.

      Parameters:
      projectKey - the project key String
      Returns:
      has original Scm info.

    • addDependencyOriginalVersion

      void addDependencyOriginalVersion(String versionlessKey, String string)

      addDependencyOriginalVersion.

      Parameters:
      versionlessKey - a String object
      string - a String object

    • addDependencyReleaseVersion

      void addDependencyReleaseVersion(String versionlessKey, String version)

      addDependencyReleaseVersion.

      Parameters:
      versionlessKey - a String object
      version - a String object

    • addDependencyDevelopmentVersion

      void addDependencyDevelopmentVersion(String versionlessKey, String version)

      addDependencyDevelopmentVersion.

      Parameters:
      versionlessKey - a String object
      version - a String object

    • addReleaseVersion

      void addReleaseVersion(String projectId, String nextVersion)

      addReleaseVersion.

      Parameters:
      projectId - a String object
      nextVersion - a String object

    • addDevelopmentVersion

      void addDevelopmentVersion(String projectId, String nextVersion)

      addDevelopmentVersion.

      Parameters:
      projectId - a String object
      nextVersion - a String object

    • setScmReleaseLabel

      void setScmReleaseLabel(String tag)

      setScmReleaseLabel.

      Parameters:
      tag - a String object

    • setScmReleasedPomRevision

      void setScmReleasedPomRevision(String scmRevision)

      setScmReleasedPomRevision.

      Parameters:
      scmRevision - a String object

    • setScmRelativePathProjectDirectory

      void setScmRelativePathProjectDirectory(String scmRelativePathProjectDirectory)

      setScmRelativePathProjectDirectory.

      Parameters:
      scmRelativePathProjectDirectory - a String object

    • setScmSourceUrl

      void setScmSourceUrl(String scmUrl)

      setScmSourceUrl.

      Parameters:
      scmUrl - a String object

    • getAutoResolveSnapshots

      String getAutoResolveSnapshots()
      Returns whether unresolved SNAPSHOT dependencies should automatically be resolved. If this is set, then this specifies the default answer to be used when unresolved SNAPSHOT dependencies should automatically be resolved ( 0:All 1:Project Dependencies 2:Plugins 3:Reports 4:Extensions ). Possible values are:
      • "all" or "0": resolve all kinds of snapshots, ie. project, plugin, report and extension dependencies
      • "dependencies" or "1": resolve project dependencies
      • "plugins" or "2": resolve plugin dependencis
      • "reports" or "3": resolve report dependencies
      • "extensions" or "4": resolve extension dependencies
      Returns:
      String

    • getLineSeparator

      String getLineSeparator()
      Get the line separator to use in the pom.xml.
      Returns:
      String

    • isPinExternals

      boolean isPinExternals()
      Determines whether the --pin-externals option in svn copy command is enabled which is new in Subversion 1.9.
      Returns:
      boolean