jetbrains.buildServer.vcs

Interface VcsPersonalSupport

All Superinterfaces:

VcsExtension

All Known Subinterfaces:

VcsBulkSuitabilityChecker

public interface VcsPersonalSupport
extends VcsExtension

Any change for RemoteRun/Pre-Tested commit is represented in full path format. This service is designed for mapping full path format to path relative to VCS root. full path is an absolute path to a file inside VCS repository, composed by the client (IDE or command line runner).

Since:

4.5

Method Summary

Modifier and Type	Method and Description
java.util.Collection<java.lang.String>	mapFullPath(VcsRootEntry rootEntry, java.lang.String fullPath) Converts full path to path (or collection of paths) relative in relation to provided VCS root.

Method Detail

mapFullPath

@NotNull
java.util.Collection<java.lang.String> mapFullPath(@NotNull
                                                            VcsRootEntry rootEntry,
                                                            @NotNull
                                                            java.lang.String fullPath)
                                                     throws VcsException

Converts full path to path (or collection of paths) relative in relation to provided VCS root. Path should not be mapped by checkout rules, this will be done by an upper level code.
Returns a collection, because for some VCS, the source fullPath can be mapped to several target paths. For instance, this is a case for Subversion.

Parameters:

rootEntry - VCS root and checkout rules

fullPath - change path from IDE patch in VCS-specific format. For SVN, it is repositoryUUID|relativePathUnderRepositoryRoot For Git, firstMonthRevisionHash-baseMergeRevision||relativePathUnderRepositoryRoot For Perforce, p4ServerPort://depotFilePathStartingWithSlashes

Returns:

see above

Throws:

VcsException - (since 9.1) if there was a error while getting information from VCS

Since:

4.5