Interface ScmProvider
-
- All Known Implementing Classes:
AbstractGitScmProvider
,AbstractScmProvider
,AbstractSvnScmProvider
,GitExeScmProvider
,HgScmProvider
,JGitScmProvider
,LocalScmProvider
,ScmProviderStub
,SvnExeScmProvider
public interface ScmProvider
- Author:
- Emmanuel Venisse
-
-
Method Summary
All Methods Instance Methods Abstract Methods Default Methods Deprecated Methods Modifier and Type Method Description AddScmResult
add(ScmRepository repository, ScmFileSet fileSet)
Adds the given files to the source control systemAddScmResult
add(ScmRepository repository, ScmFileSet fileSet, String message)
Adds the given files to the source control systemAddScmResult
add(ScmRepository repository, ScmFileSet fileSet, CommandParameters commandParameters)
Adds the given files to the source control systemBlameScmResult
blame(BlameScmRequest blameScmRequest)
BlameScmResult
blame(ScmRepository repository, ScmFileSet fileSet, String filename)
Deprecated.use blame withBlameScmRequest
parameterBranchScmResult
branch(ScmRepository repository, ScmFileSet fileSet, String branchName)
Deprecated.BranchScmResult
branch(ScmRepository repository, ScmFileSet fileSet, String branchName, String message)
Deprecated.BranchScmResult
branch(ScmRepository repository, ScmFileSet fileSet, String branchName, ScmBranchParameters scmBranchParameters)
Branch (or label in some systems) will create a branch of the source file with a certain branch nameChangeLogScmResult
changeLog(ChangeLogScmRequest scmRequest)
Returns the changes that have happened in the source control system in a certain period of time.ChangeLogScmResult
changeLog(ScmRepository repository, ScmFileSet fileSet, String startTag, String endTag)
Deprecated.ChangeLogScmResult
changeLog(ScmRepository repository, ScmFileSet fileSet, String startTag, String endTag, String datePattern)
Deprecated.ChangeLogScmResult
changeLog(ScmRepository repository, ScmFileSet fileSet, Date startDate, Date endDate, int numDays, String branch)
ChangeLogScmResult
changeLog(ScmRepository repository, ScmFileSet fileSet, Date startDate, Date endDate, int numDays, String branch, String datePattern)
Deprecated.ChangeLogScmResult
changeLog(ScmRepository repository, ScmFileSet fileSet, Date startDate, Date endDate, int numDays, ScmBranch branch)
Deprecated.ChangeLogScmResult
changeLog(ScmRepository repository, ScmFileSet fileSet, Date startDate, Date endDate, int numDays, ScmBranch branch, String datePattern)
Deprecated.ChangeLogScmResult
changeLog(ScmRepository repository, ScmFileSet fileSet, ScmVersion startVersion, ScmVersion endVersion)
Deprecated.ChangeLogScmResult
changeLog(ScmRepository repository, ScmFileSet fileSet, ScmVersion startRevision, ScmVersion endRevision, String datePattern)
Deprecated.CheckInScmResult
checkIn(ScmRepository repository, ScmFileSet fileSet, String message)
Save the changes you have done into the repository.CheckInScmResult
checkIn(ScmRepository repository, ScmFileSet fileSet, String tag, String message)
CheckInScmResult
checkIn(ScmRepository repository, ScmFileSet fileSet, CommandParameters parameters)
Save the changes you have done into the repository.CheckInScmResult
checkIn(ScmRepository repository, ScmFileSet fileSet, ScmVersion revision, String message)
Save the changes you have done into the repository.CheckOutScmResult
checkOut(ScmRepository repository, ScmFileSet fileSet)
Create a copy of the repository on your local machineCheckOutScmResult
checkOut(ScmRepository scmRepository, ScmFileSet scmFileSet, boolean recursive)
Create a copy of the repository on your local machine.CheckOutScmResult
checkOut(ScmRepository repository, ScmFileSet fileSet, String tag)
CheckOutScmResult
checkOut(ScmRepository scmRepository, ScmFileSet scmFileSet, String tag, boolean recursive)
CheckOutScmResult
checkOut(ScmRepository repository, ScmFileSet fileSet, ScmVersion version)
Create a copy of the repository on your local machineCheckOutScmResult
checkOut(ScmRepository scmRepository, ScmFileSet scmFileSet, ScmVersion version, boolean recursive)
Create a copy of the repository on your local machine.CheckOutScmResult
checkOut(ScmRepository scmRepository, ScmFileSet scmFileSet, ScmVersion version, CommandParameters commandParameters)
Create a copy of the repository on your local machine.DiffScmResult
diff(ScmRepository scmRepository, ScmFileSet scmFileSet, String startRevision, String endRevision)
DiffScmResult
diff(ScmRepository scmRepository, ScmFileSet scmFileSet, ScmVersion startVersion, ScmVersion endVersion)
Create a diff between two branch/tag/revision.EditScmResult
edit(ScmRepository repository, ScmFileSet fileSet)
Make a file editable.ExportScmResult
export(ScmRepository repository, ScmFileSet fileSet)
Create an exported copy of the repository on your local machineExportScmResult
export(ScmRepository repository, ScmFileSet fileSet, String tag)
ExportScmResult
export(ScmRepository repository, ScmFileSet fileSet, String tag, String outputDirectory)
ExportScmResult
export(ScmRepository repository, ScmFileSet fileSet, ScmVersion version)
Create an exported copy of the repository on your local machineExportScmResult
export(ScmRepository repository, ScmFileSet fileSet, ScmVersion version, String outputDirectory)
Create an exported copy of the repository on your local machineString
getScmSpecificFilename()
Returns the scm reserved file name where the SCM stores information like '.git', '.svn'.String
getScmType()
InfoScmResult
info(ScmProviderRepository repository, ScmFileSet fileSet, CommandParameters parameters)
ListScmResult
list(ScmRepository repository, ScmFileSet fileSet, boolean recursive, String tag)
ListScmResult
list(ScmRepository repository, ScmFileSet fileSet, boolean recursive, ScmVersion version)
List each element (files and directories) of fileSet as they exist in the repository.ScmProviderRepository
makeProviderScmRepository(File path)
ScmProviderRepository
makeProviderScmRepository(String scmSpecificUrl, char delimiter)
MkdirScmResult
mkdir(ScmRepository repository, ScmFileSet fileSet, String message, boolean createInLocal)
Create directory/directories in the repository.RemoteInfoScmResult
remoteInfo(ScmProviderRepository repository, ScmFileSet fileSet, CommandParameters parameters)
RemoveScmResult
remove(ScmRepository repository, ScmFileSet fileSet, String message)
Removes the given files from the source control systemboolean
requiresEditMode()
String
sanitizeTagName(String tag)
Given a tag name, make it suitable for this SCM provider.default void
setInteractive(boolean interactive)
Sets the interactive mode, which by default (i.e.StatusScmResult
status(ScmRepository repository, ScmFileSet fileSet)
Returns the status of the files in the source control system.TagScmResult
tag(ScmRepository repository, ScmFileSet fileSet, String tagName)
Deprecated.TagScmResult
tag(ScmRepository repository, ScmFileSet fileSet, String tagName, String message)
Deprecated.TagScmResult
tag(ScmRepository repository, ScmFileSet fileSet, String tagName, ScmTagParameters scmTagParameters)
Tag (or label in some systems) will tag the source file with a certain tagUnEditScmResult
unedit(ScmRepository repository, ScmFileSet fileSet)
Make a file no longer editable.UntagScmResult
untag(ScmRepository repository, ScmFileSet fileSet, CommandParameters parameters)
Deletes a tag.UpdateScmResult
update(ScmRepository repository, ScmFileSet fileSet)
Updates the copy on the local machine with the changes in the repositoryUpdateScmResult
update(ScmRepository repository, ScmFileSet fileSet, boolean runChangelog)
Updates the copy on the local machine with the changes in the repositoryUpdateScmResult
update(ScmRepository repository, ScmFileSet fileSet, String tag)
UpdateScmResult
update(ScmRepository repository, ScmFileSet fileSet, String tag, boolean runChangelog)
UpdateScmResult
update(ScmRepository repository, ScmFileSet fileSet, String tag, String datePattern)
UpdateScmResult
update(ScmRepository repository, ScmFileSet fileSet, String tag, Date lastUpdate)
UpdateScmResult
update(ScmRepository repository, ScmFileSet fileSet, String tag, Date lastUpdate, String datePattern)
UpdateScmResult
update(ScmRepository repository, ScmFileSet fileSet, ScmVersion version)
Updates the copy on the local machine with the changes in the repositoryUpdateScmResult
update(ScmRepository repository, ScmFileSet fileSet, ScmVersion version, boolean runChangelog)
Updates the copy on the local machine with the changes in the repositoryUpdateScmResult
update(ScmRepository repository, ScmFileSet fileSet, ScmVersion version, String datePattern)
Updates the copy on the local machine with the changes in the repositoryUpdateScmResult
update(ScmRepository repository, ScmFileSet fileSet, ScmVersion version, Date lastUpdate)
Updates the copy on the local machine with the changes in the repositoryUpdateScmResult
update(ScmRepository repository, ScmFileSet fileSet, ScmVersion version, Date lastUpdate, String datePattern)
Updates the copy on the local machine with the changes in the repositoryList<String>
validateScmUrl(String scmSpecificUrl, char delimiter)
Validate the scm url.boolean
validateTagName(String tag)
Check if this tag is valid for this SCM provider.
-
-
-
Method Detail
-
getScmType
String getScmType()
-
requiresEditMode
boolean requiresEditMode()
-
makeProviderScmRepository
ScmProviderRepository makeProviderScmRepository(String scmSpecificUrl, char delimiter) throws ScmRepositoryException
- Throws:
ScmRepositoryException
-
makeProviderScmRepository
ScmProviderRepository makeProviderScmRepository(File path) throws ScmRepositoryException, UnknownRepositoryStructure
-
setInteractive
default void setInteractive(boolean interactive)
Sets the interactive mode, which by default (i.e. if not called) is assumed to betrue
by providers. As providers are usually singletons, this affects every usage of this provider.- Parameters:
interactive
- eithertrue
in case user may be prompted for information, otherwisefalse
. The default istrue
.- Since:
- 2.0.0-M2
-
validateScmUrl
List<String> validateScmUrl(String scmSpecificUrl, char delimiter)
Validate the scm url.- Parameters:
scmSpecificUrl
- The SCM urldelimiter
- The delimiter used in the SCM url- Returns:
- Returns a list of messages if the validation failed
-
getScmSpecificFilename
String getScmSpecificFilename()
Returns the scm reserved file name where the SCM stores information like '.git', '.svn'.- Returns:
- the scm reserved file name
-
validateTagName
boolean validateTagName(String tag)
Check if this tag is valid for this SCM provider.- Parameters:
tag
- tag name to check- Returns:
- true if tag is valid
-
sanitizeTagName
String sanitizeTagName(String tag)
Given a tag name, make it suitable for this SCM provider.- Parameters:
tag
- input tag name- Returns:
- sanitized tag name
-
add
AddScmResult add(ScmRepository repository, ScmFileSet fileSet) throws ScmException
Adds the given files to the source control system- Parameters:
repository
- the source control systemfileSet
- the files to be added- Returns:
- an
AddScmResult
that contains the files that have been added - Throws:
ScmException
- if any
-
add
AddScmResult add(ScmRepository repository, ScmFileSet fileSet, String message) throws ScmException
Adds the given files to the source control system- Parameters:
repository
- the source control systemfileSet
- the files to be addedmessage
- a string that is a comment on the new added file- Returns:
- an
AddScmResult
that contains the files that have been added - Throws:
ScmException
- if any
-
add
AddScmResult add(ScmRepository repository, ScmFileSet fileSet, CommandParameters commandParameters) throws ScmException
Adds the given files to the source control system- Parameters:
repository
- the source control systemfileSet
- the files to be addedcommandParameters
-CommandParameters
- Returns:
- an
AddScmResult
that contains the files that have been added - Throws:
ScmException
- if any
-
branch
BranchScmResult branch(ScmRepository repository, ScmFileSet fileSet, String branchName) throws ScmException
Deprecated.Branch (or label in some systems) will create a branch of the source file with a certain branch name- Parameters:
repository
- the source control systemfileSet
- the files to branch. Implementations can also give the changes from theScmFileSet.getBasedir()
downwards.branchName
- the branch name to apply to the files- Returns:
- TODO
- Throws:
ScmException
- if any
-
branch
BranchScmResult branch(ScmRepository repository, ScmFileSet fileSet, String branchName, String message) throws ScmException
Deprecated.Branch (or label in some systems) will create a branch of the source file with a certain branch name- Parameters:
repository
- the source control systemfileSet
- the files to branch. Implementations can also give the changes from theScmFileSet.getBasedir()
downwards.branchName
- the branch name to apply to the filesmessage
- the commit message used for the tag creation- Returns:
- TODO
- Throws:
ScmException
- if any
-
branch
BranchScmResult branch(ScmRepository repository, ScmFileSet fileSet, String branchName, ScmBranchParameters scmBranchParameters) throws ScmException
Branch (or label in some systems) will create a branch of the source file with a certain branch name- Parameters:
repository
- the source control systemfileSet
- the files to branch. Implementations can also give the changes from theScmFileSet.getBasedir()
downwards.branchName
- the branch name to apply to the filesscmBranchParameters
- TODO- Returns:
- TODO
- Throws:
ScmException
- if any- Since:
- 1.3
-
changeLog
ChangeLogScmResult changeLog(ScmRepository repository, ScmFileSet fileSet, Date startDate, Date endDate, int numDays, String branch) throws ScmException
Deprecated.Returns the changes that have happened in the source control system in a certain period of time. This can be adding, removing, updating, ... of files- Parameters:
repository
- the source control systemfileSet
- the files to know the changes about. Implementations can also give the changes from theScmFileSet.getBasedir()
downwards.startDate
- the start date of the periodendDate
- the end date of the periodnumDays
- the number days before the current time if startdate and enddate are nullbranch
- the branch/tag name- Returns:
- The SCM result of the changelog command
- Throws:
ScmException
- if any
-
changeLog
@Deprecated ChangeLogScmResult changeLog(ScmRepository repository, ScmFileSet fileSet, Date startDate, Date endDate, int numDays, ScmBranch branch) throws ScmException
Deprecated.Returns the changes that have happened in the source control system in a certain period of time. This can be adding, removing, updating, ... of files- Parameters:
repository
- the source control systemfileSet
- the files to know the changes about. Implementations can also give the changes from theScmFileSet.getBasedir()
downwards.startDate
- the start date of the periodendDate
- the end date of the periodnumDays
- the number days before the current time if startdate and enddate are nullbranch
- the branch/tag- Returns:
- The SCM result of the changelog command
- Throws:
ScmException
- if any
-
changeLog
@Deprecated ChangeLogScmResult changeLog(ScmRepository repository, ScmFileSet fileSet, Date startDate, Date endDate, int numDays, String branch, String datePattern) throws ScmException
Deprecated.Returns the changes that have happened in the source control system in a certain period of time. This can be adding, removing, updating, ... of files- Parameters:
repository
- the source control systemfileSet
- the files to know the changes about. Implementations can also give the changes from theScmFileSet.getBasedir()
downwards.startDate
- the start date of the periodendDate
- the end date of the periodnumDays
- the number days before the current time if startdate and enddate are nullbranch
- the branch/tag namedatePattern
- the date pattern use in changelog output returned by scm tool- Returns:
- The SCM result of the changelog command
- Throws:
ScmException
- if any
-
changeLog
ChangeLogScmResult changeLog(ScmRepository repository, ScmFileSet fileSet, Date startDate, Date endDate, int numDays, ScmBranch branch, String datePattern) throws ScmException
Deprecated.Returns the changes that have happened in the source control system in a certain period of time. This can be adding, removing, updating, ... of files- Parameters:
repository
- the source control systemfileSet
- the files to know the changes about. Implementations can also give the changes from theScmFileSet.getBasedir()
downwards.startDate
- the start date of the periodendDate
- the end date of the periodnumDays
- the number days before the current time if startDate and endDate are nullbranch
- the branch/tagdatePattern
- the date pattern use in changelog output returned by scm tool- Returns:
- The SCM result of the changelog command
- Throws:
ScmException
- if any
-
changeLog
ChangeLogScmResult changeLog(ChangeLogScmRequest scmRequest) throws ScmException
Returns the changes that have happened in the source control system in a certain period of time. This can be adding, removing, updating, ... of files- Parameters:
scmRequest
- request wrapping detailed parameters for the changelog command- Returns:
- The SCM result of the changelog command
- Throws:
ScmException
- if any- Since:
- 1.8
-
changeLog
@Deprecated ChangeLogScmResult changeLog(ScmRepository repository, ScmFileSet fileSet, String startTag, String endTag) throws ScmException
Deprecated.Returns the changes that have happened in the source control system between two tags. This can be adding, removing, updating, ... of files- Parameters:
repository
- the source control systemfileSet
- the files to know the changes about. Implementations can also give the changes from theScmFileSet.getBasedir()
downwards.startTag
- the start tagendTag
- the end tag- Returns:
- The SCM result of the changelog command
- Throws:
ScmException
- if any
-
changeLog
@Deprecated ChangeLogScmResult changeLog(ScmRepository repository, ScmFileSet fileSet, ScmVersion startVersion, ScmVersion endVersion) throws ScmException
Deprecated.Returns the changes that have happened in the source control system between two tags. This can be adding, removing, updating, ... of files- Parameters:
repository
- the source control systemfileSet
- the files to know the changes about. Implementations can also give the changes from theScmFileSet.getBasedir()
downwards.startVersion
- the start branch/tag/revisionendVersion
- the end branch/tag/revision- Returns:
- The SCM result of the changelog command
- Throws:
ScmException
- if any
-
changeLog
@Deprecated ChangeLogScmResult changeLog(ScmRepository repository, ScmFileSet fileSet, String startTag, String endTag, String datePattern) throws ScmException
Deprecated.Returns the changes that have happened in the source control system between two tags. This can be adding, removing, updating, ... of files- Parameters:
repository
- the source control systemfileSet
- the files to know the changes about. Implementations can also give the changes from theScmFileSet.getBasedir()
downwards.startTag
- the start tagendTag
- the end tagdatePattern
- the date pattern use in changelog output returned by scm tool- Returns:
- TODO
- Throws:
ScmException
- if any
-
changeLog
@Deprecated ChangeLogScmResult changeLog(ScmRepository repository, ScmFileSet fileSet, ScmVersion startRevision, ScmVersion endRevision, String datePattern) throws ScmException
Deprecated.Returns the changes that have happened in the source control system between two tags. This can be adding, removing, updating, ... of files- Parameters:
repository
- the source control systemfileSet
- the files to know the changes about. Implementations can also give the changes from theScmFileSet.getBasedir()
downwards.startRevision
- the start revisionendRevision
- the end revisiondatePattern
- the date pattern use in changelog output returned by scm tool- Returns:
- TODO
- Throws:
ScmException
- if any
-
checkIn
CheckInScmResult checkIn(ScmRepository repository, ScmFileSet fileSet, String tag, String message) throws ScmException
Deprecated.Save the changes you have done into the repository. This will create a new version of the file or directory in the repository.When the fileSet has no entries, the fileSet.getBaseDir() is recursively committed. When the fileSet has entries, the commit is non-recursive and only the elements in the fileSet are committed.
- Parameters:
repository
- the source control systemfileSet
- the files to check in (sometimes called commit)tag
- tag or revisionmessage
- a string that is a comment on the changes that where done- Returns:
- TODO
- Throws:
ScmException
- if any
-
checkIn
CheckInScmResult checkIn(ScmRepository repository, ScmFileSet fileSet, String message) throws ScmException
Save the changes you have done into the repository. This will create a new version of the file or directory in the repository.When the fileSet has no entries, the fileSet.getBaseDir() is recursively committed. When the fileSet has entries, the commit is non-recursive and only the elements in the fileSet are committed.
- Parameters:
repository
- the source control systemfileSet
- the files to check in (sometimes called commit)message
- a string that is a comment on the changes that where done- Returns:
- TODO
- Throws:
ScmException
- if any
-
checkIn
CheckInScmResult checkIn(ScmRepository repository, ScmFileSet fileSet, CommandParameters parameters) throws ScmException
Save the changes you have done into the repository. This will create a new version of the file or directory in the repository.When the fileSet has no entries, the fileSet.getBaseDir() is recursively committed. When the fileSet has entries, the commit is non-recursive and only the elements in the fileSet are committed.
- Parameters:
repository
- the source control systemfileSet
- the files to check in (sometimes called commit)parameters
-CommandParameters
- Returns:
- TODO
- Throws:
ScmException
- if any
-
checkIn
CheckInScmResult checkIn(ScmRepository repository, ScmFileSet fileSet, ScmVersion revision, String message) throws ScmException
Save the changes you have done into the repository. This will create a new version of the file or directory in the repository.When the fileSet has no entries, the fileSet.getBaseDir() is recursively committed. When the fileSet has entries, the commit is non-recursive and only the elements in the fileSet are committed.
- Parameters:
repository
- the source control systemfileSet
- the files to check in (sometimes called commit)revision
- branch/tag/revisionmessage
- a string that is a comment on the changes that where done- Returns:
- TODO
- Throws:
ScmException
- if any
-
checkOut
CheckOutScmResult checkOut(ScmRepository repository, ScmFileSet fileSet, String tag) throws ScmException
Deprecated.Create a copy of the repository on your local machine- Parameters:
repository
- the source control systemfileSet
- the files are copied to theScmFileSet.getBasedir()
locationtag
- get the version defined by the tag- Returns:
- TODO
- Throws:
ScmException
- if any
-
checkOut
CheckOutScmResult checkOut(ScmRepository repository, ScmFileSet fileSet) throws ScmException
Create a copy of the repository on your local machine- Parameters:
repository
- the source control systemfileSet
- the files are copied to theScmFileSet.getBasedir()
location- Returns:
- TODO
- Throws:
ScmException
- if any
-
checkOut
CheckOutScmResult checkOut(ScmRepository repository, ScmFileSet fileSet, ScmVersion version) throws ScmException
Create a copy of the repository on your local machine- Parameters:
repository
- the source control systemfileSet
- the files are copied to theScmFileSet.getBasedir()
locationversion
- get the version defined by the revision, branch or tag- Returns:
- TODO
- Throws:
ScmException
- if any
-
checkOut
CheckOutScmResult checkOut(ScmRepository scmRepository, ScmFileSet scmFileSet, String tag, boolean recursive) throws ScmException
Deprecated.Create a copy of the repository on your local machine.- Parameters:
scmRepository
- the source control systemscmFileSet
- the files are copied to theScmFileSet.getBasedir()
locationtag
- tag or revisionrecursive
- whether to check out recursively- Returns:
- TODO
- Throws:
ScmException
- if any
-
checkOut
CheckOutScmResult checkOut(ScmRepository scmRepository, ScmFileSet scmFileSet, boolean recursive) throws ScmException
Create a copy of the repository on your local machine.- Parameters:
scmRepository
- the source control systemscmFileSet
- the files are copied to theScmFileSet.getBasedir()
locationrecursive
- whether to check out recursively- Returns:
- TODO
- Throws:
ScmException
- if any
-
checkOut
CheckOutScmResult checkOut(ScmRepository scmRepository, ScmFileSet scmFileSet, ScmVersion version, boolean recursive) throws ScmException
Create a copy of the repository on your local machine.- Parameters:
scmRepository
- the source control systemscmFileSet
- the files are copied to theScmFileSet.getBasedir()
locationversion
- get the version defined by the revision, branch or tagrecursive
- whether to check out recursively- Returns:
- TODO
- Throws:
ScmException
- if any
-
checkOut
CheckOutScmResult checkOut(ScmRepository scmRepository, ScmFileSet scmFileSet, ScmVersion version, CommandParameters commandParameters) throws ScmException
Create a copy of the repository on your local machine.- Parameters:
scmRepository
- the source control systemscmFileSet
- the files are copied to theScmFileSet.getBasedir()
locationversion
- get the version defined by the revision, branch or tagcommandParameters
- parameters- Returns:
- TODO
- Throws:
ScmException
- if any- Since:
- 1.9.6
-
diff
DiffScmResult diff(ScmRepository scmRepository, ScmFileSet scmFileSet, String startRevision, String endRevision) throws ScmException
Deprecated.Create a diff between two branch/tag/revision.- Parameters:
scmRepository
- the source control systemscmFileSet
- the files are copied to theScmFileSet.getBasedir()
locationstartRevision
- the start revisionendRevision
- the end revision- Returns:
- TODO
- Throws:
ScmException
- if any
-
diff
DiffScmResult diff(ScmRepository scmRepository, ScmFileSet scmFileSet, ScmVersion startVersion, ScmVersion endVersion) throws ScmException
Create a diff between two branch/tag/revision.- Parameters:
scmRepository
- the source control systemscmFileSet
- the files are copied to theScmFileSet.getBasedir()
locationstartVersion
- the start branch/tag/revisionendVersion
- the end branch/tag/revision- Returns:
- TODO
- Throws:
ScmException
- if any
-
export
ExportScmResult export(ScmRepository repository, ScmFileSet fileSet, String tag) throws ScmException
Deprecated.Create an exported copy of the repository on your local machine- Parameters:
repository
- the source control systemfileSet
- the files are copied to theScmFileSet.getBasedir()
locationtag
- get the version defined by the tag- Returns:
- TODO
- Throws:
ScmException
- if any
-
export
ExportScmResult export(ScmRepository repository, ScmFileSet fileSet) throws ScmException
Create an exported copy of the repository on your local machine- Parameters:
repository
- the source control systemfileSet
- the files are copied to theScmFileSet.getBasedir()
location- Returns:
- TODO
- Throws:
ScmException
- if any
-
export
ExportScmResult export(ScmRepository repository, ScmFileSet fileSet, ScmVersion version) throws ScmException
Create an exported copy of the repository on your local machine- Parameters:
repository
- the source control systemfileSet
- the files are copied to theScmFileSet.getBasedir()
locationversion
- get the version defined by the branch/tag/revision- Returns:
- TODO
- Throws:
ScmException
- if any
-
export
ExportScmResult export(ScmRepository repository, ScmFileSet fileSet, String tag, String outputDirectory) throws ScmException
Deprecated.Create an exported copy of the repository on your local machine- Parameters:
repository
- the source control systemfileSet
- the files are copied to theScmFileSet.getBasedir()
locationtag
- get the version defined by the tagoutputDirectory
- the directory where the export will be stored- Returns:
- TODO
- Throws:
ScmException
- if any
-
export
ExportScmResult export(ScmRepository repository, ScmFileSet fileSet, ScmVersion version, String outputDirectory) throws ScmException
Create an exported copy of the repository on your local machine- Parameters:
repository
- the source control systemfileSet
- the files are copied to theScmFileSet.getBasedir()
locationversion
- get the version defined by the branch/tag/revisionoutputDirectory
- the directory where the export will be stored- Returns:
- TODO
- Throws:
ScmException
- if any
-
remove
RemoveScmResult remove(ScmRepository repository, ScmFileSet fileSet, String message) throws ScmException
Removes the given files from the source control system- Parameters:
repository
- the source control systemfileSet
- the files to be removedmessage
- TODO- Returns:
- TODO
- Throws:
ScmException
- if any
-
status
StatusScmResult status(ScmRepository repository, ScmFileSet fileSet) throws ScmException
Returns the status of the files in the source control system. The state of each file can be one of theScmFileStatus
flags.- Parameters:
repository
- the source control systemfileSet
- the files to know the status about. Implementations can also give the changes from theScmFileSet.getBasedir()
downwards.- Returns:
- TODO
- Throws:
ScmException
- if any
-
tag
TagScmResult tag(ScmRepository repository, ScmFileSet fileSet, String tagName) throws ScmException
Deprecated.Tag (or label in some systems) will tag the source file with a certain tag- Parameters:
repository
- the source control systemfileSet
- the files to tag. Implementations can also give the changes from theScmFileSet.getBasedir()
downwards.tagName
- the tag name to apply to the files- Returns:
- TODO
- Throws:
ScmException
- if any
-
untag
UntagScmResult untag(ScmRepository repository, ScmFileSet fileSet, CommandParameters parameters) throws ScmException
Deletes a tag.- Parameters:
repository
- the source control systemfileSet
- a fileset with the relevant working directory as basedirparameters
- TODO- Returns:
- TODO
- Throws:
ScmException
- if any
-
tag
TagScmResult tag(ScmRepository repository, ScmFileSet fileSet, String tagName, String message) throws ScmException
Deprecated.Tag (or label in some systems) will tag the source file with a certain tag- Parameters:
repository
- the source control systemfileSet
- the files to tag. Implementations can also give the changes from theScmFileSet.getBasedir()
downwards.tagName
- the tag name to apply to the filesmessage
- the commit message used for the tag creation- Returns:
- TODO
- Throws:
ScmException
- if any
-
tag
TagScmResult tag(ScmRepository repository, ScmFileSet fileSet, String tagName, ScmTagParameters scmTagParameters) throws ScmException
Tag (or label in some systems) will tag the source file with a certain tag- Parameters:
repository
- the source control systemfileSet
- the files to tag. Implementations can also give the changes from theScmFileSet.getBasedir()
downwards.tagName
- the tag name to apply to the filesscmTagParameters
- bean to pass some paramters for taggingScmTagParameters
- Returns:
- TODO
- Throws:
ScmException
- if any- Since:
- 1.2
-
update
UpdateScmResult update(ScmRepository repository, ScmFileSet fileSet) throws ScmException
Updates the copy on the local machine with the changes in the repository- Parameters:
repository
- the source control systemfileSet
- location of your local copy- Returns:
- TODO
- Throws:
ScmException
- if any
-
update
UpdateScmResult update(ScmRepository repository, ScmFileSet fileSet, String tag) throws ScmException
Deprecated.Updates the copy on the local machine with the changes in the repository- Parameters:
repository
- the source control systemfileSet
- location of your local copytag
- use the version defined by the tag- Returns:
- TODO
- Throws:
ScmException
- if any
-
update
UpdateScmResult update(ScmRepository repository, ScmFileSet fileSet, ScmVersion version) throws ScmException
Updates the copy on the local machine with the changes in the repository- Parameters:
repository
- the source control systemfileSet
- location of your local copyversion
- use the version defined by the branch/tag/revision- Returns:
- TODO
- Throws:
ScmException
- if any
-
update
UpdateScmResult update(ScmRepository repository, ScmFileSet fileSet, String tag, boolean runChangelog) throws ScmException
Deprecated.Updates the copy on the local machine with the changes in the repository- Parameters:
repository
- the source control systemfileSet
- location of your local copytag
- use the version defined by the tagrunChangelog
- Run the changelog command after the update- Returns:
- TODO
- Throws:
ScmException
- if any
-
update
UpdateScmResult update(ScmRepository repository, ScmFileSet fileSet, boolean runChangelog) throws ScmException
Updates the copy on the local machine with the changes in the repository- Parameters:
repository
- the source control systemfileSet
- location of your local copyrunChangelog
- Run the changelog command after the update- Returns:
- TODO
- Throws:
ScmException
- if any
-
update
UpdateScmResult update(ScmRepository repository, ScmFileSet fileSet, ScmVersion version, boolean runChangelog) throws ScmException
Updates the copy on the local machine with the changes in the repository- Parameters:
repository
- the source control systemfileSet
- location of your local copyversion
- use the version defined by the branch/tag/revisionrunChangelog
- Run the changelog command after the update- Returns:
- TODO
- Throws:
ScmException
- if any
-
update
UpdateScmResult update(ScmRepository repository, ScmFileSet fileSet, String tag, String datePattern) throws ScmException
Deprecated.Updates the copy on the local machine with the changes in the repository- Parameters:
repository
- the source control systemfileSet
- location of your local copytag
- use the version defined by the tagdatePattern
- the date pattern use in changelog output returned by scm tool- Returns:
- TODO
- Throws:
ScmException
- if any
-
update
UpdateScmResult update(ScmRepository repository, ScmFileSet fileSet, ScmVersion version, String datePattern) throws ScmException
Updates the copy on the local machine with the changes in the repository- Parameters:
repository
- the source control systemfileSet
- location of your local copyversion
- use the version defined by the branch/tag/revisiondatePattern
- the date pattern use in changelog output returned by scm tool- Returns:
- TODO
- Throws:
ScmException
- if any
-
update
UpdateScmResult update(ScmRepository repository, ScmFileSet fileSet, String tag, Date lastUpdate) throws ScmException
Deprecated.Updates the copy on the local machine with the changes in the repository- Parameters:
repository
- the source control systemfileSet
- location of your local copytag
- use the version defined by the taglastUpdate
- TODO- Returns:
- TODO
- Throws:
ScmException
- if any
-
update
UpdateScmResult update(ScmRepository repository, ScmFileSet fileSet, ScmVersion version, Date lastUpdate) throws ScmException
Updates the copy on the local machine with the changes in the repository- Parameters:
repository
- the source control systemfileSet
- location of your local copyversion
- use the version defined by the branch/tag/revisionlastUpdate
- TODO- Returns:
- TODO
- Throws:
ScmException
- if any
-
update
UpdateScmResult update(ScmRepository repository, ScmFileSet fileSet, String tag, Date lastUpdate, String datePattern) throws ScmException
Deprecated.Updates the copy on the local machine with the changes in the repository- Parameters:
repository
- the source control systemfileSet
- location of your local copytag
- use the version defined by the taglastUpdate
- Date of last updatedatePattern
- the date pattern use in changelog output returned by scm tool- Returns:
- TODO
- Throws:
ScmException
- if any
-
update
UpdateScmResult update(ScmRepository repository, ScmFileSet fileSet, ScmVersion version, Date lastUpdate, String datePattern) throws ScmException
Updates the copy on the local machine with the changes in the repository- Parameters:
repository
- the source control systemfileSet
- location of your local copyversion
- use the version defined by the branch/tag/revisionlastUpdate
- Date of last updatedatePattern
- the date pattern use in changelog output returned by scm tool- Returns:
- TODO
- Throws:
ScmException
- if any
-
edit
EditScmResult edit(ScmRepository repository, ScmFileSet fileSet) throws ScmException
Make a file editable. This is used in source control systems where you look at read-only files and you need to make them not read-only anymore before you can edit them. This can also mean that no other user in the system can make the file not read-only anymore.- Parameters:
repository
- the source control systemfileSet
- the files to make editable- Returns:
- TODO
- Throws:
ScmException
- if any
-
unedit
UnEditScmResult unedit(ScmRepository repository, ScmFileSet fileSet) throws ScmException
Make a file no longer editable. This is the conterpart ofedit( org.apache.maven.scm.repository.ScmRepository, org.apache.maven.scm.ScmFileSet)
. It makes the file read-only again.- Parameters:
repository
- the source control systemfileSet
- the files to make uneditable- Returns:
- TODO
- Throws:
ScmException
- if any
-
list
ListScmResult list(ScmRepository repository, ScmFileSet fileSet, boolean recursive, String tag) throws ScmException
Deprecated.List each element (files and directories) of fileSet as they exist in the repository.- Parameters:
repository
- the source control systemfileSet
- the files to listrecursive
- descend recursivelytag
- use the version defined by the tag- Returns:
- the list of files in the repository
- Throws:
ScmException
- if any
-
list
ListScmResult list(ScmRepository repository, ScmFileSet fileSet, boolean recursive, ScmVersion version) throws ScmException
List each element (files and directories) of fileSet as they exist in the repository.- Parameters:
repository
- the source control systemfileSet
- the files to listrecursive
- descend recursivelyversion
- use the version defined by the branch/tag/revision- Returns:
- the list of files in the repository
- Throws:
ScmException
- if any
-
blame
BlameScmResult blame(ScmRepository repository, ScmFileSet fileSet, String filename) throws ScmException
Deprecated.use blame withBlameScmRequest
parameterReturns the blame of specified file- Parameters:
repository
- the source control systemfileSet
- location of your local copyfilename
- file- Returns:
- blame for specified file
- Throws:
ScmException
- if any- Since:
- 1.4
-
blame
BlameScmResult blame(BlameScmRequest blameScmRequest) throws ScmException
- Parameters:
blameScmRequest
- TODO- Returns:
- blame for the file specified in the request
- Throws:
ScmException
- if any- Since:
- 1.8
-
mkdir
MkdirScmResult mkdir(ScmRepository repository, ScmFileSet fileSet, String message, boolean createInLocal) throws ScmException
Create directory/directories in the repository.- Parameters:
repository
- TODOfileSet
- TODOcreateInLocal
- TODOmessage
- TODO- Returns:
- TODO
- Throws:
ScmException
- if any
-
info
InfoScmResult info(ScmProviderRepository repository, ScmFileSet fileSet, CommandParameters parameters) throws ScmException
- Parameters:
repository
- the source control systemfileSet
- location of your local copyparameters
- some parameters (not use currently but for future use)- Returns:
- if the scm implementation doesn't support "info" result will
null
- Throws:
ScmException
- if any- Since:
- 1.5
-
remoteInfo
RemoteInfoScmResult remoteInfo(ScmProviderRepository repository, ScmFileSet fileSet, CommandParameters parameters) throws ScmException
- Parameters:
repository
- the source control systemfileSet
- not use currently but for future useparameters
- some parameters (not use currently but for future use)- Returns:
- if the scm implementation doesn't support "info" result will
null
- Throws:
ScmException
- if any- Since:
- 1.6
-
-