Submitted by: Les Hughes <leslie.hughes@rubus.com> git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@268447 13f79535-47bb-0310-9956-ffa450edef68master
@@ -5377,6 +5377,7 @@ current directory as <code>docs/ChangeLog.txt</code>. For example, the archive m | |||
<li><a href="native2ascii.html">Native2Ascii</a></li> | |||
<li><a href="#netrexxc">NetRexxC</a></li> | |||
<li><a href="propertyfile.html">PropertyFile</a></li> | |||
<li><a href="perforce.html">Perforce Tasks</a></li> | |||
<li><a href="#renameexts">RenameExtensions</a></li> | |||
<li><a href="#script">Script</a></li> | |||
<li><a href="#sound">Sound</a></li> | |||
@@ -0,0 +1,352 @@ | |||
<html> | |||
<head> | |||
<title>Perforce Tasks for ANT</title> | |||
</head> | |||
<body> | |||
<h1>Perforce Tasks User Manual</h1> | |||
<p>by</p> | |||
<ul> | |||
<li>Les Hughes (<a href="mailto:leslie.hughes@rubus.com">leslie.hughes@rubus.com</a>)</li> | |||
</ul> | |||
<p>Version 1.1 - 2001/01/09</p> | |||
<hr> | |||
<h2>Contents</h2> | |||
<ul> | |||
<li><a href="#intro">Introduction</a></li> | |||
<li><a href="#tasks">The Tasks</a></li> | |||
<li><a href="#changes">Change History</a></li> | |||
</ul> | |||
<br> | |||
<h2><a name="intro">Introduction</a></h2> | |||
<p>These tasks provide an interface to the <a href="http://www.perforce.com">Perforce</a> SCM. | |||
The <code>org.apache.tools.ant.taskdefs.optional.perforce</code> package consists of a simple framework to support | |||
p4 functionality as well as some Ant tasks encapsulating frequently used (by me :-) p4 commands. | |||
However, the addition of new p4 commands is a pretty simple task (see the source). | |||
Although it is possible to use these commands on the desktop, | |||
they were primarily intended to be used by automated build systems.</p> | |||
<p><b>Note:</b> These tasks require the <a href="http://jakarta.apache.org/oro">oro 2.0</a> regular | |||
expression package. Simply download this package and copy the jakarta-oro-2.0.jar file into Ant's lib directory. | |||
You will also need the perforce client executable (p4 or p4.exe but not p4win.exe) in your path. | |||
</p> | |||
<h2><a name="tasks">The Tasks</a></h2> | |||
<ul> | |||
<table border="0" cellspacing="0" cellpadding="3"> | |||
<tr> | |||
<td><a href="#p4sync">P4Sync</a></td> | |||
<td>Synchronise a workspce to a depot</td> | |||
</tr> | |||
<tr> | |||
<td><a href="#p4change">P4Change</a></td> | |||
<td>Request a new changelist from the perforce server</td> | |||
<tr> | |||
<td><a href="#p4edit">P4Edit</a></td> | |||
<td>Open files for edit (checkout)</td> | |||
<tr> | |||
<td><a href="#p4submit">P4Submit</a></td> | |||
<td>Submit a changelist to the perforce server (checkin)</td> | |||
<tr> | |||
<td><a href="#p4have">P4Have</a></td> | |||
<td>List current files in client view, useful for reporting</td> | |||
<tr> | |||
<td><a href="#p4label">P4Label</a></td> | |||
<td>Create a label reflecting files in the current workspace</td> | |||
</tr> | |||
</table> | |||
</ul> | |||
<h3>General P4 Properties</h3> | |||
<p>Each p4 task requires a number of settings, either through build-wide properties, individual attributes | |||
or environment variables. These are | |||
</p> | |||
<table border="1" cellpadding="2" cellspacing="0"> | |||
<tr> | |||
<td valign="top"><b>Property</b></td> | |||
<td valign="top"><b>Attribute</b></td> | |||
<td valign="top"><b>Env Var</b></td> | |||
<td valign="top"><b>Description</b></td> | |||
<td align="center" valign="top"><b>Default</b></td> | |||
</tr> | |||
<tr> | |||
<td valign="top">p4.port</td> | |||
<td valign="top">port</td> | |||
<td valign="top">P4PORT</td> | |||
<td valign="top">The p4d server and port to connect to</td> | |||
<td valign="top">perforce:1666</td> | |||
</tr> | |||
<tr> | |||
<td valign="top">p4.client</td> | |||
<td valign="top">client</td> | |||
<td valign="top">P4CLIENT</td> | |||
<td valign="top">The p4 client spec to use</td> | |||
<td valign="top">The logged in username</td> | |||
</tr> | |||
<tr> | |||
<td valign="top">p4.user</td> | |||
<td valign="top">user</td> | |||
<td valign="top">P4USER</td> | |||
<td valign="top">The p4 username</td> | |||
<td valign="top">The logged in username</td> | |||
</tr> | |||
<tr> | |||
<td valign="top" align="center">--</td> | |||
<td valign="top">view</td> | |||
<td valign="top" align="center">--</td> | |||
<td valign="top">The client, branch or label view to operate upon. See the p4 user guide for more info.</td> | |||
<td valign="top">//...</td> | |||
</tr> | |||
</table> | |||
<p> | |||
Your local installation of perforce may require other settings (e.g. P4PASSWD, P4CONFIG). At the moment, these can only be set outside of Ant, as environment variables. | |||
</p> | |||
<h3>Examples</h3> | |||
<p>Setting in the environment:-</p> | |||
<p> | |||
(Unix csh) | |||
<pre>setenv P4PORT myperforcebox:1666</pre> | |||
(Unix sh et al) | |||
<pre>P4USER=myp4userid; export P4USER</pre> | |||
<p>Using build properties:-</p> | |||
<pre><property name="p4.client" value="nightlybuild"/></pre> | |||
<p>Using task attributes:-</p> | |||
<pre> | |||
<p4Whatever | |||
port="myserver:1666" | |||
client="smoketest" | |||
user="smoketestdude" | |||
. | |||
. | |||
. | |||
/> | |||
</pre> | |||
</p> | |||
<p> | |||
For more information regarding the underlying 'p4' commands you are referred to the Perforce Command Reference | |||
available from the <a href="http://www.perforce.com/">Perforce website</a>. | |||
</p> | |||
<h3>Taskdefs</h3> | |||
<p>Standard taskdefs (for you to copy'n'paste) | |||
<pre> | |||
<taskdef name="p4sync" classname="org.apache.tools.ant.taskdefs.optional.perforce.P4Sync" /> | |||
<taskdef name="p4change" classname="org.apache.tools.ant.taskdefs.optional.perforce.P4Change" /> | |||
<taskdef name="p4edit" classname="org.apache.tools.ant.taskdefs.optional.perforce.P4Edit" /> | |||
<taskdef name="p4submit" classname="org.apache.tools.ant.taskdefs.optional.perforce.P4Submit" /> | |||
<taskdef name="p4have" classname="org.apache.tools.ant.taskdefs.optional.perforce.P4Have" /> | |||
<taskdef name="p4label" classname="org.apache.tools.ant.taskdefs.optional.perforce.P4Label" /> | |||
</pre> | |||
<hr> | |||
<h2>Task Descriptions</h2> | |||
<h2><a name="#p4sync">P4Sync</a></h2> | |||
<h3>Description:</h3> | |||
<p>Synchronise the current workspace with the depot.</p> | |||
</p> | |||
<h3>Parameters</h3> | |||
<table border="1" cellpadding="2" cellspacing="0"> | |||
<tr> | |||
<td valign="top"><b>Attribute</b></td> | |||
<td valign="top"><b>Description</b></td> | |||
<td align="center" valign="top"><b>Required</b></td> | |||
</tr> | |||
<tr> | |||
<td valign="top">force</td> | |||
<td valign="top">force a refresh of files</td> | |||
<td valign="top" align="center">no</td> | |||
</tr> | |||
<tr> | |||
<td valign="top">label</td> | |||
<td valign="top">sync client to label</td> | |||
<td valign="top" align="center">no</td> | |||
</tr> | |||
</table> | |||
<h3>Examples</h3> | |||
<pre><p4sync label="nightlybuild-0.0123" force="yes" /> | |||
<p4sync view="//depot/projects/projectfoo/main/src/..." /> | |||
</pre> | |||
<hr> | |||
<h2><a name="#p4change">P4Change</a></h2> | |||
<h3>Description:</h3> | |||
<p>Request a new changelist from the perforce server. | |||
This task sets the ${p4.change} property which can then be passed to P4Submit or P4Edit. | |||
</p> | |||
<h3>Parameters</h3> | |||
<table border="1" cellpadding="2" cellspacing="0"> | |||
<tr> | |||
<td valign="top"><b>Attribute</b></td> | |||
<td valign="top"><b>Description</b></td> | |||
<td align="center" valign="top"><b>Required</b></td> | |||
</tr> | |||
<tr> | |||
<td valign="top">None</td> | |||
<td valign="top" align="center">--</td> | |||
<td valign="top" align="center">--</td> | |||
</tr> | |||
</table> | |||
<h3>Examples</h3> | |||
<pre><p4change /> | |||
</pre> | |||
<hr> | |||
<h2><a name="#p4edit">P4Edit</a></h2> | |||
<h3>Description:</h3> | |||
<p>Open file(s) for edit. P4Change should be used to obtain a new changelist for P4Edit as, | |||
although P4Edit can open files to the default change, P4Submit cannot yet submit it. | |||
</p> | |||
<h3>Parameters</h3> | |||
<table border="1" cellpadding="2" cellspacing="0"> | |||
<tr> | |||
<td valign="top"><b>Attribute</b></td> | |||
<td valign="top"><b>Description</b></td> | |||
<td align="center" valign="top"><b>Required</b></td> | |||
</tr> | |||
<tr> | |||
<td valign="top">view</td> | |||
<td valign="top">The filespec to request to edit</td> | |||
<td valign="top" align="center">Yes</td> | |||
</tr> | |||
<tr> | |||
<td valign="top">change</td> | |||
<td valign="top">An existing changelist number to assign files to.</td> | |||
<td valign="top" align="center">No, but see above.</td> | |||
</tr> | |||
</table> | |||
<h3>Examples</h3> | |||
<pre> | |||
<p4edit | |||
view="//depot/projects/projectfoo/main/src/Blah.java..." | |||
change="${p4.change}" /> | |||
</pre> | |||
<hr> | |||
<h2><a name="#p4submit">P4Submit</a></h2> | |||
<h3>Description:</h3> | |||
<p>Submit a changelist, usually obtained from P4Change. | |||
</p> | |||
<h3>Parameters</h3> | |||
<table border="1" cellpadding="2" cellspacing="0"> | |||
<tr> | |||
<td valign="top"><b>Attribute</b></td> | |||
<td valign="top"><b>Description</b></td> | |||
<td align="center" valign="top"><b>Required</b></td> | |||
</tr> | |||
<tr> | |||
<td valign="top">change</td> | |||
<td valign="top">The changelist number to submit</td> | |||
<td valign="top" align="center">Yes</td> | |||
</tr> | |||
</table> | |||
<h3>Examples</h3> | |||
<pre><p4submit change="${p4.change}" /> | |||
</pre> | |||
<hr> | |||
<h2><a name="#p4have">P4Have</a></h2> | |||
<h3>Description:</h3> | |||
<p>List handy file info reflecting the current client contents. | |||
</p> | |||
<h3>Parameters</h3> | |||
<table border="1" cellpadding="2" cellspacing="0"> | |||
<tr> | |||
<td valign="top"><b>Attribute</b></td> | |||
<td valign="top"><b>Description</b></td> | |||
<td align="center" valign="top"><b>Required</b></td> | |||
</tr> | |||
<tr> | |||
<td valign="top">None</td> | |||
<td valign="top" align="center">--</td> | |||
<td valign="top" align="center">--</td> | |||
</tr> | |||
</table> | |||
<h3>Examples</h3> | |||
<pre><p4have /> | |||
</pre> | |||
<hr> | |||
<h2><a name="#p4label">P4Label</a></h2> | |||
<h3>Description:</h3> | |||
<p>Create a new label and set contents to reflect current client file revisions. | |||
</p> | |||
<h3>Parameters</h3> | |||
<table border="1" cellpadding="2" cellspacing="0"> | |||
<tr> | |||
<td valign="top"><b>Attribute</b></td> | |||
<td valign="top"><b>Description</b></td> | |||
<td align="center" valign="top"><b>Required</b></td> | |||
</tr> | |||
<tr> | |||
<td valign="top">name</td> | |||
<td valign="top">The name of the label</td> | |||
<td valign="top" align="center">Yes</td> | |||
</tr> | |||
<tr> | |||
<td valign="top">view</td> | |||
<td valign="top">client view to use for label</td> | |||
<td valign="top" align="center">No</td> | |||
</tr> | |||
<tr> | |||
<td valign="top">desc</td> | |||
<td valign="top">Label Description</td> | |||
<td valign="top" align="center">No</td> | |||
</tr> | |||
</table> | |||
<h3>Examples</h3> | |||
<pre> | |||
<p4label | |||
name="NightlyBuild:${DSTAMP}:${TSTAMP}" | |||
desc="Auto Nightly Build" | |||
/> | |||
</pre> | |||
<hr> | |||
<h2><a name="#changes">Change History</a></h2> | |||
<table border="1" cellpadding="2" cellspacing="0"> | |||
<tr> | |||
<td valign="top">Sept 2000</td> | |||
<td valign="top" align="center">--</td> | |||
<td valign="top">Internal Release within Rubus<td> | |||
</tr> | |||
<tr> | |||
<td valign="top">Nov 2000</td> | |||
<td valign="top">V1.0</td> | |||
<td valign="top">Initial Release donated to ASF :-)<td> | |||
</tr> | |||
<tr> | |||
<td valign="top">Jan 2001</td> | |||
<td valign="top">V1.1</td> | |||
<td valign="top">fixed cross platform (NT/Unix) bug<br>refactored p4 output handling code<br>refactored exec'ing code</td> | |||
</tr> | |||
</table> | |||
</body> | |||
</html> |
@@ -50,15 +50,21 @@ | |||
* individuals on behalf of the Apache Software Foundation. For more | |||
* information on the Apache Software Foundation, please see | |||
* <http://www.apache.org/>. | |||
* | |||
* Portions of this software are based upon public domain software | |||
* originally written at the National Center for Supercomputing Applications, | |||
* University of Illinois, Urbana-Champaign. | |||
*/ | |||
package org.apache.tools.ant.taskdefs.optional.perforce; | |||
import java.io.*; | |||
import org.apache.tools.ant.*; | |||
//import org.apache.tools.ant.util.regexp.*; | |||
import org.apache.tools.ant.taskdefs.*; | |||
import org.apache.tools.ant.types.*; | |||
import org.apache.oro.text.perl.*; | |||
/** Base class for Perforce (P4) ANT tasks. See individual task for example usage. | |||
* | |||
* @see P4Sync | |||
@@ -84,15 +90,15 @@ public abstract class P4Base extends org.apache.tools.ant.Task { | |||
protected String P4Client = ""; | |||
/** Perforce User (eg fbloggs) */ | |||
protected String P4User = ""; | |||
/** Perforce view for commands (eg //projects/foobar/main/source/... ) */ | |||
/** Perforce view for commands (eg //projects/foobar/main/source/... )*/ | |||
protected String P4View = ""; | |||
//P4 g-opts and cmd opts (rtfm) | |||
/** Perforce 'global' opts. | |||
* Forms half of low level API */ | |||
* Forms half of low level API */ | |||
protected String P4Opts = ""; | |||
/** Perforce command opts. | |||
* Forms half of low level API */ | |||
* Forms half of low level API */ | |||
protected String P4CmdOpts = ""; | |||
//Setters called by Ant | |||
@@ -106,73 +112,59 @@ public abstract class P4Base extends org.apache.tools.ant.Task { | |||
util = new Perl5Util(); | |||
// Not as comprehensive as Exec but Exec | |||
// doesn't allow stdin and stdout/stderr processing | |||
String myOS = System.getProperty("os.name"); | |||
if(myOS == null) throw new BuildException("Unable to determine OS"); | |||
myOS = myOS.toLowerCase(); | |||
if( myOS.indexOf("os/2") >= 0 ) { | |||
shell = "cmd /c "; | |||
} else if( myOS.startsWith("windows") | |||
&& (myOS.indexOf("2000") >= 0 || myOS.indexOf("nt") >= 0 ) ) { | |||
shell = "cmd /c "; | |||
} else { | |||
// What about Mac OS? No perforce support there? | |||
shell = "/bin/sh "; //This needs testing on Unix!!!! | |||
} | |||
//Get default P4 settings from environment - Mark would have done something cool with | |||
//introspection here.....:-) | |||
String tmpprop; | |||
//Get default P4 settings from environment - Mark would have done something cool with | |||
//introspection here.....:-) | |||
String tmpprop; | |||
if((tmpprop = project.getProperty("p4.port")) != null) setPort(tmpprop); | |||
if((tmpprop = project.getProperty("p4.client")) != null) setClient(tmpprop); | |||
if((tmpprop = project.getProperty("p4.user")) != null) setUser(tmpprop); | |||
if((tmpprop = project.getProperty("p4.user")) != null) setUser(tmpprop); | |||
} | |||
protected void execP4Command(String command) throws BuildException { | |||
execP4Command(command, null, null); | |||
execP4Command(command, null); | |||
} | |||
protected void execP4Command(String command, P4OutputHandler handler) throws BuildException { | |||
execP4Command(command, null, handler); | |||
} | |||
/** Execute P4 command assembled by subclasses. | |||
@param command The command to run | |||
@param p4input Input to be fed to command on stdin | |||
@param handler A P4OutputHandler to process any output | |||
@param command The command to run | |||
@param p4input Input to be fed to command on stdin | |||
@param handler A P4Handler to process any input and output | |||
*/ | |||
protected void execP4Command(String command, String p4input, P4OutputHandler handler) throws BuildException { | |||
protected void execP4Command(String command, P4Handler handler) throws BuildException { | |||
try{ | |||
P4Opts = P4Port+" "+P4User+" "+P4Client; | |||
log("Execing "+shell+"p4 "+P4Opts+" "+command, Project.MSG_VERBOSE); | |||
Process proc = Runtime.getRuntime().exec(shell+"p4 "+P4Opts+" "+command); | |||
Commandline commandline = new Commandline(); | |||
commandline.setExecutable("p4"); | |||
if(p4input != null && p4input.length() >0) { | |||
OutputStream out = proc.getOutputStream(); | |||
out.write(p4input.getBytes()); | |||
out.flush(); | |||
out.close(); | |||
} | |||
//Q: Do we need to read p4 output if we're not interested? | |||
BufferedReader input = new BufferedReader( | |||
new InputStreamReader( | |||
new SequenceInputStream(proc.getInputStream(),proc.getErrorStream()))); | |||
//Check API for these - it's how CVS does it... | |||
commandline.createArgument().setValue(P4Port); | |||
commandline.createArgument().setValue(P4User); | |||
commandline.createArgument().setValue(P4Client); | |||
commandline.createArgument().setLine(command); | |||
log("Execing "+commandline.getCommandline(), Project.MSG_VERBOSE); | |||
//we check for a match on the input to save time on the substitution. | |||
String line; | |||
while((line = input.readLine()) != null) { | |||
if(handler != null) handler.process(line); | |||
if(handler == null ) handler = new SimpleP4OutputHandler(this); | |||
Execute exe = new Execute(handler, null); | |||
exe.setAntRun(project); | |||
exe.setCommandline(commandline.getCommandline()); | |||
try{ | |||
exe.execute(); | |||
}catch(IOException e) { | |||
throw new BuildException(e); | |||
} finally { | |||
try{ | |||
handler.stop(); | |||
}catch(Exception e) {} | |||
} | |||
proc.waitFor(); | |||
input.close(); | |||
}catch(Exception e) { | |||
throw new BuildException("Problem exec'ing P4 command: "+e.getMessage()); | |||
} | |||
}catch(Exception e) { | |||
throw new BuildException("Problem exec'ing P4 command: "+e.getMessage()); | |||
} | |||
} | |||
} |
@@ -50,6 +50,10 @@ | |||
* individuals on behalf of the Apache Software Foundation. For more | |||
* information on the Apache Software Foundation, please see | |||
* <http://www.apache.org/>. | |||
* | |||
* Portions of this software are based upon public domain software | |||
* originally written at the National Center for Supercomputing Applications, | |||
* University of Illinois, Urbana-Champaign. | |||
*/ | |||
package org.apache.tools.ant.taskdefs.optional.perforce; | |||
@@ -71,58 +75,63 @@ import org.apache.tools.ant.*; | |||
*/ | |||
public class P4Change extends P4Base { | |||
protected String emptyChangeList = null; | |||
protected String emptyChangeList = null; | |||
public void execute() throws BuildException { | |||
if(emptyChangeList == null) emptyChangeList = getEmptyChangeList(); | |||
final Project myProj = project; | |||
execP4Command("change -i", emptyChangeList, new P4OutputHandler() { | |||
public void process(String line) { | |||
if (util.match("/Change/", line)) { | |||
P4Handler handler = new P4HandlerAdapter() { | |||
public void process(String line) { | |||
if (util.match("/Change/", line)) { | |||
//Remove any non-numerical chars - should leave the change number | |||
line = util.substitute("s/[^0-9]//g", line); | |||
int changenumber = Integer.parseInt(line); | |||
log("Change Number is "+changenumber, Project.MSG_INFO); | |||
myProj.setProperty("p4.change", ""+changenumber); | |||
} else if(util.match("/error/", line)) { | |||
throw new BuildException("Perforce Error, check client settings and/or server"); | |||
} | |||
}}); | |||
//Remove any non-numerical chars - should leave the change number | |||
line = util.substitute("s/[^0-9]//g", line); | |||
int changenumber = Integer.parseInt(line); | |||
log("Change Number is "+changenumber, Project.MSG_INFO); | |||
myProj.setProperty("p4.change", ""+changenumber); | |||
} else if(util.match("/error/", line)) { | |||
throw new BuildException("Perforce Error, check client settings and/or server"); | |||
} | |||
}}; | |||
handler.setOutput(emptyChangeList); | |||
execP4Command("change -i", handler); | |||
} | |||
public String getEmptyChangeList() throws BuildException { | |||
final StringBuffer stringbuf = new StringBuffer(); | |||
execP4Command("change -o", new P4OutputHandler() { | |||
public void process(String line) { | |||
if(!util.match("/^#/",line)){ | |||
if(util.match("/error/", line)) { | |||
log("Client Error", Project.MSG_VERBOSE); | |||
throw new BuildException("Perforce Error, check client settings and/or server"); | |||
} else if(util.match("/<enter description here>/",line)) { | |||
line = util.substitute("s/<enter description here>/AutoSubmit By Ant/", line); | |||
} else if(util.match("/\\/\\//", line)) { | |||
//Match "//" for begining of depot filespec | |||
return; | |||
} | |||
stringbuf.append(line); | |||
stringbuf.append("\n"); | |||
} | |||
}}); | |||
return stringbuf.toString(); | |||
execP4Command("change -o", new P4HandlerAdapter() { | |||
public void process(String line) { | |||
if(!util.match("/^#/",line)){ | |||
if(util.match("/error/", line)) { | |||
log("Client Error", Project.MSG_VERBOSE); | |||
throw new BuildException("Perforce Error, check client settings and/or server"); | |||
} else if(util.match("/<enter description here>/",line)) { | |||
line = util.substitute("s/<enter description here>/AutoSubmit By Ant/", line); | |||
} else if(util.match("/\\/\\//", line)) { | |||
//Match "//" for begining of depot filespec | |||
return; | |||
} | |||
stringbuf.append(line); | |||
stringbuf.append("\n"); | |||
} | |||
}}); | |||
return stringbuf.toString(); | |||
} | |||
@@ -50,6 +50,10 @@ | |||
* individuals on behalf of the Apache Software Foundation. For more | |||
* information on the Apache Software Foundation, please see | |||
* <http://www.apache.org/>. | |||
* | |||
* Portions of this software are based upon public domain software | |||
* originally written at the National Center for Supercomputing Applications, | |||
* University of Illinois, Urbana-Champaign. | |||
*/ | |||
package org.apache.tools.ant.taskdefs.optional.perforce; | |||
@@ -65,17 +69,17 @@ import org.apache.tools.ant.*; | |||
* ToDo: Should call reopen if file is already open in one of our changelists perhaps? | |||
*/ | |||
public class P4Edit extends P4Base { | |||
public class P4Edit extends P4Base { | |||
public String change = null; | |||
public String change = null; | |||
public void setChange(String change) { | |||
this.change = change; | |||
} | |||
public void execute() throws BuildException { | |||
if(change != null ) P4CmdOpts = "-c "+change; | |||
if(P4View == null) throw new BuildException("No view specified to edit"); | |||
execP4Command("-s edit "+P4CmdOpts+" "+P4View, new SimpleP4OutputHandler(this)); | |||
} | |||
public void setChange(String change) { | |||
this.change = change; | |||
} | |||
public void execute() throws BuildException { | |||
if(change != null ) P4CmdOpts = "-c "+change; | |||
if(P4View == null) throw new BuildException("No view specified to edit"); | |||
execP4Command("-s edit "+P4CmdOpts+" "+P4View, new SimpleP4OutputHandler(this)); | |||
} | |||
} |
@@ -0,0 +1,69 @@ | |||
/* | |||
* The Apache Software License, Version 1.1 | |||
* | |||
* Copyright (c) 1999, 2000 The Apache Software Foundation. All rights | |||
* reserved. | |||
* | |||
* Redistribution and use in source and binary forms, with or without | |||
* modification, are permitted provided that the following conditions | |||
* are met: | |||
* | |||
* 1. Redistributions of source code must retain the above copyright | |||
* notice, this list of conditions and the following disclaimer. | |||
* | |||
* 2. Redistributions in binary form must reproduce the above copyright | |||
* notice, this list of conditions and the following disclaimer in | |||
* the documentation and/or other materials provided with the | |||
* distribution. | |||
* | |||
* 3. The end-user documentation included with the redistribution, if | |||
* any, must include the following acknowlegement: | |||
* "This product includes software developed by the | |||
* Apache Software Foundation (http://www.apache.org/)." | |||
* Alternately, this acknowlegement may appear in the software itself, | |||
* if and wherever such third-party acknowlegements normally appear. | |||
* | |||
* 4. The names "The Jakarta Project", "Ant", and "Apache Software | |||
* Foundation" must not be used to endorse or promote products derived | |||
* from this software without prior written permission. For written | |||
* permission, please contact apache@apache.org. | |||
* | |||
* 5. Products derived from this software may not be called "Apache" | |||
* nor may "Apache" appear in their names without prior written | |||
* permission of the Apache Group. | |||
* | |||
* THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED | |||
* WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES | |||
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE | |||
* DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR | |||
* ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, | |||
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT | |||
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF | |||
* USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND | |||
* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, | |||
* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT | |||
* OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | |||
* SUCH DAMAGE. | |||
* ==================================================================== | |||
* | |||
* This software consists of voluntary contributions made by many | |||
* individuals on behalf of the Apache Software Foundation. For more | |||
* information on the Apache Software Foundation, please see | |||
* <http://www.apache.org/>. | |||
*/ | |||
package org.apache.tools.ant.taskdefs.optional.perforce; | |||
import org.apache.tools.ant.BuildException; | |||
import org.apache.tools.ant.taskdefs.ExecuteStreamHandler; | |||
/** Interface for p4 job output stream handler. Classes implementing this interface | |||
* can be called back by P4Base.execP4Command(); | |||
* | |||
* @author <A HREF="mailto:leslie.hughes@rubus.com">Les Hughes</A> | |||
*/ | |||
public interface P4Handler extends ExecuteStreamHandler { | |||
public void process(String line) throws BuildException; | |||
public void setOutput(String line) throws BuildException; | |||
} |
@@ -0,0 +1,119 @@ | |||
/* | |||
* The Apache Software License, Version 1.1 | |||
* | |||
* Copyright (c) 1999, 2000 The Apache Software Foundation. All rights | |||
* reserved. | |||
* | |||
* Redistribution and use in source and binary forms, with or without | |||
* modification, are permitted provided that the following conditions | |||
* are met: | |||
* | |||
* 1. Redistributions of source code must retain the above copyright | |||
* notice, this list of conditions and the following disclaimer. | |||
* | |||
* 2. Redistributions in binary form must reproduce the above copyright | |||
* notice, this list of conditions and the following disclaimer in | |||
* the documentation and/or other materials provided with the | |||
* distribution. | |||
* | |||
* 3. The end-user documentation included with the redistribution, if | |||
* any, must include the following acknowlegement: | |||
* "This product includes software developed by the | |||
* Apache Software Foundation (http://www.apache.org/)." | |||
* Alternately, this acknowlegement may appear in the software itself, | |||
* if and wherever such third-party acknowlegements normally appear. | |||
* | |||
* 4. The names "The Jakarta Project", "Ant", and "Apache Software | |||
* Foundation" must not be used to endorse or promote products derived | |||
* from this software without prior written permission. For written | |||
* permission, please contact apache@apache.org. | |||
* | |||
* 5. Products derived from this software may not be called "Apache" | |||
* nor may "Apache" appear in their names without prior written | |||
* permission of the Apache Group. | |||
* | |||
* THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED | |||
* WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES | |||
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE | |||
* DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR | |||
* ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, | |||
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT | |||
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF | |||
* USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND | |||
* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, | |||
* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT | |||
* OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | |||
* SUCH DAMAGE. | |||
* ==================================================================== | |||
* | |||
* This software consists of voluntary contributions made by many | |||
* individuals on behalf of the Apache Software Foundation. For more | |||
* information on the Apache Software Foundation, please see | |||
* <http://www.apache.org/>. | |||
*/ | |||
package org.apache.tools.ant.taskdefs.optional.perforce; | |||
import java.io.*; | |||
import org.apache.tools.ant.*; | |||
public abstract class P4HandlerAdapter implements P4Handler { | |||
public abstract void process(String line); | |||
String p4input = ""; | |||
//set any data to be written to P4's stdin - messy, needs work | |||
public void setOutput(String p4Input) { | |||
this.p4input = p4Input; | |||
} | |||
public void start() throws BuildException { | |||
try{ | |||
//First write any output to P4 | |||
if(p4input != null && p4input.length() >0 && os != null) { | |||
os.write(p4input.getBytes()); | |||
os.flush(); | |||
os.close(); | |||
} | |||
//Now read any input and process | |||
BufferedReader input = new BufferedReader( | |||
new InputStreamReader( | |||
new SequenceInputStream(is,es))); | |||
String line; | |||
while((line = input.readLine()) != null) { | |||
process(line); | |||
} | |||
input.close(); | |||
}catch(Exception e) { | |||
throw new BuildException(e); | |||
} | |||
} | |||
OutputStream os; //OUtput | |||
InputStream is; //Input | |||
InputStream es; //Error | |||
public void setProcessInputStream(OutputStream os) throws IOException { | |||
this.os = os; | |||
} | |||
public void setProcessErrorStream(InputStream is) throws IOException { | |||
this.es = is; | |||
} | |||
public void setProcessOutputStream(InputStream is) throws IOException { | |||
this.is = is; | |||
} | |||
public void stop(){} | |||
} |
@@ -50,6 +50,10 @@ | |||
* individuals on behalf of the Apache Software Foundation. For more | |||
* information on the Apache Software Foundation, please see | |||
* <http://www.apache.org/>. | |||
* | |||
* Portions of this software are based upon public domain software | |||
* originally written at the National Center for Supercomputing Applications, | |||
* University of Illinois, Urbana-Champaign. | |||
*/ | |||
package org.apache.tools.ant.taskdefs.optional.perforce; | |||
@@ -50,6 +50,10 @@ | |||
* individuals on behalf of the Apache Software Foundation. For more | |||
* information on the Apache Software Foundation, please see | |||
* <http://www.apache.org/>. | |||
* | |||
* Portions of this software are based upon public domain software | |||
* originally written at the National Center for Supercomputing Applications, | |||
* University of Illinois, Urbana-Champaign. | |||
*/ | |||
package org.apache.tools.ant.taskdefs.optional.perforce; | |||
@@ -112,17 +116,21 @@ public class P4Label extends P4Base { | |||
"Options: unlocked\n"+ | |||
"View: "+P4View+"\n"; | |||
execP4Command("label -i", newLabel, new P4OutputHandler() { | |||
public void process(String line) { | |||
log(line, Project.MSG_VERBOSE); | |||
} | |||
}); | |||
P4Handler handler = new P4HandlerAdapter() { | |||
public void process(String line) { | |||
log(line, Project.MSG_VERBOSE); | |||
} | |||
}; | |||
handler.setOutput(newLabel); | |||
execP4Command("label -i", handler); | |||
execP4Command("labelsync -l "+name, null, new P4OutputHandler() { | |||
public void process(String line) { | |||
log(line, Project.MSG_VERBOSE); | |||
} | |||
}); | |||
execP4Command("labelsync -l "+name, new P4HandlerAdapter() { | |||
public void process(String line) { | |||
log(line, Project.MSG_VERBOSE); | |||
} | |||
}); | |||
log("Created Label "+name+" ("+desc+")", Project.MSG_INFO); | |||
@@ -50,6 +50,10 @@ | |||
* individuals on behalf of the Apache Software Foundation. For more | |||
* information on the Apache Software Foundation, please see | |||
* <http://www.apache.org/>. | |||
* | |||
* Portions of this software are based upon public domain software | |||
* originally written at the National Center for Supercomputing Applications, | |||
* University of Illinois, Urbana-Champaign. | |||
*/ | |||
package org.apache.tools.ant.taskdefs.optional.perforce; | |||
@@ -75,20 +79,20 @@ public class P4Submit extends P4Base { | |||
public void setChange(String change) { | |||
this.change = change; | |||
} | |||
} | |||
public void execute() throws BuildException { | |||
if(change != null) { | |||
execP4Command("submit -c "+change, new P4OutputHandler(){ | |||
public void process(String line) { | |||
log(line, Project.MSG_VERBOSE); | |||
} | |||
}); | |||
} else { | |||
//here we'd parse the output from change -o into submit -i | |||
//in order to support default change. | |||
throw new BuildException("No change specified (no support for default change yet...."); | |||
} | |||
} | |||
execP4Command("submit -c "+change, new P4HandlerAdapter(){ | |||
public void process(String line) { | |||
log(line, Project.MSG_VERBOSE); | |||
} | |||
}); | |||
} else { | |||
//here we'd parse the output from change -o into submit -i | |||
//in order to support default change. | |||
throw new BuildException("No change specified (no support for default change yet...."); | |||
} | |||
} | |||
} |
@@ -50,6 +50,10 @@ | |||
* individuals on behalf of the Apache Software Foundation. For more | |||
* information on the Apache Software Foundation, please see | |||
* <http://www.apache.org/>. | |||
* | |||
* Portions of this software are based upon public domain software | |||
* originally written at the National Center for Supercomputing Applications, | |||
* University of Illinois, Urbana-Champaign. | |||
*/ | |||
package org.apache.tools.ant.taskdefs.optional.perforce; | |||
@@ -80,7 +84,7 @@ public class P4Sync extends P4Base { | |||
public void setLabel(String label) throws BuildException { | |||
if(label == null && !label.equals("")) | |||
throw new BuildException("P4Sync: Labels cannot be Null or Empty"); | |||
throw new BuildException("P4Sync: Labels cannot be Null or Empty"); | |||
this.label = label; | |||
@@ -89,20 +93,20 @@ public class P4Sync extends P4Base { | |||
public void setForce(String force) throws BuildException { | |||
if(force == null && !label.equals("")) | |||
throw new BuildException("P4Sync: If you want to force, set force to non-null string!"); | |||
P4CmdOpts = "-f"; | |||
} | |||
throw new BuildException("P4Sync: If you want to force, set force to non-null string!"); | |||
P4CmdOpts = "-f"; | |||
} | |||
public void execute() throws BuildException { | |||
if (P4View != null) { | |||
syncCmd = P4View; | |||
syncCmd = P4View; | |||
} | |||
if(label != null && !label.equals("")) { | |||
syncCmd = syncCmd + "@" + label; | |||
syncCmd = syncCmd + "@" + label; | |||
} | |||
@@ -50,38 +50,42 @@ | |||
* individuals on behalf of the Apache Software Foundation. For more | |||
* information on the Apache Software Foundation, please see | |||
* <http://www.apache.org/>. | |||
* | |||
* Portions of this software are based upon public domain software | |||
* originally written at the National Center for Supercomputing Applications, | |||
* University of Illinois, Urbana-Champaign. | |||
*/ | |||
package org.apache.tools.ant.taskdefs.optional.perforce; | |||
import org.apache.tools.ant.*; | |||
public class SimpleP4OutputHandler implements P4OutputHandler { | |||
public class SimpleP4OutputHandler extends P4HandlerAdapter { | |||
P4Base parent; | |||
public SimpleP4OutputHandler(P4Base parent) { | |||
this.parent = parent; | |||
} | |||
public void process(String line) throws BuildException { | |||
if(parent.util.match("/^exit/",line)) return; | |||
P4Base parent; | |||
public SimpleP4OutputHandler(P4Base parent) { | |||
this.parent = parent; | |||
} | |||
public void process(String line) throws BuildException { | |||
if(parent.util.match("/^exit/",line)) return; | |||
//Throw exception on errors (except up-to-date) | |||
//p4 -s is unpredicatable. For example a server down | |||
//does not return error: markup | |||
// | |||
//Some forms producing commands (p4 -s change -o) do tag the output | |||
//others don't..... | |||
//Others mark errors as info, for example edit a file | |||
//which is already open for edit..... | |||
//Just look for error: - catches most things.... | |||
//Throw exception on errors (except up-to-date) | |||
//p4 -s is unpredicatable. For example a server down | |||
//does not return error: markup | |||
// | |||
//Some forms producing commands (p4 -s change -o) do tag the output | |||
//others don't..... | |||
//Others mark errors as info, for example edit a file | |||
//which is already open for edit..... | |||
//Just look for error: - catches most things.... | |||
if(parent.util.match("/error:/", line) && !parent.util.match("/up-to-date/", line)) { | |||
throw new BuildException(line); | |||
} | |||
if(parent.util.match("/error:/", line) && !parent.util.match("/up-to-date/", line)) { | |||
throw new BuildException(line); | |||
} | |||
parent.log(parent.util.substitute("s/^.*: //",line), Project.MSG_INFO); | |||
} | |||
parent.log(parent.util.substitute("s/^.*: //",line), Project.MSG_INFO); | |||
} | |||
} |