Description

This task provides an interface to Subversion revision control system that is a compelling replacement for CVS in the open source community.
With the help of the underlying svnClientAdapter, <svn> task uses JavaHL (a native JNI interface to the subversion api) if itcan find the corresponding library (e.g. svnjavahl.dll on windows).Otherwise it uses svn command line interface.

Setup

As with most Ant extensions, SvnAnt's task and type names must bemappedto their implementing classes before being used in an Ant buildfile. An example of how to use the antlib bundled inSvnAnt's JAR file to perform that registration follows:

Parameters

Svn commands specified as nested elements

add

You can add files and directories to svn repository with nested <add> elements.

Parameters specified as nested elements :

• fileset
  Filesets are used to select sets of files to add to the repository.
  Note that directories needed to add selected files will be added to the repository even if they are not selected by the fileset.

?

cat

Get the content of a file on repository.

checkout

Check out a working copy from a repository.

commit

Send changes from your working copy to the repository.

Parameters specified as nested elements :

• fileset
  Filesets are used to select sets of files to commit.

?

copy

Duplicate something in working copy or repository, rememberinghistory.
source and destination can each be either a working copy (WC) path or URL:

• WC->WC: copy and schedule for addition (with history)
• WC->URL: immediately commit a copy of WC to URL
• URL->WC: check out URL into WC, schedule for addition
• URL->URL: complete server-side copy; used to branch & tag

?

createRepository

Create a new, empty repository at path.

delete

If run on a working copy target, the item is scheduled fordeletion upon the next commit. Files, and directories that havenot been committed, are immediately removed from the working copy.
The command will not remove targets that are, or contain,unversioned or modified items; use the force attribute to overridethis behaviour.
If run on an url, the item is deleted from the repository via an immediate commit.

Parameters specified as nested elements :

• fileset
  Filesets are used to select sets of files to delete..

?

diff

Display the differences between two paths (oldPath and newPath) ortwo urls (oldUrl and newUrl).

export

?

1. Exports a clean directory tree from the repository specified by srcurl, at revision revision if it is given, otherwise at HEAD, into destPath.
2. Exports a clean directory tree from the working copy specified by srcPath into destPath. all local changes will be preserved, but files not under revision control will not be copied.

?

ignore

Add a given file or a pattern to the ignored files list (modifiessvn:ignore property)

import

Commit an unversioned file or tree into the repository.
Recursively commit a copy of path to url.
If newEntry is not set, copy top-level contents of pathintourldirectly. Otherwise, create newEntry underneath url and begin copy there.

info

Gets the information from the repository for a file, directory or url and setsthe values to ant properties.

?

The task sets the following properties (prefix applied accordingly):

keywordsset

Keywordsset controls which keywords will be substituted on thegiven files. Valid keywords are:

• URL, HeadURL : The URL for the head version of the object.
• Author, LastChangedBy : The last person to modify the file.
• Date, LastChangedDate : The date/time the object was last modified.
• Rev, LastChangedRevision : The last revision the object changed.
• Id : A compressed summary of the previous

?

Parameters specified as nested elements :

• fileset
  Filesets are used to select sets of files on which to apply keywords substitution.

?

keywordsadd

Keywordsadd add some keywords to be substituted on the givenfiles. Present keywords are not modified.
The attributes are the same than for keywordsset command.

keywordsremove

Keywordsadd remove some keywords to be substituted on the givenfiles. Other present keywords are not modified.
The attributes are the same than for keywordsset command.

mkdir

Create a new directory under revision control.
If target is a working copy path the directory is scheduled for addition in theworking copy. If target is an url the directory is created inthe repository via an immediate commit.
In both cases all the intermediate directories must already exist.

move

Move/rename something in working copy or repository.

cource and destination can both be working copy (WC) paths orURLs:
WC -> WC: move andschedule for addition (with history)
URL ->URL: complete server-side rename.

propdel

Remove a property from files or dirs.

propget

Get a property from a file or a directory.

propset

Set a property on files or dirs.

Note:svn recognizes the following special versioned properties but will store any arbitrary properties set:

• svn:ignore : A newline separated list of file patterns to ignore.
• svn:keywords : Keywords to be expanded. Valid keywords are:
  • URL, HeadURL : The URL for the head version of the object.
  • Author, LastChangedBy : The last person to modify the file.
  • Date, LastChangedDate : The date/time the object was last modified.
  • Rev, LastChangedRevision : The last revision the object changed.
  • Id : A compressed summary of the previous 4 keywords.
• svn:executable : If present, make the file executable. This property cannot be set on a directory. A non-recursive attempt will fail, and a recursive attempt will set the property only on the file children of the directory
• svn:eol-style : One of 'native', 'LF', 'CR', 'CRLF'.
• svn:mime-type : The mimetype of the file. Used to determine whether to merge the file, and how to serve it from Apache.
  A mimetype beginning with 'text/' (or an absent mimetype) is treated as text. Anything else is treated as binary.
• svn:externals : A newline separated list of module specifiers, each of which consists of a relative directory path, optional revision flags, and an URL. For example
  foo http://example.com/repos/zig
  foo/bar -r 1234 http://example.com/repos/zag

?

revert

Restore pristine working copy file (undo most local edits).

Parameters specified as nested elements :

• fileset
  Filesets are used to select sets of files to revert.

?

status

Get the status of working copy files and directories.

The value of TextStatusProperty can be :

• non-svn
• normal : no modifications
• added
• missing : item is missing (removed by non-svn command)
• incomplete
• deleted
• replaced
• modified
• merged
• conflicted
• obstructed
• ignored
• external
• unversioned

• normal : no modifications
• conflicted
• modified

?

?

switch

Update the working copy to mirror a new URL within the repository.This behaviour is similar to 'svn update', and is the way to move aworking copy to a branch or tag within the same repository.

update

Bring changes from the repository into the working copy.
If norevision given, bring working copy up-to-date with HEAD rev. Else synchronize working copy to revision.

• fileset
  Filesets are used to select sets of files to update.

wcVersion

Retrieves a state of the working copy. Similar to the svn's utility svnversion, just providing more.
Crawls the working copy and retrieves the maximum revision number, revision range if workingCopy is mixed etc.

The command fill set the following properties: (with optional prefix applied)

An example of the properties that would be set in a sample working copy (with modifications):
(with prefix="svn.")

svn.repository.url -> https://server/repos/branches/1.2.xsvn.repository.path -> /repos/branches/1.2.xsvn.revision.max -> 676svn.revision.max-with-flags -> 676Msvn.revision.range -> 676Msvn.committed.max -> 651svn.committed.max-with-flags -> 651Msvn.modified -> true

repository.url -> https://server/repos/branches/1.2.xrepository.path -> /repos/branches/1.2.xrevision.max -> 676revision.max-with-flags -> 676MXrevision.range -> 673:676Msvn.committed.max -> 651svn.committed.max-with-flags -> 651Mmodified -> truemixed -> true

?

cleanup

cleanup your working copy

?

Examples

?

checkouts a working copy from repository

?

?

?

deletes some files from repository (and commit changes)

?

?

add my_repos/propTest to repository and set two properties on file.png
subversion command line interface is used (javahl="false").