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

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:

grunt.loadNpmTasks('grunt-svn-fetch');

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

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: 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.

grunt.initConfig({
	'svn-fetch': {
		options: {
			'repository':	'https://my_repos.com/projectX/trunk/',
			'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:

/svn/projectX/src/folderX

and

https://my_repos.com/projectX/trunk/SVNFolderX

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

• 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
• 2014-01-21 0.2.0 Forked LMnet/grunt-svn-fetch. Full rebuild of plugin. Renamed to 'svn-fetch'.