Subclipse.unkrig.de

Introduction

This ECLIPSE plug-in adds an additional ANT task 'de.unkrig.subclipse.svn' which is available in ANT builds which have the option 'Run in the same JRE as the workspace' set.

The ANT task uses the SVN client that is provided by the SUBCLIPSE plug-in. Thus no configuration is required, because it is re-used from SUBCLIPSE.

Download and Installation

Within ECLIPSE, download and install the feature from the update site

http://subclipse.unkrig.de/update

Task Descriptions

Task <de.unkrig.subclipse.svn>

Executes a series of SVN commands.

Attributes

(None.)

Subelements

The subelements of this task represent SVN subcommands which are executed sequentially:

<copy>

Representation of an svn copy subcommand.

Attributes

url="url" or file="path" or dir="path"

File or directory to copy (resource collection subelements are an alternative to specify multiple source files; see below).

toUrl="url" or toFile="path" or toDir="path"

Where to copy the file(s) (must be an existing directory iff multiple source files are specified).

message="text"

revision="rev"

pegRevision="rev"

copyAsChild="boolean"

makeParents="boolean"

See the SVN documentation of the svn copy subcommand.

Subelements

Resource collections (e.g. <fileset>, <dirset>, ...)

An alternative to the srcUrl="url" and srcPath="path" attributes to specify multiple source files.

<export>

Representation of an svn export subcommand.

Attributes

url="url" or file="path" or dir="path"

File or directory to export.

toFile="path" or toDir="path"

Where to export the file or directory to.

revision="rev"

See the documentation of the svn export subcommand.

force="boolean"

Whether to overwrite existing files.

<import>

Representation of an svn import subcommand.

Attributes

file="path" or dir="path"

File or directory to import.

url="url"

Destination repository location.

message="text"

recurse="boolean"

See the documentation of the svn import subcommand.

<mkdir>

Representation of an svn mkdir subcommand.

Attributes

url="url"

message="text"

makeParents="boolean"

See the documentation of the svn mkdir subcommand.

Other SVN subcommands

<addDirectory>

<addFile>

<addKeywords>

<annotate>

<checkout>

<commit>

<createPatch>

<createRepository>

<diff>

<diffSummarize>

<getProperties>

<getRevProperties>

<lock>

<merge>

<move>

<relocate>

<remove>

<revert>

<unlock>

<update>

These subelements exist, but merely issue an "Not yet implemented" error when executed.

Example

Tagging projects in SVN:

<!-- Verify that ANT is running in the same JVM as ECLIPSE. -->
<fail
    unless="eclipse.running"
    message="Please activate the ECLIPSE external tool configuration option 'Run in the same JRE as the workspace' and re-run."
/>

<!-- Verify that the 'de.unkrig.subclipse' plugin is available. -->
<fail message="Please install the 'de.unkrig.subclipse' ECLIPSE feature and re-run.">
    <condition><not><typefound name="de.unkrig.subclipse.svn" /></not></condition>
</fail>

<property name="d" value="http://svn.acme.com/svn/MyRepo/tags/${tag}"/>
<de.unkrig.subclipse.svn>
    <mkdir                          url="${d}"/>
    <copy srcpath="."           desturl="${d}"/>
    <copy srcpath="../project2" desturl="${d}"/>
</de.unkrig.subclipse.svn>

If you like loading ANT tasks in separate XML namespaces, you can alternatively write:

<some-enclosing-tag-e-g-project-or-target xmlns:unkrig="antlib:de.unkrig.subclipse">
    ...
    <fail
        unless="eclipse.running"
        message="Please activate the ECLIPSE external tool configuration option 'Run in the same JRE as the workspace' and re-run."
    />

    <fail message="Please install the 'de.unkrig.subclipse' ECLIPSE feature and re-run.">
        <condition><not><typefound uri="antlib:de.unkrig.subclipse" name="svn" /></not></condition>
    </fail>

    <unkrig:svn>...

, where "unkrig" is the (arbitrary) XML namespace prefix.

License

SUBCLIPSE.UNKRIG.DE is published under the "New BSD License".

Source Code

Source code is available via SVN on

https://svn.code.sf.net/p/loggifier/code

. From that repository, check out the projects

• de.unkrig.checkstyle-configuration
• de.unkrig.commons.nullanalysis
• de.unkrig.subclipse_dist
• de.unkrig.subclipse.ant.tasks
• de.unkrig.subclipse.branding
• de.unkrig.subclipse.core
• org.apache.ant-1.8.4

, or, if you are using ECLIPSE, just import https://svn.code.sf.net/p/loggifier/code/trunk/de.unkrig.subclipse_dist/projectSet.psf.

Contact

For bugs, improvements, complaints, or any other kind of feedback, send email to arno@subclipse.unkrig.de.