source: Dev/trunk/node_modules/grunt-svninfo/package.json

{
  "name": "grunt-svninfo",
  "description": "Subversion working copy metadata (svn info) grunt plugin",
  "version": "0.1.4",
  "homepage": "https://github.com/liqweed/grunt-svninfo",
  "author": {
    "name": "liqweed"
  },
  "repository": {
    "type": "git",
    "url": "git://github.com/liqweed/grunt-svninfo.git"
  },
  "bugs": {
    "url": "https://github.com/liqweed/grunt-svninfo/issues"
  },
  "licenses": [
    {
      "type": "MIT",
      "url": "https://github.com/liqweed/grunt-svninfo/blob/master/LICENSE-MIT"
    }
  ],
  "main": "Gruntfile.js",
  "engines": {
    "node": ">= 0.8.0"
  },
  "scripts": {
    "test": "grunt test"
  },
  "devDependencies": {
    "grunt-contrib-clean": "~0.5.0",
    "grunt-contrib-nodeunit": "~0.2.0",
    "grunt-coffeelint": "*",
    "grunt-mocha-cli": "*",
    "grunt": "~0.4.x"
  },
  "peerDependencies": {
    "grunt": "~0.4.x"
  },
  "keywords": [
    "gruntplugin",
    "svn",
    "subversion",
    "svninfo"
  ],
  "readme": "# grunt-svninfo\r\n\r\n> A Grunt.js plugin that provides easy access to Subversion working copy metadata (svn info).\r\n\r\n## Getting Started\r\nThis plugin requires Grunt `~0.4.0`\r\n\r\nIf you haven't used [Grunt](http://gruntjs.com/) before, be sure to check out the [Getting Started](http://gruntjs.com/getting-started) guide, as it explains how to create a [Gruntfile](http://gruntjs.com/sample-gruntfile) as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:\r\n\r\n```shell\r\nnpm install grunt-svninfo --save-dev\r\n```\r\n\r\nOne the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:\r\n\r\n```js\r\ngrunt.loadNpmTasks('grunt-svninfo');\r\n```\r\n\r\nThat's about it, no configuration necessary.\r\n\r\n## The \"svninfo\" task\r\n\r\n### Overview\r\nIn your project's Gruntfile, add a section named `svninfo` to the data object passed into `grunt.initConfig()`.\r\nExecuting the task `svninfo` would run `svn info` in the command line and would make the retrieved data available via grunt.config (e.g. `<%= svninfo.rev %>`) in your build.\r\nThe resulting `svninfo` object has the following structure:\r\n\r\n\r\n```js\r\n{\r\n  \"rev\": \"321\",\r\n  \"url\": \"https://yourproject.unfuddle.com/svn/repo/trunk\",\r\n  \"last\": {\r\n \t  \"rev\": \"321\",\r\n \t  \"author\": \"me\",\r\n \t  \"date\": \"2013-02-10 12:35:30 +0200\"\r\n  },\r\n  \"repository\": {\r\n \t  \"root\": \"https://yourproject.unfuddle.com/svn/repo\",\r\n \t  \"id\": \"f5d41312-1fa6-4ca6-a93e-e27d7e98fc43\"\r\n  }\r\n}\r\n```\r\n\r\n### Options\r\n\r\n#### cwd\r\nType: `String`\r\n\r\nAllows to specify a cwd (current working directory) path for the SVN repository of which to retrieve the information. The default directory is the where you run grunt from (`'.'`).\r\n\r\nExample:\r\n``` js\r\nsvninfo: {\r\n  options: {\r\n    cwd: './myproject/ishere'\r\n  },\r\n  ...\r\n}\r\n```\r\n\r\n#### output\r\nType: `String`\r\n\r\nAllows to specify a custom object that would contain the retrieved and parsed SVN info. Defaults to 'svninfo'. This feature came about to support projects with multiple external dependencies (\"extenals\"), in which each external would have its own info object instead of having them override each other with each 'info' call.\r\n\r\nName of object can be redefined or specified by the first argument of task (see below).\r\n\r\nExample:\r\n``` js\r\nsvninfo: {\r\n  options: {\r\n    output: 'myExternal_svninfo'\r\n  },\r\n  ...\r\n}\r\n```\r\n\r\n#### args\r\nType: `Array`\r\n\r\nAllows to specify options for `svn info` command (e.g. target, username, password etc).\r\n\r\nExample:\r\n``` js\r\nsvninfo: {\r\n  options: {\r\n    args: ['http://some.svn-server.net/repo/project/trunk', '--username', 'name', '--password', 'pass']\r\n  },\r\n  ...\r\n}\r\n```\r\n\r\nIt is possible to retrieve command options from other option instead of `args`.\r\nIt can be done by using the second argument of task (see below).\r\n\r\n### Task arguments\r\n\r\nTwo arguments can be passed to the task:\r\n\r\n1. Allows to specify a custom object that would contain the retrieved and parsed SVN info. This argument has priority over the `output` option.\r\n2. Allows to specify name of options field that contains list of command options. This argument has priority over the `args` option.\r\n\r\nExample: \r\n``` js\r\ngrunt.initConfig({\r\n  svninfo: {\r\n    options: {\r\n      abcArgs: ['http://some.svn-server.net/repo/abc/trunk', '--username', 'name', '--password', 'pass']\r\n    },\r\n    ...\r\n  }\r\n...\r\ngrunt.registerTask(\"abcInfo\", [\"svninfo:abc:abcArgs\"]);\r\n// or `grunt svninfo:abc:abcArgs` from command line\r\n});\r\n```\r\n\r\n## Contributing\r\nIn lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using [Grunt](http://gruntjs.com/).\r\n\r\n## Release History\r\n * 0.1.4 - Support for task arguments and args option (thanks to @gamtiq)\r\n * 0.1.3 - Support for a custom name for the info object (thanks to @solomojb)\r\n * 0.1.2 - Support for 'cwd' option (thanks to @richmarr)\r\n * 0.1.1 - Grunt 0.4.x compatibility\r\n * 0.1.0 - Initial release\r\n",
  "readmeFilename": "README.md",
  "_id": "grunt-svninfo@0.1.4",
  "dist": {
    "shasum": "c07f3be71abdb93c0477c49154cd4496ead7b488"
  },
  "_from": "grunt-svninfo@",
  "_resolved": "https://registry.npmjs.org/grunt-svninfo/-/grunt-svninfo-0.1.4.tgz"
}