package org.jenkinsci.plugins.p4.client; import java.util.List; public class ViewMapHelper { private static final String QUOTE = "\""; private static final String MAP_SEP = " "; private static final String MAP_DELIM = "\n"; private static final String PATH_DELIM = "/"; private static final String EXCLUDE = "-"; private static final String INCLUDE = "+"; /** * Generates client view mapping string. * e.g //depot/src/... //ws/src/... * <p> * This method handles the case where multiple items are specified in dpotSyntax delimitted * with a new line character \n, in addition to standard specification. * e.g //depot/src/...\n//depot/tgt/... * <p> * If multiple items are speicified in depot syntax, each client syntax will be appended with * the part of the depot syntax that follows //, to avoid ambiguity. * <p> * For instance //depot/src/...\n//depot/tgt/... with a client syntax of jenkins-job will generate the following * view, * <p> * //depot/src/... //jenkins-job/depot/src/... * //depot/tgt/... //jenkins-job/depot/tgt/... * * @param depotView The left hand side of the client view * @param client The client workspace name * @return Client view mapping */ public static String getClientView(String depotView, String client) { // exit early if no depotPath if (depotView == null || depotView.isEmpty()) { return null; } // exit early if no client is defined if (client == null || client.isEmpty()) { return null; } // Split on new line and trim any following white space String[] lines = depotView.split("\n\\s*"); StringBuffer view = processLines(lines, client); return view.toString(); } public static String getClientView(List<String> views, String client) { // exit early if no views if (views == null || views.isEmpty()) { return null; } // exit early if no client is defined if (client == null || client.isEmpty()) { return null; } StringBuffer view = processLines(views.toArray(new String[0]), client); return view.toString(); } private static StringBuffer processLines(String[] lines, String client) { StringBuffer view = new StringBuffer(); boolean multi = lines.length > 1; for (int c = 0; c < lines.length; c++) { // detect space characters for later boolean spaces = lines[c].contains(" "); boolean exclude = lines[c].startsWith(EXCLUDE); boolean include = lines[c].startsWith(INCLUDE); // remove leading "//", "+//" or "-//" from path String remove = "//"; remove = (exclude) ? EXCLUDE + "//" : remove; remove = (include) ? INCLUDE + "//" : remove; String path = lines[c].substring(remove.length()); // split path on "/" depot deliminator String[] parts = path.split(PATH_DELIM); // process depot and client mappings StringBuffer lhs = processLHS(parts); StringBuffer rhs = processRHS(client, parts, multi); // Add Exclude/Include mappings if(exclude) { lhs.insert(0, EXCLUDE); } if(include) { lhs.insert(0, INCLUDE); } // Wrap with quotes if spaces are used in the path if (spaces) { lhs.insert(0, QUOTE); lhs.append(QUOTE); rhs.insert(0, QUOTE); rhs.append(QUOTE); } // Build view if (c > 0) { view.append(MAP_DELIM); } view.append(lhs); view.append(MAP_SEP); view.append(rhs); } return view; } private static StringBuffer processLHS(String[] parts) { StringBuffer lhs = new StringBuffer("//"); for (int i = 0; i < parts.length; i++) { if (i > 0) { lhs.append(PATH_DELIM); } lhs.append(parts[i]); } return lhs; } private static StringBuffer processRHS(String client, String[] parts, boolean multi) { StringBuffer rhs = new StringBuffer("//"); rhs.append(client); rhs.append("/"); // multi lines may require full depot path e.g. // //depot/proj/src/... //client/depot/proj/src/... if (multi) { for (int i = 0; i < parts.length; i++) { if (i > 0) { rhs.append(PATH_DELIM); } rhs.append(parts[i]); } } // single lines can map directly to client root e.g. // //depot/proj/src/... //client/... else { rhs.append(parts[parts.length - 1]); } return rhs; } }
# | Change | User | Description | Committed | |
---|---|---|---|---|---|
#8 | 26263 | Paul Allen |
Merge pull request #115 from nwillems/viewmaphelper-test Allow spacing around viewmappings |
||
#7 | 25973 | Paul Allen | Fix JavaDoc issues | ||
#6 | 25843 | Paul Allen | MultiBranch support for Swarm path Exclusions in the project configuration. | ||
#5 | 25564 | Paul Allen |
Merge branch 'local_map' MultiBranch support for 'HelixBranches' local and remote Mappings. Allows MultiBranches to map Depot paths external to the MultiBranch projects root. For example, a MultiBranch project with the following Jenkinsfiles: ProjA >> main //depot/projA/main/Jenkinsfile //depot/projA/main/src/... ProjA>> dev //depot/projA/dev/Jenkinsfile //depot/projA/dev/src/... An 'Includes' path for Branch Sources set to: //depot/projA/... Jenkins will now create two branches 'main' and 'dev'. The default Mapping is '...' so the 'src/...' and any other files under the branch root will appear in the project's workspace. To import an extenal location we can add another line to the mapping: ... //depot/external/stuff/... Now both branches 'main' and 'dev' will have a folder 'depot/external/stuff' with the mapped files. We can also use the `BRANCH_NAME` environment variable in the remote path uses the branch name. ... //depot/external/${BRANCH_NAME}/... and in 'main' you will now see the remote files in ' depot/external/main' along with the local project files mapped with '...' |
||
#4 | 24829 | Paul Allen |
Support Jenkinsfiles in sub directories. Preserve Jenkinsfile path in Client View. JENKINS-54382 |
||
#3 | 24504 | Paul Allen |
Tree walter for BranchSCMSource Events. On a change-submit event use the change number and grab a submitted file. Walk up the path looking for a Jenkinsfile, then derive 'Project' path, 'Branch' name and 'Path' for the SCMHead/Revision. This assumes that the Jenkinsfile is in the route of your projects. Alternatively use the Swarm Event and pass your own 'Project', 'Branch' and 'Path'. |
||
#2 | 24454 | Paul Allen |
Exclude and Include mapping support. Refactored P4Path usage and added P4SwarmPath. JENKINS-49804 |
||
#1 | 24439 | Paul Allen |
Move ViewMapHelper to shared class. JENKINS-52852 |