Skip to content
GruntJS plugin to ensure specified files are checked out or updated from SVN repository.
Find file
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
test initial version


Ensures specified files are checked out or updated from SVN repository.

Getting Started

This plugin requires Grunt ~0.4.0

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

npm install grunt-svn-fetch --save-dev

One the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:


The "svn_fetch" task


In your project's Gruntfile, add a section named svn_fetch to the data object passed into grunt.initConfig().

    svn_fetch: {
        options: {
            // Task-specific options go here.
        your_target: {
            options: {
                // Target-specific settings and/or options go here.

The task works by checking for the presence of the .svn folder under each of the target folders. If present, an update is performed, otherwise a checkout is done.



Type: String

Default value: 'svn'

Specifies the location of the SVN binary.


Type: 'Object'

Default value: {}

Specifies any options to pass to the exec command when executing the svn cli statements. For example, it may be necessary to increase the default maxBuffer for larger repositories.


Type: 'Object'

Default value: {}

Specifies any options to pass to the svn command. For example you can specify your credentials as follows:

svnOptions: {
    username: 'paul',
    password: 'paulpasswd'


Type: String

Default value: ''

The URL of the SVN repository.


Type: String

Default value: ''

The base element of the path to where checked out or updated files are placed.

Usage Examples

    svn_fetch: {
        options: {
            'repository':   '',
            'path':         '/svn/projectX/src/'
        projectX: {
            map: {
                'folderX': 'SVNFolderX',
                'folderY': 'SVNFolderY'

Each entry in map utilises the path and respository options to determine the full path and URL of the items being considered. So, in this case, the first entry would resolve to:



Note the inclusion of slashes on the option entries. The plugin makes no effort to ensure slashes are correct.

Release History

  • 2013-03-13 0.1.0 Initial release
  • 2013-03-13 0.1.2 Issue #1 fixed
  • 2013-12-11 0.1.3 Issue #2 fixed
Something went wrong with that request. Please try again.